xref: /freebsd/crypto/openssl/doc/man3/EVP_sha1.pod (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
1e71b7053SJung-uk Kim=pod
2e71b7053SJung-uk Kim
3e71b7053SJung-uk Kim=head1 NAME
4e71b7053SJung-uk Kim
5e71b7053SJung-uk KimEVP_sha1
6e71b7053SJung-uk Kim- SHA-1 For EVP
7e71b7053SJung-uk Kim
8e71b7053SJung-uk Kim=head1 SYNOPSIS
9e71b7053SJung-uk Kim
10e71b7053SJung-uk Kim #include <openssl/evp.h>
11e71b7053SJung-uk Kim
12e71b7053SJung-uk Kim const EVP_MD *EVP_sha1(void);
13e71b7053SJung-uk Kim
14e71b7053SJung-uk Kim=head1 DESCRIPTION
15e71b7053SJung-uk Kim
16e71b7053SJung-uk KimSHA-1 (Secure Hash Algorithm 1) is a cryptographic hash function standardized
17e71b7053SJung-uk Kimin NIST FIPS 180-4. The algorithm was designed by the United States National
18e71b7053SJung-uk KimSecurity Agency and initially published in 1995.
19e71b7053SJung-uk Kim
20e71b7053SJung-uk Kim=over 4
21e71b7053SJung-uk Kim
22e71b7053SJung-uk Kim=item EVP_sha1()
23e71b7053SJung-uk Kim
24e71b7053SJung-uk KimThe SHA-1 algorithm which produces a 160-bit output from a given input.
25e71b7053SJung-uk Kim
26e71b7053SJung-uk Kim=back
27e71b7053SJung-uk Kim
28*b077aed3SPierre Pronchery=head1 NOTES
29*b077aed3SPierre Pronchery
30*b077aed3SPierre ProncheryDevelopers should be aware of the negative performance implications of
31*b077aed3SPierre Proncherycalling this function multiple times and should consider using
32*b077aed3SPierre ProncheryL<EVP_MD_fetch(3)> instead.
33*b077aed3SPierre ProncherySee L<crypto(7)/Performance> for further information.
34e71b7053SJung-uk Kim
35e71b7053SJung-uk Kim=head1 RETURN VALUES
36e71b7053SJung-uk Kim
37e71b7053SJung-uk KimThese functions return a B<EVP_MD> structure that contains the
38*b077aed3SPierre Proncheryimplementation of the message digest. See L<EVP_MD_meth_new(3)> for
39e71b7053SJung-uk Kimdetails of the B<EVP_MD> structure.
40e71b7053SJung-uk Kim
41e71b7053SJung-uk Kim=head1 CONFORMING TO
42e71b7053SJung-uk Kim
43e71b7053SJung-uk KimNIST FIPS 180-4.
44e71b7053SJung-uk Kim
45e71b7053SJung-uk Kim=head1 SEE ALSO
46e71b7053SJung-uk Kim
47e71b7053SJung-uk KimL<evp(7)>,
48e71b7053SJung-uk KimL<EVP_DigestInit(3)>
49e71b7053SJung-uk Kim
50e71b7053SJung-uk Kim=head1 COPYRIGHT
51e71b7053SJung-uk Kim
52*b077aed3SPierre ProncheryCopyright 2017-2023 The OpenSSL Project Authors. All Rights Reserved.
53e71b7053SJung-uk Kim
54*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
55e71b7053SJung-uk Kimthis file except in compliance with the License.  You can obtain a copy
56e71b7053SJung-uk Kimin the file LICENSE in the source distribution or at
57e71b7053SJung-uk KimL<https://www.openssl.org/source/license.html>.
58e71b7053SJung-uk Kim
59e71b7053SJung-uk Kim=cut
60e71b7053SJung-uk Kim
61