Provided by: manpages-fr-extra_20140201_all
NOM
BN_bn2bin, BN_bin2bn, BN_bn2hex, BN_bn2dec, BN_hex2bn, BN_dec2bn, BN_print, BN_print_fp, BN_bn2mpi, BN_mpi2bn - Conversions de format
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).
VOIR AUSSI
bn(3), ERR_get_error(3), BN_zero(3), ASN1_INTEGER_to_BN(3), BN_num_bytes(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.