.TH SECURITY-SSL 2.SH NAMEssl: connect, secret \- interface to the Secure Sockets Layer.SH SYNOPSIS.EXinclude "sys.m";include "security.m";ssl := load SSL SSL->PATH; connect: fn(fd: ref Sys->FD): (string, ref Sys->Connection);secret:  fn(c: ref Sys->Connection, secretin,                secretout: array of byte): string;.EE.SH DESCRIPTION.B SSLprovides an interface to the secure sockets layer device.IR ssl (3)..PP.B Connectallocates a new.IR ssl (3)connection directory.It pushesfile descriptor.I fdinto the.B datafile of that connection, and if successful,returns a reference to a.B Connectionadt describing the connection.The.B Connectionadt has its members set as follows:.B dirnames the resulting connection directory;.B cfdis open on the connection'scontrol file; and.B dfdis open on the connection's.B datafile,which is read and written to exchange data on the original.I fdusing SSL..PP.B Secretsets the secrets for each direction on Connection.I c ;if a secret is nil, the existing setting for that direction remains unchanged.The string returned describes errors encountered, if any; otherwise it is nil..PP.SH SOURCE.B /appl/lib/ssl.b.SH "SEE ALSO".IR security-auth (2),.IR ssl (3).SH DIAGNOSTICS.B Connectreturns a tuple containing a string and a.B Connectionreference.On success the string is nil, and the connection reference is not nil;on error, the string contains a diagnostic, and the connection reference is nil.