hkdf: when HMAC key is all zeros, still set a valid key length
[openssl.git] / doc / man3 / EVP_mdc2.pod
1 =pod
2
3 =head1 NAME
4
5 EVP_mdc2
6 - MDC-2 For EVP
7
8 =head1 SYNOPSIS
9
10  #include <openssl/evp.h>
11
12  const EVP_MD *EVP_mdc2(void);
13
14 =head1 DESCRIPTION
15
16 MDC-2 (Modification Detection Code 2 or Meyer-Schilling) is a cryptographic
17 hash function based on a block cipher. This implementation is only available
18 with the legacy provider.
19
20 =over 4
21
22 =item EVP_mdc2()
23
24 The MDC-2DES algorithm of using MDC-2 with the DES block cipher. It produces a
25 128-bit output from a given input.
26
27 =back
28
29 =head1 NOTES
30
31 Developers should be aware of the negative performance implications of
32 calling this function multiple times and should consider using
33 L<EVP_MD_fetch(3)> with L<EVP_MD-MDC2(7)> instead.
34 See L<crypto(7)/Performance> for further information.
35
36 =head1 RETURN VALUES
37
38 These functions return a B<EVP_MD> structure that contains the
39 implementation of the message digest. See L<EVP_MD_meth_new(3)> for
40 details of the B<EVP_MD> structure.
41
42 =head1 CONFORMING TO
43
44 ISO/IEC 10118-2:2000 Hash-Function 2, with DES as the underlying block cipher.
45
46 =head1 SEE ALSO
47
48 L<evp(7)>,
49 L<provider(7)>,
50 L<EVP_DigestInit(3)>
51
52 =head1 COPYRIGHT
53
54 Copyright 2017-2023 The OpenSSL Project Authors. All Rights Reserved.
55
56 Licensed under the Apache License 2.0 (the "License").  You may not use
57 this file except in compliance with the License.  You can obtain a copy
58 in the file LICENSE in the source distribution or at
59 L<https://www.openssl.org/source/license.html>.
60
61 =cut
62