.\" 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_sign 3SSL" .TH fr::crypto::DSA_sign 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_sign, DSA_sign_setup, DSA_verify \- Signatures \s-1DSA\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fB #include \fBlt\fBopenssl/dsa.h>\fR .PP \&\fB int DSA_sign(int\fR \fItype\fR\fB, const unsigned char *\fR\fIdgst\fR\fB, int\fR \fIlen\fR\fB,\fR \fBunsigned char *\fR\fIsigret\fR\fB, unsigned int *\fR\fIsiglen\fR\fB, \s-1DSA\s0 *\fR\fIdsa\fR\fB);\fR\s-1ZZ\s0 .PP \&\fB int DSA_sign_setup(\s-1DSA\s0 *\fR\fIdsa\fR\fB, \s-1BN_CTX\s0 *\fR\fIctx\fR\fB, \s-1BIGNUM\s0 **\fR\fIkinvp\fR\fB,\fR \fB\s-1BIGNUM\s0 **\fR\fIrp\fR\fB);\fR .PP \&\fB int DSA_verify(int\fR \fItype\fR\fB, const unsigned char *\fR\fIdgst\fR\fB, int\fR \fIlen\fR\fB,\fR \fBunsigned char *\fR\fIsigbuf\fR\fB, int\fR \fIsiglen\fR\fB, \s-1DSA\s0 *\fR\fIdsa\fR\fB);\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBDSA_sign\fR() calcule une signature numérique du condensé de message \fIdgst\fR de \fIlen\fR octets en utilisant la clef privée \fIdsa\fR et place son encodage \&\s-1DER ASN.1\s0 en \fIsigret\fR. La taille de la signature est placée en \&\fB*\fR\fIsiglen\fR. \fIsigret\fR doit pointer vers \fBDSA_size\fR(\fIdsa\fR) octets de mémoire. .PP \&\fBDSA_sign_setup\fR() pourrait être utilisée pour précalculer une partie de l’opération de signature quand le temps de création de la signature est critique. Elle attend dans \fIdsa\fR les paramètres \s-1DSA.\s0 Elle place les valeurs précalculées dans les \fB\s-1BIGNUM\s0\fR nouvellement alloués en \fB*\fR\fIkinvp\fR et \&\fB*\fR\fIrp\fR, après la libération des anciens sauf si \fB*\fR\fIkinvp\fR et \fB*\fR\fIrp\fR sont \s-1NULL.\s0 Ces valeurs pourraient être passées à \fBDSA_sign\fR() dans \&\fIdsa\fR\fB\->kinv\fR et \fIdsa\fR\fB\->r\fR. \fIctx\fR est un \fB\s-1BN_CTX\s0\fR préalloué ou \s-1NULL.\s0 .PP \&\fBDSA_verify\fR() vérifie que la signature \fIsigbuf\fR de taille \fIsiglen\fR correspond à un condensé de message donné \fIdgst\fR de taille \fIlen\fR. \fIdsa\fR est la clef publique du signataire. .PP Le paramètre \fItype\fR est ignoré. .PP Le générateur de nombres pseudoaléatoires doit être initialisé avant d’appeler \fBDSA_sign\fR() (ou \fBDSA_sign_setup\fR()). .SH "VALEURS DE RETOUR" .IX Header "VALEURS DE RETOUR" \&\fBDSA_sign\fR() et \fBDSA_sign_setup\fR() renvoient \fB1\fR en cas de réussite et \&\fB0\fR en cas d’erreur. \fBDSA_verify\fR() renvoie \fB1\fR pour une signature valable, \fB0\fR pour une signature incorrecte ou \fB\-1\fR en cas d’erreur. Les codes d’erreur peuvent être obtenus par \&\fBERR_get_error\fR(3). .SH "CONFORMITÉ À" .IX Header "CONFORMITÉ À" \&\s-1US\s0 Federal Information Processing Standard \s-1FIPS 186 \s0(Digital Signature Standard, \s-1DSS\s0), \s-1ANSI X9.30\s0 .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBdsa\fR(3), \fBDSA_do_sign\fR(3), \&\fBERR_get_error\fR(3), \fBrand\fR(3) .SH "HISTORIQUE" .IX Header "HISTORIQUE" \&\fBDSA_sign\fR() et \fBDSA_verify\fR() sont disponibles dans toutes les versions de SSLeay. \fBDSA_sign_setup\fR() a été ajoutée dans SSLeay 0.8. .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.