=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/openssl/openssl.1,v retrieving revision 1.56 retrieving revision 1.57 diff -u -r1.56 -r1.57 --- src/usr.bin/openssl/openssl.1 2016/08/20 07:56:09 1.56 +++ src/usr.bin/openssl/openssl.1 2016/08/20 12:54:49 1.57 @@ -1,4 +1,4 @@ -.\" $OpenBSD: openssl.1,v 1.56 2016/08/20 07:56:09 jmc Exp $ +.\" $OpenBSD: openssl.1,v 1.57 2016/08/20 12:54:49 jmc Exp $ .\" ==================================================================== .\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved. .\" @@ -1729,7 +1729,7 @@ This is the default. .It Fl in Ar file The input file to read from, -or standard input if none is specified. +or standard input if not specified. .It Fl iv Ar IV The actual .Ar IV @@ -1801,7 +1801,7 @@ attacks on the password and to attack stream cipher encrypted data. .It Fl out Ar file The output file to write to, -or standard output if none is specified. +or standard output if not specified. .It Fl P Print out the salt, key, and IV used, then immediately exit; don't do any encryption or decryption. @@ -1885,7 +1885,7 @@ If none of these options are specified, no encryption is used. .It Fl out Ar file The output file to write to, -or standard output if none is specified. +or standard output if not specified. .It Ar paramfile Specify the DSA parameter file to use. The parameters in this file determine the size of the private key. @@ -1939,7 +1939,7 @@ options. .It Fl out Ar file The output file to write to, -or standard output if none is specified. +or standard output if not specified. .It Fl outform Cm der | pem The output format. .It Fl paramfile Ar file @@ -2032,7 +2032,7 @@ option. .It Fl out Ar file The output file to write to, -or standard output if none is specified. +or standard output if not specified. .It Fl passout Ar arg The output file password source. .It Ar numbits @@ -2223,7 +2223,7 @@ since it disables all verification of the responder's certificate. .It Fl out Ar file Specify the output file to write to, -or standard output if none is specified. +or standard output if not specified. .It Fl req_text , resp_text , text Print out the text form of the OCSP request, response, or both, respectively. .It Fl reqin Ar file , Fl respin Ar file @@ -2481,39 +2481,47 @@ In the output list, prepend the cleartext password and a TAB character to each password hash. .El -.\" -.\" PKCS7 -.\" .Sh PKCS7 .nr nS 1 .Nm "openssl pkcs7" -.Bk -words .Op Fl in Ar file -.Op Fl inform Ar DER | PEM +.Op Fl inform Cm der | pem .Op Fl noout .Op Fl out Ar file -.Op Fl outform Ar DER | PEM +.Op Fl outform Cm der | pem .Op Fl print_certs .Op Fl text -.Ek .nr nS 0 .Pp The .Nm pkcs7 command processes PKCS#7 files in DER or PEM format. +The PKCS#7 routines only understand PKCS#7 v 1.5 as specified in RFC 2315. +They cannot currently parse, for example, the new CMS as described in RFC 2630. .Pp +The PEM PKCS#7 format uses the header and footer lines: +.Bd -unfilled -offset indent +-----BEGIN PKCS7----- +-----END PKCS7----- +.Ed +.Pp +For compatibility with some CAs it will also accept: +.Bd -unfilled -offset indent +-----BEGIN CERTIFICATE----- +-----END CERTIFICATE----- +.Ed +.Pp The options are as follows: .Bl -tag -width Ds .It Fl in Ar file -This specifies the input -.Ar file -to read from, or standard input if this option is not specified. -.It Fl inform Ar DER | PEM -This specifies the input format. -.Ar DER +The input file to read from, +or standard input if not specified. +.It Fl inform Cm der | pem +The input format. +.Cm der format is a DER-encoded PKCS#7 v1.5 structure. -.Ar PEM -.Pq the default +.Cm pem +(the default) is a base64-encoded version of the DER form with header and footer lines. .It Fl noout Don't output the encoded version of the PKCS#7 structure @@ -2521,45 +2529,16 @@ .Fl print_certs is set). .It Fl out Ar file -Specifies the output -.Ar file -to write to, or standard output by default. -.It Fl outform Ar DER | PEM -This specifies the output format; the options have the same meaning as the -.Fl inform -option. +The output to write to, +or standard output if not specified. +.It Fl outform Cm der | pem +The output format. .It Fl print_certs -Prints out any certificates or CRLs contained in the file. -They are preceded by their subject and issuer names in a one-line format. +Print any certificates or CRLs contained in the file, +preceded by their subject and issuer names in a one-line format. .It Fl text -Prints out certificate details in full rather than just subject and -issuer names. +Print certificate details in full rather than just subject and issuer names. .El -.Sh PKCS7 EXAMPLES -Convert a PKCS#7 file from PEM to DER: -.Pp -.Dl $ openssl pkcs7 -in file.pem -outform DER -out file.der -.Pp -Output all certificates in a file: -.Pp -.Dl $ openssl pkcs7 -in file.pem -print_certs -out certs.pem -.Sh PKCS7 NOTES -The PEM PKCS#7 format uses the header and footer lines: -.Bd -unfilled -offset indent ------BEGIN PKCS7----- ------END PKCS7----- -.Ed -.Pp -For compatibility with some CAs it will also accept: -.Bd -unfilled -offset indent ------BEGIN CERTIFICATE----- ------END CERTIFICATE----- -.Ed -.Sh PKCS7 RESTRICTIONS -There is no option to print out all the fields of a PKCS#7 file. -.Pp -The PKCS#7 routines only understand PKCS#7 v 1.5 as specified in RFC 2315. -They cannot currently parse, for example, the new CMS as described in RFC 2630. .\" .\" PKCS8 .\"