diff options
Diffstat (limited to 'bin/dnssec/dnssec-keygen.docbook')
| -rw-r--r-- | bin/dnssec/dnssec-keygen.docbook | 126 |
1 files changed, 59 insertions, 67 deletions
diff --git a/bin/dnssec/dnssec-keygen.docbook b/bin/dnssec/dnssec-keygen.docbook index 472575f0d002..4737f5a821ca 100644 --- a/bin/dnssec/dnssec-keygen.docbook +++ b/bin/dnssec/dnssec-keygen.docbook @@ -1,6 +1,3 @@ -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" - "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" - [<!ENTITY mdash "—">]> <!-- - Copyright (C) 2004, 2005, 2007-2012, 2014, 2015 Internet Systems Consortium, Inc. ("ISC") - Copyright (C) 2000-2003 Internet Software Consortium. @@ -18,9 +15,14 @@ - PERFORMANCE OF THIS SOFTWARE. --> -<refentry id="man.dnssec-keygen"> +<!-- Converted by db4-upgrade version 1.0 --> +<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnssec-keygen"> + <info> + <date>2014-02-07</date> + </info> <refentryinfo> - <date>February 07, 2014</date> + <corpname>ISC</corpname> + <corpauthor>Internet Systems Consortium, Inc.</corpauthor> </refentryinfo> <refmeta> @@ -58,43 +60,43 @@ </docinfo> <refsynopsisdiv> - <cmdsynopsis> + <cmdsynopsis sepchar=" "> <command>dnssec-keygen</command> - <arg><option>-a <replaceable class="parameter">algorithm</replaceable></option></arg> - <arg ><option>-b <replaceable class="parameter">keysize</replaceable></option></arg> - <arg><option>-n <replaceable class="parameter">nametype</replaceable></option></arg> - <arg><option>-3</option></arg> - <arg><option>-A <replaceable class="parameter">date/offset</replaceable></option></arg> - <arg><option>-C</option></arg> - <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg> - <arg><option>-D <replaceable class="parameter">date/offset</replaceable></option></arg> - <arg><option>-E <replaceable class="parameter">engine</replaceable></option></arg> - <arg><option>-f <replaceable class="parameter">flag</replaceable></option></arg> - <arg><option>-G</option></arg> - <arg><option>-g <replaceable class="parameter">generator</replaceable></option></arg> - <arg><option>-h</option></arg> - <arg><option>-I <replaceable class="parameter">date/offset</replaceable></option></arg> - <arg><option>-i <replaceable class="parameter">interval</replaceable></option></arg> - <arg><option>-K <replaceable class="parameter">directory</replaceable></option></arg> - <arg><option>-L <replaceable class="parameter">ttl</replaceable></option></arg> - <arg><option>-k</option></arg> - <arg><option>-P <replaceable class="parameter">date/offset</replaceable></option></arg> - <arg><option>-p <replaceable class="parameter">protocol</replaceable></option></arg> - <arg><option>-q</option></arg> - <arg><option>-R <replaceable class="parameter">date/offset</replaceable></option></arg> - <arg><option>-r <replaceable class="parameter">randomdev</replaceable></option></arg> - <arg><option>-S <replaceable class="parameter">key</replaceable></option></arg> - <arg><option>-s <replaceable class="parameter">strength</replaceable></option></arg> - <arg><option>-t <replaceable class="parameter">type</replaceable></option></arg> - <arg><option>-v <replaceable class="parameter">level</replaceable></option></arg> - <arg><option>-V</option></arg> - <arg><option>-z</option></arg> - <arg choice="req">name</arg> + <arg choice="opt" rep="norepeat"><option>-a <replaceable class="parameter">algorithm</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-b <replaceable class="parameter">keysize</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-n <replaceable class="parameter">nametype</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-3</option></arg> + <arg choice="opt" rep="norepeat"><option>-A <replaceable class="parameter">date/offset</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-C</option></arg> + <arg choice="opt" rep="norepeat"><option>-c <replaceable class="parameter">class</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-D <replaceable class="parameter">date/offset</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-E <replaceable class="parameter">engine</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-f <replaceable class="parameter">flag</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-G</option></arg> + <arg choice="opt" rep="norepeat"><option>-g <replaceable class="parameter">generator</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-h</option></arg> + <arg choice="opt" rep="norepeat"><option>-I <replaceable class="parameter">date/offset</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-i <replaceable class="parameter">interval</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-K <replaceable class="parameter">directory</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-L <replaceable class="parameter">ttl</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-k</option></arg> + <arg choice="opt" rep="norepeat"><option>-P <replaceable class="parameter">date/offset</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-p <replaceable class="parameter">protocol</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-q</option></arg> + <arg choice="opt" rep="norepeat"><option>-R <replaceable class="parameter">date/offset</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-r <replaceable class="parameter">randomdev</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-S <replaceable class="parameter">key</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-s <replaceable class="parameter">strength</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-t <replaceable class="parameter">type</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg> + <arg choice="opt" rep="norepeat"><option>-V</option></arg> + <arg choice="opt" rep="norepeat"><option>-z</option></arg> + <arg choice="req" rep="norepeat">name</arg> </cmdsynopsis> </refsynopsisdiv> - <refsect1> - <title>DESCRIPTION</title> + <refsection><info><title>DESCRIPTION</title></info> + <para><command>dnssec-keygen</command> generates keys for DNSSEC (Secure DNS), as defined in RFC 2535 and RFC 4034. It can also generate keys for use with @@ -106,10 +108,10 @@ line. For DNSSEC keys, this must match the name of the zone for which the key is being generated. </para> - </refsect1> + </refsection> + + <refsection><info><title>OPTIONS</title></info> - <refsect1> - <title>OPTIONS</title> <variablelist> <varlistentry> @@ -431,10 +433,10 @@ </varlistentry> </variablelist> - </refsect1> + </refsection> + + <refsection><info><title>TIMING OPTIONS</title></info> - <refsect1> - <title>TIMING OPTIONS</title> <para> Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS. @@ -522,7 +524,7 @@ </para> <para> If the key is being created as an explicit successor to another - key, then the default prepublication interval is 30 days; + key, then the default prepublication interval is 30 days; otherwise it is zero. </para> <para> @@ -536,11 +538,11 @@ </varlistentry> </variablelist> - </refsect1> + </refsection> - <refsect1> - <title>GENERATED KEYS</title> + <refsection><info><title>GENERATED KEYS</title></info> + <para> When <command>dnssec-keygen</command> completes successfully, @@ -565,7 +567,7 @@ </para> </listitem> </itemizedlist> - <para><command>dnssec-keygen</command> + <para><command>dnssec-keygen</command> creates two files, with names based on the printed string. <filename>Knnnn.+aaa+iiiii.key</filename> contains the public key, and @@ -590,10 +592,10 @@ files are generated for symmetric encryption algorithms such as HMAC-MD5, even though the public and private key are equivalent. </para> - </refsect1> + </refsection> + + <refsection><info><title>EXAMPLE</title></info> - <refsect1> - <title>EXAMPLE</title> <para> To generate a 768-bit DSA key for the domain <userinput>example.com</userinput>, the following command would be @@ -612,10 +614,10 @@ and <filename>Kexample.com.+003+26160.private</filename>. </para> - </refsect1> + </refsection> + + <refsection><info><title>SEE ALSO</title></info> - <refsect1> - <title>SEE ALSO</title> <para><citerefentry> <refentrytitle>dnssec-signzone</refentrytitle><manvolnum>8</manvolnum> </citerefentry>, @@ -624,16 +626,6 @@ <citetitle>RFC 2845</citetitle>, <citetitle>RFC 4034</citetitle>. </para> - </refsect1> + </refsection> - <refsect1> - <title>AUTHOR</title> - <para><corpauthor>Internet Systems Consortium</corpauthor> - </para> - </refsect1> - -</refentry><!-- - - Local variables: - - mode: sgml - - End: ---> +</refentry> |