diff options
author | schwarze <> | 2016-11-02 11:57:56 +0000 |
---|---|---|
committer | schwarze <> | 2016-11-02 11:57:56 +0000 |
commit | 90c573eba184fe31184d14ce10367f810fa1d417 (patch) | |
tree | 62d26e7f75bb451eba292aad57737306b2f28280 /src/lib/libcrypto/doc/DSA_sign.pod | |
parent | db06cab2812484b360f2873ade2dd8277ad08a42 (diff) | |
download | openbsd-90c573eba184fe31184d14ce10367f810fa1d417.tar.gz openbsd-90c573eba184fe31184d14ce10367f810fa1d417.tar.bz2 openbsd-90c573eba184fe31184d14ce10367f810fa1d417.zip |
convert DSA and EC manuals from pod to mdoc
Diffstat (limited to 'src/lib/libcrypto/doc/DSA_sign.pod')
-rw-r--r-- | src/lib/libcrypto/doc/DSA_sign.pod | 63 |
1 files changed, 0 insertions, 63 deletions
diff --git a/src/lib/libcrypto/doc/DSA_sign.pod b/src/lib/libcrypto/doc/DSA_sign.pod deleted file mode 100644 index 4e78a71390..0000000000 --- a/src/lib/libcrypto/doc/DSA_sign.pod +++ /dev/null | |||
@@ -1,63 +0,0 @@ | |||
1 | =pod | ||
2 | |||
3 | =head1 NAME | ||
4 | |||
5 | DSA_sign, DSA_sign_setup, DSA_verify - DSA signatures | ||
6 | |||
7 | =head1 SYNOPSIS | ||
8 | |||
9 | #include <openssl/dsa.h> | ||
10 | |||
11 | int DSA_sign(int type, const unsigned char *dgst, int len, | ||
12 | unsigned char *sigret, unsigned int *siglen, DSA *dsa); | ||
13 | |||
14 | int DSA_sign_setup(DSA *dsa, BN_CTX *ctx, BIGNUM **kinvp, | ||
15 | BIGNUM **rp); | ||
16 | |||
17 | int DSA_verify(int type, const unsigned char *dgst, int len, | ||
18 | unsigned char *sigbuf, int siglen, DSA *dsa); | ||
19 | |||
20 | =head1 DESCRIPTION | ||
21 | |||
22 | DSA_sign() computes a digital signature on the B<len> byte message | ||
23 | digest B<dgst> using the private key B<dsa> and places its ASN.1 DER | ||
24 | encoding at B<sigret>. The length of the signature is places in | ||
25 | *B<siglen>. B<sigret> must point to DSA_size(B<dsa>) bytes of memory. | ||
26 | |||
27 | DSA_sign_setup() may be used to precompute part of the signing | ||
28 | operation in case signature generation is time-critical. It expects | ||
29 | B<dsa> to contain DSA parameters. It places the precomputed values | ||
30 | in newly allocated B<BIGNUM>s at *B<kinvp> and *B<rp>, after freeing | ||
31 | the old ones unless *B<kinvp> and *B<rp> are NULL. These values may | ||
32 | be passed to DSA_sign() in B<dsa-E<gt>kinv> and B<dsa-E<gt>r>. | ||
33 | B<ctx> is a pre-allocated B<BN_CTX> or NULL. | ||
34 | |||
35 | DSA_verify() verifies that the signature B<sigbuf> of size B<siglen> | ||
36 | matches a given message digest B<dgst> of size B<len>. | ||
37 | B<dsa> is the signer's public key. | ||
38 | |||
39 | The B<type> parameter is ignored. | ||
40 | |||
41 | =head1 RETURN VALUES | ||
42 | |||
43 | DSA_sign() and DSA_sign_setup() return 1 on success, 0 on error. | ||
44 | DSA_verify() returns 1 for a valid signature, 0 for an incorrect | ||
45 | signature and -1 on error. The error codes can be obtained by | ||
46 | L<ERR_get_error(3)|ERR_get_error(3)>. | ||
47 | |||
48 | =head1 CONFORMING TO | ||
49 | |||
50 | US Federal Information Processing Standard FIPS 186 (Digital Signature | ||
51 | Standard, DSS), ANSI X9.30 | ||
52 | |||
53 | =head1 SEE ALSO | ||
54 | |||
55 | L<dsa(3)|dsa(3)>, L<ERR_get_error(3)|ERR_get_error(3)>, L<rand(3)|rand(3)>, | ||
56 | L<DSA_do_sign(3)|DSA_do_sign(3)> | ||
57 | |||
58 | =head1 HISTORY | ||
59 | |||
60 | DSA_sign() and DSA_verify() are available in all versions of SSLeay. | ||
61 | DSA_sign_setup() was added in SSLeay 0.8. | ||
62 | |||
63 | =cut | ||