.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "fr::crypto::DSA_set_method 3SSL" .TH fr::crypto::DSA_set_method 3SSL "2015-12-31" "1.0.2a 1.0.2c" "OpenSSL" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOM" .IX Header "NOM" DSA_set_default_method, DSA_get_default_method, DSA_set_method, DSA_new_method, DSA_OpenSSL \- Sélectionner la méthode \s-1DSA\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fB #include \fR \fB#include \fR .PP \&\fB void DSA_set_default_method(const \s-1DSA_METHOD\s0 *\fR\fImeth\fR\fB);\fR .PP \&\fB const \s-1DSA_METHOD\s0 *DSA_get_default_method(void);\fR .PP \&\fB int DSA_set_method(\s-1DSA\s0 *\fR\fIdsa\fR\fB, const \s-1DSA_METHOD\s0 *\fR\fImeth\fR\fB);\fR .PP \&\fB \s-1DSA\s0 *DSA_new_method(\s-1ENGINE\s0 *\fR\fIengine\fR\fB);\fR .PP \&\fB \s-1DSA_METHOD\s0 *DSA_OpenSSL(void);\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" Une \fB\s-1DSA_METHOD\s0\fR indique les fonctions qu’OpenSSL utilise pour les opérations \s-1DSA.\s0 En modifiant la méthode, les implémentations alternatives comme les accélérateurs matériels pourraient être utilisés. \fBImportant\fR : consultez la section \fB\s-1NOTES\s0\fR qui contient des renseignements importants sur la façon dont ces fonctions d’interface de programmation \s-1DSA\s0 sont concernées par l’utilisation des appels d’interface de programmation \fB\s-1ENGINE\s0\fR. .PP Initialement, la \s-1DSA_METHOD\s0 par défaut est l’implémentation interne d’OpenSSL, telle que renvoyée par \fBDSA_OpenSSL\fR(). .PP \&\fBDSA_set_default_method\fR() fait de \fImeth\fR la méthode par défaut pour toutes les structures \s-1DSA\s0 créées ensuite. \fBRemarque\fR : ce n’est vrai que tant qu’aucun \s-1ENGINE\s0 n’a été défini par défaut pour \s-1DSA,\s0 donc cette fonction n’est plus recommandée. .PP \&\fBDSA_get_default_method\fR() renvoie un pointeur vers la \s-1DSA_METHOD\s0 par défaut actuelle. Cependant, la signification de ce résultat dépend de l’utilisation ou non de l’interface de programmation \s-1ENGINE,\s0 donc cette fonction n’est plus recommandée. .PP \&\fBDSA_set_method\fR() sélectionne \fImeth\fR pour réaliser toutes les opérations utilisant la clef \fIdsa\fR. Cela remplacera la \s-1DSA_METHOD\s0 utilisée par la clef \&\s-1DSA\s0 et, si la méthode précédente a été fournie par un \s-1ENGINE,\s0 le traitement par cet \s-1ENGINE\s0 sera abandonné pendant la modification. Certaines clefs pourraient ne fonctionner qu’avec certaines implémentations de \s-1DSA_METHOD \&\s0(par exemple à partir d’un module \s-1ENGINE\s0 qui prend en charge les clefs protégées matériellement) et, dans ces cas, essayer de modifier la \&\s-1DSA_METHOD\s0 pour la clef peut avoir des résultats inattendus. .PP \&\fBDSA_new_method\fR() alloue et initialise une structure \s-1DSA\s0 de telle sorte qu’\fIengine\fR sera utilisé pour les opérations \s-1DSA.\s0 Si \fIengine\fR est \s-1NULL,\s0 l’ENGINE par défaut pour les opérations \s-1DSA\s0 est utilisé, et si aucun \s-1ENGINE\s0 par défaut n’est défini, la \s-1DSA_METHOD\s0 contrôlée par \&\fBDSA_set_default_method\fR() est utilisée. .SH "LA STRUCTURE DSA_METHOD" .IX Header "LA STRUCTURE DSA_METHOD" struct { /* nom de l’implémentation */ const char *name; .PP .Vb 3 \& /* 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; .Ve .SH "VALEURS DE RETOUR" .IX Header "VALEURS DE RETOUR" \&\fBDSA_OpenSSL\fR() et \fBDSA_get_default_method\fR() renvoient des pointeurs vers les \fB\s-1DSA_METHOD\s0\fR respectives. .PP \&\fBDSA_set_default_method\fR() ne renvoie rien. .PP \&\fBDSA_set_method\fR() renvoie une valeur non nulle si la \fImeth\fR a été définie correctement comme la méthode pour \fIdsa\fR (y compris le déchargement du traitement de l’ENGINE si la méthode précédente était fournie par un \&\s-1ENGINE\s0). .PP \&\fBDSA_new_method\fR() renvoie \s-1NULL\s0 et positionne un code d'erreur qui peut être récupéré avec \fBERR_get_error\fR(3) si l'allocation échoue. Sinon, elle renvoie un pointeur vers la structure nouvellement allouée. .SH "NOTES" .IX Header "NOTES" Depuis la version 0.9.7, les implémentations \s-1DSA_METHOD\s0 sont regroupées avec d’autres interfaces de programmation algorithmiques (par exemple \s-1RSA_METHOD, EVP_CIPHER,\s0 etc.) dans les modules \fB\s-1ENGINE\s0\fR. Si un \s-1ENGINE\s0 par défaut est indiqué pour la fonctionnalité \s-1DSA\s0 utilisant une fonction d’interface de programmation \s-1ENGINE,\s0 cela remplacera tous les \s-1DSA\s0 par défaut définis en utilisant l’interface de programmation \s-1DSA \s0(c’est\-à\-dire \&\fBDSA_set_default_method\fR()). Pour cette raison, l’interface de programmation \s-1ENGINE\s0 est la façon recommandée de contrôler les implémentations par défaut à utiliser dans les algorithmes cryptographiques \&\s-1DSA\s0 et autres. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBdsa\fR(3), \fBDSA_new\fR(3) .SH "HISTORIQUE" .IX Header "HISTORIQUE" \&\fBDSA_set_default_method\fR(), \fBDSA_get_default_method\fR(), \&\fBDSA_set_method\fR(), \fBDSA_new_method\fR() et \fBDSA_OpenSSL\fR() ont été ajoutées dans OpenSSL 0.9.4. .PP \&\fBDSA_set_default_openssl_method\fR() et \fBDSA_get_default_openssl_method\fR() ont respectivement remplacé \fBDSA_set_default_method\fR() et \&\fBDSA_get_default_method\fR(), et \fBDSA_set_method\fR() et \fBDSA_new_method\fR() ont été modifiées pour utiliser des \fB\s-1ENGINE\s0\fR plutôt que des \fB\s-1DSA_METHOD\s0\fR pendant le développement de la version \s-1ENGINE\s0 d’OpenSSL 0.9.6. Pour 0.9.7, le traitement des valeurs par défaut dans l’interface de programmation \&\s-1ENGINE\s0 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 \s-1ENGINE\s0 remplace maintenant de façon transparente le comportement des valeurs par défaut dans l’interface de programmation \s-1DSA\s0 sans modification nécessaire de ces prototypes de fonctions. .SH "TRADUCTION" .IX Header "TRADUCTION" La traduction de cette page de manuel est maintenue par les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.