xref: /freebsd/crypto/openssl/doc/man7/EVP_MD-MD5-SHA1.pod (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
1*b077aed3SPierre Pronchery=pod
2*b077aed3SPierre Pronchery
3*b077aed3SPierre Pronchery=head1 NAME
4*b077aed3SPierre Pronchery
5*b077aed3SPierre ProncheryEVP_MD-MD5-SHA1 - The MD5-SHA1 EVP_MD implementation
6*b077aed3SPierre Pronchery
7*b077aed3SPierre Pronchery=head1 DESCRIPTION
8*b077aed3SPierre Pronchery
9*b077aed3SPierre ProncherySupport for computing MD5-SHA1 digests through the B<EVP_MD> API.
10*b077aed3SPierre Pronchery
11*b077aed3SPierre ProncheryMD5-SHA1 is a rather special digest that's used with SSLv3.
12*b077aed3SPierre Pronchery
13*b077aed3SPierre Pronchery=head2 Identity
14*b077aed3SPierre Pronchery
15*b077aed3SPierre ProncheryThis implementation is only available with the default provider, and is
16*b077aed3SPierre Proncheryidentified with the name "MD5-SHA1".
17*b077aed3SPierre Pronchery
18*b077aed3SPierre Pronchery=head2 Gettable Parameters
19*b077aed3SPierre Pronchery
20*b077aed3SPierre ProncheryThis implementation supports the common gettable parameters described
21*b077aed3SPierre Proncheryin L<EVP_MD-common(7)>.
22*b077aed3SPierre Pronchery
23*b077aed3SPierre Pronchery=head2 Settable Context Parameters
24*b077aed3SPierre Pronchery
25*b077aed3SPierre ProncheryThis implementation supports the following L<OSSL_PARAM(3)> entries,
26*b077aed3SPierre Proncherysettable for an B<EVP_MD_CTX> with L<EVP_MD_CTX_set_params(3)>:
27*b077aed3SPierre Pronchery
28*b077aed3SPierre Pronchery=over 4
29*b077aed3SPierre Pronchery
30*b077aed3SPierre Pronchery=item "ssl3-ms" (B<OSSL_DIGEST_PARAM_SSL3_MS>) <octet string>
31*b077aed3SPierre Pronchery
32*b077aed3SPierre ProncheryThis parameter is set by libssl in order to calculate a signature hash for an
33*b077aed3SPierre ProncherySSLv3 CertificateVerify message as per RFC6101.
34*b077aed3SPierre ProncheryIt is only set after all handshake messages have already been digested via
35*b077aed3SPierre ProncheryOP_digest_update() calls.
36*b077aed3SPierre ProncheryThe parameter provides the master secret value to be added to the digest.
37*b077aed3SPierre ProncheryThe digest implementation should calculate the complete digest as per RFC6101
38*b077aed3SPierre Proncherysection 5.6.8.
39*b077aed3SPierre ProncheryThe next call after setting this parameter should be OP_digest_final().
40*b077aed3SPierre Pronchery
41*b077aed3SPierre Pronchery=back
42*b077aed3SPierre Pronchery
43*b077aed3SPierre Pronchery=head1 SEE ALSO
44*b077aed3SPierre Pronchery
45*b077aed3SPierre ProncheryL<EVP_MD_CTX_set_params(3)>, L<provider-digest(7)>, L<OSSL_PROVIDER-default(7)>
46*b077aed3SPierre Pronchery
47*b077aed3SPierre Pronchery=head1 COPYRIGHT
48*b077aed3SPierre Pronchery
49*b077aed3SPierre ProncheryCopyright 2020 The OpenSSL Project Authors. All Rights Reserved.
50*b077aed3SPierre Pronchery
51*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
52*b077aed3SPierre Proncherythis file except in compliance with the License.  You can obtain a copy
53*b077aed3SPierre Proncheryin the file LICENSE in the source distribution or at
54*b077aed3SPierre ProncheryL<https://www.openssl.org/source/license.html>.
55*b077aed3SPierre Pronchery
56*b077aed3SPierre Pronchery=cut
57