doc/apps/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 =cut