SYNOPSIS

#include <openssl/bn.h>
int BN_bn2bin(const BIGNUM *a, unsigned char *to);
BIGNUM *BN_bin2bn(const unsigned char *s, int len, BIGNUM *ret);
char *BN_bn2hex(const BIGNUM *a);
char *BN_bn2dec(const BIGNUM *a);
int BN_hex2bn(BIGNUM **a, const char *str);
int BN_dec2bn(BIGNUM **a, const char *str);
int BN_print(BIO *fp, const BIGNUM *a);
int BN_print_fp(FILE *fp, const BIGNUM *a);
int BN_bn2mpi(const BIGNUM *a, unsigned char *to);
BIGNUM *BN_mpi2bn(unsigned char *s, int len, BIGNUM *ret);

DESCRIPTION

BN_bn2bin() convertit la valeur absolue de a sous forme grand-boutiste et la stocke à to. to doit pointer vers BN_num_bytes(a) octets de mémoire.

BN_bin2bn() convertit l'entier positif sous forme grand-boutiste de taille len à s en un BIGNUM et le place en ret. Si ret est NULL, un nouveau BIGNUM est créé.

BN_bn2hex() et BN_bn2dec() renvoient des chaînes affichables contenant respectivement les encodages hexadécimal et décimal de a. Pour les nombres négatifs, la chaîne est précédée d'un « - ». La chaîne doit être libérée plus tard en utilisant OPENSSL_free().

BN_hex2bn() convertit la chaîne str contenant un nombre hexadécimal en un BIGNUM et le stocke en **bn. Si *bn est NULL, un nouveau BIGNUM est créé. Si bn est NULL, elle ne calcule que sa taille en nombre de chiffres hexadécimaux. Si la chaîne commence par « - », le nombre est négatif. BN_dec2bn() est la même en utilisant le système décimal.

BN_print() et BN_print_fp() écrivent l'encodage hexadécimal de a, en commençant par « - » si le nombre est négatif, vers les BIO ou FILE fp.

BN_bn2mpi() et BN_mpi2bn() convertissent les BIGNUM de et vers un format constitué de la taille du nombre en octet représenté comme un nombre grand-boutiste de 4 octets et du nombre lui-même au format grand-boutiste, où le bit de poids fort indique un nombre négatif (la représentation des nombres avec le bit de poids fort défini est précédée de l'octet NULL).

BN_bn2mpi() stocke la représentation de a à to, où to doit être assez grand pour faire tenir le résultat. La taille peut être déterminée en appelant BN_bn2mpi(a, NULL).

BN_mpi2bn() convertit la représentation de taille len octets à s vers un BIGNUM et le stocke à ret ou dans un BIGNUM nouvellement alloué si ret est NULL.

VALEURS DE RETOUR

BN_bn2bin() renvoie la taille du nombre grand-boutiste placé à to. BN_bin2bn() renvoie le BIGNUM ou NULL en cas d'erreur.

BN_bn2hex() et BN_bn2dec() renvoient une chaîne terminée par NULL ou NULL en cas d'erreur. BN_hex2bn() et BN_dec2bn() renvoient la taille en nombre de chiffres hexadécimaux ou décimaux, ou 0 en cas d'erreur.

BN_print_fp() et BN_print() renvoient 1 si elles réussissent ou 0 en cas d'erreur d'écriture.

BN_bn2mpi() renvoie la taille de la représentation. BN_mpi2bn() renvoie le BIGNUM ou NULL en cas d'erreur.

Les codes d'erreur peuvent être obtenus par ERR_get_error(3).

HISTORIQUE

BN_bn2bin(), BN_bin2bn(), BN_print_fp() et BN_print() sont disponibles dans toutes les versions de SSLeay et OpenSSL.

BN_bn2hex(), BN_bn2dec(), BN_hex2bn(), BN_dec2bn(), BN_bn2mpi() et BN_mpi2bn() ont été ajoutées dans la version 0.9.0 de SSLeay.

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.