1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/security/nss/doc/derdump.xml Wed Dec 31 06:09:35 2014 +0100 1.3 @@ -0,0 +1,96 @@ 1.4 +<?xml version="1.0" encoding="UTF-8"?> 1.5 +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 1.6 + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ 1.7 +<!ENTITY date SYSTEM "date.xml"> 1.8 +<!ENTITY version SYSTEM "version.xml"> 1.9 +]> 1.10 + 1.11 +<refentry id="derdump"> 1.12 + 1.13 + <refentryinfo> 1.14 + <date>&date;</date> 1.15 + <title>NSS Security Tools</title> 1.16 + <productname>nss-tools</productname> 1.17 + <productnumber>&version;</productnumber> 1.18 + </refentryinfo> 1.19 + 1.20 + <refmeta> 1.21 + <refentrytitle>DERDUMP</refentrytitle> 1.22 + <manvolnum>1</manvolnum> 1.23 + </refmeta> 1.24 + 1.25 + <refnamediv> 1.26 + <refname>derdump </refname> 1.27 + <refpurpose>Dumps C-sequence strings from a DER encoded certificate file</refpurpose> 1.28 + </refnamediv> 1.29 + 1.30 + <refsynopsisdiv> 1.31 + <cmdsynopsis> 1.32 + <command>derdump</command> 1.33 + <arg><option>-r</option></arg> 1.34 + <arg><option>-i <replaceable>input-file</replaceable></option></arg> 1.35 + <arg><option>-o <replaceable>output-file</replaceable></option></arg> 1.36 + </cmdsynopsis> 1.37 + </refsynopsisdiv> 1.38 + 1.39 + <refsection> 1.40 + <title>STATUS</title> 1.41 + <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> 1.42 + </para> 1.43 + </refsection> 1.44 + 1.45 + <refsection> 1.46 + <title>Description</title> 1.47 + 1.48 + <para><command>derdump </command>dumps C-sequence strings from a DER encode certificate file </para> 1.49 + 1.50 + </refsection> 1.51 + 1.52 +<refsection> 1.53 + <title>Options</title> 1.54 + 1.55 + <variablelist> 1.56 + 1.57 + <varlistentry> 1.58 + <term><option>-r </option></term> 1.59 + <listitem><simpara>For formatted items, dump raw bytes as well</simpara></listitem> 1.60 + </varlistentry> 1.61 + 1.62 + <varlistentry> 1.63 + <term><option>-i </option> <replaceable>DER encoded file</replaceable></term> 1.64 + <listitem><simpara>Define an input file to use (default is stdin)</simpara></listitem> 1.65 + </varlistentry> 1.66 + 1.67 + <varlistentry> 1.68 + <term><option>-o </option> <replaceable>output file</replaceable></term> 1.69 + <listitem><simpara>Define an output file to use (default is stdout).</simpara></listitem> 1.70 + </varlistentry> 1.71 + 1.72 + </variablelist> 1.73 + </refsection> 1.74 + 1.75 + <refsection id="resources"> 1.76 + <title>Additional Resources</title> 1.77 + <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> 1.78 + <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> 1.79 + <para>Mailing lists: pki-devel@redhat.com and pki-users@redhat.com</para> 1.80 + <para>IRC: Freenode at #dogtag-pki</para> 1.81 + </refsection> 1.82 + 1.83 +<!-- fill in your name first; keep the other names for reference --> 1.84 + <refsection id="authors"> 1.85 + <title>Authors</title> 1.86 + <para>The NSS tools were written and maintained by developers with Netscape, Red Hat, Sun, Oracle, Mozilla, and Google.</para> 1.87 + <para> 1.88 + Authors: Gerhardus Geldenhuis <gerhardus.geldenhuis@gmail.com>. Elio Maldonado <emaldona@redhat.com>, Deon Lackey <dlackey@redhat.com> 1.89 + </para> 1.90 + </refsection> 1.91 + 1.92 +<!-- don't change --> 1.93 + <refsection id="license"> 1.94 + <title>LICENSE</title> 1.95 + <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/. 1.96 + </para> 1.97 + </refsection> 1.98 + 1.99 +</refentry>