NOM¶
d2i_SSL_SESSION, i2d_SSL_SESSION - Convertir un objet SSL_SESSION depuis ou vers
une représentation ASN1
SYNOPSIS¶
#include <openssl/ssl.h>
SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, const unsigned char **pp, long length);
int i2d_SSL_SESSION(SSL_SESSION *in, unsigned char **pp);
DESCRIPTION¶
d2i_SSL_SESSION() transforme la représentation ASN1 externe d'une
session SSL ou TLS, stockée en données binaires à l'emplacement
pp de taille
length, en un objet SSL_SESSION.
i2d_SSL_SESSION() transforme l'objet SSL_SESSION
in en
représentation ASN1 et la stocke à l'emplacement mémoire
pointé par
pp. La taille de la représentation ASN1 est
renvoyée. Si
pp est le pointeur NULL, seule la taille est
calculée et renvoyée.
NOTES¶
L'objet SSL_SESSION est construit à partir de plusieurs parties issues de
malloc(), il ne peut donc pas être déplacé, copié
ou stocké directement. Afin de stocker les données de session sur le
disque ou dans une base de données, elles doivent être
transformées en représentation ASN1 binaire.
Lors de l'utilisation de
d2i_SSL_SESSION(), l'objet SSL_SESSION est
automatiquement alloué. Le compteur de références est 1, de
telle sorte que la session doit être supprimée explicitement en
utilisant
SSL_SESSION_free(3), sauf si l'objet SSL_SESSION a
complètement pris le dessus, lorsqu'il est appelé depuis la
get_session_cb() (consultez
SSL_CTX_sess_set_get_cb(3)).
Les objets SSL_SESSION conservent des informations internes sur les liens à
propos de la liste du cache de sessions, lorsqu'ils sont insérés
dans le cache de sessions d'un objet SSL_CTX. Un objet SSL_SESSION, quel que
soit son compteur de références, ne doit donc être utilisé
qu'avec un objet SSL_CTX (et les objets SSL créés à partir de
cet objet SSL_CTX).
Lors de l'utilisation de
i2d_SSL_SESSION(), l'emplacement de mémoire
pointé par
pp doit être assez grand pour y placer la
représentation binaire de la session. La taille de représentation
ASN1 créée n'a pas de limite connue, donc la quantité d'espace
nécessaire devrait être obtenue en appelant d'abord
i2d_SSL_SESSION() avec
pp=NULL afin d'allouer la mémoire
avant d'appeler de nouveau
i2d_SSL_SESSION().
VALEURS DE RETOUR¶
d2i_SSL_SESSION() renvoie un pointeur vers l'objet SSL_SESSION
nouvellement alloué. En cas d'échec, le pointeur NULL est
renvoyé et le message d'erreur peut être récupéré
depuis la pile d'erreur.
i2d_SSL_SESSION() renvoie la taille de la représentation ASN1 en
octet. Quand la session n'est pas valable,
0 est renvoyé et aucune
opération n'est réalisée.
VOIR AUSSI¶
ssl(3),
SSL_SESSION_free(3),
SSL_CTX_sess_set_get_cb(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.