ref: 4dcbf96833d0b11a3d4c9984c9998f380e194e74
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.