4765aecea843620dc1c0026a71a17e48c65da21d
[openssl.git] / doc / man1 / nseq.pod
1 =pod
2
3 =head1 NAME
4
5 nseq - create or examine a Netscape certificate sequence
6
7 =head1 SYNOPSIS
8
9 B<openssl> B<nseq>
10 [B<-help>]
11 [B<-in filename>]
12 [B<-out filename>]
13 [B<-toseq>]
14
15 =head1 DESCRIPTION
16
17 The B<nseq> command takes a file containing a Netscape certificate
18 sequence and prints out the certificates contained in it or takes a
19 file of certificates and converts it into a Netscape certificate
20 sequence.
21
22 =head1 COMMAND OPTIONS
23
24 =over 4
25
26 =item B<-help>
27
28 Print out a usage message.
29
30 =item B<-in filename>
31
32 This specifies the input filename to read or standard input if this
33 option is not specified.
34
35 =item B<-out filename>
36
37 specifies the output filename or standard output by default.
38
39 =item B<-toseq>
40
41 normally a Netscape certificate sequence will be input and the output
42 is the certificates contained in it. With the B<-toseq> option the
43 situation is reversed: a Netscape certificate sequence is created from
44 a file of certificates.
45
46 =back
47
48 =head1 EXAMPLES
49
50 Output the certificates in a Netscape certificate sequence
51
52  openssl nseq -in nseq.pem -out certs.pem
53
54 Create a Netscape certificate sequence
55
56  openssl nseq -in certs.pem -toseq -out nseq.pem
57
58 =head1 NOTES
59
60 The B<PEM> encoded form uses the same headers and footers as a certificate:
61
62  -----BEGIN CERTIFICATE-----
63  -----END CERTIFICATE-----
64
65 A Netscape certificate sequence is a Netscape specific form that can be sent
66 to browsers as an alternative to the standard PKCS#7 format when several
67 certificates are sent to the browser: for example during certificate enrollment.
68 It is used by Netscape certificate server for example.
69
70 =head1 BUGS
71
72 This program needs a few more options: like allowing DER or PEM input and
73 output files and allowing multiple certificate files to be used.
74
75 =head1 COPYRIGHT
76
77 Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.
78
79 Licensed under the OpenSSL license (the "License").  You may not use
80 this file except in compliance with the License.  You can obtain a copy
81 in the file LICENSE in the source distribution or at
82 L<https://www.openssl.org/source/license.html>.
83
84 =cut