1*b077aed3SPierre Pronchery=pod 2*b077aed3SPierre Pronchery 3*b077aed3SPierre Pronchery=begin comment 4*b077aed3SPierre Pronchery{- join("\n", @autowarntext) -} 5*b077aed3SPierre Pronchery 6*b077aed3SPierre Pronchery=end comment 7*b077aed3SPierre Pronchery 8*b077aed3SPierre Pronchery=head1 NAME 9*b077aed3SPierre Pronchery 10*b077aed3SPierre Proncheryopenssl-pkcs7 - PKCS#7 command 11*b077aed3SPierre Pronchery 12*b077aed3SPierre Pronchery=head1 SYNOPSIS 13*b077aed3SPierre Pronchery 14*b077aed3SPierre ProncheryB<openssl> B<pkcs7> 15*b077aed3SPierre Pronchery[B<-help>] 16*b077aed3SPierre Pronchery[B<-inform> B<DER>|B<PEM>] 17*b077aed3SPierre Pronchery[B<-outform> B<DER>|B<PEM>] 18*b077aed3SPierre Pronchery[B<-in> I<filename>] 19*b077aed3SPierre Pronchery[B<-out> I<filename>] 20*b077aed3SPierre Pronchery[B<-print>] 21*b077aed3SPierre Pronchery[B<-print_certs>] 22*b077aed3SPierre Pronchery[B<-text>] 23*b077aed3SPierre Pronchery[B<-noout>] 24*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_engine_synopsis -}{- $OpenSSL::safe::opt_provider_synopsis -} 25*b077aed3SPierre Pronchery 26*b077aed3SPierre Pronchery=head1 DESCRIPTION 27*b077aed3SPierre Pronchery 28*b077aed3SPierre ProncheryThis command processes PKCS#7 files. Note that it only understands PKCS#7 29*b077aed3SPierre Proncheryv 1.5 as specified in IETF RFC 2315. It cannot currently parse CMS as 30*b077aed3SPierre Proncherydescribed in IETF RFC 2630. 31*b077aed3SPierre Pronchery 32*b077aed3SPierre Pronchery=head1 OPTIONS 33*b077aed3SPierre Pronchery 34*b077aed3SPierre Pronchery=over 4 35*b077aed3SPierre Pronchery 36*b077aed3SPierre Pronchery=item B<-help> 37*b077aed3SPierre Pronchery 38*b077aed3SPierre ProncheryPrint out a usage message. 39*b077aed3SPierre Pronchery 40*b077aed3SPierre Pronchery=item B<-inform> B<DER>|B<PEM>, B<-outform> B<DER>|B<PEM> 41*b077aed3SPierre Pronchery 42*b077aed3SPierre ProncheryThe input and formats; the default is B<PEM>. 43*b077aed3SPierre ProncherySee L<openssl-format-options(1)> for details. 44*b077aed3SPierre Pronchery 45*b077aed3SPierre ProncheryThe data is a PKCS#7 Version 1.5 structure. 46*b077aed3SPierre Pronchery 47*b077aed3SPierre Pronchery=item B<-in> I<filename> 48*b077aed3SPierre Pronchery 49*b077aed3SPierre ProncheryThis specifies the input filename to read from or standard input if this 50*b077aed3SPierre Proncheryoption is not specified. 51*b077aed3SPierre Pronchery 52*b077aed3SPierre Pronchery=item B<-out> I<filename> 53*b077aed3SPierre Pronchery 54*b077aed3SPierre ProncherySpecifies the output filename to write to or standard output by 55*b077aed3SPierre Proncherydefault. 56*b077aed3SPierre Pronchery 57*b077aed3SPierre Pronchery=item B<-print> 58*b077aed3SPierre Pronchery 59*b077aed3SPierre ProncheryPrint out the full PKCS7 object. 60*b077aed3SPierre Pronchery 61*b077aed3SPierre Pronchery=item B<-print_certs> 62*b077aed3SPierre Pronchery 63*b077aed3SPierre ProncheryPrints out any certificates or CRLs contained in the file. They are 64*b077aed3SPierre Proncherypreceded by their subject and issuer names in one line format. 65*b077aed3SPierre Pronchery 66*b077aed3SPierre Pronchery=item B<-text> 67*b077aed3SPierre Pronchery 68*b077aed3SPierre ProncheryPrints out certificate details in full rather than just subject and 69*b077aed3SPierre Proncheryissuer names. 70*b077aed3SPierre Pronchery 71*b077aed3SPierre Pronchery=item B<-noout> 72*b077aed3SPierre Pronchery 73*b077aed3SPierre ProncheryDon't output the encoded version of the PKCS#7 structure (or certificates 74*b077aed3SPierre Proncheryif B<-print_certs> is set). 75*b077aed3SPierre Pronchery 76*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_engine_item -} 77*b077aed3SPierre Pronchery 78*b077aed3SPierre Pronchery{- $OpenSSL::safe::opt_provider_item -} 79*b077aed3SPierre Pronchery 80*b077aed3SPierre Pronchery=back 81*b077aed3SPierre Pronchery 82*b077aed3SPierre Pronchery=head1 EXAMPLES 83*b077aed3SPierre Pronchery 84*b077aed3SPierre ProncheryConvert a PKCS#7 file from PEM to DER: 85*b077aed3SPierre Pronchery 86*b077aed3SPierre Pronchery openssl pkcs7 -in file.pem -outform DER -out file.der 87*b077aed3SPierre Pronchery 88*b077aed3SPierre ProncheryOutput all certificates in a file: 89*b077aed3SPierre Pronchery 90*b077aed3SPierre Pronchery openssl pkcs7 -in file.pem -print_certs -out certs.pem 91*b077aed3SPierre Pronchery 92*b077aed3SPierre Pronchery=head1 SEE ALSO 93*b077aed3SPierre Pronchery 94*b077aed3SPierre ProncheryL<openssl(1)>, 95*b077aed3SPierre ProncheryL<openssl-crl2pkcs7(1)> 96*b077aed3SPierre Pronchery 97*b077aed3SPierre Pronchery=head1 HISTORY 98*b077aed3SPierre Pronchery 99*b077aed3SPierre ProncheryThe B<-engine> option was deprecated in OpenSSL 3.0. 100*b077aed3SPierre Pronchery 101*b077aed3SPierre Pronchery=head1 COPYRIGHT 102*b077aed3SPierre Pronchery 103*b077aed3SPierre ProncheryCopyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved. 104*b077aed3SPierre Pronchery 105*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License"). You may not use 106*b077aed3SPierre Proncherythis file except in compliance with the License. You can obtain a copy 107*b077aed3SPierre Proncheryin the file LICENSE in the source distribution or at 108*b077aed3SPierre ProncheryL<https://www.openssl.org/source/license.html>. 109*b077aed3SPierre Pronchery 110*b077aed3SPierre Pronchery=cut 111