SYNOPSIS

#include <openssl/ec.h>

EC_GROUP *d2i_ECPKParameters(EC_GROUP **px, \
                              const unsigned char **in, \
                              long len);
 int i2d_ECPKParameters(const EC_GROUP *x, unsigned char **out);
 #define d2i_ECPKParameters_bio(bp,x) \
                ASN1_d2i_bio_of(EC_GROUP,NULL,d2i_ECPKParameters,bp,x)

 #define i2d_ECPKParameters_bio(bp,x) \
                ASN1_i2d_bio_of_const(EC_GROUP,i2d_ECPKParameters,bp,x)

 #define d2i_ECPKParameters_fp(fp,x) (EC_GROUP *)ASN1_d2i_fp(NULL, \
                (char *(*)())d2i_ECPKParameters,(fp),(unsigned char **)(x))

 #define i2d_ECPKParameters_fp(fp,x) \
                ASN1_i2d_fp(i2d_ECPKParameters,(fp), \

                (unsigned char *)(x))

 int     ECPKParameters_print(BIO *bp, const EC_GROUP *x, int off);
 int     ECPKParameters_print_fp(FILE *fp, const EC_GROUP *x, int off);

DESCRIPTION

Les routines d'encodage et décodage ECPKParameters encodent et analysent les paramètres publics pour une structure EC_GROUP, qui représente une courbe.

d2i_ECPKParameters() essaye de décoder len octets à *in. En cas de réussite, un pointeur vers la structure EC_GROUP est renvoyé. Si une erreur survient, alors NULL est renvoyé. Si px n'est pas NULL, alors la structure renvoyée est écrite en *px. Si *px n'est pas NULL, alors *px est supposé contenir une structure EC_GROUP valable et une tentative est faite pour la réutiliser. Si l'appel a réussi, *in est incrémenté à l'octet qui suit les données analysées.

i2d_ECPKParameters() encode la structure pointée par x au format DER. Si out n'est pas NULL, les données encodées en DER sont écrites dans le tampon à *out, et il est incrémenté pour pointer après les données qui viennent d'être écrites. Si la valeur de retour est négative, une erreur est survenue, sinon la taille des données encodées est renvoyée.

Si *out est NULL, une allocation de mémoire sera faite pour un tampon et les données encodées y seront écrites. Dans ce cas, *out n'est pas incrémenté et il pointe au début des données qui viennent d'être écrites.

d2i_ECPKParameters_bio() est similaire à d2i_ECPKParameters(), à la différence qu'elle essaye d'analyser les données du BIO bp.

d2i_ECPKParameters_fp() est similaire à d2i_ECPKParameters(), à la différence qu'elle essaye d'analyser les données du pointeur FILE fp.

i2d_ECPKParameters_bio() est similaire à i2d_ECPKParameters(), à la différence qu'elle écrit l'encodage de la structure x dans le BIO bp et renvoie 1 en cas de réussite et 0 en cas d'échec.

i2d_ECPKParameters_fp() est similaire à i2d_ECPKParameters(), à la différence qu'elle écrit l'encodage de la structure x dans le pointeur FILE fp et renvoie 1 en cas de réussite et 0 en cas d'échec.

Ces fonctions sont très similaires aux fonctions X509 décrites dans d2i_X509(3), où d’autres notes et exemples sont fournis.

Les fonctions ECPKParameters_print() et ECPKParameters_print_fp() affichent au format lisible les paramètres publics de l’EC_GROUP pour bp ou fp. Les lignes affichées sont indentées de off espaces.

VALEURS DE RETOUR

d2i_ECPKParameters(), d2i_ECPKParameters_bio() et d2i_ECPKParameters_fp() renvoient une structure EC_GROUP valable ou NULL si une erreur est survenue.

i2d_ECPKParameters() renvoie le nombre d'octets encodés ou une valeur négative en cas d'erreur.

i2d_ECPKParameters_bio(), i2d_ECPKParameters_fp(), ECPKParameters_print() et ECPKParameters_print_fp() renvoient 1 en cas de réussite et 0 en cas d’erreur.

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.