diff options
| author | jmc <> | 2003-04-25 12:43:10 +0000 | 
|---|---|---|
| committer | jmc <> | 2003-04-25 12:43:10 +0000 | 
| commit | 7f7aa15f5be4823b7a344578e769349a2e1d0235 (patch) | |
| tree | 66f3488100321ffa9c46118c60e80b10dfe708cf | |
| parent | 8f1420b571676cc4a8a863fa689bb24e55d24f7d (diff) | |
| download | openbsd-7f7aa15f5be4823b7a344578e769349a2e1d0235.tar.gz openbsd-7f7aa15f5be4823b7a344578e769349a2e1d0235.tar.bz2 openbsd-7f7aa15f5be4823b7a344578e769349a2e1d0235.zip | |
- add missing .El macros (7 of them!)
- use .Bl not .Bd for lists
- whitespace at EOL killed
- typos in macros
- .El -width shortened Ds -> XXXX
Diffstat (limited to '')
| -rw-r--r-- | src/usr.sbin/openssl/openssl.1 | 328 | 
1 files changed, 168 insertions, 160 deletions
| diff --git a/src/usr.sbin/openssl/openssl.1 b/src/usr.sbin/openssl/openssl.1 index c17d026e74..30685260bb 100644 --- a/src/usr.sbin/openssl/openssl.1 +++ b/src/usr.sbin/openssl/openssl.1 | |||
| @@ -1,4 +1,4 @@ | |||
| 1 | .\" $OpenBSD: openssl.1,v 1.5 2003/03/22 08:02:03 david Exp $ | 1 | .\" $OpenBSD: openssl.1,v 1.6 2003/04/25 12:43:10 jmc Exp $ | 
| 2 | .\" ==================================================================== | 2 | .\" ==================================================================== | 
| 3 | .\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved. | 3 | .\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved. | 
| 4 | .\" | 4 | .\" | 
| @@ -7,7 +7,7 @@ | |||
| 7 | .\" are met: | 7 | .\" are met: | 
| 8 | .\" | 8 | .\" | 
| 9 | .\" 1. Redistributions of source code must retain the above copyright | 9 | .\" 1. Redistributions of source code must retain the above copyright | 
| 10 | .\" notice, this list of conditions and the following disclaimer. | 10 | .\" notice, this list of conditions and the following disclaimer. | 
| 11 | .\" | 11 | .\" | 
| 12 | .\" 2. Redistributions in binary form must reproduce the above copyright | 12 | .\" 2. Redistributions in binary form must reproduce the above copyright | 
| 13 | .\" notice, this list of conditions and the following disclaimer in | 13 | .\" notice, this list of conditions and the following disclaimer in | 
| @@ -51,28 +51,28 @@ | |||
| 51 | .\" (eay@cryptsoft.com). This product includes software written by Tim | 51 | .\" (eay@cryptsoft.com). This product includes software written by Tim | 
| 52 | .\" Hudson (tjh@cryptsoft.com). | 52 | .\" Hudson (tjh@cryptsoft.com). | 
| 53 | .\" | 53 | .\" | 
| 54 | .\" | 54 | .\" | 
| 55 | .\" Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) | 55 | .\" Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) | 
| 56 | .\" All rights reserved. | 56 | .\" All rights reserved. | 
| 57 | .\" | 57 | .\" | 
| 58 | .\" This package is an SSL implementation written | 58 | .\" This package is an SSL implementation written | 
| 59 | .\" by Eric Young (eay@cryptsoft.com). | 59 | .\" by Eric Young (eay@cryptsoft.com). | 
| 60 | .\" The implementation was written so as to conform with Netscapes SSL. | 60 | .\" The implementation was written so as to conform with Netscapes SSL. | 
| 61 | .\" | 61 | .\" | 
| 62 | .\" This library is free for commercial and non-commercial use as long as | 62 | .\" This library is free for commercial and non-commercial use as long as | 
| 63 | .\" the following conditions are aheared to. The following conditions | 63 | .\" the following conditions are aheared to. The following conditions | 
| 64 | .\" apply to all code found in this distribution, be it the RC4, RSA, | 64 | .\" apply to all code found in this distribution, be it the RC4, RSA, | 
| 65 | .\" lhash, DES, etc., code; not just the SSL code. The SSL documentation | 65 | .\" lhash, DES, etc., code; not just the SSL code. The SSL documentation | 
| 66 | .\" included with this distribution is covered by the same copyright terms | 66 | .\" included with this distribution is covered by the same copyright terms | 
| 67 | .\" except that the holder is Tim Hudson (tjh@cryptsoft.com). | 67 | .\" except that the holder is Tim Hudson (tjh@cryptsoft.com). | 
| 68 | .\" | 68 | .\" | 
| 69 | .\" Copyright remains Eric Young's, and as such any Copyright notices in | 69 | .\" Copyright remains Eric Young's, and as such any Copyright notices in | 
| 70 | .\" the code are not to be removed. | 70 | .\" the code are not to be removed. | 
| 71 | .\" If this package is used in a product, Eric Young should be given attribution | 71 | .\" If this package is used in a product, Eric Young should be given attribution | 
| 72 | .\" as the author of the parts of the library used. | 72 | .\" as the author of the parts of the library used. | 
| 73 | .\" This can be in the form of a textual message at program startup or | 73 | .\" This can be in the form of a textual message at program startup or | 
| 74 | .\" in documentation (online or textual) provided with the package. | 74 | .\" in documentation (online or textual) provided with the package. | 
| 75 | .\" | 75 | .\" | 
| 76 | .\" Redistribution and use in source and binary forms, with or without | 76 | .\" Redistribution and use in source and binary forms, with or without | 
| 77 | .\" modification, are permitted provided that the following conditions | 77 | .\" modification, are permitted provided that the following conditions | 
| 78 | .\" are met: | 78 | .\" are met: | 
| @@ -87,12 +87,12 @@ | |||
| 87 | .\" Eric Young (eay@cryptsoft.com)" | 87 | .\" Eric Young (eay@cryptsoft.com)" | 
| 88 | .\" The word 'cryptographic' can be left out if the rouines from the library | 88 | .\" The word 'cryptographic' can be left out if the rouines from the library | 
| 89 | .\" being used are not cryptographic related :-). | 89 | .\" being used are not cryptographic related :-). | 
| 90 | .\" 4. If you include any Windows specific code (or a derivative thereof) from | 90 | .\" 4. If you include any Windows specific code (or a derivative thereof) from | 
| 91 | .\" the apps directory (application code) you must include an | 91 | .\" the apps directory (application code) you must include an | 
| 92 | .\" acknowledgement: | 92 | .\" acknowledgement: | 
| 93 | .\" "This product includes software written by Tim Hudson | 93 | .\" "This product includes software written by Tim Hudson | 
| 94 | .\" (tjh@cryptsoft.com)" | 94 | .\" (tjh@cryptsoft.com)" | 
| 95 | .\" | 95 | .\" | 
| 96 | .\" THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND | 96 | .\" THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND | 
| 97 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | 97 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | 
| 98 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | 98 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | 
| @@ -104,7 +104,7 @@ | |||
| 104 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | 104 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | 
| 105 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 105 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 
| 106 | .\" SUCH DAMAGE. | 106 | .\" SUCH DAMAGE. | 
| 107 | .\" | 107 | .\" | 
| 108 | .\" The licence and distribution terms for any publically available version or | 108 | .\" The licence and distribution terms for any publically available version or | 
| 109 | .\" derivative of this code cannot be changed. i.e. this code cannot simply be | 109 | .\" derivative of this code cannot be changed. i.e. this code cannot simply be | 
| 110 | .\" copied and put under another distribution licence | 110 | .\" copied and put under another distribution licence | 
| @@ -148,14 +148,14 @@ program is a command line tool for using the various | |||
| 148 | cryptography functions of | 148 | cryptography functions of | 
| 149 | .Nm OpenSSL Ns Li 's | 149 | .Nm OpenSSL Ns Li 's | 
| 150 | .Em crypto | 150 | .Em crypto | 
| 151 | library from the shell. | 151 | library from the shell. | 
| 152 | It can be used for | 152 | It can be used for | 
| 153 | .Pp | 153 | .Pp | 
| 154 | .Bl -bullet -compact | 154 | .Bl -bullet -compact | 
| 155 | .It | 155 | .It | 
| 156 | Creation of RSA, DH and DSA key parameters | 156 | Creation of RSA, DH and DSA key parameters | 
| 157 | .It | 157 | .It | 
| 158 | Creation of X.509 certificates, CSRs and CRLs | 158 | Creation of X.509 certificates, CSRs and CRLs | 
| 159 | .It | 159 | .It | 
| 160 | Calculation of Message Digests | 160 | Calculation of Message Digests | 
| 161 | .It | 161 | .It | 
| @@ -401,6 +401,7 @@ Read the password from the file descriptor | |||
| 401 | This can be used to send the data via a pipe for example. | 401 | This can be used to send the data via a pipe for example. | 
| 402 | .It Ar stdin | 402 | .It Ar stdin | 
| 403 | Read the password from standard input. | 403 | Read the password from standard input. | 
| 404 | .El | ||
| 404 | .\" | 405 | .\" | 
| 405 | .\" ASN1PARSE | 406 | .\" ASN1PARSE | 
| 406 | .\" | 407 | .\" | 
| @@ -423,7 +424,7 @@ command is a diagnostic utility that can parse ASN.1 structures. | |||
| 423 | It can also be used to extract data from ASN.1 formatted data. | 424 | It can also be used to extract data from ASN.1 formatted data. | 
| 424 | .Pp | 425 | .Pp | 
| 425 | The options are as follows: | 426 | The options are as follows: | 
| 426 | .Bl -tag -width Ds | 427 | .Bl -tag -width "XXXX" | 
| 427 | .It Fl inform Ar DER|PEM | 428 | .It Fl inform Ar DER|PEM | 
| 428 | The input format. | 429 | The input format. | 
| 429 | .Ar DER | 430 | .Ar DER | 
| @@ -457,25 +458,26 @@ section below. | |||
| 457 | Parse the contents octets of the ASN.1 object starting at | 458 | Parse the contents octets of the ASN.1 object starting at | 
| 458 | .Ar offset . | 459 | .Ar offset . | 
| 459 | This option can be used multiple times to "drill down" into a nested structure. | 460 | This option can be used multiple times to "drill down" into a nested structure. | 
| 461 | .El | ||
| 460 | .Sh ASN1PARSE OUTPUT | 462 | .Sh ASN1PARSE OUTPUT | 
| 461 | The output will typically contain lines like this: | 463 | The output will typically contain lines like this: | 
| 462 | .Pp | 464 | .Pp | 
| 463 | .Bd -literal | 465 | .Bd -literal | 
| 464 | 0:d=0 hl=4 l= 681 cons: SEQUENCE | 466 | 0:d=0 hl=4 l= 681 cons: SEQUENCE | 
| 465 | .Pp | 467 | |
| 466 | \&..... | 468 | \&..... | 
| 467 | .Pp | 469 | |
| 468 | 229:d=3 hl=3 l= 141 prim: BIT STRING | 470 | 229:d=3 hl=3 l= 141 prim: BIT STRING | 
| 469 | 373:d=2 hl=3 l= 162 cons: cont [ 3 ] | 471 | 373:d=2 hl=3 l= 162 cons: cont [ 3 ] | 
| 470 | 376:d=3 hl=3 l= 159 cons: SEQUENCE | 472 | 376:d=3 hl=3 l= 159 cons: SEQUENCE | 
| 471 | 379:d=4 hl=2 l= 29 cons: SEQUENCE | 473 | 379:d=4 hl=2 l= 29 cons: SEQUENCE | 
| 472 | 381:d=5 hl=2 l= 3 prim: OBJECT :X509v3 Subject Key Identifier | 474 | 381:d=5 hl=2 l= 3 prim: OBJECT :X509v3 Subject Key Identifier | 
| 473 | 386:d=5 hl=2 l= 22 prim: OCTET STRING | 475 | 386:d=5 hl=2 l= 22 prim: OCTET STRING | 
| 474 | 410:d=4 hl=2 l= 112 cons: SEQUENCE | 476 | 410:d=4 hl=2 l= 112 cons: SEQUENCE | 
| 475 | 412:d=5 hl=2 l= 3 prim: OBJECT :X509v3 Authority Key Identifier | 477 | 412:d=5 hl=2 l= 3 prim: OBJECT :X509v3 Authority Key Identifier | 
| 476 | 417:d=5 hl=2 l= 105 prim: OCTET STRING | 478 | 417:d=5 hl=2 l= 105 prim: OCTET STRING | 
| 477 | 524:d=4 hl=2 l= 12 cons: SEQUENCE | 479 | 524:d=4 hl=2 l= 12 cons: SEQUENCE | 
| 478 | .Pp | 480 | |
| 479 | \&..... | 481 | \&..... | 
| 480 | .Ed | 482 | .Ed | 
| 481 | .Pp | 483 | .Pp | 
| @@ -493,7 +495,7 @@ The | |||
| 493 | .Fl i | 495 | .Fl i | 
| 494 | option can be used to make the output more readable. | 496 | option can be used to make the output more readable. | 
| 495 | .Pp | 497 | .Pp | 
| 496 | Some knowledge of the ASN.1 structure is needed to interpret the output. | 498 | Some knowledge of the ASN.1 structure is needed to interpret the output. | 
| 497 | .Pp | 499 | .Pp | 
| 498 | In this example the BIT STRING at offset 229 is the certificate public key. | 500 | In this example the BIT STRING at offset 229 is the certificate public key. | 
| 499 | The contents octets of this will contain the public key information. | 501 | The contents octets of this will contain the public key information. | 
| @@ -502,9 +504,10 @@ This can be examined using the option | |||
| 502 | to yield: | 504 | to yield: | 
| 503 | .Pp | 505 | .Pp | 
| 504 | .Bd -literal | 506 | .Bd -literal | 
| 505 | \& 0:d=0 hl=3 l= 137 cons: SEQUENCE | 507 | \& 0:d=0 hl=3 l= 137 cons: SEQUENCE | 
| 506 | \& 3:d=1 hl=3 l= 129 prim: INTEGER :E5D21E1F5C8D208EA7A2166C7FAF9F6BDF2059669C60876DDB70840F1A5AAFA59699FE471F379F1DD6A487E7D5409AB6A88D4A9746E24B91D8CF55DB3521015460C8EDE44EE8A4189F7A7BE77D6CD3A9AF2696F486855CF58BF0EDF2B4068058C7A947F52548DDF7E15E96B385F86422BEA9064A3EE9E1158A56E4A6F47E5897 | 508 | \& 3:d=1 hl=3 l= 129 prim: INTEGER :E5D21E1F5C8D208EA7A2166C7FAF9F6BDF2059669C60876DDB70840F1A5AAFA59699FE471F379F1DD6A487E7D5409AB6A88D4A9746E24B91D8CF55DB3521015460C8EDE44EE8A4189F7A7BE77D6CD3A9AF2696F486855CF58BF0EDF2B4068058C7A947F52548DDF7E15E96B385F86422BEA9064A3EE9E1158A56E4A6F47E5897 | 
| 507 | \& 135:d=1 hl=2 l= 3 prim: INTEGER :010001 | 509 | \& 135:d=1 hl=2 l= 3 prim: INTEGER :010001 | 
| 510 | .Ed | ||
| 508 | .Sh ASN1PARSE NOTES | 511 | .Sh ASN1PARSE NOTES | 
| 509 | If an OID is not part of | 512 | If an OID is not part of | 
| 510 | .Nm OpenSSL Ns Li 's | 513 | .Nm OpenSSL Ns Li 's | 
| @@ -575,7 +578,7 @@ It also maintains a text database of issued certificates and their status. | |||
| 575 | .Pp | 578 | .Pp | 
| 576 | The options descriptions will be divided into each purpose. | 579 | The options descriptions will be divided into each purpose. | 
| 577 | .Sh CA OPTIONS | 580 | .Sh CA OPTIONS | 
| 578 | .Bl -tag -width Ds | 581 | .Bl -tag -width "XXXX" | 
| 579 | .It Fl config Ar filename | 582 | .It Fl config Ar filename | 
| 580 | Specifies the configuration file to use. | 583 | Specifies the configuration file to use. | 
| 581 | .It Fl name Ar section | 584 | .It Fl name Ar section | 
| @@ -600,7 +603,7 @@ See the | |||
| 600 | section for information on the required format. | 603 | section for information on the required format. | 
| 601 | .It Fl infiles | 604 | .It Fl infiles | 
| 602 | If present, this should be the last option; all subsequent arguments | 605 | If present, this should be the last option; all subsequent arguments | 
| 603 | are assumed to be the names of files containing certificate requests. | 606 | are assumed to be the names of files containing certificate requests. | 
| 604 | .It Fl out Ar filename | 607 | .It Fl out Ar filename | 
| 605 | The output file to output certificates to. | 608 | The output file to output certificates to. | 
| 606 | The default is standard output. | 609 | The default is standard output. | 
| @@ -707,7 +710,7 @@ to read certificate extensions from | |||
| 707 | option is also used). | 710 | option is also used). | 
| 708 | .El | 711 | .El | 
| 709 | .Sh CRL OPTIONS | 712 | .Sh CRL OPTIONS | 
| 710 | .Bl -tag -width Ds | 713 | .Bl -tag -width "XXXX" | 
| 711 | .It Fl gencrl | 714 | .It Fl gencrl | 
| 712 | This option generates a CRL based on information in the index file. | 715 | This option generates a CRL based on information in the index file. | 
| 713 | .It Fl crldays Ar num | 716 | .It Fl crldays Ar num | 
| @@ -739,7 +742,7 @@ The CRL extensions specified are CRL extensions and | |||
| 739 | .Em not | 742 | .Em not | 
| 740 | CRL entry extensions. | 743 | CRL entry extensions. | 
| 741 | It should be noted that some software (for example Netscape) | 744 | It should be noted that some software (for example Netscape) | 
| 742 | can't handle V2 CRLs. | 745 | can't handle V2 CRLs. | 
| 743 | .El | 746 | .El | 
| 744 | .Sh CA CONFIGURATION FILE OPTIONS | 747 | .Sh CA CONFIGURATION FILE OPTIONS | 
| 745 | The section of the configuration file containing options for | 748 | The section of the configuration file containing options for | 
| @@ -774,12 +777,12 @@ the command line value is used. | |||
| 774 | Where an option is described as mandatory, then it must be present in | 777 | Where an option is described as mandatory, then it must be present in | 
| 775 | the configuration file or the command line equivalent (if any) used. | 778 | the configuration file or the command line equivalent (if any) used. | 
| 776 | .Pp | 779 | .Pp | 
| 777 | .Bl -tag -width Ds | 780 | .Bl -tag -width "XXXX" | 
| 778 | .It Ar oid_file | 781 | .It Ar oid_file | 
| 779 | This specifies a file containing additional OBJECT IDENTIFIERS. | 782 | This specifies a file containing additional OBJECT IDENTIFIERS. | 
| 780 | Each line of the file should consist of the numerical form of the | 783 | Each line of the file should consist of the numerical form of the | 
| 781 | object identifier followed by whitespace, then the short name followed | 784 | object identifier followed by whitespace, then the short name followed | 
| 782 | by whitespace and finally the long name. | 785 | by whitespace and finally the long name. | 
| 783 | .It Ar oid_section | 786 | .It Ar oid_section | 
| 784 | This specifies a section in the configuration file containing extra | 787 | This specifies a section in the configuration file containing extra | 
| 785 | object identifiers. | 788 | object identifiers. | 
| @@ -813,7 +816,7 @@ or an EGD socket (see | |||
| 813 | The same as the | 816 | The same as the | 
| 814 | .Fl days | 817 | .Fl days | 
| 815 | option. | 818 | option. | 
| 816 | The number of days to certify a certificate for. | 819 | The number of days to certify a certificate for. | 
| 817 | .It Ar default_startdate | 820 | .It Ar default_startdate | 
| 818 | The same as the | 821 | The same as the | 
| 819 | .Fl startdate | 822 | .Fl startdate | 
| @@ -945,7 +948,7 @@ The input to the | |||
| 945 | command line option is a Netscape signed public key and challenge. | 948 | command line option is a Netscape signed public key and challenge. | 
| 946 | This will usually come from the | 949 | This will usually come from the | 
| 947 | .Em KEYGEN | 950 | .Em KEYGEN | 
| 948 | tag in an HTML form to create a new private key. | 951 | tag in an HTML form to create a new private key. | 
| 949 | It is, however, possible to create SPKACs using the | 952 | It is, however, possible to create SPKACs using the | 
| 950 | .Nm spkac | 953 | .Nm spkac | 
| 951 | utility. | 954 | utility. | 
| @@ -1192,7 +1195,7 @@ cipher lists into ordered SSL cipher preference lists. | |||
| 1192 | It can be used as a test tool to determine the appropriate cipherlist. | 1195 | It can be used as a test tool to determine the appropriate cipherlist. | 
| 1193 | .Pp | 1196 | .Pp | 
| 1194 | The options are as follows: | 1197 | The options are as follows: | 
| 1195 | .Bl -tag -width -Ds | 1198 | .Bl -tag -width "XXXX" | 
| 1196 | .It Fl v | 1199 | .It Fl v | 
| 1197 | Verbose option. | 1200 | Verbose option. | 
| 1198 | List ciphers with a complete description of protocol version | 1201 | List ciphers with a complete description of protocol version | 
| @@ -1285,7 +1288,7 @@ can be used at any point to sort the current cipher list in order of | |||
| 1285 | encryption algorithm key length. | 1288 | encryption algorithm key length. | 
| 1286 | .Sh CIPHERS STRINGS | 1289 | .Sh CIPHERS STRINGS | 
| 1287 | The following is a list of all permitted cipher strings and their meanings. | 1290 | The following is a list of all permitted cipher strings and their meanings. | 
| 1288 | .Bl -tag -width Ds | 1291 | .Bl -tag -width "XXXX" | 
| 1289 | .It Ar DEFAULT | 1292 | .It Ar DEFAULT | 
| 1290 | The default cipher list. | 1293 | The default cipher list. | 
| 1291 | This is determined at compile time and is normally | 1294 | This is determined at compile time and is normally | 
| @@ -1482,8 +1485,8 @@ These ciphers can also be used in SSL v3. | |||
| 1482 | .Ed | 1485 | .Ed | 
| 1483 | .Pp | 1486 | .Pp | 
| 1484 | .Cm SSL v2.0 cipher suites | 1487 | .Cm SSL v2.0 cipher suites | 
| 1485 | .Bd -literal | ||
| 1486 | .Pp | 1488 | .Pp | 
| 1489 | .Bd -literal | ||
| 1487 | \& SSL_CK_RC4_128_WITH_MD5 RC4-MD5 | 1490 | \& SSL_CK_RC4_128_WITH_MD5 RC4-MD5 | 
| 1488 | \& SSL_CK_RC4_128_EXPORT40_WITH_MD5 EXP-RC4-MD5 | 1491 | \& SSL_CK_RC4_128_EXPORT40_WITH_MD5 EXP-RC4-MD5 | 
| 1489 | \& SSL_CK_RC2_128_CBC_WITH_MD5 RC2-MD5 | 1492 | \& SSL_CK_RC2_128_CBC_WITH_MD5 RC2-MD5 | 
| @@ -1559,7 +1562,7 @@ or | |||
| 1559 | format. | 1562 | format. | 
| 1560 | .Pp | 1563 | .Pp | 
| 1561 | The options are as follows: | 1564 | The options are as follows: | 
| 1562 | .Bl -tag -width Ds | 1565 | .Bl -tag -width "XXXX" | 
| 1563 | .It Fl inform Ar DER|PEM | 1566 | .It Fl inform Ar DER|PEM | 
| 1564 | This specifies the input format. | 1567 | This specifies the input format. | 
| 1565 | .Ar DER | 1568 | .Ar DER | 
| @@ -1568,7 +1571,7 @@ format is DER encoded CRL structure. | |||
| 1568 | (the default) is a base64 encoded version of the DER form with header | 1571 | (the default) is a base64 encoded version of the DER form with header | 
| 1569 | and footer lines. | 1572 | and footer lines. | 
| 1570 | .It Fl outform Ar DER|PEM | 1573 | .It Fl outform Ar DER|PEM | 
| 1571 | This specifies the output format; the options have the same meaning as the | 1574 | This specifies the output format; the options have the same meaning as the | 
| 1572 | .Fl inform | 1575 | .Fl inform | 
| 1573 | option. | 1576 | option. | 
| 1574 | .It Fl in Ar filename | 1577 | .It Fl in Ar filename | 
| @@ -1647,7 +1650,7 @@ certificates and converts them into a PKCS#7 degenerate | |||
| 1647 | "certificates only" structure. | 1650 | "certificates only" structure. | 
| 1648 | .Pp | 1651 | .Pp | 
| 1649 | The options are as follows: | 1652 | The options are as follows: | 
| 1650 | .Bl -tag -width Ds | 1653 | .Bl -tag -width "XXXX" | 
| 1651 | .It Fl inform Ar DER|PEM | 1654 | .It Fl inform Ar DER|PEM | 
| 1652 | This specifies the CRL input format. | 1655 | This specifies the CRL input format. | 
| 1653 | .Ar DER | 1656 | .Ar DER | 
| @@ -1695,7 +1698,7 @@ format with no CRL from several | |||
| 1695 | different certificates: | 1698 | different certificates: | 
| 1696 | .Pp | 1699 | .Pp | 
| 1697 | .Bd -literal | 1700 | .Bd -literal | 
| 1698 | \& $ openssl crl2pkcs7 -nocrl -certfile newcert.pem | 1701 | \& $ openssl crl2pkcs7 -nocrl -certfile newcert.pem | 
| 1699 | \& -certfile demoCA/cacert.pem -outform DER -out p7.der | 1702 | \& -certfile demoCA/cacert.pem -outform DER -out p7.der | 
| 1700 | .Ed | 1703 | .Ed | 
| 1701 | .Sh CRL2PKCS7 NOTES | 1704 | .Sh CRL2PKCS7 NOTES | 
| @@ -1743,7 +1746,7 @@ in hexadecimal form. | |||
| 1743 | They can also be used for digital signing and verification. | 1746 | They can also be used for digital signing and verification. | 
| 1744 | .Pp | 1747 | .Pp | 
| 1745 | The options are as follows: | 1748 | The options are as follows: | 
| 1746 | .Bl -tag -width Ds | 1749 | .Bl -tag -width "XXXX" | 
| 1747 | .It Fl c | 1750 | .It Fl c | 
| 1748 | Print out the digest in two digit groups separated by colons, only relevant if | 1751 | Print out the digest in two digit groups separated by colons, only relevant if | 
| 1749 | .Em hex | 1752 | .Em hex | 
| @@ -1783,7 +1786,7 @@ for MS-Windows, | |||
| 1783 | .Cm \&, | 1786 | .Cm \&, | 
| 1784 | for OpenVMS, and | 1787 | for OpenVMS, and | 
| 1785 | .Cm \&: | 1788 | .Cm \&: | 
| 1786 | for all others. | 1789 | for all others. | 
| 1787 | .It Fl signature Ar filename | 1790 | .It Fl signature Ar filename | 
| 1788 | The actual signature to verify. | 1791 | The actual signature to verify. | 
| 1789 | .It Ar file ... | 1792 | .It Ar file ... | 
| @@ -1838,7 +1841,7 @@ The | |||
| 1838 | command is used to manipulate DH parameter files. | 1841 | command is used to manipulate DH parameter files. | 
| 1839 | .Pp | 1842 | .Pp | 
| 1840 | The options are as follows: | 1843 | The options are as follows: | 
| 1841 | .Bl -tag -width Ds | 1844 | .Bl -tag -width "XXXX" | 
| 1842 | .It Fl inform Ar DER|PEM | 1845 | .It Fl inform Ar DER|PEM | 
| 1843 | This specifies the input format. | 1846 | This specifies the input format. | 
| 1844 | The argument | 1847 | The argument | 
| @@ -1851,7 +1854,7 @@ form is the default format: | |||
| 1851 | it consists of the DER format base64 encoded with | 1854 | it consists of the DER format base64 encoded with | 
| 1852 | additional header and footer lines. | 1855 | additional header and footer lines. | 
| 1853 | .It Fl outform Ar DER|PEM | 1856 | .It Fl outform Ar DER|PEM | 
| 1854 | This specifies the output format, the options have the same meaning as the | 1857 | This specifies the output format, the options have the same meaning as the | 
| 1855 | .Fl inform | 1858 | .Fl inform | 
| 1856 | option. | 1859 | option. | 
| 1857 | .It Fl in Ar filename | 1860 | .It Fl in Ar filename | 
| @@ -1905,7 +1908,7 @@ This argument specifies that a parameter set should be generated of size | |||
| 1905 | .Ar numbits . | 1908 | .Ar numbits . | 
| 1906 | It must be the last option. | 1909 | It must be the last option. | 
| 1907 | If not present, then a value of 512 is used. | 1910 | If not present, then a value of 512 is used. | 
| 1908 | If this value is present then the input file is ignored and | 1911 | If this value is present then the input file is ignored and | 
| 1909 | parameters are generated instead. | 1912 | parameters are generated instead. | 
| 1910 | .It Fl noout | 1913 | .It Fl noout | 
| 1911 | This option inhibits the output of the encoded version of the parameters. | 1914 | This option inhibits the output of the encoded version of the parameters. | 
| @@ -1916,6 +1919,7 @@ This option converts the parameters into C code. | |||
| 1916 | The parameters can then be loaded by calling the | 1919 | The parameters can then be loaded by calling the | 
| 1917 | .Cm get_dh Ns Ar numbits Ns Li () | 1920 | .Cm get_dh Ns Ar numbits Ns Li () | 
| 1918 | function. | 1921 | function. | 
| 1922 | .El | ||
| 1919 | .Sh DHPARAM WARNINGS | 1923 | .Sh DHPARAM WARNINGS | 
| 1920 | The program | 1924 | The program | 
| 1921 | .Nm dhparam | 1925 | .Nm dhparam | 
| @@ -1931,7 +1935,7 @@ The | |||
| 1931 | .Nm dh | 1935 | .Nm dh | 
| 1932 | and | 1936 | and | 
| 1933 | .Nm gendh | 1937 | .Nm gendh | 
| 1934 | programs are retained for now, but may have different purposes in future | 1938 | programs are retained for now, but may have different purposes in future | 
| 1935 | versions of | 1939 | versions of | 
| 1936 | .Nm OpenSSL . | 1940 | .Nm OpenSSL . | 
| 1937 | .Sh DHPARAM NOTES | 1941 | .Sh DHPARAM NOTES | 
| @@ -1997,7 +2001,7 @@ newer applications should use the more secure PKCS#8 format using the | |||
| 1997 | command. | 2001 | command. | 
| 1998 | .Pp | 2002 | .Pp | 
| 1999 | The options are as follows: | 2003 | The options are as follows: | 
| 2000 | .Bl -tag -width Ds | 2004 | .Bl -tag -width "XXXX" | 
| 2001 | .It Fl inform Ar DER|PEM | 2005 | .It Fl inform Ar DER|PEM | 
| 2002 | This specifies the input format. | 2006 | This specifies the input format. | 
| 2003 | The | 2007 | The | 
| @@ -2017,7 +2021,7 @@ It consists of the DER format base64 | |||
| 2017 | encoded with additional header and footer lines. | 2021 | encoded with additional header and footer lines. | 
| 2018 | In the case of a private key, PKCS#8 format is also accepted. | 2022 | In the case of a private key, PKCS#8 format is also accepted. | 
| 2019 | .It Fl outform Ar DER|PEM | 2023 | .It Fl outform Ar DER|PEM | 
| 2020 | This specifies the output format, the options have the same meaning as the | 2024 | This specifies the output format, the options have the same meaning as the | 
| 2021 | .Fl inform | 2025 | .Fl inform | 
| 2022 | option. | 2026 | option. | 
| 2023 | .It Fl in Ar filename | 2027 | .It Fl in Ar filename | 
| @@ -2049,7 +2053,7 @@ see the | |||
| 2049 | .Sx PASS PHRASE ARGUMENTS | 2053 | .Sx PASS PHRASE ARGUMENTS | 
| 2050 | section above. | 2054 | section above. | 
| 2051 | .It Cm -des|-des3|-idea | 2055 | .It Cm -des|-des3|-idea | 
| 2052 | These options encrypt the private key with the DES, triple DES, or the | 2056 | These options encrypt the private key with the DES, triple DES, or the | 
| 2053 | IDEA ciphers, respectively, before outputting it. | 2057 | IDEA ciphers, respectively, before outputting it. | 
| 2054 | A pass phrase is prompted for. | 2058 | A pass phrase is prompted for. | 
| 2055 | If none of these options is specified, the key is written in plain text. | 2059 | If none of these options is specified, the key is written in plain text. | 
| @@ -2075,6 +2079,7 @@ With this option a public key is read instead. | |||
| 2075 | By default a private key is output. | 2079 | By default a private key is output. | 
| 2076 | With this option a public key will be output instead. | 2080 | With this option a public key will be output instead. | 
| 2077 | This option is automatically set if the input is a public key. | 2081 | This option is automatically set if the input is a public key. | 
| 2082 | .El | ||
| 2078 | .Sh DSA NOTES | 2083 | .Sh DSA NOTES | 
| 2079 | The | 2084 | The | 
| 2080 | .Ar PEM | 2085 | .Ar PEM | 
| @@ -2102,7 +2107,7 @@ To encrypt a private key using triple DES: | |||
| 2102 | .Pp | 2107 | .Pp | 
| 2103 | \& $ openssl dsa -in key.pem -des3 -out keyout.pem | 2108 | \& $ openssl dsa -in key.pem -des3 -out keyout.pem | 
| 2104 | .Pp | 2109 | .Pp | 
| 2105 | To convert a private key from PEM to DER format: | 2110 | To convert a private key from PEM to DER format: | 
| 2106 | .Pp | 2111 | .Pp | 
| 2107 | \& $ openssl dsa -in key.pem -outform DER -out keyout.der | 2112 | \& $ openssl dsa -in key.pem -outform DER -out keyout.der | 
| 2108 | .Pp | 2113 | .Pp | 
| @@ -2134,7 +2139,7 @@ The | |||
| 2134 | command is used to manipulate or generate \s-1DSA\s0 parameter files. | 2139 | command is used to manipulate or generate \s-1DSA\s0 parameter files. | 
| 2135 | .Pp | 2140 | .Pp | 
| 2136 | The options are as follows: | 2141 | The options are as follows: | 
| 2137 | .Bl -tag -width Ds | 2142 | .Bl -tag -width "XXXX" | 
| 2138 | .It Fl inform Ar DER|PEM | 2143 | .It Fl inform Ar DER|PEM | 
| 2139 | This specifies the input format. | 2144 | This specifies the input format. | 
| 2140 | The | 2145 | The | 
| @@ -2147,7 +2152,7 @@ form is the default format: | |||
| 2147 | it consists of the DER format base64 encoded with additional header | 2152 | it consists of the DER format base64 encoded with additional header | 
| 2148 | and footer lines. | 2153 | and footer lines. | 
| 2149 | .It Fl outform Ar DER|PEM | 2154 | .It Fl outform Ar DER|PEM | 
| 2150 | This specifies the output format; the options have the same meaning as the | 2155 | This specifies the output format; the options have the same meaning as the | 
| 2151 | .Fl inform | 2156 | .Fl inform | 
| 2152 | option. | 2157 | option. | 
| 2153 | .It Fl in Ar filename | 2158 | .It Fl in Ar filename | 
| @@ -2239,7 +2244,7 @@ or explicitly provided. Base64 encoding or decoding can also be performed | |||
| 2239 | either by itself or in addition to the encryption or decryption. | 2244 | either by itself or in addition to the encryption or decryption. | 
| 2240 | .Pp | 2245 | .Pp | 
| 2241 | The options are as follows: | 2246 | The options are as follows: | 
| 2242 | .Bl -tag -width Ds | 2247 | .Bl -tag -width "XXXX" | 
| 2243 | .It Fl in Ar filename | 2248 | .It Fl in Ar filename | 
| 2244 | The input | 2249 | The input | 
| 2245 | .Ar filename , | 2250 | .Ar filename , | 
| @@ -2584,7 +2589,7 @@ command generates a DSA private key from a DSA parameter file | |||
| 2584 | command). | 2589 | command). | 
| 2585 | .Pp | 2590 | .Pp | 
| 2586 | The options are as follows: | 2591 | The options are as follows: | 
| 2587 | .Bl -tag -width Ds | 2592 | .Bl -tag -width "XXXX" | 
| 2588 | .It Cm -des|-des3|-idea | 2593 | .It Cm -des|-des3|-idea | 
| 2589 | These options encrypt the private key with the DES, triple DES, | 2594 | These options encrypt the private key with the DES, triple DES, | 
| 2590 | or the IDEA ciphers, respectively, before outputting it. | 2595 | or the IDEA ciphers, respectively, before outputting it. | 
| @@ -2612,6 +2617,7 @@ The parameters in this file determine the size of the private key. | |||
| 2612 | DSA parameters can be generated and examined using the | 2617 | DSA parameters can be generated and examined using the | 
| 2613 | .Nm openssl dsaparam | 2618 | .Nm openssl dsaparam | 
| 2614 | command. | 2619 | command. | 
| 2620 | .El | ||
| 2615 | .Sh GENDSA NOTES | 2621 | .Sh GENDSA NOTES | 
| 2616 | DSA key generation is little more than random number generation so it is | 2622 | DSA key generation is little more than random number generation so it is | 
| 2617 | much quicker that RSA key generation for example. | 2623 | much quicker that RSA key generation for example. | 
| @@ -2635,7 +2641,7 @@ The | |||
| 2635 | command generates an RSA private key. | 2641 | command generates an RSA private key. | 
| 2636 | .Pp | 2642 | .Pp | 
| 2637 | The options are as follows: | 2643 | The options are as follows: | 
| 2638 | .Bl -tag -width Ds | 2644 | .Bl -tag -width "XXXX" | 
| 2639 | .It Fl out Ar filename | 2645 | .It Fl out Ar filename | 
| 2640 | The output | 2646 | The output | 
| 2641 | .Ar filename . | 2647 | .Ar filename . | 
| @@ -2648,7 +2654,7 @@ see the | |||
| 2648 | .Sx PASS PHRASE ARGUMENTS | 2654 | .Sx PASS PHRASE ARGUMENTS | 
| 2649 | section above. | 2655 | section above. | 
| 2650 | .It Cm -des|-des3|-idea | 2656 | .It Cm -des|-des3|-idea | 
| 2651 | These options encrypt the private key with the DES, triple DES, or the | 2657 | These options encrypt the private key with the DES, triple DES, or the | 
| 2652 | IDEA ciphers, respectively, before outputting it. | 2658 | IDEA ciphers, respectively, before outputting it. | 
| 2653 | If none of these options is specified, no encryption is used. | 2659 | If none of these options is specified, no encryption is used. | 
| 2654 | If encryption is used a pass phrase is prompted for, | 2660 | If encryption is used a pass phrase is prompted for, | 
| @@ -2678,6 +2684,7 @@ for all others. | |||
| 2678 | The size of the private key to generate in bits. | 2684 | The size of the private key to generate in bits. | 
| 2679 | This must be the last option specified. | 2685 | This must be the last option specified. | 
| 2680 | The default is 512. | 2686 | The default is 512. | 
| 2687 | .El | ||
| 2681 | .Sh GENRSA NOTES | 2688 | .Sh GENRSA NOTES | 
| 2682 | RSA private key generation essentially involves the generation of two prime | 2689 | RSA private key generation essentially involves the generation of two prime | 
| 2683 | numbers. | 2690 | numbers. | 
| @@ -2716,7 +2723,7 @@ file of certificates and converts it into a Netscape certificate | |||
| 2716 | sequence. | 2723 | sequence. | 
| 2717 | .Pp | 2724 | .Pp | 
| 2718 | The options are as follows: | 2725 | The options are as follows: | 
| 2719 | .Bl -tag -width Ds | 2726 | .Bl -tag -width "XXXX" | 
| 2720 | .It Fl in Ar filename | 2727 | .It Fl in Ar filename | 
| 2721 | This specifies the input | 2728 | This specifies the input | 
| 2722 | .Ar filename | 2729 | .Ar filename | 
| @@ -2818,7 +2825,7 @@ create requests and send queries to an OCSP responder and behave like | |||
| 2818 | a mini OCSP server itself. | 2825 | a mini OCSP server itself. | 
| 2819 | .Pp | 2826 | .Pp | 
| 2820 | The options are as follows: | 2827 | The options are as follows: | 
| 2821 | .Bl -tag -width Ds | 2828 | .Bl -tag -width "XXXX" | 
| 2822 | .It Fl out Ar filename | 2829 | .It Fl out Ar filename | 
| 2823 | Specify output | 2830 | Specify output | 
| 2824 | .Ar filename , | 2831 | .Ar filename , | 
| @@ -2997,7 +3004,7 @@ By default this additional check is not performed. | |||
| 2997 | .El | 3004 | .El | 
| 2998 | .Sh OCSP SERVER OPTIONS | 3005 | .Sh OCSP SERVER OPTIONS | 
| 2999 | .Pp | 3006 | .Pp | 
| 3000 | .Bl -tag -with DS | 3007 | .Bl -tag -width "XXXX" | 
| 3001 | .It Fl index Ar indexfile | 3008 | .It Fl index Ar indexfile | 
| 3002 | .Ar indexfile | 3009 | .Ar indexfile | 
| 3003 | is a text index file in | 3010 | is a text index file in | 
| @@ -3058,7 +3065,7 @@ option. | |||
| 3058 | .It Fl nrequest Ar number | 3065 | .It Fl nrequest Ar number | 
| 3059 | The OCSP server will exit after receiving | 3066 | The OCSP server will exit after receiving | 
| 3060 | .Ar number | 3067 | .Ar number | 
| 3061 | requests, default unlimited. | 3068 | requests, default unlimited. | 
| 3062 | .It Fl nmin Ar minutes , Fl ndays Ar days | 3069 | .It Fl nmin Ar minutes , Fl ndays Ar days | 
| 3063 | Number of | 3070 | Number of | 
| 3064 | .Ar minutes | 3071 | .Ar minutes | 
| @@ -3240,7 +3247,7 @@ and its Apache variant | |||
| 3240 | are available. | 3247 | are available. | 
| 3241 | .Pp | 3248 | .Pp | 
| 3242 | The options are as follows: | 3249 | The options are as follows: | 
| 3243 | .Bl -tag -width Ds | 3250 | .Bl -tag -width "XXXX" | 
| 3244 | .It Fl crypt | 3251 | .It Fl crypt | 
| 3245 | Use the | 3252 | Use the | 
| 3246 | .Em crypt | 3253 | .Em crypt | 
| @@ -3273,7 +3280,7 @@ to each password hash. | |||
| 3273 | .El | 3280 | .El | 
| 3274 | .Sh PASSWD EXAMPLES | 3281 | .Sh PASSWD EXAMPLES | 
| 3275 | .Pp | 3282 | .Pp | 
| 3276 | .Bl -tag -width Ds | 3283 | .Bl -tag -width "XXXX" | 
| 3277 | .It $ openssl passwd -crypt -salt xx password | 3284 | .It $ openssl passwd -crypt -salt xx password | 
| 3278 | prints | 3285 | prints | 
| 3279 | .Em xxj31ZMTZzkVA . | 3286 | .Em xxj31ZMTZzkVA . | 
| @@ -3283,6 +3290,7 @@ prints | |||
| 3283 | .It $ openssl passwd -apr1 -salt xxxxxxxx password | 3290 | .It $ openssl passwd -apr1 -salt xxxxxxxx password | 
| 3284 | prints | 3291 | prints | 
| 3285 | .Em $apr1$xxxxxxxx$dxHfLAsjHkDRmG83UXe8K0 . | 3292 | .Em $apr1$xxxxxxxx$dxHfLAsjHkDRmG83UXe8K0 . | 
| 3293 | .El | ||
| 3286 | .\" | 3294 | .\" | 
| 3287 | .\" PKCS7 | 3295 | .\" PKCS7 | 
| 3288 | .\" | 3296 | .\" | 
| @@ -3308,7 +3316,7 @@ or | |||
| 3308 | format. | 3316 | format. | 
| 3309 | .Pp | 3317 | .Pp | 
| 3310 | The options are as follows: | 3318 | The options are as follows: | 
| 3311 | .Bl -tag -width Ds | 3319 | .Bl -tag -width "XXXX" | 
| 3312 | .It Fl inform Ar DER|PEM | 3320 | .It Fl inform Ar DER|PEM | 
| 3313 | This specifies the input format. | 3321 | This specifies the input format. | 
| 3314 | .Ar DER | 3322 | .Ar DER | 
| @@ -3317,7 +3325,7 @@ format is DER encoded PKCS#7 v1.5 structure. | |||
| 3317 | (the default) is a base64 encoded version of the DER form with header | 3325 | (the default) is a base64 encoded version of the DER form with header | 
| 3318 | and footer lines. | 3326 | and footer lines. | 
| 3319 | .It Fl outform Ar DER|PEM | 3327 | .It Fl outform Ar DER|PEM | 
| 3320 | This specifies the output format, the options have the same meaning as the | 3328 | This specifies the output format, the options have the same meaning as the | 
| 3321 | .Fl inform | 3329 | .Fl inform | 
| 3322 | option. | 3330 | option. | 
| 3323 | .It Fl in Ar filename | 3331 | .It Fl in Ar filename | 
| @@ -3339,6 +3347,7 @@ Don't output the encoded version of the PKCS#7 structure | |||
| 3339 | (or certificates if | 3347 | (or certificates if | 
| 3340 | .Fl print_certs | 3348 | .Fl print_certs | 
| 3341 | is set). | 3349 | is set). | 
| 3350 | .El | ||
| 3342 | .Sh PKCS7 EXAMPLES | 3351 | .Sh PKCS7 EXAMPLES | 
| 3343 | Convert a PKCS#7 file from | 3352 | Convert a PKCS#7 file from | 
| 3344 | .Em PEM | 3353 | .Em PEM | 
| @@ -3401,7 +3410,7 @@ and EncryptedPrivateKeyInfo format with a variety of PKCS#5 | |||
| 3401 | (v1.5 and v2.0) and PKCS#12 algorithms. | 3410 | (v1.5 and v2.0) and PKCS#12 algorithms. | 
| 3402 | .Pp | 3411 | .Pp | 
| 3403 | The options are as follows: | 3412 | The options are as follows: | 
| 3404 | .Bl -tag -width Ds | 3413 | .Bl -tag -width "XXXX" | 
| 3405 | .It Fl topk8 | 3414 | .It Fl topk8 | 
| 3406 | Normally a PKCS#8 private key is expected on input and a traditional format | 3415 | Normally a PKCS#8 private key is expected on input and a traditional format | 
| 3407 | private key will be written. | 3416 | private key will be written. | 
| @@ -3423,7 +3432,7 @@ or | |||
| 3423 | .Em PEM | 3432 | .Em PEM | 
| 3424 | format of the traditional format private key is used. | 3433 | format of the traditional format private key is used. | 
| 3425 | .It Fl outform Ar DER|PEM | 3434 | .It Fl outform Ar DER|PEM | 
| 3426 | This specifies the output format, the options have the same meaning as the | 3435 | This specifies the output format, the options have the same meaning as the | 
| 3427 | .Fl inform | 3436 | .Fl inform | 
| 3428 | option. | 3437 | option. | 
| 3429 | .It Fl in Ar filename | 3438 | .It Fl in Ar filename | 
| @@ -3513,6 +3522,7 @@ is used. | |||
| 3513 | .It Fl v1 Ar alg | 3522 | .It Fl v1 Ar alg | 
| 3514 | This option specifies a PKCS#5 v1.5 or PKCS#12 algorithm to use. | 3523 | This option specifies a PKCS#5 v1.5 or PKCS#12 algorithm to use. | 
| 3515 | A complete list of possible algorithms is included below. | 3524 | A complete list of possible algorithms is included below. | 
| 3525 | .El | ||
| 3516 | .Sh PKCS8 NOTES | 3526 | .Sh PKCS8 NOTES | 
| 3517 | The encrypted form of a | 3527 | The encrypted form of a | 
| 3518 | .Em PEM | 3528 | .Em PEM | 
| @@ -3557,23 +3567,20 @@ Various algorithms can be used with the | |||
| 3557 | command line option, including PKCS#5 v1.5 and PKCS#12. | 3567 | command line option, including PKCS#5 v1.5 and PKCS#12. | 
| 3558 | These are described in more detail below. | 3568 | These are described in more detail below. | 
| 3559 | .Pp | 3569 | .Pp | 
| 3560 | .Bd -literal -offset indent | 3570 | .Bl -tag -width "XXXX" | 
| 3561 | .It Ar \ \ PBE-MD2-DES PBE-MD5-DES | 3571 | .It Ar PBE-MD2-DES PBE-MD5-DES | 
| 3562 | .br | ||
| 3563 | These algorithms were included in the original PKCS#5 v1.5 specification. | 3572 | These algorithms were included in the original PKCS#5 v1.5 specification. | 
| 3564 | They only offer 56 bits of protection since they both use DES. | 3573 | They only offer 56 bits of protection since they both use DES. | 
| 3565 | .It Ar \ \ PBE-SHA1-RC2-64 PBE-MD2-RC2-64 PBE-MD5-RC2-64 PBE-SHA1-DES | 3574 | .It Ar PBE-SHA1-RC2-64 PBE-MD2-RC2-64 PBE-MD5-RC2-64 PBE-SHA1-DES | 
| 3566 | .br | ||
| 3567 | These algorithms are not mentioned in the original PKCS#5 v1.5 specification | 3575 | These algorithms are not mentioned in the original PKCS#5 v1.5 specification | 
| 3568 | but they use the same key derivation algorithm and are supported by some | 3576 | but they use the same key derivation algorithm and are supported by some | 
| 3569 | software. | 3577 | software. | 
| 3570 | They are mentioned in PKCS#5 v2.0. | 3578 | They are mentioned in PKCS#5 v2.0. | 
| 3571 | They use either 64 bit RC2 or 56 bit DES. | 3579 | They use either 64 bit RC2 or 56 bit DES. | 
| 3572 | .It Ar \ \ PBE-SHA1-RC4-128 PBE-SHA1-RC4-40 PBE-SHA1-3DES PBE-SHA1-2DES PBE-SHA1-RC2-128 PBE-SHA1-RC2-40 | 3580 | .It Ar PBE-SHA1-RC4-128 PBE-SHA1-RC4-40 PBE-SHA1-3DES PBE-SHA1-2DES PBE-SHA1-RC2-128 PBE-SHA1-RC2-40 | 
| 3573 | .br | ||
| 3574 | These algorithms use the PKCS#12 password based encryption algorithm and | 3581 | These algorithms use the PKCS#12 password based encryption algorithm and | 
| 3575 | allow strong encryption algorithms like triple DES or 128 bit RC2 to be used. | 3582 | allow strong encryption algorithms like triple DES or 128 bit RC2 to be used. | 
| 3576 | .Ed | 3583 | .El | 
| 3577 | .Sh PKCS8 EXAMPLES | 3584 | .Sh PKCS8 EXAMPLES | 
| 3578 | Convert a private from traditional to PKCS#5 v2.0 format using triple DES: | 3585 | Convert a private from traditional to PKCS#5 v2.0 format using triple DES: | 
| 3579 | .Pp | 3586 | .Pp | 
| @@ -3665,7 +3672,7 @@ a PKCS#12 file can be created by using the | |||
| 3665 | .Fl export | 3672 | .Fl export | 
| 3666 | option (see below). | 3673 | option (see below). | 
| 3667 | .Sh PKCS12 PARSING OPTIONS | 3674 | .Sh PKCS12 PARSING OPTIONS | 
| 3668 | .Bd -ragged -offset indent | 3675 | .Bl -tag -width "XXXX" | 
| 3669 | .It Fl in Ar filename | 3676 | .It Fl in Ar filename | 
| 3670 | This specifies the | 3677 | This specifies the | 
| 3671 | .Ar filename | 3678 | .Ar filename | 
| @@ -3720,9 +3727,9 @@ Don't attempt to verify the integrity MAC before reading the file. | |||
| 3720 | Prompt for separate integrity and encryption passwords: most software | 3727 | Prompt for separate integrity and encryption passwords: most software | 
| 3721 | always assumes these are the same so this option will render such | 3728 | always assumes these are the same so this option will render such | 
| 3722 | PKCS#12 files unreadable. | 3729 | PKCS#12 files unreadable. | 
| 3723 | .Ed | 3730 | .El | 
| 3724 | .Sh PKCS12 FILE CREATION OPTIONS | 3731 | .Sh PKCS12 FILE CREATION OPTIONS | 
| 3725 | .Bd -ragged -offset indent | 3732 | .Bl -tag -width "XXXX" | 
| 3726 | .It Fl export | 3733 | .It Fl export | 
| 3727 | This option specifies that a PKCS#12 file will be created rather than | 3734 | This option specifies that a PKCS#12 file will be created rather than | 
| 3728 | parsed. | 3735 | parsed. | 
| @@ -3838,7 +3845,7 @@ for MS-Windows, | |||
| 3838 | for OpenVMS, and | 3845 | for OpenVMS, and | 
| 3839 | .Cm \&: | 3846 | .Cm \&: | 
| 3840 | for all others. | 3847 | for all others. | 
| 3841 | .Ed | 3848 | .El | 
| 3842 | .Sh PKCS12 NOTES | 3849 | .Sh PKCS12 NOTES | 
| 3843 | Although there are a large number of options, | 3850 | Although there are a large number of options, | 
| 3844 | most of them are very rarely used. | 3851 | most of them are very rarely used. | 
| @@ -3989,7 +3996,7 @@ file will be written back if enough | |||
| 3989 | seeding was obtained from these sources. | 3996 | seeding was obtained from these sources. | 
| 3990 | .Pp | 3997 | .Pp | 
| 3991 | The options are as follows: | 3998 | The options are as follows: | 
| 3992 | .Bd -ragged -offset indent | 3999 | .Bl -tag -width "XXXX" | 
| 3993 | .It Fl out Ar file | 4000 | .It Fl out Ar file | 
| 3994 | Write to | 4001 | Write to | 
| 3995 | .Ar file | 4002 | .Ar file | 
| @@ -4064,7 +4071,7 @@ It can additionally create self-signed certificates, | |||
| 4064 | for use as root CAs, for example. | 4071 | for use as root CAs, for example. | 
| 4065 | .Pp | 4072 | .Pp | 
| 4066 | The options are as follows: | 4073 | The options are as follows: | 
| 4067 | .Bd -ragged -offset indent | 4074 | .Bl -tag -width "XXXX" | 
| 4068 | .It Fl inform Ar DER|PEM | 4075 | .It Fl inform Ar DER|PEM | 
| 4069 | This specifies the input format. | 4076 | This specifies the input format. | 
| 4070 | The | 4077 | The | 
| @@ -4077,7 +4084,7 @@ form is the default format: | |||
| 4077 | it consists of the DER format base64 encoded with additional header and | 4084 | it consists of the DER format base64 encoded with additional header and | 
| 4078 | footer lines. | 4085 | footer lines. | 
| 4079 | .It Fl outform Ar DER|PEM | 4086 | .It Fl outform Ar DER|PEM | 
| 4080 | This specifies the output format, the options have the same meaning as the | 4087 | This specifies the output format, the options have the same meaning as the | 
| 4081 | .Fl inform | 4088 | .Fl inform | 
| 4082 | option. | 4089 | option. | 
| 4083 | .It Fl in Ar filename | 4090 | .It Fl in Ar filename | 
| @@ -4223,7 +4230,7 @@ This allows several different sections to | |||
| 4223 | be used in the same configuration file to specify requests for | 4230 | be used in the same configuration file to specify requests for | 
| 4224 | a variety of purposes. | 4231 | a variety of purposes. | 
| 4225 | .It Fl utf8 | 4232 | .It Fl utf8 | 
| 4226 | This option causes field values to be interpreted as UTF8 strings, by | 4233 | This option causes field values to be interpreted as UTF8 strings, by | 
| 4227 | default they are interpreted as ASCII. | 4234 | default they are interpreted as ASCII. | 
| 4228 | This means that the field values, whether prompted from a terminal or | 4235 | This means that the field values, whether prompted from a terminal or | 
| 4229 | obtained from a configuration file, must be valid UTF8 strings. | 4236 | obtained from a configuration file, must be valid UTF8 strings. | 
| @@ -4267,7 +4274,7 @@ Some software (Netscape certificate server) and some CAs need this. | |||
| 4267 | Non-interactive mode. | 4274 | Non-interactive mode. | 
| 4268 | .It Fl verbose | 4275 | .It Fl verbose | 
| 4269 | Print extra details about the operations being performed. | 4276 | Print extra details about the operations being performed. | 
| 4270 | .Ed | 4277 | .El | 
| 4271 | .Sh REQ CONFIGURATION FILE FORMAT | 4278 | .Sh REQ CONFIGURATION FILE FORMAT | 
| 4272 | The configuration options are specified in the | 4279 | The configuration options are specified in the | 
| 4273 | .Em req | 4280 | .Em req | 
| @@ -4280,7 +4287,7 @@ then the initial unnamed or | |||
| 4280 | section is searched too. | 4287 | section is searched too. | 
| 4281 | .Pp | 4288 | .Pp | 
| 4282 | The options available are described in detail below. | 4289 | The options available are described in detail below. | 
| 4283 | .Bd -ragged -offset indent | 4290 | .Bl -tag -width "XXXX" | 
| 4284 | .It Ar input_password output_password | 4291 | .It Ar input_password output_password | 
| 4285 | The passwords for the input private key file (if present) and | 4292 | The passwords for the input private key file (if present) and | 
| 4286 | the output private key file (if one will be created). | 4293 | the output private key file (if one will be created). | 
| @@ -4308,7 +4315,7 @@ option. | |||
| 4308 | This specifies a file containing additional OBJECT IDENTIFIERS. | 4315 | This specifies a file containing additional OBJECT IDENTIFIERS. | 
| 4309 | Each line of the file should consist of the numerical form of the | 4316 | Each line of the file should consist of the numerical form of the | 
| 4310 | object identifier, followed by whitespace, then the short name followed | 4317 | object identifier, followed by whitespace, then the short name followed | 
| 4311 | by whitespace and finally the long name. | 4318 | by whitespace and finally the long name. | 
| 4312 | .It Ar oid_section | 4319 | .It Ar oid_section | 
| 4313 | This specifies a section in the configuration file containing extra | 4320 | This specifies a section in the configuration file containing extra | 
| 4314 | object identifiers. | 4321 | object identifiers. | 
| @@ -4353,7 +4360,7 @@ which is also the default option, uses | |||
| 4353 | .Em PrintableStrings , T61Strings | 4360 | .Em PrintableStrings , T61Strings | 
| 4354 | and | 4361 | and | 
| 4355 | .Em BMPStrings ; | 4362 | .Em BMPStrings ; | 
| 4356 | if the | 4363 | if the | 
| 4357 | .Ar pkix | 4364 | .Ar pkix | 
| 4358 | value is used then only | 4365 | value is used then only | 
| 4359 | .Em PrintableStrings | 4366 | .Em PrintableStrings | 
| @@ -4424,7 +4431,7 @@ request signing utilities, but some CAs might want them. | |||
| 4424 | This specifies the section containing the distinguished name fields to | 4431 | This specifies the section containing the distinguished name fields to | 
| 4425 | prompt for when generating a certificate or certificate request. | 4432 | prompt for when generating a certificate or certificate request. | 
| 4426 | The format is described in the next section. | 4433 | The format is described in the next section. | 
| 4427 | .Ed | 4434 | .El | 
| 4428 | .Sh REQ DISTINGUISHED NAME AND ATTRIBUTE SECTION FORMAT | 4435 | .Sh REQ DISTINGUISHED NAME AND ATTRIBUTE SECTION FORMAT | 
| 4429 | There are two separate formats for the distinguished name and attribute | 4436 | There are two separate formats for the distinguished name and attribute | 
| 4430 | sections. | 4437 | sections. | 
| @@ -4760,7 +4767,7 @@ newer applications should use the more secure PKCS#8 format using the | |||
| 4760 | utility. | 4767 | utility. | 
| 4761 | .Pp | 4768 | .Pp | 
| 4762 | The options are as follows: | 4769 | The options are as follows: | 
| 4763 | .Bd -ragged -offset indent | 4770 | .Bl -tag -width "XXXX" | 
| 4764 | .It Fl inform Ar DER|NET|PEM | 4771 | .It Fl inform Ar DER|NET|PEM | 
| 4765 | This specifies the input format. | 4772 | This specifies the input format. | 
| 4766 | The | 4773 | The | 
| @@ -4779,7 +4786,7 @@ form is a format described in the | |||
| 4779 | .Sx RSA NOTES | 4786 | .Sx RSA NOTES | 
| 4780 | section. | 4787 | section. | 
| 4781 | .It Fl outform Ar DER|NET|PEM | 4788 | .It Fl outform Ar DER|NET|PEM | 
| 4782 | This specifies the output format, the options have the same meaning as the | 4789 | This specifies the output format, the options have the same meaning as the | 
| 4783 | .Fl inform | 4790 | .Fl inform | 
| 4784 | option. | 4791 | option. | 
| 4785 | .It Fl in Ar filename | 4792 | .It Fl in Ar filename | 
| @@ -4815,7 +4822,7 @@ Use the modified | |||
| 4815 | .Em NET | 4822 | .Em NET | 
| 4816 | algorithm used with some versions of Microsoft IIS and SGC keys. | 4823 | algorithm used with some versions of Microsoft IIS and SGC keys. | 
| 4817 | .It Cm -des|-des3|-idea | 4824 | .It Cm -des|-des3|-idea | 
| 4818 | These options encrypt the private key with the DES, triple DES, or the | 4825 | These options encrypt the private key with the DES, triple DES, or the | 
| 4819 | IDEA ciphers, respectively, before outputting it. | 4826 | IDEA ciphers, respectively, before outputting it. | 
| 4820 | A pass phrase is prompted for. | 4827 | A pass phrase is prompted for. | 
| 4821 | If none of these options is specified the key is written in plain text. | 4828 | If none of these options is specified the key is written in plain text. | 
| @@ -4829,7 +4836,7 @@ These options can only be used with | |||
| 4829 | format output files. | 4836 | format output files. | 
| 4830 | .It Fl text | 4837 | .It Fl text | 
| 4831 | Prints out the various public or private key components in | 4838 | Prints out the various public or private key components in | 
| 4832 | plain text, in addition to the encoded version. | 4839 | plain text, in addition to the encoded version. | 
| 4833 | .It Fl noout | 4840 | .It Fl noout | 
| 4834 | This option prevents output of the encoded version of the key. | 4841 | This option prevents output of the encoded version of the key. | 
| 4835 | .It Fl modulus | 4842 | .It Fl modulus | 
| @@ -4843,7 +4850,7 @@ option a public key is read instead. | |||
| 4843 | By default a private key is output: | 4850 | By default a private key is output: | 
| 4844 | with this option a public key will be output instead. | 4851 | with this option a public key will be output instead. | 
| 4845 | This option is automatically set if the input is a public key. | 4852 | This option is automatically set if the input is a public key. | 
| 4846 | .Ed | 4853 | .El | 
| 4847 | .Sh RSA NOTES | 4854 | .Sh RSA NOTES | 
| 4848 | The | 4855 | The | 
| 4849 | .Em PEM | 4856 | .Em PEM | 
| @@ -4897,7 +4904,7 @@ To convert a private key from | |||
| 4897 | .Em PEM | 4904 | .Em PEM | 
| 4898 | to | 4905 | to | 
| 4899 | .Em DER | 4906 | .Em DER | 
| 4900 | format: | 4907 | format: | 
| 4901 | .Pp | 4908 | .Pp | 
| 4902 | \& $ openssl rsa -in key.pem -outform DER -out keyout.der | 4909 | \& $ openssl rsa -in key.pem -outform DER -out keyout.der | 
| 4903 | .br | 4910 | .br | 
| @@ -4942,7 +4949,7 @@ command can be used to sign, verify, encrypt and decrypt | |||
| 4942 | data using the RSA algorithm. | 4949 | data using the RSA algorithm. | 
| 4943 | .Pp | 4950 | .Pp | 
| 4944 | The options are as follows: | 4951 | The options are as follows: | 
| 4945 | .Bd -ragged -offset indent | 4952 | .Bl -tag -width "XXXX" | 
| 4946 | .It Fl in Ar filename | 4953 | .It Fl in Ar filename | 
| 4947 | This specifies the input | 4954 | This specifies the input | 
| 4948 | .Ar filename | 4955 | .Ar filename | 
| @@ -4956,9 +4963,9 @@ default. | |||
| 4956 | .It Fl inkey Ar file | 4963 | .It Fl inkey Ar file | 
| 4957 | The input key file, by default it should be an RSA private key. | 4964 | The input key file, by default it should be an RSA private key. | 
| 4958 | .It Fl pubin | 4965 | .It Fl pubin | 
| 4959 | The input file is an RSA public key. | 4966 | The input file is an RSA public key. | 
| 4960 | .It Fl certin | 4967 | .It Fl certin | 
| 4961 | The input is a certificate containing an RSA public key. | 4968 | The input is a certificate containing an RSA public key. | 
| 4962 | .It Fl sign | 4969 | .It Fl sign | 
| 4963 | Sign the input data and output the signed result. | 4970 | Sign the input data and output the signed result. | 
| 4964 | This requires an RSA private key. | 4971 | This requires an RSA private key. | 
| @@ -5028,23 +5035,23 @@ as follows yields: | |||
| 5028 | \& $ openssl asn1parse -in pca-cert.pem | 5035 | \& $ openssl asn1parse -in pca-cert.pem | 
| 5029 | .Pp | 5036 | .Pp | 
| 5030 | .Bd -literal | 5037 | .Bd -literal | 
| 5031 | \& 0:d=0 hl=4 l= 742 cons: SEQUENCE | 5038 | \& 0:d=0 hl=4 l= 742 cons: SEQUENCE | 
| 5032 | \& 4:d=1 hl=4 l= 591 cons: SEQUENCE | 5039 | \& 4:d=1 hl=4 l= 591 cons: SEQUENCE | 
| 5033 | \& 8:d=2 hl=2 l= 3 cons: cont [ 0 ] | 5040 | \& 8:d=2 hl=2 l= 3 cons: cont [ 0 ] | 
| 5034 | \& 10:d=3 hl=2 l= 1 prim: INTEGER :02 | 5041 | \& 10:d=3 hl=2 l= 1 prim: INTEGER :02 | 
| 5035 | \& 13:d=2 hl=2 l= 1 prim: INTEGER :00 | 5042 | \& 13:d=2 hl=2 l= 1 prim: INTEGER :00 | 
| 5036 | \& 16:d=2 hl=2 l= 13 cons: SEQUENCE | 5043 | \& 16:d=2 hl=2 l= 13 cons: SEQUENCE | 
| 5037 | \& 18:d=3 hl=2 l= 9 prim: OBJECT :md5WithRSAEncryption | 5044 | \& 18:d=3 hl=2 l= 9 prim: OBJECT :md5WithRSAEncryption | 
| 5038 | \& 29:d=3 hl=2 l= 0 prim: NULL | 5045 | \& 29:d=3 hl=2 l= 0 prim: NULL | 
| 5039 | \& 31:d=2 hl=2 l= 92 cons: SEQUENCE | 5046 | \& 31:d=2 hl=2 l= 92 cons: SEQUENCE | 
| 5040 | \& 33:d=3 hl=2 l= 11 cons: SET | 5047 | \& 33:d=3 hl=2 l= 11 cons: SET | 
| 5041 | \& 35:d=4 hl=2 l= 9 cons: SEQUENCE | 5048 | \& 35:d=4 hl=2 l= 9 cons: SEQUENCE | 
| 5042 | \& 37:d=5 hl=2 l= 3 prim: OBJECT :countryName | 5049 | \& 37:d=5 hl=2 l= 3 prim: OBJECT :countryName | 
| 5043 | \& 42:d=5 hl=2 l= 2 prim: PRINTABLESTRING :AU | 5050 | \& 42:d=5 hl=2 l= 2 prim: PRINTABLESTRING :AU | 
| 5044 | \& .... | 5051 | \& .... | 
| 5045 | \& 599:d=1 hl=2 l= 13 cons: SEQUENCE | 5052 | \& 599:d=1 hl=2 l= 13 cons: SEQUENCE | 
| 5046 | \& 601:d=2 hl=2 l= 9 prim: OBJECT :md5WithRSAEncryption | 5053 | \& 601:d=2 hl=2 l= 9 prim: OBJECT :md5WithRSAEncryption | 
| 5047 | \& 612:d=2 hl=2 l= 0 prim: NULL | 5054 | \& 612:d=2 hl=2 l= 0 prim: NULL | 
| 5048 | \& 614:d=1 hl=3 l= 129 prim: BIT STRING | 5055 | \& 614:d=1 hl=3 l= 129 prim: BIT STRING | 
| 5049 | .Ed | 5056 | .Ed | 
| 5050 | .Pp | 5057 | .Pp | 
| @@ -5062,11 +5069,11 @@ The signature can be analysed with: | |||
| 5062 | \& $ openssl rsautl -in sig -verify -asn1parse -inkey pubkey.pem -pubin | 5069 | \& $ openssl rsautl -in sig -verify -asn1parse -inkey pubkey.pem -pubin | 
| 5063 | .Pp | 5070 | .Pp | 
| 5064 | .Bd -literal | 5071 | .Bd -literal | 
| 5065 | \& 0:d=0 hl=2 l= 32 cons: SEQUENCE | 5072 | \& 0:d=0 hl=2 l= 32 cons: SEQUENCE | 
| 5066 | \& 2:d=1 hl=2 l= 12 cons: SEQUENCE | 5073 | \& 2:d=1 hl=2 l= 12 cons: SEQUENCE | 
| 5067 | \& 4:d=2 hl=2 l= 8 prim: OBJECT :md5 | 5074 | \& 4:d=2 hl=2 l= 8 prim: OBJECT :md5 | 
| 5068 | \& 14:d=2 hl=2 l= 0 prim: NULL | 5075 | \& 14:d=2 hl=2 l= 0 prim: NULL | 
| 5069 | \& 16:d=1 hl=2 l= 16 prim: OCTET STRING | 5076 | \& 16:d=1 hl=2 l= 16 prim: OCTET STRING | 
| 5070 | \& 0000 - f3 46 9e aa 1a 4a 73 c9-37 ea 93 00 48 25 08 b5 .F...Js.7...H%.. | 5077 | \& 0000 - f3 46 9e aa 1a 4a 73 c9-37 ea 93 00 48 25 08 b5 .F...Js.7...H%.. | 
| 5071 | .Ed | 5078 | .Ed | 
| 5072 | .Pp | 5079 | .Pp | 
| @@ -5128,7 +5135,7 @@ It is a | |||
| 5128 | useful diagnostic tool for SSL servers. | 5135 | useful diagnostic tool for SSL servers. | 
| 5129 | .Pp | 5136 | .Pp | 
| 5130 | The options are as follows: | 5137 | The options are as follows: | 
| 5131 | .Bd -ragged -offset indent | 5138 | .Bl -tag -width "XXXX" | 
| 5132 | .It Fl connect Ar host:port | 5139 | .It Fl connect Ar host:port | 
| 5133 | This specifies the | 5140 | This specifies the | 
| 5134 | .Ar host | 5141 | .Ar host | 
| @@ -5254,7 +5261,7 @@ for OpenVMS, and | |||
| 5254 | .Cm \&: | 5261 | .Cm \&: | 
| 5255 | for | 5262 | for | 
| 5256 | all others. | 5263 | all others. | 
| 5257 | .Ed | 5264 | .El | 
| 5258 | .Sh S_CLIENT CONNECTED COMMANDS | 5265 | .Sh S_CLIENT CONNECTED COMMANDS | 
| 5259 | If a connection is established with an SSL server then any data received | 5266 | If a connection is established with an SSL server then any data received | 
| 5260 | from the server is displayed and any key presses will be sent to the | 5267 | from the server is displayed and any key presses will be sent to the | 
| @@ -5381,7 +5388,7 @@ command implements a generic SSL/TLS server which listens | |||
| 5381 | for connections on a given port using SSL/TLS. | 5388 | for connections on a given port using SSL/TLS. | 
| 5382 | .Pp | 5389 | .Pp | 
| 5383 | The options are as follows: | 5390 | The options are as follows: | 
| 5384 | .Bd -ragged -offset indent | 5391 | .Bl -tag -width "XXXX" | 
| 5385 | .It Fl accept Ar port | 5392 | .It Fl accept Ar port | 
| 5386 | The TCP | 5393 | The TCP | 
| 5387 | .Ar port | 5394 | .Ar port | 
| @@ -5544,19 +5551,19 @@ for MS-Windows, | |||
| 5544 | for OpenVMS, and | 5551 | for OpenVMS, and | 
| 5545 | .Cm \&: | 5552 | .Cm \&: | 
| 5546 | for all others. | 5553 | for all others. | 
| 5547 | .Ed | 5554 | .El | 
| 5548 | .Sh S_SERVER CONNECTED COMMANDS | 5555 | .Sh S_SERVER CONNECTED COMMANDS | 
| 5549 | If a connection request is established with an SSL client and neither the | 5556 | If a connection request is established with an SSL client and neither the | 
| 5550 | .Fl www | 5557 | .Fl www | 
| 5551 | nor the | 5558 | nor the | 
| 5552 | .Fl WWW | 5559 | .Fl WWW | 
| 5553 | option has been used, then normally any data received | 5560 | option has been used, then normally any data received | 
| 5554 | from the client is displayed and any key presses will be sent to the client. | 5561 | from the client is displayed and any key presses will be sent to the client. | 
| 5555 | .Pp | 5562 | .Pp | 
| 5556 | Certain single letter commands are also recognized which perform special | 5563 | Certain single letter commands are also recognized which perform special | 
| 5557 | operations: these are listed below. | 5564 | operations: these are listed below. | 
| 5558 | .Pp | 5565 | .Pp | 
| 5559 | .Bd -ragged -offset indent | 5566 | .Bl -tag -width "XXXX" | 
| 5560 | .It Ar q | 5567 | .It Ar q | 
| 5561 | End the current SSL connection, but still accept new connections. | 5568 | End the current SSL connection, but still accept new connections. | 
| 5562 | .It Ar Q | 5569 | .It Ar Q | 
| @@ -5570,7 +5577,7 @@ Send some plain text down the underlying TCP connection: this should | |||
| 5570 | cause the client to disconnect due to a protocol violation. | 5577 | cause the client to disconnect due to a protocol violation. | 
| 5571 | .It Ar S | 5578 | .It Ar S | 
| 5572 | Print out some session cache status information. | 5579 | Print out some session cache status information. | 
| 5573 | .Ed | 5580 | .El | 
| 5574 | .Sh S_SERVER NOTES | 5581 | .Sh S_SERVER NOTES | 
| 5575 | .Nm s_server | 5582 | .Nm s_server | 
| 5576 | can be used to debug SSL clients. | 5583 | can be used to debug SSL clients. | 
| @@ -5641,7 +5648,7 @@ Since this is a diagnostic tool that needs some knowledge of the SSL | |||
| 5641 | protocol to use properly, most users will not need to use it. | 5648 | protocol to use properly, most users will not need to use it. | 
| 5642 | .Pp | 5649 | .Pp | 
| 5643 | The options are as follows: | 5650 | The options are as follows: | 
| 5644 | .Bd -ragged -offset indent | 5651 | .Bl -tag -width "XXXX" | 
| 5645 | .It Fl inform Ar DER|PEM | 5652 | .It Fl inform Ar DER|PEM | 
| 5646 | This specifies the input format. | 5653 | This specifies the input format. | 
| 5647 | The | 5654 | The | 
| @@ -5654,7 +5661,7 @@ The | |||
| 5654 | form is the default format: it consists of the DER | 5661 | form is the default format: it consists of the DER | 
| 5655 | format base64 encoded with additional header and footer lines. | 5662 | format base64 encoded with additional header and footer lines. | 
| 5656 | .It Fl outform Ar DER|PEM | 5663 | .It Fl outform Ar DER|PEM | 
| 5657 | This specifies the output format, the options have the same meaning as the | 5664 | This specifies the output format, the options have the same meaning as the | 
| 5658 | .Fl inform | 5665 | .Fl inform | 
| 5659 | option. | 5666 | option. | 
| 5660 | .It Fl in Ar filename | 5667 | .It Fl in Ar filename | 
| @@ -5668,7 +5675,7 @@ to write session information to, or standard | |||
| 5668 | output if this option is not specified. | 5675 | output if this option is not specified. | 
| 5669 | .It Fl text | 5676 | .It Fl text | 
| 5670 | Prints out the various public or private key components in | 5677 | Prints out the various public or private key components in | 
| 5671 | plain text in addition to the encoded version. | 5678 | plain text in addition to the encoded version. | 
| 5672 | .It Fl cert | 5679 | .It Fl cert | 
| 5673 | If a certificate is present in the session it will be output using this option, | 5680 | If a certificate is present in the session it will be output using this option, | 
| 5674 | if the | 5681 | if the | 
| @@ -5684,7 +5691,7 @@ The | |||
| 5684 | .Ar ID | 5691 | .Ar ID | 
| 5685 | can be any string of characters. | 5692 | can be any string of characters. | 
| 5686 | This option won't normally be used. | 5693 | This option won't normally be used. | 
| 5687 | .Ed | 5694 | .El | 
| 5688 | .Sh SESS_ID OUTPUT | 5695 | .Sh SESS_ID OUTPUT | 
| 5689 | Typical output: | 5696 | Typical output: | 
| 5690 | .Pp | 5697 | .Pp | 
| @@ -5702,7 +5709,7 @@ Typical output: | |||
| 5702 | .Ed | 5709 | .Ed | 
| 5703 | .Pp | 5710 | .Pp | 
| 5704 | These are described below in more detail. | 5711 | These are described below in more detail. | 
| 5705 | .Bd -ragged -offset indent | 5712 | .Bl -tag -width "XXXX" | 
| 5706 | .It Ar Protocol | 5713 | .It Ar Protocol | 
| 5707 | This is the protocol in use: TLSv1, SSLv3 or SSLv2. | 5714 | This is the protocol in use: TLSv1, SSLv3 or SSLv2. | 
| 5708 | .It Ar Cipher | 5715 | .It Ar Cipher | 
| @@ -5723,7 +5730,7 @@ in standard Unix format. | |||
| 5723 | The timeout in seconds. | 5730 | The timeout in seconds. | 
| 5724 | .It Ar Verify return code | 5731 | .It Ar Verify return code | 
| 5725 | This is the return code when an SSL client certificate is verified. | 5732 | This is the return code when an SSL client certificate is verified. | 
| 5726 | .Ed | 5733 | .El | 
| 5727 | .Sh SESS_ID NOTES | 5734 | .Sh SESS_ID NOTES | 
| 5728 | The | 5735 | The | 
| 5729 | .Em PEM | 5736 | .Em PEM | 
| @@ -5789,7 +5796,7 @@ There are five operation options that set the type of operation to be performed. | |||
| 5789 | The meaning of the other options varies according to the operation type. | 5796 | The meaning of the other options varies according to the operation type. | 
| 5790 | .Pp | 5797 | .Pp | 
| 5791 | The options are as follows: | 5798 | The options are as follows: | 
| 5792 | .Bd -ragged -offset indent | 5799 | .Bl -tag -width "XXXX" | 
| 5793 | .It Fl encrypt | 5800 | .It Fl encrypt | 
| 5794 | Encrypt mail for the given recipient certificates. | 5801 | Encrypt mail for the given recipient certificates. | 
| 5795 | Input file is the message to be encrypted. | 5802 | Input file is the message to be encrypted. | 
| @@ -5879,7 +5886,7 @@ This option adds plain text (text/plain) | |||
| 5879 | headers to the supplied message if encrypting or signing. | 5886 | headers to the supplied message if encrypting or signing. | 
| 5880 | If decrypting or verifying it strips off text headers: | 5887 | If decrypting or verifying it strips off text headers: | 
| 5881 | if the decrypted or verified message is not of | 5888 | if the decrypted or verified message is not of | 
| 5882 | .Em MIME | 5889 | .Em MIME | 
| 5883 | type text/plain then an error occurs. | 5890 | type text/plain then an error occurs. | 
| 5884 | .It Fl CAfile Ar file | 5891 | .It Fl CAfile Ar file | 
| 5885 | A | 5892 | A | 
| @@ -5994,7 +6001,7 @@ for OpenVMS, and | |||
| 5994 | for all others. | 6001 | for all others. | 
| 5995 | .It Ar cert.pem ... | 6002 | .It Ar cert.pem ... | 
| 5996 | One or more certificates of message recipients: used when encrypting | 6003 | One or more certificates of message recipients: used when encrypting | 
| 5997 | a message. | 6004 | a message. | 
| 5998 | .It Fl to , from , subject | 6005 | .It Fl to , from , subject | 
| 5999 | The relevant mail headers. | 6006 | The relevant mail headers. | 
| 6000 | These are included outside the signed | 6007 | These are included outside the signed | 
| @@ -6003,7 +6010,7 @@ If signing, then many | |||
| 6003 | .Em S/MIME | 6010 | .Em S/MIME | 
| 6004 | mail clients check the signer's certificate email | 6011 | mail clients check the signer's certificate email | 
| 6005 | address matches that specified in the From: address. | 6012 | address matches that specified in the From: address. | 
| 6006 | .Ed | 6013 | .El | 
| 6007 | .Sh SMIME NOTES | 6014 | .Sh SMIME NOTES | 
| 6008 | The | 6015 | The | 
| 6009 | .Em MIME | 6016 | .Em MIME | 
| @@ -6048,7 +6055,7 @@ clients. | |||
| 6048 | Strictly speaking these process PKCS#7 enveloped data: PKCS#7 | 6055 | Strictly speaking these process PKCS#7 enveloped data: PKCS#7 | 
| 6049 | encrypted data is used for other purposes. | 6056 | encrypted data is used for other purposes. | 
| 6050 | .Sh SMIME EXIT CODES | 6057 | .Sh SMIME EXIT CODES | 
| 6051 | .Bd -ragged -offset indent | 6058 | .Bl -tag -width "XXXX" | 
| 6052 | .It Ar 0 | 6059 | .It Ar 0 | 
| 6053 | The operation was completely successful. | 6060 | The operation was completely successful. | 
| 6054 | .It Ar 1 | 6061 | .It Ar 1 | 
| @@ -6064,7 +6071,7 @@ An error occurred decrypting or verifying the message. | |||
| 6064 | .It Ar 5 | 6071 | .It Ar 5 | 
| 6065 | The message was verified correctly, but an error occurred writing out | 6072 | The message was verified correctly, but an error occurred writing out | 
| 6066 | the signers certificates. | 6073 | the signers certificates. | 
| 6067 | .Ed | 6074 | .El | 
| 6068 | .Sh SMIME EXAMPLES | 6075 | .Sh SMIME EXAMPLES | 
| 6069 | Create a cleartext signed message: | 6076 | Create a cleartext signed message: | 
| 6070 | .Pp | 6077 | .Pp | 
| @@ -6222,7 +6229,7 @@ The | |||
| 6222 | .Nm speed | 6229 | .Nm speed | 
| 6223 | command is used to test the performance of cryptographic algorithms. | 6230 | command is used to test the performance of cryptographic algorithms. | 
| 6224 | .Pp | 6231 | .Pp | 
| 6225 | .Bd -ragged -offset indent | 6232 | .Bl -tag -width "XXXX" | 
| 6226 | .It Fl engine Ar id | 6233 | .It Fl engine Ar id | 
| 6227 | Specifying an engine (by it's unique | 6234 | Specifying an engine (by it's unique | 
| 6228 | .Ar id | 6235 | .Ar id | 
| @@ -6236,7 +6243,7 @@ for all available algorithms. | |||
| 6236 | If any options are given, | 6243 | If any options are given, | 
| 6237 | .Nm speed | 6244 | .Nm speed | 
| 6238 | tests those algorithms, otherwise all of the above are tested. | 6245 | tests those algorithms, otherwise all of the above are tested. | 
| 6239 | .Ed | 6246 | .El | 
| 6240 | .\" | 6247 | .\" | 
| 6241 | .\" SPKAC | 6248 | .\" SPKAC | 
| 6242 | .\" | 6249 | .\" | 
| @@ -6261,7 +6268,7 @@ It can print out their contents, verify the signature and | |||
| 6261 | produce its own SPKACs from a supplied private key. | 6268 | produce its own SPKACs from a supplied private key. | 
| 6262 | .Pp | 6269 | .Pp | 
| 6263 | The options are as follows: | 6270 | The options are as follows: | 
| 6264 | .Bd -ragged -offset indent | 6271 | .Bl -tag -width "XXXX" | 
| 6265 | .It Fl in Ar filename | 6272 | .It Fl in Ar filename | 
| 6266 | This specifies the input | 6273 | This specifies the input | 
| 6267 | .Ar filename | 6274 | .Ar filename | 
| @@ -6307,7 +6314,7 @@ Output the public key of an SPKAC (not used if an SPKAC is | |||
| 6307 | being created). | 6314 | being created). | 
| 6308 | .It Fl verify | 6315 | .It Fl verify | 
| 6309 | Verifies the digital signature on the supplied SPKAC. | 6316 | Verifies the digital signature on the supplied SPKAC. | 
| 6310 | .Ed | 6317 | .El | 
| 6311 | .Sh SPKAC EXAMPLES | 6318 | .Sh SPKAC EXAMPLES | 
| 6312 | Print out the contents of an SPKAC: | 6319 | Print out the contents of an SPKAC: | 
| 6313 | .Pp | 6320 | .Pp | 
| @@ -6361,7 +6368,7 @@ to be used in a "replay attack". | |||
| 6361 | .Op Fl help | 6368 | .Op Fl help | 
| 6362 | .Op Fl issuer_checks | 6369 | .Op Fl issuer_checks | 
| 6363 | .Op Fl verbose | 6370 | .Op Fl verbose | 
| 6364 | .Op Fl | 6371 | .Op Fl | 
| 6365 | .Op Ar certificates | 6372 | .Op Ar certificates | 
| 6366 | .Pp | 6373 | .Pp | 
| 6367 | The | 6374 | The | 
| @@ -6369,7 +6376,7 @@ The | |||
| 6369 | command verifies certificate chains. | 6376 | command verifies certificate chains. | 
| 6370 | .Pp | 6377 | .Pp | 
| 6371 | The options are as follows: | 6378 | The options are as follows: | 
| 6372 | .Bd -ragged -offset indent | 6379 | .Bl -tag -width "XXXX" | 
| 6373 | .It Fl CApath directory | 6380 | .It Fl CApath directory | 
| 6374 | A | 6381 | A | 
| 6375 | .Ar directory | 6382 | .Ar directory | 
| @@ -6423,7 +6430,7 @@ This shows why each candidate issuer certificate was rejected. | |||
| 6423 | However the presence of rejection messages | 6430 | However the presence of rejection messages | 
| 6424 | does not itself imply that anything is wrong: during the normal | 6431 | does not itself imply that anything is wrong: during the normal | 
| 6425 | verify process several rejections may take place. | 6432 | verify process several rejections may take place. | 
| 6426 | .It Fl | 6433 | .It Fl | 
| 6427 | Marks the last option. | 6434 | Marks the last option. | 
| 6428 | All arguments following this are assumed to be certificate files. | 6435 | All arguments following this are assumed to be certificate files. | 
| 6429 | This is useful if the first certificate filename begins with a | 6436 | This is useful if the first certificate filename begins with a | 
| @@ -6437,7 +6444,7 @@ a certificate from standard input. | |||
| 6437 | They should all be in | 6444 | They should all be in | 
| 6438 | .Em PEM | 6445 | .Em PEM | 
| 6439 | format. | 6446 | format. | 
| 6440 | .Ed | 6447 | .El | 
| 6441 | .Sh VERIFY OPERATION | 6448 | .Sh VERIFY OPERATION | 
| 6442 | The | 6449 | The | 
| 6443 | .Nm verify | 6450 | .Nm verify | 
| @@ -6459,7 +6466,7 @@ and ending in the root CA. | |||
| 6459 | It is an error if the whole chain cannot be built up. | 6466 | It is an error if the whole chain cannot be built up. | 
| 6460 | The chain is built up by looking up the issuers certificate of the current | 6467 | The chain is built up by looking up the issuers certificate of the current | 
| 6461 | certificate. | 6468 | certificate. | 
| 6462 | If a certificate is found which is its own issuer it is assumed | 6469 | If a certificate is found which is its own issuer it is assumed | 
| 6463 | to be the root CA. | 6470 | to be the root CA. | 
| 6464 | .Pp | 6471 | .Pp | 
| 6465 | The process of 'looking up the issuers certificate' itself involves a number | 6472 | The process of 'looking up the issuers certificate' itself involves a number | 
| @@ -6504,7 +6511,7 @@ For compatibility with previous versions of | |||
| 6504 | and | 6511 | and | 
| 6505 | .Nm OpenSSL , | 6512 | .Nm OpenSSL , | 
| 6506 | a certificate with no trust settings is considered to be valid for | 6513 | a certificate with no trust settings is considered to be valid for | 
| 6507 | all purposes. | 6514 | all purposes. | 
| 6508 | .Pp | 6515 | .Pp | 
| 6509 | The final operation is to check the validity of the certificate chain. | 6516 | The final operation is to check the validity of the certificate chain. | 
| 6510 | The validity period is checked against the current system time and the | 6517 | The validity period is checked against the current system time and the | 
| @@ -6540,7 +6547,7 @@ includes the name of the error code as defined in the header file | |||
| 6540 | Some of the error codes are defined but never returned: these are described | 6547 | Some of the error codes are defined but never returned: these are described | 
| 6541 | as "unused". | 6548 | as "unused". | 
| 6542 | .Pp | 6549 | .Pp | 
| 6543 | .Bd -ragged -offset indent | 6550 | .Bl -tag -width "XXXX" | 
| 6544 | .It Ar "0 X509_V_OK: ok" | 6551 | .It Ar "0 X509_V_OK: ok" | 
| 6545 | The operation was successful. | 6552 | The operation was successful. | 
| 6546 | .It Ar 2 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT: unable to get issuer certificate | 6553 | .It Ar 2 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT: unable to get issuer certificate | 
| @@ -6662,7 +6669,7 @@ extension does not permit certificate signing. | |||
| 6662 | .It Ar 50 X509_V_ERR_APPLICATION_VERIFICATION: application verification failure | 6669 | .It Ar 50 X509_V_ERR_APPLICATION_VERIFICATION: application verification failure | 
| 6663 | An application specific error. | 6670 | An application specific error. | 
| 6664 | Unused. | 6671 | Unused. | 
| 6665 | .Ed | 6672 | .El | 
| 6666 | .Sh VERIFY BUGS | 6673 | .Sh VERIFY BUGS | 
| 6667 | Although the issuer checks are a considerable improvement over the old | 6674 | Although the issuer checks are a considerable improvement over the old | 
| 6668 | technique, they still suffer from limitations in the underlying | 6675 | technique, they still suffer from limitations in the underlying | 
| @@ -6697,7 +6704,7 @@ command is used to print out version information about | |||
| 6697 | .Nm OpenSSL . | 6704 | .Nm OpenSSL . | 
| 6698 | .Pp | 6705 | .Pp | 
| 6699 | The options are as follows: | 6706 | The options are as follows: | 
| 6700 | .Bd -ragged -offset indent | 6707 | .Bl -tag -width "XXXX" | 
| 6701 | .It Fl a | 6708 | .It Fl a | 
| 6702 | All information: this is the same as setting all the other flags. | 6709 | All information: this is the same as setting all the other flags. | 
| 6703 | .It Fl v | 6710 | .It Fl v | 
| @@ -6717,7 +6724,7 @@ Platform setting. | |||
| 6717 | .It Fl d | 6724 | .It Fl d | 
| 6718 | .Em OPENSSLDIR | 6725 | .Em OPENSSLDIR | 
| 6719 | setting. | 6726 | setting. | 
| 6720 | .Ed | 6727 | .El | 
| 6721 | .Sh VERSION NOTES | 6728 | .Sh VERSION NOTES | 
| 6722 | The output of | 6729 | The output of | 
| 6723 | .Nm openssl version -a | 6730 | .Nm openssl version -a | 
| @@ -6788,7 +6795,7 @@ certificate trust settings. | |||
| 6788 | Since there are a large number of options, they are split up into | 6795 | Since there are a large number of options, they are split up into | 
| 6789 | various sections. | 6796 | various sections. | 
| 6790 | .Sh X509 INPUT, OUTPUT AND GENERAL PURPOSE OPTIONS | 6797 | .Sh X509 INPUT, OUTPUT AND GENERAL PURPOSE OPTIONS | 
| 6791 | .Bd -ragged -offset indent | 6798 | .Bl -tag -width "XXXX" | 
| 6792 | .It Fl inform Ar DER|PEM|NET | 6799 | .It Fl inform Ar DER|PEM|NET | 
| 6793 | This specifies the input format. | 6800 | This specifies the input format. | 
| 6794 | Normally the command will expect an X509 certificate, | 6801 | Normally the command will expect an X509 certificate, | 
| @@ -6806,7 +6813,7 @@ option is an obscure Netscape server format that is now | |||
| 6806 | obsolete. | 6813 | obsolete. | 
| 6807 | .It Fl outform Ar DER|PEM|NET | 6814 | .It Fl outform Ar DER|PEM|NET | 
| 6808 | This specifies the output format; | 6815 | This specifies the output format; | 
| 6809 | the options have the same meaning as the | 6816 | the options have the same meaning as the | 
| 6810 | .Fl inform | 6817 | .Fl inform | 
| 6811 | option. | 6818 | option. | 
| 6812 | .It Fl in Ar filename | 6819 | .It Fl in Ar filename | 
| @@ -6828,7 +6835,7 @@ options. | |||
| 6828 | If not specified then MD5 is used. | 6835 | If not specified then MD5 is used. | 
| 6829 | If the key being used to sign with is a DSA key then | 6836 | If the key being used to sign with is a DSA key then | 
| 6830 | this option has no effect: SHA1 is always used with DSA keys. | 6837 | this option has no effect: SHA1 is always used with DSA keys. | 
| 6831 | .Ed | 6838 | .El | 
| 6832 | .Sh X509 DISPLAY OPTIONS | 6839 | .Sh X509 DISPLAY OPTIONS | 
| 6833 | .Sy Note : | 6840 | .Sy Note : | 
| 6834 | The | 6841 | The | 
| @@ -6838,7 +6845,7 @@ and | |||
| 6838 | options are also display options but are described in the | 6845 | options are also display options but are described in the | 
| 6839 | .Sx X509 TRUST OPTIONS | 6846 | .Sx X509 TRUST OPTIONS | 
| 6840 | section. | 6847 | section. | 
| 6841 | .Bd -ragged -offset indent | 6848 | .Bl -tag -width "XXXX" | 
| 6842 | .It Fl text | 6849 | .It Fl text | 
| 6843 | Prints out the certificate in text form. | 6850 | Prints out the certificate in text form. | 
| 6844 | Full details are output including the public key, signature algorithms, | 6851 | Full details are output including the public key, signature algorithms, | 
| @@ -6902,7 +6909,7 @@ Prints out the digest of the DER encoded version of the whole certificate | |||
| 6902 | .Sx DIGEST OPTIONS ) . | 6909 | .Sx DIGEST OPTIONS ) . | 
| 6903 | .It Fl C | 6910 | .It Fl C | 
| 6904 | This outputs the certificate in the form of a C source file. | 6911 | This outputs the certificate in the form of a C source file. | 
| 6905 | .Ed | 6912 | .El | 
| 6906 | .Sh X509 TRUST SETTINGS | 6913 | .Sh X509 TRUST SETTINGS | 
| 6907 | Please note these options are currently experimental and may well change. | 6914 | Please note these options are currently experimental and may well change. | 
| 6908 | .Pp | 6915 | .Pp | 
| @@ -6930,7 +6937,7 @@ utility for more information on the meaning of trust settings. | |||
| 6930 | Future versions of | 6937 | Future versions of | 
| 6931 | .Nm OpenSSL | 6938 | .Nm OpenSSL | 
| 6932 | will recognize trust settings on any certificate: not just root CAs. | 6939 | will recognize trust settings on any certificate: not just root CAs. | 
| 6933 | .Bd -ragged -offset indent | 6940 | .Bl -tag -width "XXXX" | 
| 6934 | .It Fl trustout | 6941 | .It Fl trustout | 
| 6935 | This causes | 6942 | This causes | 
| 6936 | .Nm x509 | 6943 | .Nm x509 | 
| @@ -6984,17 +6991,17 @@ the results. | |||
| 6984 | For a more complete description see the | 6991 | For a more complete description see the | 
| 6985 | .Sx X509 CERTIFICATE EXTENSIONS | 6992 | .Sx X509 CERTIFICATE EXTENSIONS | 
| 6986 | section. | 6993 | section. | 
| 6987 | .Ed | 6994 | .El | 
| 6988 | .Sh X509 SIGNING OPTIONS | 6995 | .Sh X509 SIGNING OPTIONS | 
| 6989 | The | 6996 | The | 
| 6990 | .Nm x509 | 6997 | .Nm x509 | 
| 6991 | utility can be used to sign certificates and requests: it | 6998 | utility can be used to sign certificates and requests: it | 
| 6992 | can thus behave like a "mini CA". | 6999 | can thus behave like a "mini CA". | 
| 6993 | .Pp | 7000 | .Pp | 
| 6994 | .Bd -ragged -offset indent | 7001 | .Bl -tag -width "XXXX" | 
| 6995 | .It Fl signkey Ar filename | 7002 | .It Fl signkey Ar filename | 
| 6996 | This option causes the input file to be self-signed using the supplied | 7003 | This option causes the input file to be self-signed using the supplied | 
| 6997 | private key. | 7004 | private key. | 
| 6998 | .Pp | 7005 | .Pp | 
| 6999 | If the input file is a certificate, it sets the issuer name to the | 7006 | If the input file is a certificate, it sets the issuer name to the | 
| 7000 | subject name (i.e. makes it self-signed), changes the public key to the | 7007 | subject name (i.e. makes it self-signed), changes the public key to the | 
| @@ -7091,7 +7098,7 @@ to the file again. | |||
| 7091 | The default filename consists of the CA certificate file base name with | 7098 | The default filename consists of the CA certificate file base name with | 
| 7092 | .Pa .srl | 7099 | .Pa .srl | 
| 7093 | appended. | 7100 | appended. | 
| 7094 | For example if the CA certificate file is called | 7101 | For example if the CA certificate file is called | 
| 7095 | .Pa mycacert.pem , | 7102 | .Pa mycacert.pem , | 
| 7096 | it expects to find a serial number file called | 7103 | it expects to find a serial number file called | 
| 7097 | .Pa mycacert.srl . | 7104 | .Pa mycacert.srl . | 
| @@ -7110,7 +7117,7 @@ The section to add certificate extensions from. | |||
| 7110 | If this option is not specified then the extensions should either be | 7117 | If this option is not specified then the extensions should either be | 
| 7111 | contained in the unnamed (default) section or the default section should | 7118 | contained in the unnamed (default) section or the default section should | 
| 7112 | contain a variable called "extensions" which contains the section to use. | 7119 | contain a variable called "extensions" which contains the section to use. | 
| 7113 | .Ed | 7120 | .El | 
| 7114 | .Sh X509 NAME OPTIONS | 7121 | .Sh X509 NAME OPTIONS | 
| 7115 | The | 7122 | The | 
| 7116 | .Fl nameopt | 7123 | .Fl nameopt | 
| @@ -7126,7 +7133,7 @@ a | |||
| 7126 | .Cm \&- | 7133 | .Cm \&- | 
| 7127 | to turn the option off. | 7134 | to turn the option off. | 
| 7128 | Only the first four will normally be used. | 7135 | Only the first four will normally be used. | 
| 7129 | .Bd -ragged -offset indent | 7136 | .Bl -tag -width "XXXX" | 
| 7130 | .It Ar compat | 7137 | .It Ar compat | 
| 7131 | Use the old format. | 7138 | Use the old format. | 
| 7132 | This is equivalent to specifying no name options at all. | 7139 | This is equivalent to specifying no name options at all. | 
| @@ -7253,7 +7260,7 @@ Only usable with | |||
| 7253 | Places spaces round the | 7260 | Places spaces round the | 
| 7254 | .Cm \&= | 7261 | .Cm \&= | 
| 7255 | character which follows the field name. | 7262 | character which follows the field name. | 
| 7256 | .Ed | 7263 | .El | 
| 7257 | .Sh X509 TEXT OPTIONS | 7264 | .Sh X509 TEXT OPTIONS | 
| 7258 | As well as customising the name output format, it is also possible to | 7265 | As well as customising the name output format, it is also possible to | 
| 7259 | customise the actual fields printed using the | 7266 | customise the actual fields printed using the | 
| @@ -7262,7 +7269,7 @@ options when the | |||
| 7262 | .Fl text | 7269 | .Fl text | 
| 7263 | option is present. | 7270 | option is present. | 
| 7264 | The default behaviour is to print all fields. | 7271 | The default behaviour is to print all fields. | 
| 7265 | .Bd -ragged -offset indent | 7272 | .Bl -tag -width "XXXX" | 
| 7266 | .It Ar compatible | 7273 | .It Ar compatible | 
| 7267 | Use the old format. | 7274 | Use the old format. | 
| 7268 | This is equivalent to specifying no output options at all. | 7275 | This is equivalent to specifying no output options at all. | 
| @@ -7310,7 +7317,7 @@ utility, equivalent to | |||
| 7310 | .Ar no_version , no_sigdump | 7317 | .Ar no_version , no_sigdump | 
| 7311 | and | 7318 | and | 
| 7312 | .Ar no_signame . | 7319 | .Ar no_signame . | 
| 7313 | .Ed | 7320 | .El | 
| 7314 | .Sh X509 EXAMPLES | 7321 | .Sh X509 EXAMPLES | 
| 7315 | .Sy Note : | 7322 | .Sy Note : | 
| 7316 | In these examples the '\e' means the example should be all on one | 7323 | In these examples the '\e' means the example should be all on one | 
| @@ -7487,7 +7494,7 @@ and V1 certificates above apply to | |||
| 7487 | .Em all | 7494 | .Em all | 
| 7488 | CA certificates. | 7495 | CA certificates. | 
| 7489 | .Pp | 7496 | .Pp | 
| 7490 | .Bd -ragged -offset indent | 7497 | .Bl -tag -width "XXXX" | 
| 7491 | .It Ar SSL Client | 7498 | .It Ar SSL Client | 
| 7492 | The extended key usage extension must be absent or include the | 7499 | The extended key usage extension must be absent or include the | 
| 7493 | "web client authentication" OID. | 7500 | "web client authentication" OID. | 
| @@ -7566,7 +7573,7 @@ Netscape certificate type must be absent or must have the | |||
| 7566 | .Em S/MIME CA | 7573 | .Em S/MIME CA | 
| 7567 | bit set: this is used as a work around if the | 7574 | bit set: this is used as a work around if the | 
| 7568 | .Em basicConstraints | 7575 | .Em basicConstraints | 
| 7569 | extension is absent. | 7576 | extension is absent. | 
| 7570 | .It Ar CRL Signing | 7577 | .It Ar CRL Signing | 
| 7571 | The | 7578 | The | 
| 7572 | .Em keyUsage | 7579 | .Em keyUsage | 
| @@ -7578,6 +7585,7 @@ The normal CA tests apply. | |||
| 7578 | Except in this case the | 7585 | Except in this case the | 
| 7579 | .Em basicConstraints | 7586 | .Em basicConstraints | 
| 7580 | extension must be present. | 7587 | extension must be present. | 
| 7588 | .El | ||
| 7581 | .Sh X509 BUGS | 7589 | .Sh X509 BUGS | 
| 7582 | Extensions in certificates are not transferred to certificate requests and | 7590 | Extensions in certificates are not transferred to certificate requests and | 
| 7583 | vice versa. | 7591 | vice versa. | 
