ref: 4d919ab612f61c1ef1b21d41513f264d57c010d4
dir: /sys/man/2/pushssl/
.TH PUSHSSL 2 .SH NAME pushssl \- attach SSL version 2 encryption to a communication channel .SH SYNOPSIS .B #include <u.h> .br .B #include <libc.h> .PP .B int pushssl(int fd, char *alg, char *secin, char *secout, int *cfd) .SH DESCRIPTION .I Pushssl opens an .IR ssl (3) device, connects it to the communications channel .IR fd , and starts up encryption and message authentication as specified in .IR alg . The algorithms are separated by a space and either can be first. See .IR ssl (3) for the possible algorithms. .I Secin and .I secout contain the encryption keys for the two directions. If either is nil, the other is used in both directions. If .I cfd is non-nil, the SSL control channel is opened and its fd returned. .PP .I Pushssl returns a file descriptor for the SSL data channel. Anything written to this descriptor will get encrypted and authenticated and then written to the file descriptor, .IR fd . .I Pushssl closes the original file descriptor .IR fd on success. .SH SOURCE .B /sys/src/libc/9sys .SH "SEE ALSO" .IR dial (2), .IR ssl (3), .SH DIAGNOSTICS return \-1 on failure.