xref: /freebsd/crypto/openssl/doc/man7/EVP_CIPHER-NULL.pod (revision 7fdf597e96a02165cfe22ff357b857d5fa15ed8a)
1=pod
2
3=head1 NAME
4
5EVP_CIPHER-NULL - The NULL EVP_CIPHER implementation
6
7=head1 DESCRIPTION
8
9Support for a NULL symmetric encryption using the B<EVP_CIPHER> API.
10This is used when the TLS cipher suite is TLS_NULL_WITH_NULL_NULL.
11This does no encryption (just copies the data) and has a mac size of zero.
12
13=head2 Algorithm Name
14
15The following algorithm is available in the default provider:
16
17=over 4
18
19=item "NULL"
20
21=back
22
23=head2 Parameters
24
25This implementation supports the following parameters:
26
27=head3 Gettable EVP_CIPHER parameters
28
29See L<EVP_EncryptInit(3)/Gettable EVP_CIPHER parameters>
30
31=head3 Gettable EVP_CIPHER_CTX parameters
32
33=over 4
34
35=item "keylen" (B<OSSL_CIPHER_PARAM_KEYLEN>) <unsigned integer>
36
37=item "ivlen" (B<OSSL_CIPHER_PARAM_IVLEN> and <B<OSSL_CIPHER_PARAM_AEAD_IVLEN>) <unsigned integer>
38
39=item "tls-mac" (B<OSSL_CIPHER_PARAM_TLS_MAC>) <octet ptr>
40
41=back
42
43See L<EVP_EncryptInit(3)/PARAMETERS> for further information.
44
45=head3 Settable EVP_CIPHER_CTX parameters
46
47=over 4
48
49=item "tls-mac-size" (B<OSSL_CIPHER_PARAM_TLS_MAC_SIZE>) <unsigned integer>
50
51=back
52
53See L<EVP_EncryptInit(3)/PARAMETERS> for further information.
54
55=head1 CONFORMING TO
56
57RFC 5246 section-6.2.3.1
58
59=head1 SEE ALSO
60
61L<provider-cipher(7)>, L<OSSL_PROVIDER-default(7)>
62
63=head1 COPYRIGHT
64
65Copyright 2023 The OpenSSL Project Authors. All Rights Reserved.
66
67Licensed under the Apache License 2.0 (the "License").  You may not use
68this file except in compliance with the License.  You can obtain a copy
69in the file LICENSE in the source distribution or at
70L<https://www.openssl.org/source/license.html>.
71
72=cut
73