libressl-SSL_get_fd(3)

libressl-SSL_get_fd3

Get file descriptor linked to an ssl object

Usage

SSL Library (libssl, -lssl) libcrypto

#include <openssl/ssl.h>

int

SSL_get_fd(const SSL *ssl);

int

SSL_get_rfd(const SSL *ssl);

int

SSL_get_wfd(const SSL *ssl);

Overview

SSL_get_fd() returns the file descriptor which is linked to ssl. SSL_get_rfd() and SSL_get_wfd() return the file descriptors for the read or the write channel, which can be different. If the read and the write channel are different, SSL_get_fd() will return the file descriptor of the read channel.

Return values

The following return values can occur:

−1

The operation failed, because the underlying BIO is not of the correct type (suitable for file descriptors).

≥0

The file descriptor linked to ssl.

History

SSL_get_fd() appeared in SSLeay 0.4 or earlier and has been available since OpenBSD 2.4.

SSL_get_rfd() and SSL_get_wfd() first appeared in OpenSSL 0.9.6c and have been available since OpenBSD 3.2.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.