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