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-09-11" "1.1.1" "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 Many commands use an external configuration file for some or all of their
 176 arguments and have a \fB\-config\fR option to specify that file.
 177 The environment variable \fB\s-1OPENSSL_CONF\s0\fR can be used to specify
 178 the location of the file.
 179 If the environment variable is not specified, then the file is named
 180 \&\fBopenssl.cnf\fR in the default certificate storage area, whose value
 181 depends on the configuration flags specified when the OpenSSL
 182 was built.
 183 .PP
 184 The list parameters \fBstandard-commands\fR, \fBdigest-commands\fR,
 185 and \fBcipher-commands\fR output a list (one entry per line) of the names
 186 of all standard commands, message digest commands, or cipher commands,
 187 respectively, that are available in the present \fBopenssl\fR utility.
 188 .PP
 189 The list parameters \fBcipher-algorithms\fR and
 190 \&\fBdigest-algorithms\fR list all cipher and message digest names, one entry per line. Aliases are listed as:
 191 .PP
 192 .Vb 1
 193 \& from => to
 194 .Ve
 195 .PP
 196 The list parameter \fBpublic-key-algorithms\fR lists all supported public
 197 key algorithms.
 198 .PP
 199 The command \fBno\-\fR\fI\s-1XXX\s0\fR tests whether a command of the
 200 specified name is available.  If no command named \fI\s-1XXX\s0\fR exists, it
 201 returns 0 (success) and prints \fBno\-\fR\fI\s-1XXX\s0\fR; otherwise it returns 1
 202 and prints \fI\s-1XXX\s0\fR.  In both cases, the output goes to \fBstdout\fR and
 203 nothing is printed to \fBstderr\fR.  Additional command line arguments
 204 are always ignored.  Since for each cipher there is a command of the
 205 same name, this provides an easy way for shell scripts to test for the
 206 availability of ciphers in the \fBopenssl\fR program.  (\fBno\-\fR\fI\s-1XXX\s0\fR is
 207 not able to detect pseudo-commands such as \fBquit\fR,
 208 \&\fBlist\fR, or \fBno\-\fR\fI\s-1XXX\s0\fR itself.)
 209 .SS "Standard Commands"
 210 .IX Subsection "Standard Commands"
 211 .IP "\fBasn1parse\fR" 4
 212 .IX Item "asn1parse"
 213 Parse an \s-1ASN.1\s0 sequence.
 214 .IP "\fBca\fR" 4
 215 .IX Item "ca"
 216 Certificate Authority (\s-1CA\s0) Management.
 217 .IP "\fBciphers\fR" 4
 218 .IX Item "ciphers"
 219 Cipher Suite Description Determination.
 220 .IP "\fBcms\fR" 4
 221 .IX Item "cms"
 222 \&\s-1CMS\s0 (Cryptographic Message Syntax) utility.
 223 .IP "\fBcrl\fR" 4
 224 .IX Item "crl"
 225 Certificate Revocation List (\s-1CRL\s0) Management.
 226 .IP "\fBcrl2pkcs7\fR" 4
 227 .IX Item "crl2pkcs7"
 228 \&\s-1CRL\s0 to PKCS#7 Conversion.
 229 .IP "\fBdgst\fR" 4
 230 .IX Item "dgst"
 231 Message Digest Calculation.
 232 .IP "\fBdh\fR" 4
 233 .IX Item "dh"
 234 Diffie-Hellman Parameter Management.
 235 Obsoleted by \fIdhparam\fR\|(1).
 236 .IP "\fBdhparam\fR" 4
 237 .IX Item "dhparam"
 238 Generation and Management of Diffie-Hellman Parameters. Superseded by
 239 \&\fIgenpkey\fR\|(1) and \fIpkeyparam\fR\|(1).
 240 .IP "\fBdsa\fR" 4
 241 .IX Item "dsa"
 242 \&\s-1DSA\s0 Data Management.
 243 .IP "\fBdsaparam\fR" 4
 244 .IX Item "dsaparam"
 245 \&\s-1DSA\s0 Parameter Generation and Management. Superseded by
 246 \&\fIgenpkey\fR\|(1) and \fIpkeyparam\fR\|(1).
 247 .IP "\fBec\fR" 4
 248 .IX Item "ec"
 249 \&\s-1EC\s0 (Elliptic curve) key processing.
 250 .IP "\fBecparam\fR" 4
 251 .IX Item "ecparam"
 252 \&\s-1EC\s0 parameter manipulation and generation.
 253 .IP "\fBenc\fR" 4
 254 .IX Item "enc"
 255 Encoding with Ciphers.
 256 .IP "\fBengine\fR" 4
 257 .IX Item "engine"
 258 Engine (loadable module) information and manipulation.
 259 .IP "\fBerrstr\fR" 4
 260 .IX Item "errstr"
 261 Error Number to Error String Conversion.
 262 .IP "\fBgendh\fR" 4
 263 .IX Item "gendh"
 264 Generation of Diffie-Hellman Parameters.
 265 Obsoleted by \fIdhparam\fR\|(1).
 266 .IP "\fBgendsa\fR" 4
 267 .IX Item "gendsa"
 268 Generation of \s-1DSA\s0 Private Key from Parameters. Superseded by
 269 \&\fIgenpkey\fR\|(1) and \fIpkey\fR\|(1).
 270 .IP "\fBgenpkey\fR" 4
 271 .IX Item "genpkey"
 272 Generation of Private Key or Parameters.
 273 .IP "\fBgenrsa\fR" 4
 274 .IX Item "genrsa"
 275 Generation of \s-1RSA\s0 Private Key. Superseded by \fIgenpkey\fR\|(1).
 276 .IP "\fBnseq\fR" 4
 277 .IX Item "nseq"
 278 Create or examine a Netscape certificate sequence.
 279 .IP "\fBocsp\fR" 4
 280 .IX Item "ocsp"
 281 Online Certificate Status Protocol utility.
 282 .IP "\fBpasswd\fR" 4
 283 .IX Item "passwd"
 284 Generation of hashed passwords.
 285 .IP "\fBpkcs12\fR" 4
 286 .IX Item "pkcs12"
 287 PKCS#12 Data Management.
 288 .IP "\fBpkcs7\fR" 4
 289 .IX Item "pkcs7"
 290 PKCS#7 Data Management.
 291 .IP "\fBpkcs8\fR" 4
 292 .IX Item "pkcs8"
 293 PKCS#8 format private key conversion tool.
 294 .IP "\fBpkey\fR" 4
 295 .IX Item "pkey"
 296 Public and private key management.
 297 .IP "\fBpkeyparam\fR" 4
 298 .IX Item "pkeyparam"
 299 Public key algorithm parameter management.
 300 .IP "\fBpkeyutl\fR" 4
 301 .IX Item "pkeyutl"
 302 Public key algorithm cryptographic operation utility.
 303 .IP "\fBprime\fR" 4
 304 .IX Item "prime"
 305 Compute prime numbers.
 306 .IP "\fBrand\fR" 4
 307 .IX Item "rand"
 308 Generate pseudo-random bytes.
 309 .IP "\fBrehash\fR" 4
 310 .IX Item "rehash"
 311 Create symbolic links to certificate and \s-1CRL\s0 files named by the hash values.
 312 .IP "\fBreq\fR" 4
 313 .IX Item "req"
 314 PKCS#10 X.509 Certificate Signing Request (\s-1CSR\s0) Management.
 315 .IP "\fBrsa\fR" 4
 316 .IX Item "rsa"
 317 \&\s-1RSA\s0 key management.
 318 .IP "\fBrsautl\fR" 4
 319 .IX Item "rsautl"
 320 \&\s-1RSA\s0 utility for signing, verification, encryption, and decryption. Superseded
 321 by  \fIpkeyutl\fR\|(1).
 322 .IP "\fBs_client\fR" 4
 323 .IX Item "s_client"
 324 This implements a generic \s-1SSL/TLS\s0 client which can establish a transparent
 325 connection to a remote server speaking \s-1SSL/TLS.\s0 It's intended for testing
 326 purposes only and provides only rudimentary interface functionality but
 327 internally uses mostly all functionality of the OpenSSL \fBssl\fR library.
 328 .IP "\fBs_server\fR" 4
 329 .IX Item "s_server"
 330 This implements a generic \s-1SSL/TLS\s0 server which accepts connections from remote
 331 clients speaking \s-1SSL/TLS.\s0 It's intended for testing purposes only and provides
 332 only rudimentary interface functionality but internally uses mostly all
 333 functionality of the OpenSSL \fBssl\fR library.  It provides both an own command
 334 line oriented protocol for testing \s-1SSL\s0 functions and a simple \s-1HTTP\s0 response
 335 facility to emulate an SSL/TLS\-aware webserver.
 336 .IP "\fBs_time\fR" 4
 337 .IX Item "s_time"
 338 \&\s-1SSL\s0 Connection Timer.
 339 .IP "\fBsess_id\fR" 4
 340 .IX Item "sess_id"
 341 \&\s-1SSL\s0 Session Data Management.
 342 .IP "\fBsmime\fR" 4
 343 .IX Item "smime"
 344 S/MIME mail processing.
 345 .IP "\fBspeed\fR" 4
 346 .IX Item "speed"
 347 Algorithm Speed Measurement.
 348 .IP "\fBspkac\fR" 4
 349 .IX Item "spkac"
 350 \&\s-1SPKAC\s0 printing and generating utility.
 351 .IP "\fBsrp\fR" 4
 352 .IX Item "srp"
 353 Maintain \s-1SRP\s0 password file.
 354 .IP "\fBstoreutl\fR" 4
 355 .IX Item "storeutl"
 356 Utility to list and display certificates, keys, CRLs, etc.
 357 .IP "\fBts\fR" 4
 358 .IX Item "ts"
 359 Time Stamping Authority tool (client/server).
 360 .IP "\fBverify\fR" 4
 361 .IX Item "verify"
 362 X.509 Certificate Verification.
 363 .IP "\fBversion\fR" 4
 364 .IX Item "version"
 365 OpenSSL Version Information.
 366 .IP "\fBx509\fR" 4
 367 .IX Item "x509"
 368 X.509 Certificate Data Management.
 369 .SS "Message Digest Commands"
 370 .IX Subsection "Message Digest Commands"
 371 .IP "\fBblake2b512\fR" 4
 372 .IX Item "blake2b512"
 373 BLAKE2b\-512 Digest
 374 .IP "\fBblake2s256\fR" 4
 375 .IX Item "blake2s256"
 376 BLAKE2s\-256 Digest
 377 .IP "\fBmd2\fR" 4
 378 .IX Item "md2"
 379 \&\s-1MD2\s0 Digest
 380 .IP "\fBmd4\fR" 4
 381 .IX Item "md4"
 382 \&\s-1MD4\s0 Digest
 383 .IP "\fBmd5\fR" 4
 384 .IX Item "md5"
 385 \&\s-1MD5\s0 Digest
 386 .IP "\fBmdc2\fR" 4
 387 .IX Item "mdc2"
 388 \&\s-1MDC2\s0 Digest
 389 .IP "\fBrmd160\fR" 4
 390 .IX Item "rmd160"
 391 \&\s-1RMD\-160\s0 Digest
 392 .IP "\fBsha1\fR" 4
 393 .IX Item "sha1"
 394 \&\s-1SHA\-1\s0 Digest
 395 .IP "\fBsha224\fR" 4
 396 .IX Item "sha224"
 397 \&\s-1SHA\-2 224\s0 Digest
 398 .IP "\fBsha256\fR" 4
 399 .IX Item "sha256"
 400 \&\s-1SHA\-2 256\s0 Digest
 401 .IP "\fBsha384\fR" 4
 402 .IX Item "sha384"
 403 \&\s-1SHA\-2 384\s0 Digest
 404 .IP "\fBsha512\fR" 4
 405 .IX Item "sha512"
 406 \&\s-1SHA\-2 512\s0 Digest
 407 .IP "\fBsha3\-224\fR" 4
 408 .IX Item "sha3-224"
 409 \&\s-1SHA\-3 224\s0 Digest
 410 .IP "\fBsha3\-256\fR" 4
 411 .IX Item "sha3-256"
 412 \&\s-1SHA\-3 256\s0 Digest
 413 .IP "\fBsha3\-384\fR" 4
 414 .IX Item "sha3-384"
 415 \&\s-1SHA\-3 384\s0 Digest
 416 .IP "\fBsha3\-512\fR" 4
 417 .IX Item "sha3-512"
 418 \&\s-1SHA\-3 512\s0 Digest
 419 .IP "\fBshake128\fR" 4
 420 .IX Item "shake128"
 421 \&\s-1SHA\-3 SHAKE128\s0 Digest
 422 .IP "\fBshake256\fR" 4
 423 .IX Item "shake256"
 424 \&\s-1SHA\-3 SHAKE256\s0 Digest
 425 .IP "\fBsm3\fR" 4
 426 .IX Item "sm3"
 427 \&\s-1SM3\s0 Digest
 428 .SS "Encoding and Cipher Commands"
 429 .IX Subsection "Encoding and Cipher Commands"
 430 .IP "\fBbase64\fR" 4
 431 .IX Item "base64"
 432 Base64 Encoding
 433 .IP "\fBbf\fR, \fBbf-cbc\fR, \fBbf-cfb\fR, \fBbf-ecb\fR, \fBbf-ofb\fR" 4
 434 .IX Item "bf, bf-cbc, bf-cfb, bf-ecb, bf-ofb"
 435 Blowfish Cipher
 436 .IP "\fBcast\fR, \fBcast-cbc\fR" 4
 437 .IX Item "cast, cast-cbc"
 438 \&\s-1CAST\s0 Cipher
 439 .IP "\fBcast5\-cbc\fR, \fBcast5\-cfb\fR, \fBcast5\-ecb\fR, \fBcast5\-ofb\fR" 4
 440 .IX Item "cast5-cbc, cast5-cfb, cast5-ecb, cast5-ofb"
 441 \&\s-1CAST5\s0 Cipher
 442 .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
 443 .IX Item "des, des-cbc, des-cfb, des-ecb, des-ede, des-ede-cbc, des-ede-cfb, des-ede-ofb, des-ofb"
 444 \&\s-1DES\s0 Cipher
 445 .IP "\fBdes3\fR, \fBdesx\fR, \fBdes\-ede3\fR, \fBdes\-ede3\-cbc\fR, \fBdes\-ede3\-cfb\fR, \fBdes\-ede3\-ofb\fR" 4
 446 .IX Item "des3, desx, des-ede3, des-ede3-cbc, des-ede3-cfb, des-ede3-ofb"
 447 Triple-DES Cipher
 448 .IP "\fBidea\fR, \fBidea-cbc\fR, \fBidea-cfb\fR, \fBidea-ecb\fR, \fBidea-ofb\fR" 4
 449 .IX Item "idea, idea-cbc, idea-cfb, idea-ecb, idea-ofb"
 450 \&\s-1IDEA\s0 Cipher
 451 .IP "\fBrc2\fR, \fBrc2\-cbc\fR, \fBrc2\-cfb\fR, \fBrc2\-ecb\fR, \fBrc2\-ofb\fR" 4
 452 .IX Item "rc2, rc2-cbc, rc2-cfb, rc2-ecb, rc2-ofb"
 453 \&\s-1RC2\s0 Cipher
 454 .IP "\fBrc4\fR" 4
 455 .IX Item "rc4"
 456 \&\s-1RC4\s0 Cipher
 457 .IP "\fBrc5\fR, \fBrc5\-cbc\fR, \fBrc5\-cfb\fR, \fBrc5\-ecb\fR, \fBrc5\-ofb\fR" 4
 458 .IX Item "rc5, rc5-cbc, rc5-cfb, rc5-ecb, rc5-ofb"
 459 \&\s-1RC5\s0 Cipher
 460 .SH "OPTIONS"
 461 .IX Header "OPTIONS"
 462 Details of which options are available depend on the specific command.
 463 This section describes some common options with common behavior.
 464 .SS "Common Options"
 465 .IX Subsection "Common Options"
 466 .IP "\fB\-help\fR" 4
 467 .IX Item "-help"
 468 Provides a terse summary of all options.
 469 .SS "Pass Phrase Options"
 470 .IX Subsection "Pass Phrase Options"
 471 Several commands accept password arguments, typically using \fB\-passin\fR
 472 and \fB\-passout\fR for input and output passwords respectively. These allow
 473 the password to be obtained from a variety of sources. Both of these
 474 options take a single argument whose format is described below. If no
 475 password argument is given and a password is required then the user is
 476 prompted to enter one: this will typically be read from the current
 477 terminal with echoing turned off.
 478 .PP
 479 Note that character encoding may be relevant, please see
 480 \&\fIpassphrase\-encoding\fR\|(7).
 481 .IP "\fBpass:password\fR" 4
 482 .IX Item "pass:password"
 483 The actual password is \fBpassword\fR. Since the password is visible
 484 to utilities (like 'ps' under Unix) this form should only be used
 485 where security is not important.
 486 .IP "\fBenv:var\fR" 4
 487 .IX Item "env:var"
 488 Obtain the password from the environment variable \fBvar\fR. Since
 489 the environment of other processes is visible on certain platforms
 490 (e.g. ps under certain Unix OSes) this option should be used with caution.
 491 .IP "\fBfile:pathname\fR" 4
 492 .IX Item "file:pathname"
 493 The first line of \fBpathname\fR is the password. If the same \fBpathname\fR
 494 argument is supplied to \fB\-passin\fR and \fB\-passout\fR arguments then the first
 495 line will be used for the input password and the next line for the output
 496 password. \fBpathname\fR need not refer to a regular file: it could for example
 497 refer to a device or named pipe.
 498 .IP "\fBfd:number\fR" 4
 499 .IX Item "fd:number"
 500 Read the password from the file descriptor \fBnumber\fR. This can be used to
 501 send the data via a pipe for example.
 502 .IP "\fBstdin\fR" 4
 503 .IX Item "stdin"
 504 Read the password from standard input.
 505 .SH "SEE ALSO"
 506 .IX Header "SEE ALSO"
 507 \&\fIasn1parse\fR\|(1), \fIca\fR\|(1), \fIciphers\fR\|(1), \fIcms\fR\|(1), \fIconfig\fR\|(5),
 508 \&\fIcrl\fR\|(1), \fIcrl2pkcs7\fR\|(1), \fIdgst\fR\|(1),
 509 \&\fIdhparam\fR\|(1), \fIdsa\fR\|(1), \fIdsaparam\fR\|(1),
 510 \&\fIec\fR\|(1), \fIecparam\fR\|(1),
 511 \&\fIenc\fR\|(1), \fIengine\fR\|(1), \fIerrstr\fR\|(1), \fIgendsa\fR\|(1), \fIgenpkey\fR\|(1),
 512 \&\fIgenrsa\fR\|(1), \fInseq\fR\|(1), \fIocsp\fR\|(1),
 513 \&\fIpasswd\fR\|(1),
 514 \&\fIpkcs12\fR\|(1), \fIpkcs7\fR\|(1), \fIpkcs8\fR\|(1),
 515 \&\fIpkey\fR\|(1), \fIpkeyparam\fR\|(1), \fIpkeyutl\fR\|(1), \fIprime\fR\|(1),
 516 \&\fIrand\fR\|(1), \fIrehash\fR\|(1), \fIreq\fR\|(1), \fIrsa\fR\|(1),
 517 \&\fIrsautl\fR\|(1), \fIs_client\fR\|(1),
 518 \&\fIs_server\fR\|(1), \fIs_time\fR\|(1), \fIsess_id\fR\|(1),
 519 \&\fIsmime\fR\|(1), \fIspeed\fR\|(1), \fIspkac\fR\|(1), \fIsrp\fR\|(1), \fIstoreutl\fR\|(1),
 520 \&\fIts\fR\|(1),
 521 \&\fIverify\fR\|(1), \fIversion\fR\|(1), \fIx509\fR\|(1),
 522 \&\fIcrypto\fR\|(7), \fIssl\fR\|(7), \fIx509v3_config\fR\|(5)
 523 .SH "HISTORY"
 524 .IX Header "HISTORY"
 525 The \fBlist\-\fR\fI\s-1XXX\s0\fR\fB\-algorithms\fR pseudo-commands were added in OpenSSL 1.0.0;
 526 For notes on the availability of other commands, see their individual
 527 manual pages.
 528 .SH "COPYRIGHT"
 529 .IX Header "COPYRIGHT"
 530 Copyright 2000\-2018 The OpenSSL Project Authors. All Rights Reserved.
 531 .PP
 532 Licensed under the OpenSSL license (the \*(L"License\*(R").  You may not use
 533 this file except in compliance with the License.  You can obtain a copy
 534 in the file \s-1LICENSE\s0 in the source distribution or at
 535 <https://www.openssl.org/source/license.html>.