]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - secure/usr.bin/openssl/man/openssl.1
OpenSSL: Merge OpenSSL 1.1.1o
[FreeBSD/FreeBSD.git] / secure / usr.bin / openssl / man / openssl.1
1 .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings.  \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 .    ds -- \(*W-
28 .    ds PI pi
29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
31 .    ds L" ""
32 .    ds R" ""
33 .    ds C` ""
34 .    ds C' ""
35 'br\}
36 .el\{\
37 .    ds -- \|\(em\|
38 .    ds PI \(*p
39 .    ds L" ``
40 .    ds R" ''
41 .    ds C`
42 .    ds C'
43 'br\}
44 .\"
45 .\" Escape single quotes in literal strings from groff's Unicode transform.
46 .ie \n(.g .ds Aq \(aq
47 .el       .ds Aq '
48 .\"
49 .\" If the F register is >0, we'll generate index entries on stderr for
50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51 .\" entries marked with X<> in POD.  Of course, you'll have to process the
52 .\" output yourself in some meaningful fashion.
53 .\"
54 .\" Avoid warning from groff about undefined register 'F'.
55 .de IX
56 ..
57 .nr rF 0
58 .if \n(.g .if rF .nr rF 1
59 .if (\n(rF:(\n(.g==0)) \{\
60 .    if \nF \{\
61 .        de IX
62 .        tm Index:\\$1\t\\n%\t"\\$2"
63 ..
64 .        if !\nF==2 \{\
65 .            nr % 0
66 .            nr F 2
67 .        \}
68 .    \}
69 .\}
70 .rr rF
71 .\"
72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
73 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
74 .    \" fudge factors for nroff and troff
75 .if n \{\
76 .    ds #H 0
77 .    ds #V .8m
78 .    ds #F .3m
79 .    ds #[ \f1
80 .    ds #] \fP
81 .\}
82 .if t \{\
83 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
84 .    ds #V .6m
85 .    ds #F 0
86 .    ds #[ \&
87 .    ds #] \&
88 .\}
89 .    \" simple accents for nroff and troff
90 .if n \{\
91 .    ds ' \&
92 .    ds ` \&
93 .    ds ^ \&
94 .    ds , \&
95 .    ds ~ ~
96 .    ds /
97 .\}
98 .if t \{\
99 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
100 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
101 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
102 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
103 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
104 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
105 .\}
106 .    \" troff and (daisy-wheel) nroff accents
107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
114 .ds ae a\h'-(\w'a'u*4/10)'e
115 .ds Ae A\h'-(\w'A'u*4/10)'E
116 .    \" corrections for vroff
117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
119 .    \" for low resolution devices (crt and lpr)
120 .if \n(.H>23 .if \n(.V>19 \
121 \{\
122 .    ds : e
123 .    ds 8 ss
124 .    ds o a
125 .    ds d- d\h'-1'\(ga
126 .    ds D- D\h'-1'\(hy
127 .    ds th \o'bp'
128 .    ds Th \o'LP'
129 .    ds ae ae
130 .    ds Ae AE
131 .\}
132 .rm #[ #] #H #V #F C
133 .\" ========================================================================
134 .\"
135 .IX Title "OPENSSL 1"
136 .TH OPENSSL 1 "2022-05-03" "1.1.1o" "OpenSSL"
137 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
138 .\" way too many mistakes in technical documents.
139 .if n .ad l
140 .nh
141 .SH "NAME"
142 openssl \- OpenSSL command line tool
143 .SH "SYNOPSIS"
144 .IX Header "SYNOPSIS"
145 \&\fBopenssl\fR
146 \&\fIcommand\fR
147 [ \fIcommand_opts\fR ]
148 [ \fIcommand_args\fR ]
149 .PP
150 \&\fBopenssl\fR \fBlist\fR [ \fBstandard-commands\fR | \fBdigest-commands\fR | \fBcipher-commands\fR | \fBcipher-algorithms\fR | \fBdigest-algorithms\fR | \fBpublic-key-algorithms\fR]
151 .PP
152 \&\fBopenssl\fR \fBno\-\fR\fI\s-1XXX\s0\fR [ \fIarbitrary options\fR ]
153 .SH "DESCRIPTION"
154 .IX Header "DESCRIPTION"
155 OpenSSL is a cryptography toolkit implementing the Secure Sockets Layer (\s-1SSL\s0
156 v2/v3) and Transport Layer Security (\s-1TLS\s0 v1) network protocols and related
157 cryptography standards required by them.
158 .PP
159 The \fBopenssl\fR program is a command line tool for using the various
160 cryptography functions of OpenSSL's \fBcrypto\fR library from the shell.
161 It can be used for
162 .PP
163 .Vb 8
164 \& o  Creation and management of private keys, public keys and parameters
165 \& o  Public key cryptographic operations
166 \& o  Creation of X.509 certificates, CSRs and CRLs
167 \& o  Calculation of Message Digests
168 \& o  Encryption and Decryption with Ciphers
169 \& o  SSL/TLS Client and Server Tests
170 \& o  Handling of S/MIME signed or encrypted mail
171 \& o  Time Stamp requests, generation and verification
172 .Ve
173 .SH "COMMAND SUMMARY"
174 .IX Header "COMMAND SUMMARY"
175 The \fBopenssl\fR program provides a rich variety of commands (\fIcommand\fR in the
176 \&\s-1SYNOPSIS\s0 above), each of which often has a wealth of options and arguments
177 (\fIcommand_opts\fR and \fIcommand_args\fR in the \s-1SYNOPSIS\s0).
178 .PP
179 Detailed documentation and use cases for most standard subcommands are available
180 (e.g., \fBx509\fR\|(1) or \fBopenssl\-x509\fR\|(1)).
181 .PP
182 Many commands use an external configuration file for some or all of their
183 arguments and have a \fB\-config\fR option to specify that file.
184 The environment variable \fB\s-1OPENSSL_CONF\s0\fR can be used to specify
185 the location of the file.
186 If the environment variable is not specified, then the file is named
187 \&\fBopenssl.cnf\fR in the default certificate storage area, whose value
188 depends on the configuration flags specified when the OpenSSL
189 was built.
190 .PP
191 The list parameters \fBstandard-commands\fR, \fBdigest-commands\fR,
192 and \fBcipher-commands\fR output a list (one entry per line) of the names
193 of all standard commands, message digest commands, or cipher commands,
194 respectively, that are available in the present \fBopenssl\fR utility.
195 .PP
196 The list parameters \fBcipher-algorithms\fR and
197 \&\fBdigest-algorithms\fR list all cipher and message digest names, one entry per line. Aliases are listed as:
198 .PP
199 .Vb 1
200 \& from => to
201 .Ve
202 .PP
203 The list parameter \fBpublic-key-algorithms\fR lists all supported public
204 key algorithms.
205 .PP
206 The command \fBno\-\fR\fI\s-1XXX\s0\fR tests whether a command of the
207 specified name is available.  If no command named \fI\s-1XXX\s0\fR exists, it
208 returns 0 (success) and prints \fBno\-\fR\fI\s-1XXX\s0\fR; otherwise it returns 1
209 and prints \fI\s-1XXX\s0\fR.  In both cases, the output goes to \fBstdout\fR and
210 nothing is printed to \fBstderr\fR.  Additional command line arguments
211 are always ignored.  Since for each cipher there is a command of the
212 same name, this provides an easy way for shell scripts to test for the
213 availability of ciphers in the \fBopenssl\fR program.  (\fBno\-\fR\fI\s-1XXX\s0\fR is
214 not able to detect pseudo-commands such as \fBquit\fR,
215 \&\fBlist\fR, or \fBno\-\fR\fI\s-1XXX\s0\fR itself.)
216 .SS "Standard Commands"
217 .IX Subsection "Standard Commands"
218 .IP "\fBasn1parse\fR" 4
219 .IX Item "asn1parse"
220 Parse an \s-1ASN.1\s0 sequence.
221 .IP "\fBca\fR" 4
222 .IX Item "ca"
223 Certificate Authority (\s-1CA\s0) Management.
224 .IP "\fBciphers\fR" 4
225 .IX Item "ciphers"
226 Cipher Suite Description Determination.
227 .IP "\fBcms\fR" 4
228 .IX Item "cms"
229 \&\s-1CMS\s0 (Cryptographic Message Syntax) utility.
230 .IP "\fBcrl\fR" 4
231 .IX Item "crl"
232 Certificate Revocation List (\s-1CRL\s0) Management.
233 .IP "\fBcrl2pkcs7\fR" 4
234 .IX Item "crl2pkcs7"
235 \&\s-1CRL\s0 to PKCS#7 Conversion.
236 .IP "\fBdgst\fR" 4
237 .IX Item "dgst"
238 Message Digest Calculation.
239 .IP "\fBdh\fR" 4
240 .IX Item "dh"
241 Diffie-Hellman Parameter Management.
242 Obsoleted by \fBdhparam\fR\|(1).
243 .IP "\fBdhparam\fR" 4
244 .IX Item "dhparam"
245 Generation and Management of Diffie-Hellman Parameters. Superseded by
246 \&\fBgenpkey\fR\|(1) and \fBpkeyparam\fR\|(1).
247 .IP "\fBdsa\fR" 4
248 .IX Item "dsa"
249 \&\s-1DSA\s0 Data Management.
250 .IP "\fBdsaparam\fR" 4
251 .IX Item "dsaparam"
252 \&\s-1DSA\s0 Parameter Generation and Management. Superseded by
253 \&\fBgenpkey\fR\|(1) and \fBpkeyparam\fR\|(1).
254 .IP "\fBec\fR" 4
255 .IX Item "ec"
256 \&\s-1EC\s0 (Elliptic curve) key processing.
257 .IP "\fBecparam\fR" 4
258 .IX Item "ecparam"
259 \&\s-1EC\s0 parameter manipulation and generation.
260 .IP "\fBenc\fR" 4
261 .IX Item "enc"
262 Encoding with Ciphers.
263 .IP "\fBengine\fR" 4
264 .IX Item "engine"
265 Engine (loadable module) information and manipulation.
266 .IP "\fBerrstr\fR" 4
267 .IX Item "errstr"
268 Error Number to Error String Conversion.
269 .IP "\fBgendh\fR" 4
270 .IX Item "gendh"
271 Generation of Diffie-Hellman Parameters.
272 Obsoleted by \fBdhparam\fR\|(1).
273 .IP "\fBgendsa\fR" 4
274 .IX Item "gendsa"
275 Generation of \s-1DSA\s0 Private Key from Parameters. Superseded by
276 \&\fBgenpkey\fR\|(1) and \fBpkey\fR\|(1).
277 .IP "\fBgenpkey\fR" 4
278 .IX Item "genpkey"
279 Generation of Private Key or Parameters.
280 .IP "\fBgenrsa\fR" 4
281 .IX Item "genrsa"
282 Generation of \s-1RSA\s0 Private Key. Superseded by \fBgenpkey\fR\|(1).
283 .IP "\fBnseq\fR" 4
284 .IX Item "nseq"
285 Create or examine a Netscape certificate sequence.
286 .IP "\fBocsp\fR" 4
287 .IX Item "ocsp"
288 Online Certificate Status Protocol utility.
289 .IP "\fBpasswd\fR" 4
290 .IX Item "passwd"
291 Generation of hashed passwords.
292 .IP "\fBpkcs12\fR" 4
293 .IX Item "pkcs12"
294 PKCS#12 Data Management.
295 .IP "\fBpkcs7\fR" 4
296 .IX Item "pkcs7"
297 PKCS#7 Data Management.
298 .IP "\fBpkcs8\fR" 4
299 .IX Item "pkcs8"
300 PKCS#8 format private key conversion tool.
301 .IP "\fBpkey\fR" 4
302 .IX Item "pkey"
303 Public and private key management.
304 .IP "\fBpkeyparam\fR" 4
305 .IX Item "pkeyparam"
306 Public key algorithm parameter management.
307 .IP "\fBpkeyutl\fR" 4
308 .IX Item "pkeyutl"
309 Public key algorithm cryptographic operation utility.
310 .IP "\fBprime\fR" 4
311 .IX Item "prime"
312 Compute prime numbers.
313 .IP "\fBrand\fR" 4
314 .IX Item "rand"
315 Generate pseudo-random bytes.
316 .IP "\fBrehash\fR" 4
317 .IX Item "rehash"
318 Create symbolic links to certificate and \s-1CRL\s0 files named by the hash values.
319 .IP "\fBreq\fR" 4
320 .IX Item "req"
321 PKCS#10 X.509 Certificate Signing Request (\s-1CSR\s0) Management.
322 .IP "\fBrsa\fR" 4
323 .IX Item "rsa"
324 \&\s-1RSA\s0 key management.
325 .IP "\fBrsautl\fR" 4
326 .IX Item "rsautl"
327 \&\s-1RSA\s0 utility for signing, verification, encryption, and decryption. Superseded
328 by  \fBpkeyutl\fR\|(1).
329 .IP "\fBs_client\fR" 4
330 .IX Item "s_client"
331 This implements a generic \s-1SSL/TLS\s0 client which can establish a transparent
332 connection to a remote server speaking \s-1SSL/TLS.\s0 It's intended for testing
333 purposes only and provides only rudimentary interface functionality but
334 internally uses mostly all functionality of the OpenSSL \fBssl\fR library.
335 .IP "\fBs_server\fR" 4
336 .IX Item "s_server"
337 This implements a generic \s-1SSL/TLS\s0 server which accepts connections from remote
338 clients speaking \s-1SSL/TLS.\s0 It's intended for testing purposes only and provides
339 only rudimentary interface functionality but internally uses mostly all
340 functionality of the OpenSSL \fBssl\fR library.  It provides both an own command
341 line oriented protocol for testing \s-1SSL\s0 functions and a simple \s-1HTTP\s0 response
342 facility to emulate an SSL/TLS\-aware webserver.
343 .IP "\fBs_time\fR" 4
344 .IX Item "s_time"
345 \&\s-1SSL\s0 Connection Timer.
346 .IP "\fBsess_id\fR" 4
347 .IX Item "sess_id"
348 \&\s-1SSL\s0 Session Data Management.
349 .IP "\fBsmime\fR" 4
350 .IX Item "smime"
351 S/MIME mail processing.
352 .IP "\fBspeed\fR" 4
353 .IX Item "speed"
354 Algorithm Speed Measurement.
355 .IP "\fBspkac\fR" 4
356 .IX Item "spkac"
357 \&\s-1SPKAC\s0 printing and generating utility.
358 .IP "\fBsrp\fR" 4
359 .IX Item "srp"
360 Maintain \s-1SRP\s0 password file.
361 .IP "\fBstoreutl\fR" 4
362 .IX Item "storeutl"
363 Utility to list and display certificates, keys, CRLs, etc.
364 .IP "\fBts\fR" 4
365 .IX Item "ts"
366 Time Stamping Authority tool (client/server).
367 .IP "\fBverify\fR" 4
368 .IX Item "verify"
369 X.509 Certificate Verification.
370 .IP "\fBversion\fR" 4
371 .IX Item "version"
372 OpenSSL Version Information.
373 .IP "\fBx509\fR" 4
374 .IX Item "x509"
375 X.509 Certificate Data Management.
376 .SS "Message Digest Commands"
377 .IX Subsection "Message Digest Commands"
378 .IP "\fBblake2b512\fR" 4
379 .IX Item "blake2b512"
380 BLAKE2b\-512 Digest
381 .IP "\fBblake2s256\fR" 4
382 .IX Item "blake2s256"
383 BLAKE2s\-256 Digest
384 .IP "\fBmd2\fR" 4
385 .IX Item "md2"
386 \&\s-1MD2\s0 Digest
387 .IP "\fBmd4\fR" 4
388 .IX Item "md4"
389 \&\s-1MD4\s0 Digest
390 .IP "\fBmd5\fR" 4
391 .IX Item "md5"
392 \&\s-1MD5\s0 Digest
393 .IP "\fBmdc2\fR" 4
394 .IX Item "mdc2"
395 \&\s-1MDC2\s0 Digest
396 .IP "\fBrmd160\fR" 4
397 .IX Item "rmd160"
398 \&\s-1RMD\-160\s0 Digest
399 .IP "\fBsha1\fR" 4
400 .IX Item "sha1"
401 \&\s-1SHA\-1\s0 Digest
402 .IP "\fBsha224\fR" 4
403 .IX Item "sha224"
404 \&\s-1SHA\-2 224\s0 Digest
405 .IP "\fBsha256\fR" 4
406 .IX Item "sha256"
407 \&\s-1SHA\-2 256\s0 Digest
408 .IP "\fBsha384\fR" 4
409 .IX Item "sha384"
410 \&\s-1SHA\-2 384\s0 Digest
411 .IP "\fBsha512\fR" 4
412 .IX Item "sha512"
413 \&\s-1SHA\-2 512\s0 Digest
414 .IP "\fBsha3\-224\fR" 4
415 .IX Item "sha3-224"
416 \&\s-1SHA\-3 224\s0 Digest
417 .IP "\fBsha3\-256\fR" 4
418 .IX Item "sha3-256"
419 \&\s-1SHA\-3 256\s0 Digest
420 .IP "\fBsha3\-384\fR" 4
421 .IX Item "sha3-384"
422 \&\s-1SHA\-3 384\s0 Digest
423 .IP "\fBsha3\-512\fR" 4
424 .IX Item "sha3-512"
425 \&\s-1SHA\-3 512\s0 Digest
426 .IP "\fBshake128\fR" 4
427 .IX Item "shake128"
428 \&\s-1SHA\-3 SHAKE128\s0 Digest
429 .IP "\fBshake256\fR" 4
430 .IX Item "shake256"
431 \&\s-1SHA\-3 SHAKE256\s0 Digest
432 .IP "\fBsm3\fR" 4
433 .IX Item "sm3"
434 \&\s-1SM3\s0 Digest
435 .SS "Encoding and Cipher Commands"
436 .IX Subsection "Encoding and Cipher Commands"
437 The following aliases provide convenient access to the most used encodings
438 and ciphers.
439 .PP
440 Depending on how OpenSSL was configured and built, not all ciphers listed
441 here may be present. See \fBenc\fR\|(1) for more information and command usage.
442 .IP "\fBaes128\fR, \fBaes\-128\-cbc\fR, \fBaes\-128\-cfb\fR, \fBaes\-128\-ctr\fR, \fBaes\-128\-ecb\fR, \fBaes\-128\-ofb\fR" 4
443 .IX Item "aes128, aes-128-cbc, aes-128-cfb, aes-128-ctr, aes-128-ecb, aes-128-ofb"
444 \&\s-1AES\-128\s0 Cipher
445 .IP "\fBaes192\fR, \fBaes\-192\-cbc\fR, \fBaes\-192\-cfb\fR, \fBaes\-192\-ctr\fR, \fBaes\-192\-ecb\fR, \fBaes\-192\-ofb\fR" 4
446 .IX Item "aes192, aes-192-cbc, aes-192-cfb, aes-192-ctr, aes-192-ecb, aes-192-ofb"
447 \&\s-1AES\-192\s0 Cipher
448 .IP "\fBaes256\fR, \fBaes\-256\-cbc\fR, \fBaes\-256\-cfb\fR, \fBaes\-256\-ctr\fR, \fBaes\-256\-ecb\fR, \fBaes\-256\-ofb\fR" 4
449 .IX Item "aes256, aes-256-cbc, aes-256-cfb, aes-256-ctr, aes-256-ecb, aes-256-ofb"
450 \&\s-1AES\-256\s0 Cipher
451 .IP "\fBaria128\fR, \fBaria\-128\-cbc\fR, \fBaria\-128\-cfb\fR, \fBaria\-128\-ctr\fR, \fBaria\-128\-ecb\fR, \fBaria\-128\-ofb\fR" 4
452 .IX Item "aria128, aria-128-cbc, aria-128-cfb, aria-128-ctr, aria-128-ecb, aria-128-ofb"
453 Aria\-128 Cipher
454 .IP "\fBaria192\fR, \fBaria\-192\-cbc\fR, \fBaria\-192\-cfb\fR, \fBaria\-192\-ctr\fR, \fBaria\-192\-ecb\fR, \fBaria\-192\-ofb\fR" 4
455 .IX Item "aria192, aria-192-cbc, aria-192-cfb, aria-192-ctr, aria-192-ecb, aria-192-ofb"
456 Aria\-192 Cipher
457 .IP "\fBaria256\fR, \fBaria\-256\-cbc\fR, \fBaria\-256\-cfb\fR, \fBaria\-256\-ctr\fR, \fBaria\-256\-ecb\fR, \fBaria\-256\-ofb\fR" 4
458 .IX Item "aria256, aria-256-cbc, aria-256-cfb, aria-256-ctr, aria-256-ecb, aria-256-ofb"
459 Aria\-256 Cipher
460 .IP "\fBbase64\fR" 4
461 .IX Item "base64"
462 Base64 Encoding
463 .IP "\fBbf\fR, \fBbf-cbc\fR, \fBbf-cfb\fR, \fBbf-ecb\fR, \fBbf-ofb\fR" 4
464 .IX Item "bf, bf-cbc, bf-cfb, bf-ecb, bf-ofb"
465 Blowfish Cipher
466 .IP "\fBcamellia128\fR, \fBcamellia\-128\-cbc\fR, \fBcamellia\-128\-cfb\fR, \fBcamellia\-128\-ctr\fR, \fBcamellia\-128\-ecb\fR, \fBcamellia\-128\-ofb\fR" 4
467 .IX Item "camellia128, camellia-128-cbc, camellia-128-cfb, camellia-128-ctr, camellia-128-ecb, camellia-128-ofb"
468 Camellia\-128 Cipher
469 .IP "\fBcamellia192\fR, \fBcamellia\-192\-cbc\fR, \fBcamellia\-192\-cfb\fR, \fBcamellia\-192\-ctr\fR, \fBcamellia\-192\-ecb\fR, \fBcamellia\-192\-ofb\fR" 4
470 .IX Item "camellia192, camellia-192-cbc, camellia-192-cfb, camellia-192-ctr, camellia-192-ecb, camellia-192-ofb"
471 Camellia\-192 Cipher
472 .IP "\fBcamellia256\fR, \fBcamellia\-256\-cbc\fR, \fBcamellia\-256\-cfb\fR, \fBcamellia\-256\-ctr\fR, \fBcamellia\-256\-ecb\fR, \fBcamellia\-256\-ofb\fR" 4
473 .IX Item "camellia256, camellia-256-cbc, camellia-256-cfb, camellia-256-ctr, camellia-256-ecb, camellia-256-ofb"
474 Camellia\-256 Cipher
475 .IP "\fBcast\fR, \fBcast-cbc\fR" 4
476 .IX Item "cast, cast-cbc"
477 \&\s-1CAST\s0 Cipher
478 .IP "\fBcast5\-cbc\fR, \fBcast5\-cfb\fR, \fBcast5\-ecb\fR, \fBcast5\-ofb\fR" 4
479 .IX Item "cast5-cbc, cast5-cfb, cast5-ecb, cast5-ofb"
480 \&\s-1CAST5\s0 Cipher
481 .IP "\fBchacha20\fR" 4
482 .IX Item "chacha20"
483 Chacha20 Cipher
484 .IP "\fBdes\fR, \fBdes-cbc\fR, \fBdes-cfb\fR, \fBdes-ecb\fR, \fBdes-ede\fR, \fBdes-ede-cbc\fR, \fBdes-ede-cfb\fR, \fBdes-ede-ofb\fR, \fBdes-ofb\fR" 4
485 .IX Item "des, des-cbc, des-cfb, des-ecb, des-ede, des-ede-cbc, des-ede-cfb, des-ede-ofb, des-ofb"
486 \&\s-1DES\s0 Cipher
487 .IP "\fBdes3\fR, \fBdesx\fR, \fBdes\-ede3\fR, \fBdes\-ede3\-cbc\fR, \fBdes\-ede3\-cfb\fR, \fBdes\-ede3\-ofb\fR" 4
488 .IX Item "des3, desx, des-ede3, des-ede3-cbc, des-ede3-cfb, des-ede3-ofb"
489 Triple-DES Cipher
490 .IP "\fBidea\fR, \fBidea-cbc\fR, \fBidea-cfb\fR, \fBidea-ecb\fR, \fBidea-ofb\fR" 4
491 .IX Item "idea, idea-cbc, idea-cfb, idea-ecb, idea-ofb"
492 \&\s-1IDEA\s0 Cipher
493 .IP "\fBrc2\fR, \fBrc2\-cbc\fR, \fBrc2\-cfb\fR, \fBrc2\-ecb\fR, \fBrc2\-ofb\fR" 4
494 .IX Item "rc2, rc2-cbc, rc2-cfb, rc2-ecb, rc2-ofb"
495 \&\s-1RC2\s0 Cipher
496 .IP "\fBrc4\fR" 4
497 .IX Item "rc4"
498 \&\s-1RC4\s0 Cipher
499 .IP "\fBrc5\fR, \fBrc5\-cbc\fR, \fBrc5\-cfb\fR, \fBrc5\-ecb\fR, \fBrc5\-ofb\fR" 4
500 .IX Item "rc5, rc5-cbc, rc5-cfb, rc5-ecb, rc5-ofb"
501 \&\s-1RC5\s0 Cipher
502 .IP "\fBseed\fR, \fBseed-cbc\fR, \fBseed-cfb\fR, \fBseed-ecb\fR, \fBseed-ofb\fR" 4
503 .IX Item "seed, seed-cbc, seed-cfb, seed-ecb, seed-ofb"
504 \&\s-1SEED\s0 Cipher
505 .IP "\fBsm4\fR, \fBsm4\-cbc\fR, \fBsm4\-cfb\fR, \fBsm4\-ctr\fR, \fBsm4\-ecb\fR, \fBsm4\-ofb\fR" 4
506 .IX Item "sm4, sm4-cbc, sm4-cfb, sm4-ctr, sm4-ecb, sm4-ofb"
507 \&\s-1SM4\s0 Cipher
508 .SH "OPTIONS"
509 .IX Header "OPTIONS"
510 Details of which options are available depend on the specific command.
511 This section describes some common options with common behavior.
512 .SS "Common Options"
513 .IX Subsection "Common Options"
514 .IP "\fB\-help\fR" 4
515 .IX Item "-help"
516 Provides a terse summary of all options.
517 .SS "Pass Phrase Options"
518 .IX Subsection "Pass Phrase Options"
519 Several commands accept password arguments, typically using \fB\-passin\fR
520 and \fB\-passout\fR for input and output passwords respectively. These allow
521 the password to be obtained from a variety of sources. Both of these
522 options take a single argument whose format is described below. If no
523 password argument is given and a password is required then the user is
524 prompted to enter one: this will typically be read from the current
525 terminal with echoing turned off.
526 .PP
527 Note that character encoding may be relevant, please see
528 \&\fBpassphrase\-encoding\fR\|(7).
529 .IP "\fBpass:password\fR" 4
530 .IX Item "pass:password"
531 The actual password is \fBpassword\fR. Since the password is visible
532 to utilities (like 'ps' under Unix) this form should only be used
533 where security is not important.
534 .IP "\fBenv:var\fR" 4
535 .IX Item "env:var"
536 Obtain the password from the environment variable \fBvar\fR. Since
537 the environment of other processes is visible on certain platforms
538 (e.g. ps under certain Unix OSes) this option should be used with caution.
539 .IP "\fBfile:pathname\fR" 4
540 .IX Item "file:pathname"
541 The first line of \fBpathname\fR is the password. If the same \fBpathname\fR
542 argument is supplied to \fB\-passin\fR and \fB\-passout\fR arguments then the first
543 line will be used for the input password and the next line for the output
544 password. \fBpathname\fR need not refer to a regular file: it could for example
545 refer to a device or named pipe.
546 .IP "\fBfd:number\fR" 4
547 .IX Item "fd:number"
548 Read the password from the file descriptor \fBnumber\fR. This can be used to
549 send the data via a pipe for example.
550 .IP "\fBstdin\fR" 4
551 .IX Item "stdin"
552 Read the password from standard input.
553 .SH "SEE ALSO"
554 .IX Header "SEE ALSO"
555 \&\fBasn1parse\fR\|(1), \fBca\fR\|(1), \fBciphers\fR\|(1), \fBcms\fR\|(1), \fBconfig\fR\|(5),
556 \&\fBcrl\fR\|(1), \fBcrl2pkcs7\fR\|(1), \fBdgst\fR\|(1),
557 \&\fBdhparam\fR\|(1), \fBdsa\fR\|(1), \fBdsaparam\fR\|(1),
558 \&\fBec\fR\|(1), \fBecparam\fR\|(1),
559 \&\fBenc\fR\|(1), \fBengine\fR\|(1), \fBerrstr\fR\|(1), \fBgendsa\fR\|(1), \fBgenpkey\fR\|(1),
560 \&\fBgenrsa\fR\|(1), \fBnseq\fR\|(1), \fBocsp\fR\|(1),
561 \&\fBpasswd\fR\|(1),
562 \&\fBpkcs12\fR\|(1), \fBpkcs7\fR\|(1), \fBpkcs8\fR\|(1),
563 \&\fBpkey\fR\|(1), \fBpkeyparam\fR\|(1), \fBpkeyutl\fR\|(1), \fBprime\fR\|(1),
564 \&\fBrand\fR\|(1), \fBrehash\fR\|(1), \fBreq\fR\|(1), \fBrsa\fR\|(1),
565 \&\fBrsautl\fR\|(1), \fBs_client\fR\|(1),
566 \&\fBs_server\fR\|(1), \fBs_time\fR\|(1), \fBsess_id\fR\|(1),
567 \&\fBsmime\fR\|(1), \fBspeed\fR\|(1), \fBspkac\fR\|(1), \fBsrp\fR\|(1), \fBstoreutl\fR\|(1),
568 \&\fBts\fR\|(1),
569 \&\fBverify\fR\|(1), \fBversion\fR\|(1), \fBx509\fR\|(1),
570 \&\fBcrypto\fR\|(7), \fBssl\fR\|(7), \fBx509v3_config\fR\|(5)
571 .SH "HISTORY"
572 .IX Header "HISTORY"
573 The \fBlist\-\fR\fI\s-1XXX\s0\fR\fB\-algorithms\fR pseudo-commands were added in OpenSSL 1.0.0;
574 For notes on the availability of other commands, see their individual
575 manual pages.
576 .SH "COPYRIGHT"
577 .IX Header "COPYRIGHT"
578 Copyright 2000\-2018 The OpenSSL Project Authors. All Rights Reserved.
579 .PP
580 Licensed under the OpenSSL license (the \*(L"License\*(R").  You may not use
581 this file except in compliance with the License.  You can obtain a copy
582 in the file \s-1LICENSE\s0 in the source distribution or at
583 <https://www.openssl.org/source/license.html>.