SYNOPSIS

#include ltopenssl/dsa.h>

int DSA_generate_parameters_ex(DSA *dsa, int bits,
                const unsigned char *seed, int seed_len,

                int *counter_ret, unsigned long *h_ret, BN_GENCB *cb);

Obsolète :

DSA *DSA_generate_parameters(int bits, unsigned char *seed,
                int seed_len int *counter_ret, unsigned long *h_ret,

                void (*callback)(int, int, void *), void *cb_arg);

DESCRIPTION

DSA_generate_parameters_ex() crée des nombres premiers p et q et un générateur g pour utiliser dans le DSA et conserve le résultat dans dsa.

bits est la taille du nombre premier à générer ; la DSS permet 1024 bits au maximum.

Si seed est NULL ou seed_len < 20, les nombres premiers seront créés de façon aléatoire. Sinon, ils seront initialisés avec seed. Si la valeur de départ donnée ne renvoie pas de nombre premier q, une nouvelle initialisation aléatoire est choisie et placée dans seed.

DSA_generate_parameters_ex() place le décompte d’itérations dans *counter_ret et un compteur utilisé pour trouver un générateur dans *h_ret, sauf s’ils sont NULL.

Une fonction de rappel pourrait être utilisée pour fournir un retour sur l’avancement de la création de clef. Si cb n’est pas NULL, elle sera appelée comme montré ci-dessous. Pour plus de renseignements sur la structure BN_GENCB et la fonction BN_GENCB_call() évoquées ci-dessous, consultez BN_generate_prime(3).

• Quand un candidat pour q est créé, BN_GENCB_call(cb, 0, m++) est appelée (m est 0 pour le premier candidat).
• Quand un candidat pour q a passé un test par divisions successives, BN_GENCB_call(cb, 1, -1) est appelée. Alors qu’un candidat pour q est testé par les tests de primalité de Miller-Rabin, BN_GENCB_call(cb, 1, i) est appelée dans la boucle externe (une fois pour chaque témoin confirmant que le candidat pourrait être premier) ; i est le compteur de boucles (commençant à 0).
• Quand un nombre premier q a été trouvé, BN_GENCB_call(cb, 2, 0) et BN_GENCB_call(cb, 3, 0) sont appelées.
• Avant qu’un candidat pour p (autre que le premier) ne soit créé et testé, BN_GENCB_call(cb, 0, compteur) est appelée.
• Quand un candidat pour p a passé un test par divisions successives, BN_GENCB_call(cb, 1, -1) est appelée. Alors qu’il est testé par les tests de primalité de Miller-Rabin, BN_GENCB_call(cb, 1, i) est appelée dans la boucle externe (une fois pour chaque témoin confirmant que le candidat pourrait être premier). i est le compteur de boucle (commençant à 0).
• Quand p a été trouvé, BN_GENCB_call(cb, 2, 1) est appelée.
• Quand le générateur a été trouvé, BN_GENCB_call(cb, 3, 1) est appelée.

DSA_generate_parameters() (obsolète) fonctionne de façon très similaire à DSA_generate_parameters_ex(), à part qu’aucun paramètre dsa n’est passé et, qu’à la place, une structure DSA nouvellement allouée est renvoyée. De plus, les rappels « à l’ancienne » sont utilisés au lieu de la nouvelle approche basée sur BN_GENCB. Consultez BN_generate_prime(3) pour plus de renseignements.

VALEUR DE RETOUR

DSA_generate_parameters_ex() renvoie 1 si elle réussit et 0 sinon.

DSA_generate_parameters() renvoie un pointeur vers la structure DSA ou NULL en cas d’échec de création de paramètre.

Les codes d'erreur peuvent être obtenus à l'aide de ERR_get_error(3).

HISTORIQUE

DSA_generate_parameters() est apparue dans SSLeay 0.8. L’argument cb_arg a été ajouté dans SSLeay 0.9.0. Dans OpenSSL jusqu’à la version 0.9.4, callback(1, ...) était appelée dans la boucle interne du test de Miller-Rabin à chaque fois qu’elle atteignait l’étape du carré (les paramètres de callback n’indiquaient pas le nombre de témoins qui avaient été essayés) ; depuis OpenSSL 0.9.5, callback(1, ...) est appelée comme dans BN_is_prime(3), c’est-à-dire une fois par témoin.

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.