From 9081bb1d21b0a0f6812099e5f2207f28c7e1b944 Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Tue, 25 Sep 2001 15:48:11 +0000
Subject: [PATCH] =?UTF-8?q?Added=20documentation=20for=20the=20SSL=20inter?=
 =?UTF-8?q?face,=20contributed=20by=20Gerhard=20H=C3=A4ring.=20This=20clos?=
 =?UTF-8?q?es=20SF=20patch=20#461337.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Doc/lib/libsocket.tex | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/Doc/lib/libsocket.tex b/Doc/lib/libsocket.tex
index 3e585593099..2468aecde5d 100644
--- a/Doc/lib/libsocket.tex
+++ b/Doc/lib/libsocket.tex
@@ -265,6 +265,15 @@ protocol number.  The address family should be \constant{AF_INET}, \constant{AF_
 The protocol number is usually zero and may be omitted in that case.
 \end{funcdesc}
 
+\begin{funcdesc}{ssl}{sock, keyfile, certfile}
+Initiate a SSL connection over the socket \var{sock}. \var{keyfile} is
+the name of a PEM formatted file that contains your private
+key. \var{certfile} is a PEM formatted certificate chain file. On
+success, a new \class{SSLObject} is returned.
+
+\strong{Warning:} This does not do any certificate verification!
+\end{funcdesc}
+
 \begin{funcdesc}{fromfd}{fd, family, type\optional{, proto}}
 Build a socket object from an existing file descriptor (an integer as
 returned by a file object's \method{fileno()} method).  Address family,
@@ -510,6 +519,20 @@ use \method{recv()} and \method{send()} without \var{flags} argument
 instead.
 
 
+\subsection{SSL Objects \label{ssl-objects}}
+
+SSL objects have the following methods.
+
+\begin{methoddesc}{write}{s}
+Writes the string \var{s} to the on the object's SSL connection.
+The return value is the number of bytes written.
+\end{methoddesc}
+
+\begin{methoddesc}{read}{\optional{n}}
+If \var{n} is provided, read \var{n} bytes from the SSL connection, otherwise
+read until EOF. The return value is a string of the bytes read.
+\end{methoddesc}
+
 \subsection{Example \label{socket-example}}
 
 Here are four minimal example programs using the TCP/IP protocol:\ a