NAME

SSL_set_fd − Connect the SSL object with a file descriptor

SYNOPSIS

#include <openssl/ssl.h>
int SSL_set_fd(
        SSL ∗ssl, int fd ); int SSL_set_rfd(
        SSL ∗ssl, int fd ); int SSL_set_wfd(
        SSL ∗ssl, int fd );

DESCRIPTION

The SSL_set_fd() function sets the file descriptor fd as the input/output facility for the TLS/SSL (encrypted) side of ssl. The fd will typically be the socket file descriptor of a network connection. 

When performing the operation, a socket BIO is automatically created to interface between the ssl and the fd. The BIO and the SSL engine inherit the behavior of fd. If fd is non-blocking, the ssl will also have non-blocking behavior. 

If there was already a BIO connected to ssl, the BIO_free() function will be called (for both the reading and writing side, if different). 

The SSL_set_rfd() and SSL_set_wfd() functions perform the respective action, but only for the read channel or the write channel, which can be set independently. 

RETURN VALUES

The following return values can occur:

0The operation failed. Check the error stack to find out why. 

1The operation succeeded. 

SEE ALSO

Functions: SSL_get_fd(3), SSL_set_bio(3), SSL_connect(3), SSL_accept(3), SSL_shutdown(3), ssl(3) , bio(3)