xref: /onnv-gate/usr/src/common/openssl/doc/apps/nseq.pod (revision 2175:b0b2f052a486)
1*2175Sjp161948=pod
2*2175Sjp161948
3*2175Sjp161948=head1 NAME
4*2175Sjp161948
5*2175Sjp161948nseq - create or examine a netscape certificate sequence
6*2175Sjp161948
7*2175Sjp161948=head1 SYNOPSIS
8*2175Sjp161948
9*2175Sjp161948B<openssl> B<nseq>
10*2175Sjp161948[B<-in filename>]
11*2175Sjp161948[B<-out filename>]
12*2175Sjp161948[B<-toseq>]
13*2175Sjp161948
14*2175Sjp161948=head1 DESCRIPTION
15*2175Sjp161948
16*2175Sjp161948The B<nseq> command takes a file containing a Netscape certificate
17*2175Sjp161948sequence and prints out the certificates contained in it or takes a
18*2175Sjp161948file of certificates and converts it into a Netscape certificate
19*2175Sjp161948sequence.
20*2175Sjp161948
21*2175Sjp161948=head1 COMMAND OPTIONS
22*2175Sjp161948
23*2175Sjp161948=over 4
24*2175Sjp161948
25*2175Sjp161948=item B<-in filename>
26*2175Sjp161948
27*2175Sjp161948This specifies the input filename to read or standard input if this
28*2175Sjp161948option is not specified.
29*2175Sjp161948
30*2175Sjp161948=item B<-out filename>
31*2175Sjp161948
32*2175Sjp161948specifies the output filename or standard output by default.
33*2175Sjp161948
34*2175Sjp161948=item B<-toseq>
35*2175Sjp161948
36*2175Sjp161948normally a Netscape certificate sequence will be input and the output
37*2175Sjp161948is the certificates contained in it. With the B<-toseq> option the
38*2175Sjp161948situation is reversed: a Netscape certificate sequence is created from
39*2175Sjp161948a file of certificates.
40*2175Sjp161948
41*2175Sjp161948=back
42*2175Sjp161948
43*2175Sjp161948=head1 EXAMPLES
44*2175Sjp161948
45*2175Sjp161948Output the certificates in a Netscape certificate sequence
46*2175Sjp161948
47*2175Sjp161948 openssl nseq -in nseq.pem -out certs.pem
48*2175Sjp161948
49*2175Sjp161948Create a Netscape certificate sequence
50*2175Sjp161948
51*2175Sjp161948 openssl nseq -in certs.pem -toseq -out nseq.pem
52*2175Sjp161948
53*2175Sjp161948=head1 NOTES
54*2175Sjp161948
55*2175Sjp161948The B<PEM> encoded form uses the same headers and footers as a certificate:
56*2175Sjp161948
57*2175Sjp161948 -----BEGIN CERTIFICATE-----
58*2175Sjp161948 -----END CERTIFICATE-----
59*2175Sjp161948
60*2175Sjp161948A Netscape certificate sequence is a Netscape specific form that can be sent
61*2175Sjp161948to browsers as an alternative to the standard PKCS#7 format when several
62*2175Sjp161948certificates are sent to the browser: for example during certificate enrollment.
63*2175Sjp161948It is used by Netscape certificate server for example.
64*2175Sjp161948
65*2175Sjp161948=head1 BUGS
66*2175Sjp161948
67*2175Sjp161948This program needs a few more options: like allowing DER or PEM input and
68*2175Sjp161948output files and allowing multiple certificate files to be used.
69*2175Sjp161948
70*2175Sjp161948=cut
71