cgit.sxemacs.org Git - gnus/blob - lisp/starttls.el

   1 ;;; starttls.el --- STARTTLS functions
   2
   3 ;; Copyright (C) 1999, 2000 Free Software Foundation, Inc.
   4
   5 ;; Author: Daiki Ueno <ueno@unixuser.org>
   6 ;; Created: 1999/11/20
   7 ;; Keywords: TLS, SSL, OpenSSL, mail, news
   8
   9 ;; This file is part of GNU Emacs.
  10
  11 ;; GNU Emacs is free software; you can redistribute it and/or modify
  12 ;; it under the terms of the GNU General Public License as published by
  13 ;; the Free Software Foundation; either version 2, or (at your option)
  14 ;; any later version.
  15
  16 ;; GNU Emacs is distributed in the hope that it will be useful,
  17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19 ;; GNU General Public License for more details.
  20
  21 ;; You should have received a copy of the GNU General Public License
  22 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
  23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  24 ;; Boston, MA 02111-1307, USA.
  25
  26 ;;; Commentary:
  27
  28 ;; This module defines some utility functions for STARTTLS profiles.
  29
  30 ;; [RFC 2595] "Using TLS with IMAP, POP3 and ACAP"
  31 ;;      by Chris Newman <chris.newman@innosoft.com> (1999/06)
  32
  33 ;;; Code:
  34
  35 (defgroup starttls nil
  36   "Support for `Transport Layer Security' protocol."
  37   :version "21.1"
  38   :group 'mail)
  39
  40 (defcustom starttls-program "starttls"
  41   "The program to run in a subprocess to open an TLSv1 connection."
  42   :type 'string
  43   :group 'starttls)
  44
  45 (defcustom starttls-extra-args nil
  46   "Extra arguments to `starttls-program'."
  47   :type '(repeat string)
  48   :group 'starttls)
  49
  50 (defun starttls-negotiate (process)
  51   (signal-process (process-id process) 'SIGALRM))
  52
  53 (defun starttls-open-stream (name buffer host service)
  54   "Open a TLS connection for a service to a host.
  55 Returns a subprocess-object to represent the connection.
  56 Input and output work as for subprocesses; `delete-process' closes it.
  57 Args are NAME BUFFER HOST SERVICE.
  58 NAME is name for process.  It is modified if necessary to make it unique.
  59 BUFFER is the buffer (or `buffer-name') to associate with the process.