diff options
author | schwarze <> | 2016-11-05 13:36:33 +0000 |
---|---|---|
committer | schwarze <> | 2016-11-05 13:36:33 +0000 |
commit | 71b431bd059aaefaa67b54a34adfaadc4014902c (patch) | |
tree | 7bf60aef63735e9638d12b0d8302b14d9860466e /src/lib/libcrypto/man/RIPEMD160.3 | |
parent | 5074288f0801a2b426584402e81b5953f706a44f (diff) | |
download | openbsd-71b431bd059aaefaa67b54a34adfaadc4014902c.tar.gz openbsd-71b431bd059aaefaa67b54a34adfaadc4014902c.tar.bz2 openbsd-71b431bd059aaefaa67b54a34adfaadc4014902c.zip |
convert the remaining manual pages from pod to mdoc
Diffstat (limited to 'src/lib/libcrypto/man/RIPEMD160.3')
-rw-r--r-- | src/lib/libcrypto/man/RIPEMD160.3 | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/src/lib/libcrypto/man/RIPEMD160.3 b/src/lib/libcrypto/man/RIPEMD160.3 new file mode 100644 index 0000000000..57cff8a9e4 --- /dev/null +++ b/src/lib/libcrypto/man/RIPEMD160.3 | |||
@@ -0,0 +1,96 @@ | |||
1 | .Dd $Mdocdate: November 5 2016 $ | ||
2 | .Dt RIPEMD160 3 | ||
3 | .Os | ||
4 | .Sh NAME | ||
5 | .Nm RIPEMD160 , | ||
6 | .Nm RIPEMD160_Init , | ||
7 | .Nm RIPEMD160_Update , | ||
8 | .Nm RIPEMD160_Final | ||
9 | .Nd RIPEMD-160 hash function | ||
10 | .Sh SYNOPSIS | ||
11 | .In openssl/ripemd.h | ||
12 | .Ft unsigned char * | ||
13 | .Fo RIPEMD160 | ||
14 | .Fa "const unsigned char *d" | ||
15 | .Fa "unsigned long n" | ||
16 | .Fa "unsigned char *md" | ||
17 | .Fc | ||
18 | .Ft int | ||
19 | .Fo RIPEMD160_Init | ||
20 | .Fa "RIPEMD160_CTX *c" | ||
21 | .Fc | ||
22 | .Ft int | ||
23 | .Fo RIPEMD160_Update | ||
24 | .Fa "RIPEMD_CTX *c" | ||
25 | .Fa "const void *data" | ||
26 | .Fa "unsigned long len" | ||
27 | .Fc | ||
28 | .Ft int | ||
29 | .Fo RIPEMD160_Final | ||
30 | .Fa "unsigned char *md" | ||
31 | .Fa "RIPEMD160_CTX *c" | ||
32 | .Fc | ||
33 | .Sh DESCRIPTION | ||
34 | RIPEMD-160 is a cryptographic hash function with a 160 bit output. | ||
35 | .Pp | ||
36 | .Fn RIPEMD160 | ||
37 | computes the RIPEMD-160 message digest of the | ||
38 | .Fa n | ||
39 | bytes at | ||
40 | .Fa d | ||
41 | and places it in | ||
42 | .Fa md , | ||
43 | which must have space for | ||
44 | .Dv RIPEMD160_DIGEST_LENGTH | ||
45 | == 20 bytes of output. | ||
46 | If | ||
47 | .Fa md | ||
48 | is | ||
49 | .Dv NULL , | ||
50 | the digest is placed in a static array. | ||
51 | .Pp | ||
52 | The following functions may be used if the message is not completely | ||
53 | stored in memory: | ||
54 | .Pp | ||
55 | .Fn RIPEMD160_Init | ||
56 | initializes a | ||
57 | .Vt RIPEMD160_CTX | ||
58 | structure. | ||
59 | .Pp | ||
60 | .Fn RIPEMD160_Update | ||
61 | can be called repeatedly with chunks of the message to be hashed | ||
62 | .Pq Fa len No bytes at Fa data . | ||
63 | .Pp | ||
64 | .Fn RIPEMD160_Final | ||
65 | places the message digest in | ||
66 | .Fa md , | ||
67 | which must have space for | ||
68 | .Dv RIPEMD160_DIGEST_LENGTH | ||
69 | == 20 bytes of output, | ||
70 | and erases the | ||
71 | .Vt RIPEMD160_CTX . | ||
72 | .Pp | ||
73 | Applications should use the higher level functions | ||
74 | .Xr EVP_DigestInit 3 | ||
75 | etc. instead of calling the hash functions directly. | ||
76 | .Sh RETURN VALUES | ||
77 | .Fn RIPEMD160 | ||
78 | returns a pointer to the hash value. | ||
79 | .Pp | ||
80 | .Fn RIPEMD160_Init , | ||
81 | .Fn RIPEMD160_Update , | ||
82 | and | ||
83 | .Fn RIPEMD160_Final | ||
84 | return 1 for success or 0 otherwise. | ||
85 | .Sh SEE ALSO | ||
86 | .Xr EVP_DigestInit 3 , | ||
87 | .Xr HMAC 3 | ||
88 | .Sh STANDARDS | ||
89 | ISO/IEC 10118-3 (draft) (??) | ||
90 | .Sh HISTORY | ||
91 | .Fn RIPEMD160 , | ||
92 | .Fn RIPEMD160_Init , | ||
93 | .Fn RIPEMD160_Update , | ||
94 | and | ||
95 | .Fn RIPEMD160_Final | ||
96 | are available since SSLeay 0.9.0. | ||