summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/RIPEMD160.3
diff options
context:
space:
mode:
authorschwarze <>2016-11-05 13:36:33 +0000
committerschwarze <>2016-11-05 13:36:33 +0000
commit71b431bd059aaefaa67b54a34adfaadc4014902c (patch)
tree7bf60aef63735e9638d12b0d8302b14d9860466e /src/lib/libcrypto/man/RIPEMD160.3
parent5074288f0801a2b426584402e81b5953f706a44f (diff)
downloadopenbsd-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.396
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
34RIPEMD-160 is a cryptographic hash function with a 160 bit output.
35.Pp
36.Fn RIPEMD160
37computes the RIPEMD-160 message digest of the
38.Fa n
39bytes at
40.Fa d
41and places it in
42.Fa md ,
43which must have space for
44.Dv RIPEMD160_DIGEST_LENGTH
45== 20 bytes of output.
46If
47.Fa md
48is
49.Dv NULL ,
50the digest is placed in a static array.
51.Pp
52The following functions may be used if the message is not completely
53stored in memory:
54.Pp
55.Fn RIPEMD160_Init
56initializes a
57.Vt RIPEMD160_CTX
58structure.
59.Pp
60.Fn RIPEMD160_Update
61can 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
65places the message digest in
66.Fa md ,
67which must have space for
68.Dv RIPEMD160_DIGEST_LENGTH
69== 20 bytes of output,
70and erases the
71.Vt RIPEMD160_CTX .
72.Pp
73Applications should use the higher level functions
74.Xr EVP_DigestInit 3
75etc. instead of calling the hash functions directly.
76.Sh RETURN VALUES
77.Fn RIPEMD160
78returns a pointer to the hash value.
79.Pp
80.Fn RIPEMD160_Init ,
81.Fn RIPEMD160_Update ,
82and
83.Fn RIPEMD160_Final
84return 1 for success or 0 otherwise.
85.Sh SEE ALSO
86.Xr EVP_DigestInit 3 ,
87.Xr HMAC 3
88.Sh STANDARDS
89ISO/IEC 10118-3 (draft) (??)
90.Sh HISTORY
91.Fn RIPEMD160 ,
92.Fn RIPEMD160_Init ,
93.Fn RIPEMD160_Update ,
94and
95.Fn RIPEMD160_Final
96are available since SSLeay 0.9.0.