NOM

       SSL_connect - Démarrer l'initiation de connexion TLS ou SSL avec un serveur TLS ou SSL

SYNOPSIS

        #include <openssl/ssl.h>

        int SSL_connect(SSL *ssl);

DESCRIPTION

       SSL_connect() commence l'initiation de connexion TLS ou SSL avec un serveur. Le canal de communication
       doit avoir déjà été configuré et assigné à ssl en configurant le BIO sous-jacent.

NOTES

       Le comportement de SSL_connect() dépend du BIO sous-jacent.

       Si le BIO sous-jacent est bloquant, SSL_connect() ne s'arrêtera qu'une fois l'initiation de connexion
       terminée ou si une erreur survient.

       Si le BIO sous-jacent est non bloquant, SSL_connect() s'arrêtera aussi si le BIO sous-jacent ne peut pas
       satisfaire les besoins de SSL_connect() pour continuer l'initiation de connexion, indiquant le problème
       avec la valeur de retour -1. Dans ce cas, un appel de SSL_get_error() avec la valeur de retour de
       SSL_connect() renverra SSL_ERROR_WANT_READ ou SSL_ERROR_WANT_WRITE. Le processus appelant doit alors
       répéter l'appel après avoir pris les mesures nécessaires pour satisfaire les besoins de SSL_connect().
       L'action dépend du BIO sous-jacent. Lors de l'utilisation d'une socket non bloquante, il n'y a rien à
       faire, à part utiliser select() pour vérifier la condition nécessaire. Lors de l'utilisation d'un BIO de
       type tampon, comme une paire de BIO, les données doivent être écrites ou récupérées du BIO avant de
       pouvoir continuer.

VALEURS DE RETOUR

       Les valeurs suivantes peuvent être renvoyées.

       0   L'initiation  de  connexion  TLS  ou  SSL  n'a  pas  réussi  mais  a  été  arrêtée de façon contrôlée
           conformément aux spécifications des protocoles TLS ou SSL. Appelez SSL_get_error() avec la valeur  de
           retour ret pour en connaître la raison.

       1   L'initiation de connexion TLS ou SSL a réussi, une connexion TLS ou SSL a été établie.

       <0  L'initiation  de  connexion  TLS  ou SSL n'a pas réussi, soit à cause d'une erreur fatale survenue au
           niveau du protocole, soit à cause d'un échec de connexion. L'arrêt  n'était  pas  propre.  Cela  peut
           aussi  arriver  si  une  action est nécessaire pour continuer l'opération pour les BIO non bloquants.
           Appelez SSL_get_error() avec la valeur de retour ret pour en connaître la raison.

VOIR AUSSI

       SSL_get_error(3),   SSL_accept(3),    SSL_shutdown(3),    ssl(3),    bio(3),    SSL_set_connect_state(3),
       SSL_do_handshake(3), SSL_CTX_new(3)

TRADUCTION

       La  traduction  de  cette page de manuel est maintenue par les membres de la liste <debian-l10n-french AT
       lists DOT debian DOT org>. Veuillez signaler toute erreur de traduction par un rapport de  bogue  sur  le
       paquet manpages-fr-extra.

1.0.2a 1.0.2c                                      2015-12-31                         fr::ssl::SSL_connect(3SSL)