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.