Switch from OpenSSL 0.9.7d to 0.9.7e.
[dragonfly.git] / secure / lib / libcrypto / man / EVP_DigestInit.3
CommitLineData
74dab6c2
JR
1.rn '' }`
2''' $RCSfile$$Revision$$Date$
3'''
4''' $Log$
5'''
6.de Sh
984263bc
MD
7.br
8.if t .Sp
9.ne 5
10.PP
11\fB\\$1\fR
12.PP
13..
74dab6c2 14.de Sp
984263bc
MD
15.if t .sp .5v
16.if n .sp
17..
74dab6c2 18.de Ip
984263bc
MD
19.br
20.ie \\n(.$>=3 .ne \\$3
21.el .ne 3
22.IP "\\$1" \\$2
23..
74dab6c2 24.de Vb
984263bc
MD
25.ft CW
26.nf
27.ne \\$1
28..
74dab6c2 29.de Ve
984263bc
MD
30.ft R
31
32.fi
33..
74dab6c2
JR
34'''
35'''
36''' Set up \*(-- to give an unbreakable dash;
37''' string Tr holds user defined translation string.
38''' Bell System Logo is used as a dummy character.
39'''
984263bc 40.tr \(*W-|\(bv\*(Tr
984263bc 41.ie n \{\
74dab6c2
JR
42.ds -- \(*W-
43.ds PI pi
44.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
45.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
46.ds L" ""
47.ds R" ""
48''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
49''' \*(L" and \*(R", except that they are used on ".xx" lines,
50''' such as .IP and .SH, which do another additional levels of
51''' double-quote interpretation
52.ds M" """
53.ds S" """
54.ds N" """""
55.ds T" """""
56.ds L' '
57.ds R' '
58.ds M' '
59.ds S' '
60.ds N' '
61.ds T' '
984263bc
MD
62'br\}
63.el\{\
74dab6c2
JR
64.ds -- \(em\|
65.tr \*(Tr
66.ds L" ``
67.ds R" ''
68.ds M" ``
69.ds S" ''
70.ds N" ``
71.ds T" ''
72.ds L' `
73.ds R' '
74.ds M' `
75.ds S' '
76.ds N' `
77.ds T' '
78.ds PI \(*p
984263bc 79'br\}
74dab6c2
JR
80.\" If the F register is turned on, we'll generate
81.\" index entries out stderr for the following things:
82.\" TH Title
83.\" SH Header
84.\" Sh Subsection
85.\" Ip Item
86.\" X<> Xref (embedded
87.\" Of course, you have to process the output yourself
88.\" in some meaninful fashion.
89.if \nF \{
90.de IX
91.tm Index:\\$1\t\\n%\t"\\$2"
984263bc 92..
74dab6c2
JR
93.nr % 0
94.rr F
984263bc 95.\}
74dab6c2
JR
96.TH EVP_DigestInit 3 "0.9.7d" "2/Sep/2004" "OpenSSL"
97.UC
98.if n .hy 0
984263bc 99.if n .na
74dab6c2
JR
100.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
101.de CQ \" put $1 in typewriter font
102.ft CW
103'if n "\c
104'if t \\&\\$1\c
105'if n \\&\\$1\c
106'if n \&"
107\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
108'.ft R
109..
110.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
111. \" AM - accent mark definitions
984263bc 112.bd B 3
74dab6c2 113. \" fudge factors for nroff and troff
984263bc 114.if n \{\
74dab6c2
JR
115. ds #H 0
116. ds #V .8m
117. ds #F .3m
118. ds #[ \f1
119. ds #] \fP
984263bc
MD
120.\}
121.if t \{\
74dab6c2
JR
122. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
123. ds #V .6m
124. ds #F 0
125. ds #[ \&
126. ds #] \&
984263bc 127.\}
74dab6c2 128. \" simple accents for nroff and troff
984263bc 129.if n \{\
74dab6c2
JR
130. ds ' \&
131. ds ` \&
132. ds ^ \&
133. ds , \&
134. ds ~ ~
135. ds ? ?
136. ds ! !
137. ds /
138. ds q
984263bc
MD
139.\}
140.if t \{\
74dab6c2
JR
141. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
142. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
143. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
144. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
145. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
146. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
147. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
148. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
149. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
984263bc 150.\}
74dab6c2 151. \" troff and (daisy-wheel) nroff accents
984263bc
MD
152.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
153.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
74dab6c2
JR
154.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
155.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
156.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
157.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
984263bc
MD
158.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
159.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
160.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
161.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
162.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
163.ds ae a\h'-(\w'a'u*4/10)'e
164.ds Ae A\h'-(\w'A'u*4/10)'E
74dab6c2
JR
165.ds oe o\h'-(\w'o'u*4/10)'e
166.ds Oe O\h'-(\w'O'u*4/10)'E
167. \" corrections for vroff
984263bc
MD
168.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
169.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
74dab6c2 170. \" for low resolution devices (crt and lpr)
984263bc
MD
171.if \n(.H>23 .if \n(.V>19 \
172\{\
74dab6c2
JR
173. ds : e
174. ds 8 ss
175. ds v \h'-1'\o'\(aa\(ga'
176. ds _ \h'-1'^
177. ds . \h'-1'.
178. ds 3 3
179. ds o a
180. ds d- d\h'-1'\(ga
181. ds D- D\h'-1'\(hy
182. ds th \o'bp'
183. ds Th \o'LP'
184. ds ae ae
185. ds Ae AE
186. ds oe oe
187. ds Oe OE
984263bc
MD
188.\}
189.rm #[ #] #H #V #F C
984263bc
MD
190.SH "NAME"
191EVP_MD_CTX_init, EVP_MD_CTX_create, EVP_DigestInit_ex, EVP_DigestUpdate,
74dab6c2
JR
192EVP_DigestFinal_ex, EVP_MD_CTX_cleanup, EVP_MD_CTX_destroy, EVP_MAX_MD_SIZE,
193EVP_MD_CTX_copy_ex, EVP_MD_CTX_copy, EVP_MD_type, EVP_MD_pkey_type, EVP_MD_size,
984263bc
MD
194EVP_MD_block_size, EVP_MD_CTX_md, EVP_MD_CTX_size, EVP_MD_CTX_block_size, EVP_MD_CTX_type,
195EVP_md_null, EVP_md2, EVP_md5, EVP_sha, EVP_sha1, EVP_dss, EVP_dss1, EVP_mdc2,
196EVP_ripemd160, EVP_get_digestbyname, EVP_get_digestbynid, EVP_get_digestbyobj \-
74dab6c2 197EVP digest routines
984263bc 198.SH "SYNOPSIS"
74dab6c2 199.PP
984263bc
MD
200.Vb 1
201\& #include <openssl/evp.h>
202.Ve
203.Vb 2
204\& void EVP_MD_CTX_init(EVP_MD_CTX *ctx);
205\& EVP_MD_CTX *EVP_MD_CTX_create(void);
206.Ve
207.Vb 4
208\& int EVP_DigestInit_ex(EVP_MD_CTX *ctx, const EVP_MD *type, ENGINE *impl);
209\& int EVP_DigestUpdate(EVP_MD_CTX *ctx, const void *d, unsigned int cnt);
210\& int EVP_DigestFinal_ex(EVP_MD_CTX *ctx, unsigned char *md,
211\& unsigned int *s);
212.Ve
213.Vb 2
214\& int EVP_MD_CTX_cleanup(EVP_MD_CTX *ctx);
215\& void EVP_MD_CTX_destroy(EVP_MD_CTX *ctx);
216.Ve
217.Vb 1
74dab6c2 218\& int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out,const EVP_MD_CTX *in);
984263bc
MD
219.Ve
220.Vb 3
221\& int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type);
222\& int EVP_DigestFinal(EVP_MD_CTX *ctx, unsigned char *md,
223\& unsigned int *s);
224.Ve
225.Vb 1
74dab6c2 226\& int EVP_MD_CTX_copy(EVP_MD_CTX *out,EVP_MD_CTX *in);
984263bc
MD
227.Ve
228.Vb 1
229\& #define EVP_MAX_MD_SIZE (16+20) /* The SSLv3 md5+sha1 type */
230.Ve
231.Vb 4
232\& #define EVP_MD_type(e) ((e)->type)
233\& #define EVP_MD_pkey_type(e) ((e)->pkey_type)
234\& #define EVP_MD_size(e) ((e)->md_size)
235\& #define EVP_MD_block_size(e) ((e)->block_size)
236.Ve
237.Vb 4
238\& #define EVP_MD_CTX_md(e) (e)->digest)
239\& #define EVP_MD_CTX_size(e) EVP_MD_size((e)->digest)
240\& #define EVP_MD_CTX_block_size(e) EVP_MD_block_size((e)->digest)
241\& #define EVP_MD_CTX_type(e) EVP_MD_type((e)->digest)
242.Ve
243.Vb 9
244\& const EVP_MD *EVP_md_null(void);
245\& const EVP_MD *EVP_md2(void);
246\& const EVP_MD *EVP_md5(void);
247\& const EVP_MD *EVP_sha(void);
248\& const EVP_MD *EVP_sha1(void);
249\& const EVP_MD *EVP_dss(void);
250\& const EVP_MD *EVP_dss1(void);
251\& const EVP_MD *EVP_mdc2(void);
252\& const EVP_MD *EVP_ripemd160(void);
253.Ve
254.Vb 3
255\& const EVP_MD *EVP_get_digestbyname(const char *name);
256\& #define EVP_get_digestbynid(a) EVP_get_digestbyname(OBJ_nid2sn(a))
257\& #define EVP_get_digestbyobj(a) EVP_get_digestbynid(OBJ_obj2nid(a))
258.Ve
259.SH "DESCRIPTION"
74dab6c2 260The EVP digest routines are a high level interface to message digests.
984263bc 261.PP
74dab6c2 262\fIEVP_MD_CTX_init()\fR initializes digest contet \fBctx\fR.
984263bc 263.PP
74dab6c2 264\fIEVP_MD_CTX_create()\fR allocates, initializes and returns a digest contet.
984263bc 265.PP
74dab6c2
JR
266\fIEVP_DigestInit_ex()\fR sets up digest context \fBctx\fR to use a digest
267\fBtype\fR from ENGINE \fBimpl\fR. \fBctx\fR must be initialized before calling this
984263bc 268function. \fBtype\fR will typically be supplied by a functionsuch as \fIEVP_sha1()\fR.
74dab6c2 269If \fBimpl\fR is NULL then the default implementation of digest \fBtype\fR is used.
984263bc 270.PP
74dab6c2 271\fIEVP_DigestUpdate()\fR hashes \fBcnt\fR bytes of data at \fBd\fR into the
984263bc
MD
272digest context \fBctx\fR. This function can be called several times on the
273same \fBctx\fR to hash additional data.
274.PP
74dab6c2
JR
275\fIEVP_DigestFinal_ex()\fR retrieves the digest value from \fBctx\fR and places
276it in \fBmd\fR. If the \fBs\fR parameter is not NULL then the number of
984263bc 277bytes of data written (i.e. the length of the digest) will be written
74dab6c2 278to the integer at \fBs\fR, at most \fBEVP_MAX_MD_SIZE\fR bytes will be written.
984263bc
MD
279After calling \fIEVP_DigestFinal_ex()\fR no additional calls to \fIEVP_DigestUpdate()\fR
280can be made, but \fIEVP_DigestInit_ex()\fR can be called to initialize a new
281digest operation.
282.PP
74dab6c2 283\fIEVP_MD_CTX_cleanup()\fR cleans up digest context \fBctx\fR, it should be called
984263bc
MD
284after a digest context is no longer needed.
285.PP
74dab6c2 286\fIEVP_MD_CTX_destroy()\fR cleans up digest context \fBctx\fR and frees up the
984263bc
MD
287space allocated to it, it should be called only on a context created
288using \fIEVP_MD_CTX_create()\fR.
289.PP
74dab6c2
JR
290\fIEVP_MD_CTX_copy_ex()\fR can be used to copy the message digest state from
291\fBin\fR to \fBout\fR. This is useful if large amounts of data are to be
984263bc
MD
292hashed which only differ in the last few bytes. \fBout\fR must be initialized
293before calling this function.
294.PP
74dab6c2 295\fIEVP_DigestInit()\fR behaves in the same way as \fIEVP_DigestInit_ex()\fR except
984263bc
MD
296the passed context \fBctx\fR does not have to be initialized, and it always
297uses the default digest implementation.
298.PP
74dab6c2 299\fIEVP_DigestFinal()\fR is similar to \fIEVP_DigestFinal_ex()\fR except the digest
984263bc
MD
300contet \fBctx\fR is automatically cleaned up.
301.PP
74dab6c2
JR
302\fIEVP_MD_CTX_copy()\fR is similar to \fIEVP_MD_CTX_copy_ex()\fR except the destination
303\fBout\fR does not have to be initialized.
984263bc 304.PP
74dab6c2
JR
305\fIEVP_MD_size()\fR and \fIEVP_MD_CTX_size()\fR return the size of the message digest
306when passed an \fBEVP_MD\fR or an \fBEVP_MD_CTX\fR structure, i.e. the size of the
984263bc
MD
307hash.
308.PP
74dab6c2
JR
309\fIEVP_MD_block_size()\fR and \fIEVP_MD_CTX_block_size()\fR return the block size of the
310message digest when passed an \fBEVP_MD\fR or an \fBEVP_MD_CTX\fR structure.
984263bc 311.PP
74dab6c2
JR
312\fIEVP_MD_type()\fR and \fIEVP_MD_CTX_type()\fR return the NID of the OBJECT IDENTIFIER
313representing the given message digest when passed an \fBEVP_MD\fR structure.
314For example \fIEVP_MD_type\fR\|(\fIEVP_sha1()\fR) returns \fBNID_sha1\fR. This function is
315normally used when setting ASN1 OIDs.
984263bc 316.PP
74dab6c2
JR
317\fIEVP_MD_CTX_md()\fR returns the \fBEVP_MD\fR structure corresponding to the passed
318\fBEVP_MD_CTX\fR.
984263bc 319.PP
74dab6c2
JR
320\fIEVP_MD_pkey_type()\fR returns the NID of the public key signing algorithm associated
321with this digest. For example \fIEVP_sha1()\fR is associated with RSA so this will
984263bc
MD
322return \fBNID_sha1WithRSAEncryption\fR. This \*(L"link\*(R" between digests and signature
323algorithms may not be retained in future versions of OpenSSL.
324.PP
74dab6c2
JR
325\fIEVP_md2()\fR, \fIEVP_md5()\fR, \fIEVP_sha()\fR, \fIEVP_sha1()\fR, \fIEVP_mdc2()\fR and \fIEVP_ripemd160()\fR
326return \fBEVP_MD\fR structures for the MD2, MD5, SHA, SHA1, MDC2 and RIPEMD160 digest
327algorithms respectively. The associated signature algorithm is RSA in each case.
984263bc 328.PP
74dab6c2
JR
329\fIEVP_dss()\fR and \fIEVP_dss1()\fR return \fBEVP_MD\fR structures for SHA and SHA1 digest
330algorithms but using DSS (DSA) for the signature algorithm.
984263bc 331.PP
74dab6c2 332\fIEVP_md_null()\fR is a \*(L"null\*(R" message digest that does nothing: i.e. the hash it
984263bc
MD
333returns is of zero length.
334.PP
74dab6c2
JR
335\fIEVP_get_digestbyname()\fR, \fIEVP_get_digestbynid()\fR and \fIEVP_get_digestbyobj()\fR
336return an \fBEVP_MD\fR structure when passed a digest name, a digest NID or
337an ASN1_OBJECT structure respectively. The digest table must be initialized
984263bc
MD
338using, for example, \fIOpenSSL_add_all_digests()\fR for these functions to work.
339.SH "RETURN VALUES"
74dab6c2 340\fIEVP_DigestInit_ex()\fR, \fIEVP_DigestUpdate()\fR and \fIEVP_DigestFinal_ex()\fR return 1 for
984263bc
MD
341success and 0 for failure.
342.PP
74dab6c2 343\fIEVP_MD_CTX_copy_ex()\fR returns 1 if successful or 0 for failure.
984263bc 344.PP
74dab6c2
JR
345\fIEVP_MD_type()\fR, \fIEVP_MD_pkey_type()\fR and \fIEVP_MD_type()\fR return the NID of the
346corresponding OBJECT IDENTIFIER or NID_undef if none exists.
984263bc 347.PP
74dab6c2
JR
348\fIEVP_MD_size()\fR, \fIEVP_MD_block_size()\fR, \fIEVP_MD_CTX_size\fR\|(e), \fIEVP_MD_size()\fR,
349\fIEVP_MD_CTX_block_size()\fR and \fIEVP_MD_block_size()\fR return the digest or block
984263bc
MD
350size in bytes.
351.PP
74dab6c2
JR
352\fIEVP_md_null()\fR, \fIEVP_md2()\fR, \fIEVP_md5()\fR, \fIEVP_sha()\fR, \fIEVP_sha1()\fR, \fIEVP_dss()\fR,
353\fIEVP_dss1()\fR, \fIEVP_mdc2()\fR and \fIEVP_ripemd160()\fR return pointers to the
354corresponding EVP_MD structures.
984263bc 355.PP
74dab6c2
JR
356\fIEVP_get_digestbyname()\fR, \fIEVP_get_digestbynid()\fR and \fIEVP_get_digestbyobj()\fR
357return either an \fBEVP_MD\fR structure or NULL if an error occurs.
984263bc 358.SH "NOTES"
74dab6c2 359The \fBEVP\fR interface to message digests should almost always be used in
984263bc
MD
360preference to the low level interfaces. This is because the code then becomes
361transparent to the digest used and much more flexible.
362.PP
74dab6c2 363SHA1 is the digest of choice for new applications. The other digest algorithms
984263bc
MD
364are still in common use.
365.PP
366For most applications the \fBimpl\fR parameter to \fIEVP_DigestInit_ex()\fR will be
74dab6c2 367set to NULL to use the default digest implementation.
984263bc
MD
368.PP
369The functions \fIEVP_DigestInit()\fR, \fIEVP_DigestFinal()\fR and \fIEVP_MD_CTX_copy()\fR are
370obsolete but are retained to maintain compatibility with existing code. New
371applications should use \fIEVP_DigestInit_ex()\fR, \fIEVP_DigestFinal_ex()\fR and
74dab6c2 372\fIEVP_MD_CTX_copy_ex()\fR because they can efficiently reuse a digest context
984263bc
MD
373instead of initializing and cleaning it up on each call and allow non default
374implementations of digests to be specified.
375.PP
376In OpenSSL 0.9.7 and later if digest contexts are not cleaned up after use
377memory leaks will occur.
378.SH "EXAMPLE"
984263bc
MD
379This example digests the data \*(L"Test Message\en\*(R" and \*(L"Hello World\en\*(R", using the
380digest name passed on the command line.
381.PP
382.Vb 2
383\& #include <stdio.h>
384\& #include <openssl/evp.h>
385.Ve
386.Vb 8
387\& main(int argc, char *argv[])
388\& {
389\& EVP_MD_CTX mdctx;
390\& const EVP_MD *md;
391\& char mess1[] = "Test Message\en";
392\& char mess2[] = "Hello World\en";
393\& unsigned char md_value[EVP_MAX_MD_SIZE];
394\& int md_len, i;
395.Ve
396.Vb 1
397\& OpenSSL_add_all_digests();
398.Ve
399.Vb 4
400\& if(!argv[1]) {
401\& printf("Usage: mdtest digestname\en");
402\& exit(1);
403\& }
404.Ve
405.Vb 1
406\& md = EVP_get_digestbyname(argv[1]);
407.Ve
408.Vb 4
409\& if(!md) {
410\& printf("Unknown message digest %s\en", argv[1]);
411\& exit(1);
412\& }
413.Ve
414.Vb 6
415\& EVP_MD_CTX_init(&mdctx);
416\& EVP_DigestInit_ex(&mdctx, md, NULL);
417\& EVP_DigestUpdate(&mdctx, mess1, strlen(mess1));
418\& EVP_DigestUpdate(&mdctx, mess2, strlen(mess2));
419\& EVP_DigestFinal_ex(&mdctx, md_value, &md_len);
420\& EVP_MD_CTX_cleanup(&mdctx);
421.Ve
422.Vb 4
423\& printf("Digest is: ");
424\& for(i = 0; i < md_len; i++) printf("%02x", md_value[i]);
425\& printf("\en");
426\& }
427.Ve
428.SH "BUGS"
984263bc 429The link between digests and signing algorithms results in a situation where
74dab6c2 430\fIEVP_sha1()\fR must be used with RSA and \fIEVP_dss1()\fR must be used with DSS
984263bc
MD
431even though they are identical digests.
432.SH "SEE ALSO"
984263bc
MD
433evp(3), hmac(3), md2(3),
434md5(3), mdc2(3), ripemd(3),
435sha(3), dgst(1)
436.SH "HISTORY"
74dab6c2 437\fIEVP_DigestInit()\fR, \fIEVP_DigestUpdate()\fR and \fIEVP_DigestFinal()\fR are
984263bc
MD
438available in all versions of SSLeay and OpenSSL.
439.PP
74dab6c2
JR
440\fIEVP_MD_CTX_init()\fR, \fIEVP_MD_CTX_create()\fR, \fIEVP_MD_CTX_copy_ex()\fR,
441\fIEVP_MD_CTX_cleanup()\fR, \fIEVP_MD_CTX_destroy()\fR, \fIEVP_DigestInit_ex()\fR
984263bc
MD
442and \fIEVP_DigestFinal_ex()\fR were added in OpenSSL 0.9.7.
443.PP
74dab6c2
JR
444\fIEVP_md_null()\fR, \fIEVP_md2()\fR, \fIEVP_md5()\fR, \fIEVP_sha()\fR, \fIEVP_sha1()\fR,
445\fIEVP_dss()\fR, \fIEVP_dss1()\fR, \fIEVP_mdc2()\fR and \fIEVP_ripemd160()\fR were
446changed to return truely const EVP_MD * in OpenSSL 0.9.7.
447
448.rn }` ''
449.IX Title "EVP_DigestInit 3"
450.IX Name "EVP_MD_CTX_init, EVP_MD_CTX_create, EVP_DigestInit_ex, EVP_DigestUpdate,
451EVP_DigestFinal_ex, EVP_MD_CTX_cleanup, EVP_MD_CTX_destroy, EVP_MAX_MD_SIZE,
452EVP_MD_CTX_copy_ex, EVP_MD_CTX_copy, EVP_MD_type, EVP_MD_pkey_type, EVP_MD_size,
453EVP_MD_block_size, EVP_MD_CTX_md, EVP_MD_CTX_size, EVP_MD_CTX_block_size, EVP_MD_CTX_type,
454EVP_md_null, EVP_md2, EVP_md5, EVP_sha, EVP_sha1, EVP_dss, EVP_dss1, EVP_mdc2,
455EVP_ripemd160, EVP_get_digestbyname, EVP_get_digestbynid, EVP_get_digestbyobj - EVP digest routines"
456
457.IX Header "NAME"
458
459.IX Header "SYNOPSIS"
460
461.IX Header "DESCRIPTION"
462
463.IX Header "RETURN VALUES"
464
465.IX Header "NOTES"
466
467.IX Header "EXAMPLE"
468
469.IX Header "BUGS"
470
471.IX Header "SEE ALSO"
472
473.IX Header "HISTORY"
474