Import OpenSSL-0.9.8i.
[dragonfly.git] / crypto / openssl-0.9.7d / doc / apps / nseq.pod
blob989c3108fb83643c42f42d7a388320b028380c08
1 =pod
3 =head1 NAME
5 nseq - create or examine a netscape certificate sequence
7 =head1 SYNOPSIS
9 B<openssl> B<nseq>
10 [B<-in filename>]
11 [B<-out filename>]
12 [B<-toseq>]
14 =head1 DESCRIPTION
16 The B<nseq> command takes a file containing a Netscape certificate
17 sequence and prints out the certificates contained in it or takes a
18 file of certificates and converts it into a Netscape certificate
19 sequence.
21 =head1 COMMAND OPTIONS
23 =over 4
25 =item B<-in filename>
27 This specifies the input filename to read or standard input if this
28 option is not specified.
30 =item B<-out filename>
32 specifies the output filename or standard output by default.
34 =item B<-toseq>
36 normally a Netscape certificate sequence will be input and the output
37 is the certificates contained in it. With the B<-toseq> option the
38 situation is reversed: a Netscape certificate sequence is created from
39 a file of certificates.
41 =back
43 =head1 EXAMPLES
45 Output the certificates in a Netscape certificate sequence
47  openssl nseq -in nseq.pem -out certs.pem
49 Create a Netscape certificate sequence
51  openssl nseq -in certs.pem -toseq -out nseq.pem
53 =head1 NOTES
55 The B<PEM> encoded form uses the same headers and footers as a certificate:
57  -----BEGIN CERTIFICATE-----
58  -----END CERTIFICATE-----
60 A Netscape certificate sequence is a Netscape specific form that can be sent
61 to browsers as an alternative to the standard PKCS#7 format when several
62 certificates are sent to the browser: for example during certificate enrollment.
63 It is used by Netscape certificate server for example.
65 =head1 BUGS
67 This program needs a few more options: like allowing DER or PEM input and
68 output files and allowing multiple certificate files to be used.
70 =cut