contrib/bind9/bin/tools/genrandom.docbook

   1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   2                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
   3                [<!ENTITY mdash "&#8212;">]>
   4 <!--
   5  - Copyright (C) 2009-2011  Internet Systems Consortium, Inc. ("ISC")
   6  -
   7  - Permission to use, copy, modify, and/or distribute this software for any
   8  - purpose with or without fee is hereby granted, provided that the above
   9  - copyright notice and this permission notice appear in all copies.
  10  -
  11  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  12  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  13  - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  14  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  15  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  16  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  17  - PERFORMANCE OF THIS SOFTWARE.
  18 -->
  19
  20 <!-- $Id: genrandom.docbook,v 1.6.124.2 2011-08-08 23:45:44 tbox Exp $ -->
  21 <refentry id="man.genrandom">
  22   <refentryinfo>
  23     <date>Feb 19, 2009</date>
  24   </refentryinfo>
  25
  26   <refmeta>
  27     <refentrytitle><application>genrandom</application></refentrytitle>
  28     <manvolnum>8</manvolnum>
  29     <refmiscinfo>BIND9</refmiscinfo>
  30   </refmeta>
  31
  32   <refnamediv>
  33     <refname><application>genrandom</application></refname>
  34     <refpurpose>generate a file containing random data</refpurpose>
  35   </refnamediv>
  36
  37   <docinfo>
  38     <copyright>
  39       <year>2009</year>
  40       <year>2010</year>
  41       <year>2011</year>
  42       <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
  43     </copyright>
  44   </docinfo>
  45
  46   <refsynopsisdiv>
  47     <cmdsynopsis>
  48       <command>genrandom</command>
  49       <arg><option>-n <replaceable class="parameter">number</replaceable></option></arg>
  50       <arg choice="req"><replaceable class="parameter">size</replaceable></arg>
  51       <arg choice="req"><replaceable class="parameter">filename</replaceable></arg>
  52     </cmdsynopsis>
  53   </refsynopsisdiv>
  54
  55   <refsect1>
  56     <title>DESCRIPTION</title>
  57     <para>
  58       <command>genrandom</command>
  59       generates a file or a set of files containing a specified quantity
  60       of pseudo-random data, which can be used as a source of entropy for
  61       other commands on systems with no random device.
  62     </para>
  63   </refsect1>
  64
  65   <refsect1>
  66     <title>ARGUMENTS</title>
  67     <variablelist>
  68       <varlistentry>
  69         <term>-n <replaceable class="parameter">number</replaceable></term>
  70         <listitem>
  71           <para>
  72             In place of generating one file, generates <option>number</option>
  73             (from 2 to 9) files, appending <option>number</option> to the name.
  74           </para>
  75         </listitem>
  76       </varlistentry>
  77
  78       <varlistentry>
  79         <term>size</term>
  80         <listitem>
  81           <para>
  82             The size of the file, in kilobytes, to generate.
  83           </para>
  84         </listitem>
  85       </varlistentry>
  86
  87       <varlistentry>
  88         <term>filename</term>
  89         <listitem>
  90           <para>
  91             The file name into which random data should be written.
  92           </para>
  93         </listitem>
  94       </varlistentry>
  95     </variablelist>
  96   </refsect1>
  97
  98   <refsect1>
  99     <title>SEE ALSO</title>
 100     <para>
 101       <citerefentry>
 102         <refentrytitle>rand</refentrytitle><manvolnum>3</manvolnum>
 103       </citerefentry>,
 104       <citerefentry>
 105         <refentrytitle>arc4random</refentrytitle><manvolnum>3</manvolnum>
 106       </citerefentry>
 107     </para>
 108   </refsect1>
 109
 110   <refsect1>
 111     <title>AUTHOR</title>
 112     <para><corpauthor>Internet Systems Consortium</corpauthor>
 113     </para>
 114   </refsect1>
 115
 116 </refentry><!--
 117  - Local variables:
 118  - mode: sgml
 119  - End:
 120 -->