Upgrade to OpenSSL 0.9.8h.
[dragonfly.git] / secure / usr.bin / openssl / man / req.1
index 4a6ab27..5098170 100644 (file)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.12 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
 .\"
 .\" Standard preamble:
 .\" ========================================================================
 ..
 .\" Set up some character translations and predefined strings.  \*(-- will
 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
-.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
+.\" double quote, and \*(R" will give a right double quote.  | will give a
+.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
+.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
+.\" expand to `' in nroff, nothing in troff, for use with C<>.
+.tr \(*W-|\(bv\*(Tr
 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 .ie n \{\
 .    ds -- \(*W-
 .    rr F
 .\}
 .\"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.hy 0
+.if n .na
+.\"
 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 .    \" fudge factors for nroff and troff
 .\" ========================================================================
 .\"
 .IX Title "REQ 1"
-.TH REQ 1 "2007-10-24" "0.9.8g" "OpenSSL"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.if n .ad l
-.nh
+.TH REQ 1 "2008-09-06" "0.9.8h" "OpenSSL"
 .SH "NAME"
 req \- PKCS#10 certificate request and certificate generating utility.
 .SH "SYNOPSIS"
@@ -233,7 +234,7 @@ key using information specified in the configuration file.
 a file or files containing random data used to seed the random number
 generator, or an \s-1EGD\s0 socket (see \fIRAND_egd\fR\|(3)).
 Multiple files can be specified separated by a OS-dependent character.
-The separator is \fB;\fR for MS-Windows, \fB,\fR for OpenVMS, and \fB:\fR for
+The separator is \fB;\fR for MS\-Windows, \fB,\fR for OpenVMS, and \fB:\fR for
 all others.
 .IP "\fB\-newkey arg\fR" 4
 .IX Item "-newkey arg"
@@ -382,7 +383,7 @@ overridden by the \fB\-keyout\fR option.
 This specifies a file containing additional \fB\s-1OBJECT\s0 \s-1IDENTIFIERS\s0\fR.
 Each line of the file should consist of the numerical form of the
 object identifier followed by white space then the short name followed
-by white space and finally the long name.
+by white space and finally the long name. 
 .IP "\fBoid_section\fR" 4
 .IX Item "oid_section"
 This specifies a section in the configuration file containing extra
@@ -508,26 +509,26 @@ will be treated as though they were a DirectoryString.
 Examine and verify certificate request:
 .PP
 .Vb 1
-\& openssl req \-in req.pem \-text \-verify \-noout
+\& openssl req -in req.pem -text -verify -noout
 .Ve
 .PP
 Create a private key and then generate a certificate request from it:
 .PP
 .Vb 2
-\& openssl genrsa \-out key.pem 1024
-\& openssl req \-new \-key key.pem \-out req.pem
+\& openssl genrsa -out key.pem 1024
+\& openssl req -new -key key.pem -out req.pem
 .Ve
 .PP
 The same but just using req:
 .PP
 .Vb 1
-\& openssl req \-newkey rsa:1024 \-keyout key.pem \-out req.pem
+\& openssl req -newkey rsa:1024 -keyout key.pem -out req.pem
 .Ve
 .PP
 Generate a self signed root certificate:
 .PP
 .Vb 1
-\& openssl req \-x509 \-newkey rsa:1024 \-keyout key.pem \-out req.pem
+\& openssl req -x509 -newkey rsa:1024 -keyout key.pem -out req.pem
 .Ve
 .PP
 Example of a file pointed to by the \fBoid_file\fR option:
@@ -554,32 +555,50 @@ Sample configuration file prompting for field values:
 \& distinguished_name     = req_distinguished_name
 \& attributes             = req_attributes
 \& x509_extensions        = v3_ca
-\&
+.Ve
+.PP
+.Vb 1
 \& dirstring_type = nobmp
-\&
+.Ve
+.PP
+.Vb 5
 \& [ req_distinguished_name ]
 \& countryName                    = Country Name (2 letter code)
 \& countryName_default            = AU
 \& countryName_min                = 2
 \& countryName_max                = 2
-\&
+.Ve
+.PP
+.Vb 1
 \& localityName                   = Locality Name (eg, city)
-\&
+.Ve
+.PP
+.Vb 1
 \& organizationalUnitName         = Organizational Unit Name (eg, section)
-\&
+.Ve
+.PP
+.Vb 2
 \& commonName                     = Common Name (eg, YOUR name)
 \& commonName_max                 = 64
-\&
+.Ve
+.PP
+.Vb 2
 \& emailAddress                   = Email Address
 \& emailAddress_max               = 40
-\&
+.Ve
+.PP
+.Vb 4
 \& [ req_attributes ]
 \& challengePassword              = A challenge password
 \& challengePassword_min          = 4
 \& challengePassword_max          = 20
-\&
+.Ve
+.PP
+.Vb 1
 \& [ v3_ca ]
-\&
+.Ve
+.PP
+.Vb 3
 \& subjectKeyIdentifier=hash
 \& authorityKeyIdentifier=keyid:always,issuer:always
 \& basicConstraints = CA:true
@@ -589,7 +608,9 @@ Sample configuration containing all field values:
 .PP
 .Vb 1
 \& RANDFILE               = $ENV::HOME/.rnd
-\&
+.Ve
+.PP
+.Vb 7
 \& [ req ]
 \& default_bits           = 1024
 \& default_keyfile        = keyfile.pem
@@ -597,7 +618,9 @@ Sample configuration containing all field values:
 \& attributes             = req_attributes
 \& prompt                 = no
 \& output_password        = mypass
-\&
+.Ve
+.PP
+.Vb 8
 \& [ req_distinguished_name ]
 \& C                      = GB
 \& ST                     = Test State or Province
@@ -606,7 +629,9 @@ Sample configuration containing all field values:
 \& OU                     = Organizational Unit Name
 \& CN                     = Common Name
 \& emailAddress           = test@email.address
-\&
+.Ve
+.PP
+.Vb 2
 \& [ req_attributes ]
 \& challengePassword              = A challenge password
 .Ve
@@ -615,15 +640,15 @@ Sample configuration containing all field values:
 The header and footer lines in the \fB\s-1PEM\s0\fR format are normally:
 .PP
 .Vb 2
-\& \-\-\-\-\-BEGIN CERTIFICATE REQUEST\-\-\-\-\-
-\& \-\-\-\-\-END CERTIFICATE REQUEST\-\-\-\-\-
+\& -----BEGIN CERTIFICATE REQUEST-----
+\& -----END CERTIFICATE REQUEST-----
 .Ve
 .PP
 some software (some versions of Netscape certificate server) instead needs:
 .PP
 .Vb 2
-\& \-\-\-\-\-BEGIN NEW CERTIFICATE REQUEST\-\-\-\-\-
-\& \-\-\-\-\-END NEW CERTIFICATE REQUEST\-\-\-\-\-
+\& -----BEGIN NEW CERTIFICATE REQUEST-----
+\& -----END NEW CERTIFICATE REQUEST-----
 .Ve
 .PP
 which is produced with the \fB\-newhdr\fR option but is otherwise compatible.