|
Packit |
c4476c |
=pod
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 NAME
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
openssl-pkcs7,
|
|
Packit |
c4476c |
pkcs7 - PKCS#7 utility
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 SYNOPSIS
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
B<openssl> B<pkcs7>
|
|
Packit |
c4476c |
[B<-help>]
|
|
Packit |
c4476c |
[B<-inform PEM|DER>]
|
|
Packit |
c4476c |
[B<-outform PEM|DER>]
|
|
Packit |
c4476c |
[B<-in filename>]
|
|
Packit |
c4476c |
[B<-out filename>]
|
|
Packit |
c4476c |
[B<-print_certs>]
|
|
Packit |
c4476c |
[B<-text>]
|
|
Packit |
c4476c |
[B<-noout>]
|
|
Packit |
c4476c |
[B<-engine id>]
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 DESCRIPTION
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
The B<pkcs7> command processes PKCS#7 files in DER or PEM format.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 OPTIONS
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=over 4
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-help>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Print out a usage message.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-inform DER|PEM>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
This specifies the input format. B<DER> format is DER encoded PKCS#7
|
|
Packit |
c4476c |
v1.5 structure.B<PEM> (the default) is a base64 encoded version of
|
|
Packit |
c4476c |
the DER form with header and footer lines.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-outform DER|PEM>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
This specifies the output format, the options have the same meaning and default
|
|
Packit |
c4476c |
as the B<-inform> option.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-in filename>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
This specifies the input filename to read from or standard input if this
|
|
Packit |
c4476c |
option is not specified.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-out filename>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Specifies the output filename to write to or standard output by
|
|
Packit |
c4476c |
default.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-print_certs>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Prints out any certificates or CRLs contained in the file. They are
|
|
Packit |
c4476c |
preceded by their subject and issuer names in one line format.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-text>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Prints out certificates details in full rather than just subject and
|
|
Packit |
c4476c |
issuer names.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-noout>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Don't output the encoded version of the PKCS#7 structure (or certificates
|
|
Packit |
c4476c |
is B<-print_certs> is set).
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=item B<-engine id>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Specifying an engine (by its unique B<id> string) will cause B<pkcs7>
|
|
Packit |
c4476c |
to attempt to obtain a functional reference to the specified engine,
|
|
Packit |
c4476c |
thus initialising it if needed. The engine will then be set as the default
|
|
Packit |
c4476c |
for all available algorithms.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=back
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 EXAMPLES
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Convert a PKCS#7 file from PEM to DER:
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
openssl pkcs7 -in file.pem -outform DER -out file.der
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Output all certificates in a file:
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
openssl pkcs7 -in file.pem -print_certs -out certs.pem
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 NOTES
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
The PEM PKCS#7 format uses the header and footer lines:
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
-----BEGIN PKCS7-----
|
|
Packit |
c4476c |
-----END PKCS7-----
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
For compatibility with some CAs it will also accept:
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
-----BEGIN CERTIFICATE-----
|
|
Packit |
c4476c |
-----END CERTIFICATE-----
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 RESTRICTIONS
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
There is no option to print out all the fields of a PKCS#7 file.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
This PKCS#7 routines only understand PKCS#7 v 1.5 as specified in RFC2315 they
|
|
Packit |
c4476c |
cannot currently parse, for example, the new CMS as described in RFC2630.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 SEE ALSO
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
L<crl2pkcs7(1)>
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=head1 COPYRIGHT
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
Licensed under the OpenSSL license (the "License"). You may not use
|
|
Packit |
c4476c |
this file except in compliance with the License. You can obtain a copy
|
|
Packit |
c4476c |
in the file LICENSE in the source distribution or at
|
|
Packit |
c4476c |
L<https://www.openssl.org/source/license.html>.
|
|
Packit |
c4476c |
|
|
Packit |
c4476c |
=cut
|