Update build for OpenSSL-0.9.8j upgrade.
[dragonfly.git] / secure / usr.bin / openssl / man / smime.1
index 1c376de..2d346fc 100644 (file)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
 .\"
 .\" 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.  | 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
+.\" 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-
 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 .ie n \{\
 .    ds -- \(*W-
 .    ds R" ''
 'br\}
 .\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
 .\" If the F register is turned on, we'll generate index entries on stderr for
 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
 .\" entries marked with X<> in POD.  Of course, you'll have to process the
 .\" output yourself in some meaningful fashion.
-.if \nF \{\
+.ie \nF \{\
 .    de IX
 .    tm Index:\\$1\t\\n%\t"\\$2"
 ..
 .    nr % 0
 .    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
+.el \{\
+.    de IX
+..
+.\}
 .\"
 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 .\" ========================================================================
 .\"
 .IX Title "SMIME 1"
-.TH SMIME 1 "2008-09-27" "0.9.8i" "OpenSSL"
+.TH SMIME 1 "2009-01-11" "0.9.8j" "OpenSSL"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
 .SH "NAME"
 smime \- S/MIME utility
 .SH "SYNOPSIS"
@@ -315,12 +322,12 @@ see the \fB\s-1PASS\s0 \s-1PHRASE\s0 \s-1ARGUMENTS\s0\fR section in \fIopenssl\f
 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 "\fBcert.pem...\fR" 4
 .IX Item "cert.pem..."
 one or more certificates of message recipients: used when encrypting
-a message. 
+a message.
 .IP "\fB\-to, \-from, \-subject\fR" 4
 .IX Item "-to, -from, -subject"
 the relevant mail headers. These are included outside the signed
@@ -377,54 +384,54 @@ the signers certificates.
 Create a cleartext signed message:
 .PP
 .Vb 2
-\& openssl smime -sign -in message.txt -text -out mail.msg \e
-\&        -signer mycert.pem
+\& openssl smime \-sign \-in message.txt \-text \-out mail.msg \e
+\&        \-signer mycert.pem
 .Ve
 .PP
 Create and opaque signed message
 .PP
 .Vb 2
-\& openssl smime -sign -in message.txt -text -out mail.msg -nodetach \e
-\&        -signer mycert.pem
+\& openssl smime \-sign \-in message.txt \-text \-out mail.msg \-nodetach \e
+\&        \-signer mycert.pem
 .Ve
 .PP
 Create a signed message, include some additional certificates and
 read the private key from another file:
 .PP
 .Vb 2
-\& openssl smime -sign -in in.txt -text -out mail.msg \e
-\&        -signer mycert.pem -inkey mykey.pem -certfile mycerts.pem
+\& openssl smime \-sign \-in in.txt \-text \-out mail.msg \e
+\&        \-signer mycert.pem \-inkey mykey.pem \-certfile mycerts.pem
 .Ve
 .PP
 Send a signed message under Unix directly to sendmail, including headers:
 .PP
 .Vb 3
-\& openssl smime -sign -in in.txt -text -signer mycert.pem \e
-\&        -from steve@openssl.org -to someone@somewhere \e
-\&        -subject "Signed message" | sendmail someone@somewhere
+\& openssl smime \-sign \-in in.txt \-text \-signer mycert.pem \e
+\&        \-from steve@openssl.org \-to someone@somewhere \e
+\&        \-subject "Signed message" | sendmail someone@somewhere
 .Ve
 .PP
 Verify a message and extract the signer's certificate if successful:
 .PP
 .Vb 1
-\& openssl smime -verify -in mail.msg -signer user.pem -out signedtext.txt
+\& openssl smime \-verify \-in mail.msg \-signer user.pem \-out signedtext.txt
 .Ve
 .PP
 Send encrypted mail using triple \s-1DES:\s0
 .PP
 .Vb 3
-\& openssl smime -encrypt -in in.txt -from steve@openssl.org \e
-\&        -to someone@somewhere -subject "Encrypted message" \e
-\&        -des3 user.pem -out mail.msg
+\& openssl smime \-encrypt \-in in.txt \-from steve@openssl.org \e
+\&        \-to someone@somewhere \-subject "Encrypted message" \e
+\&        \-des3 user.pem \-out mail.msg
 .Ve
 .PP
 Sign and encrypt mail:
 .PP
 .Vb 4
-\& openssl smime -sign -in ml.txt -signer my.pem -text \e
-\&        | openssl smime -encrypt -out mail.msg \e
-\&        -from steve@openssl.org -to someone@somewhere \e
-\&        -subject "Signed and Encrypted message" -des3 user.pem
+\& openssl smime \-sign \-in ml.txt \-signer my.pem \-text \e
+\&        | openssl smime \-encrypt \-out mail.msg \e
+\&        \-from steve@openssl.org \-to someone@somewhere \e
+\&        \-subject "Signed and Encrypted message" \-des3 user.pem
 .Ve
 .PP
 Note: the encryption command does not include the \fB\-text\fR option because the message
@@ -433,7 +440,7 @@ being encrypted already has \s-1MIME\s0 headers.
 Decrypt mail:
 .PP
 .Vb 1
-\& openssl smime -decrypt -in mail.msg -recip mycert.pem -inkey key.pem
+\& openssl smime \-decrypt \-in mail.msg \-recip mycert.pem \-inkey key.pem
 .Ve
 .PP
 The output from Netscape form signing is a PKCS#7 structure with the
@@ -442,26 +449,26 @@ signature by line wrapping the base64 encoded structure and surrounding
 it with:
 .PP
 .Vb 2
-\& -----BEGIN PKCS7-----
-\& -----END PKCS7-----
+\& \-\-\-\-\-BEGIN PKCS7\-\-\-\-\-
+\& \-\-\-\-\-END PKCS7\-\-\-\-\-
 .Ve
 .PP
-and using the command, 
+and using the command,
 .PP
 .Vb 1
-\& openssl smime -verify -inform PEM -in signature.pem -content content.txt
+\& openssl smime \-verify \-inform PEM \-in signature.pem \-content content.txt
 .Ve
 .PP
 alternatively you can base64 decode the signature and use
 .PP
 .Vb 1
-\& openssl smime -verify -inform DER -in signature.der -content content.txt
+\& openssl smime \-verify \-inform DER \-in signature.der \-content content.txt
 .Ve
 .PP
 Create an encrypted message using 128 bit Camellia:
 .PP
 .Vb 1
-\& openssl smime -encrypt -in plain.txt -camellia128 -out mail.msg cert.pem
+\& openssl smime \-encrypt \-in plain.txt \-camellia128 \-out mail.msg cert.pem
 .Ve
 .SH "BUGS"
 .IX Header "BUGS"