Updated to 3.17 for bug fixes and optimizations
[platform/upstream/nss.git] / doc / derdump.xml
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"\r
3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [\r
4 <!ENTITY date SYSTEM "date.xml">\r
5 <!ENTITY version SYSTEM "version.xml">\r
6 ]>\r
7 \r
8 <refentry id="derdump">\r
9 \r
10   <refentryinfo>\r
11     <date>&date;</date>\r
12     <title>NSS Security Tools</title>\r
13     <productname>nss-tools</productname>\r
14     <productnumber>&version;</productnumber>\r
15   </refentryinfo>\r
16 \r
17   <refmeta>\r
18     <refentrytitle>DERDUMP</refentrytitle>\r
19     <manvolnum>1</manvolnum>\r
20   </refmeta>\r
21 \r
22   <refnamediv>\r
23     <refname>derdump </refname>\r
24     <refpurpose>Dumps C-sequence strings from a DER encoded certificate file</refpurpose>\r
25   </refnamediv>\r
26 \r
27  <refsynopsisdiv>\r
28     <cmdsynopsis>\r
29       <command>derdump</command>\r
30       <arg><option>-r</option></arg>\r
31       <arg><option>-i <replaceable>input-file</replaceable></option></arg>\r
32       <arg><option>-o <replaceable>output-file</replaceable></option></arg>\r
33     </cmdsynopsis>\r
34   </refsynopsisdiv>\r
35 \r
36   <refsection>
37     <title>STATUS</title>
38     <para>This documentation is still work in progress. Please contribute to the initial review in <ulink url="https://bugzilla.mozilla.org/show_bug.cgi?id=836477">Mozilla NSS bug 836477</ulink>
39     </para>
40   </refsection>
41
42   <refsection>\r
43     <title>Description</title>\r
44 \r
45     <para><command>derdump </command>dumps C-sequence strings from a DER encode certificate file </para>\r
46 \r
47   </refsection>\r
48 \r
49 <refsection>\r
50     <title>Options</title>\r
51     \r
52     <variablelist>\r
53     \r
54     <varlistentry>\r
55         <term><option>-r </option></term>\r
56         <listitem><simpara>For formatted items, dump raw bytes as well</simpara></listitem>\r
57       </varlistentry>\r
58       \r
59       <varlistentry>\r
60         <term><option>-i </option> <replaceable>DER encoded file</replaceable></term>\r
61         <listitem><simpara>Define an input file to use (default is stdin)</simpara></listitem>\r
62       </varlistentry>\r
63 \r
64       <varlistentry>\r
65         <term><option>-o </option> <replaceable>output file</replaceable></term>\r
66         <listitem><simpara>Define an output file to use (default is stdout).</simpara></listitem>\r
67       </varlistentry>\r
68     \r
69         </variablelist>\r
70   </refsection>\r
71   \r
72   <refsection id="resources">\r
73     <title>Additional Resources</title>\r
74     <para>NSS is maintained in conjunction with PKI and security-related projects through Mozilla dn Fedora. The most closely-related project is Dogtag PKI, with a project wiki at <ulink url="http://pki.fedoraproject.org/wiki/">PKI Wiki</ulink>. </para>\r
75         <para>For information specifically about NSS, the NSS project wiki is located at <ulink url="http://www.mozilla.org/projects/security/pki/nss/">Mozilla NSS site</ulink>. The NSS site relates directly to NSS code changes and releases.</para>\r
76         <para>Mailing lists: pki-devel@redhat.com and pki-users@redhat.com</para>\r
77         <para>IRC: Freenode at #dogtag-pki</para>\r
78   </refsection>\r
79 \r
80 <!-- fill in your name first; keep the other names for reference -->\r
81   <refsection id="authors">\r
82     <title>Authors</title>\r
83     <para>The NSS tools were written and maintained by developers with Netscape, Red Hat,  Sun, Oracle, Mozilla, and Google.</para>
84     <para>\r
85         Authors: Gerhardus Geldenhuis &lt;gerhardus.geldenhuis@gmail.com>. Elio Maldonado &lt;emaldona@redhat.com>, Deon Lackey &lt;dlackey@redhat.com&gt;\r
86     </para>\r
87   </refsection>\r
88 \r
89 <!-- don't change -->\r
90   <refsection id="license">\r
91     <title>LICENSE</title>\r
92     <para>Licensed under the Mozilla Public License, v. 2.0.  If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
93     </para>\r
94   </refsection>\r
95 \r
96 </refentry>\r