Debian Codegraph @

upstream/debian-unstable/man3/EVP_sm4_cbc.3ssl

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "EVP_SM4_CBC 3SSL"
58 .TH EVP_SM4_CBC 3SSL 2026-04-07 3.6.2 OpenSSL
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 EVP_sm4_cbc,
65 EVP_sm4_ecb,
66 EVP_sm4_cfb,
67 EVP_sm4_cfb128,
68 EVP_sm4_ofb,
69 EVP_sm4_ctr
70 \&\- EVP SM4 cipher
71 .SH SYNOPSIS
72 .IX Header "SYNOPSIS"
73 .Vb 1
74 \& #include <openssl/evp.h>
75 \&
76 \& const EVP_CIPHER *EVP_sm4_cbc(void);
77 \& const EVP_CIPHER *EVP_sm4_ecb(void);
78 \& const EVP_CIPHER *EVP_sm4_cfb(void);
79 \& const EVP_CIPHER *EVP_sm4_cfb128(void);
80 \& const EVP_CIPHER *EVP_sm4_ofb(void);
81 \& const EVP_CIPHER *EVP_sm4_ctr(void);
82 .Ve
83 .SH DESCRIPTION
84 .IX Header "DESCRIPTION"
85 The SM4 blockcipher (GB/T 32907\-2016) for EVP.
86 .PP
87 All modes below use a key length of 128 bits and acts on blocks of 128 bits.
88 .IP "\fBEVP_sm4_cbc()\fR, \fBEVP_sm4_ecb()\fR, \fBEVP_sm4_cfb()\fR, \fBEVP_sm4_cfb128()\fR, \fBEVP_sm4_ofb()\fR, \fBEVP_sm4_ctr()\fR" 4
89 .IX Item "EVP_sm4_cbc(), EVP_sm4_ecb(), EVP_sm4_cfb(), EVP_sm4_cfb128(), EVP_sm4_ofb(), EVP_sm4_ctr()"
90 The SM4 blockcipher with a 128\-bit key in CBC, ECB, CFB, OFB and CTR modes
91 respectively.
92 .SH NOTES
93 .IX Header "NOTES"
94 Developers should be aware of the negative performance implications of
95 calling these functions multiple times and should consider using
96 \&\fBEVP_CIPHER_fetch\fR\|(3) with \fBEVP_CIPHER\-SM4\fR\|(7) instead.
97 See "Performance" in \fBcrypto\fR\|(7) for further information.
98 .SH "RETURN VALUES"
99 .IX Header "RETURN VALUES"
100 These functions return a \fBEVP_CIPHER\fR structure that contains the
101 implementation of the symmetric cipher. See \fBEVP_CIPHER_meth_new\fR\|(3) for
102 details of the \fBEVP_CIPHER\fR structure.
103 .SH "SEE ALSO"
104 .IX Header "SEE ALSO"
105 \&\fBevp\fR\|(7),
106 \&\fBEVP_EncryptInit\fR\|(3),
107 \&\fBEVP_CIPHER_meth_new\fR\|(3)
108 .SH COPYRIGHT
109 .IX Header "COPYRIGHT"
110 Copyright 2017\-2023 The OpenSSL Project Authors. All Rights Reserved.
111 Copyright 2017 Ribose Inc. All Rights Reserved.
112 .PP
113 Licensed under the Apache License 2.0 (the "License"). You may not use
114 this file except in compliance with the License. You can obtain a copy
115 in the file LICENSE in the source distribution or at
116 <https://www.openssl.org/source/license.html>.