Name

SSL_set_fd — connect the SSL object with a file descriptor

Library

libssl.lib

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);

Detailed Description

SSL_set_fd() sets the file descriptor fd as the input/output facility for the TLS/SSL (encrypted) side of ssl. 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 fd. The BIO and hence the SSL engine inherit the behaviour of fd. If fd is non-blocking, the ssl will also have non-blocking behaviour.

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

SSL_set_rfd() and SSL_set_wfd() 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:

See Also

SSL_get_fd(), SSL_set_bio(), SSL_connect(), SSL_accept(), SSL_shutdown(), ssl() ,bio()

Feedback

For additional information or queries on this page send feedback