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.