NOM

       SSL_set_fd, SSL_set_rfd, SSL_set_wfd - Connecter l'objet SSL à un descripteur de fichier

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

       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 nonblocking, the ssl will also
       have nonblocking behaviour.

       When used on a QUIC connection SSL object, a datagram BIO is automatically created instead of a socket
       BIO. These functions fail if called on a QUIC stream SSL object.

       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.

VALEURS RENVOYÉES

       Les valeurs suivantes peuvent être renvoyées.

       0   L'opération a échoué. Vérifiez la pile d'erreur pour découvrir la raison.

       1   L'opération a réussi.

NOTES

       On  Windows,  a  socket  handle  is  a  64-bit  data  type  (UINT_PTR), which leads to a compiler warning
       (conversion from  'SOCKET'  to  'int',  possible  loss  of  data)  when  passing  the  socket  handle  to
       SSL_set_*fd().  For  the  time  being, this warning can safely be ignored, because although the Microsoft
       documentation claims that the upper limit is  INVALID_SOCKET-1  (2^64  -  2),  in  practice  the  current
       socket()  implementation  returns  an index into the kernel handle table, the size of which is limited to
       2^24.

VOIR AUSSI

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

COPYRIGHT

       Copyright 2000-2023 Les auteurs du projet OpenSSL. Tous droits réservés.

       Sous licence Apache 2.0 (la « Licence »). Vous ne pouvez utiliser ce fichier  que  conformément  avec  la
       Licence.  Vous  trouverez  une  copie dans le fichier LICENSE de la distribution du source ou à l'adresse
       <https://www.openssl.org/source/license.html>.

TRADUCTION

       La  traduction   française   de   cette   page   de   manuel   a   été   créée   par   Nicolas   François
       <nicolas.francois@centraliens.net>,     David     Prévot    <david@tilapin.org>    et    Lucas    Laugier
       <zoxmo17@hotmail.fr>

       Cette traduction est une documentation libre ; veuillez vous  reporter  à  la  GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si  vous  découvrez  un  bogue  dans la traduction de cette page de manuel, veuillez envoyer un message à
       debian-l10n-french@lists.debian.org.

3.5.0                                              28 mai 2025                                  SSL_SET_FD(3SSL)