Provided by: manpages-fr-extra_20151231_all 
NOM
DSA_set_default_method, DSA_get_default_method, DSA_set_method, DSA_new_method, DSA_OpenSSL -
Sélectionner la méthode DSA
SYNOPSIS
#include <openssl/dsa.h>
#include <openssl/engine.h>
void DSA_set_default_method(const DSA_METHOD *meth);
const DSA_METHOD *DSA_get_default_method(void);
int DSA_set_method(DSA *dsa, const DSA_METHOD *meth);
DSA *DSA_new_method(ENGINE *engine);
DSA_METHOD *DSA_OpenSSL(void);
DESCRIPTION
Une DSA_METHOD indique les fonctions qu’OpenSSL utilise pour les opérations DSA. En modifiant la méthode,
les implémentations alternatives comme les accélérateurs matériels pourraient être utilisés. Important :
consultez la section NOTES qui contient des renseignements importants sur la façon dont ces fonctions
d’interface de programmation DSA sont concernées par l’utilisation des appels d’interface de
programmation ENGINE.
Initialement, la DSA_METHOD par défaut est l’implémentation interne d’OpenSSL, telle que renvoyée par
DSA_OpenSSL().
DSA_set_default_method() fait de meth la méthode par défaut pour toutes les structures DSA créées
ensuite. Remarque : ce n’est vrai que tant qu’aucun ENGINE n’a été défini par défaut pour DSA, donc cette
fonction n’est plus recommandée.
DSA_get_default_method() renvoie un pointeur vers la DSA_METHOD par défaut actuelle. Cependant, la
signification de ce résultat dépend de l’utilisation ou non de l’interface de programmation ENGINE, donc
cette fonction n’est plus recommandée.
DSA_set_method() sélectionne meth pour réaliser toutes les opérations utilisant la clef dsa. Cela
remplacera la DSA_METHOD utilisée par la clef DSA et, si la méthode précédente a été fournie par un
ENGINE, le traitement par cet ENGINE sera abandonné pendant la modification. Certaines clefs pourraient
ne fonctionner qu’avec certaines implémentations de DSA_METHOD (par exemple à partir d’un module ENGINE
qui prend en charge les clefs protégées matériellement) et, dans ces cas, essayer de modifier la
DSA_METHOD pour la clef peut avoir des résultats inattendus.
DSA_new_method() alloue et initialise une structure DSA de telle sorte qu’engine sera utilisé pour les
opérations DSA. Si engine est NULL, l’ENGINE par défaut pour les opérations DSA est utilisé, et si aucun
ENGINE par défaut n’est défini, la DSA_METHOD contrôlée par DSA_set_default_method() est utilisée.
LA STRUCTURE DSA_METHOD
struct
{
/* nom de l’implémentation */
const char *name;
/* signer */
DSA_SIG *(*dsa_do_sign)(const unsigned char *dgst, int dlen,
DSA *dsa);
/* précalculer k^-1 et r */
int (*dsa_sign_setup)(DSA *dsa, BN_CTX *ctx_in, BIGNUM **kinvp,
BIGNUM **rp);
/* vérifier */
int (*dsa_do_verify)(const unsigned char *dgst, int dgst_len,
DSA_SIG *sig, DSA *dsa);
/* calculer rr = a1^p1 * a2^p2 mod m (pourrait être NULL pour
certaines implémentations) */
int (*dsa_mod_exp)(DSA *dsa, BIGNUM *rr, BIGNUM *a1, BIGNUM *p1,
BIGNUM *a2, BIGNUM *p2, BIGNUM *m,
BN_CTX *ctx, BN_MONT_CTX *in_mont);
/* calculer r = a ^ p mod m (pourrait être NULL pour
certaines implémentations) */
int (*bn_mod_exp)(DSA *dsa, BIGNUM *r, BIGNUM *a,
const BIGNUM *p, const BIGNUM *m,
BN_CTX *ctx, BN_MONT_CTX *m_ctx);
/* appelée à DSA_new */
int (*init)(DSA *DSA);
/* appelée à DSA_free */
int (*finish)(DSA *DSA);
int flags;
char *app_data; /* ? */
} DSA_METHOD;
VALEURS DE RETOUR
DSA_OpenSSL() et DSA_get_default_method() renvoient des pointeurs vers les DSA_METHOD respectives.
DSA_set_default_method() ne renvoie rien.
DSA_set_method() renvoie une valeur non nulle si la meth a été définie correctement comme la méthode pour
dsa (y compris le déchargement du traitement de l’ENGINE si la méthode précédente était fournie par un
ENGINE).
DSA_new_method() renvoie NULL et positionne un code d'erreur qui peut être récupéré avec ERR_get_error(3)
si l'allocation échoue. Sinon, elle renvoie un pointeur vers la structure nouvellement allouée.
NOTES
Depuis la version 0.9.7, les implémentations DSA_METHOD sont regroupées avec d’autres interfaces de
programmation algorithmiques (par exemple RSA_METHOD, EVP_CIPHER, etc.) dans les modules ENGINE. Si un
ENGINE par défaut est indiqué pour la fonctionnalité DSA utilisant une fonction d’interface de
programmation ENGINE, cela remplacera tous les DSA par défaut définis en utilisant l’interface de
programmation DSA (c’est-à-dire DSA_set_default_method()). Pour cette raison, l’interface de
programmation ENGINE est la façon recommandée de contrôler les implémentations par défaut à utiliser dans
les algorithmes cryptographiques DSA et autres.
VOIR AUSSI
dsa(3), DSA_new(3)
HISTORIQUE
DSA_set_default_method(), DSA_get_default_method(), DSA_set_method(), DSA_new_method() et DSA_OpenSSL()
ont été ajoutées dans OpenSSL 0.9.4.
DSA_set_default_openssl_method() et DSA_get_default_openssl_method() ont respectivement remplacé
DSA_set_default_method() et DSA_get_default_method(), et DSA_set_method() et DSA_new_method() ont été
modifiées pour utiliser des ENGINE plutôt que des DSA_METHOD pendant le développement de la version
ENGINE d’OpenSSL 0.9.6. Pour 0.9.7, le traitement des valeurs par défaut dans l’interface de
programmation ENGINE a été restructuré en revenant sur cette modification, pour que le comportement des
autres fonctions ressemble plus au comportement précédent. Le comportement des valeurs par défaut dans
l’interface de programmation ENGINE remplace maintenant de façon transparente le comportement des valeurs
par défaut dans l’interface de programmation DSA sans modification nécessaire de ces prototypes de
fonctions.
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.
1.0.2a 1.0.2c 2015-12-31 fr::crypto::DSA_set_method(3SSL)