/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-2012  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$ -->
 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      <year>2012</year>
 43      <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
 44    </copyright>
 45  </docinfo>
 46
 47  <refsynopsisdiv>
 48    <cmdsynopsis>
 49      <command>genrandom</command>
 50      <arg><option>-n <replaceable class="parameter">number</replaceable></option></arg>
 51      <arg choice="req"><replaceable class="parameter">size</replaceable></arg>
 52      <arg choice="req"><replaceable class="parameter">filename</replaceable></arg>
 53    </cmdsynopsis>
 54  </refsynopsisdiv>
 55
 56  <refsect1>
 57    <title>DESCRIPTION</title>
 58    <para>
 59      <command>genrandom</command>
 60      generates a file or a set of files containing a specified quantity
 61      of pseudo-random data, which can be used as a source of entropy for
 62      other commands on systems with no random device.
 63    </para>
 64  </refsect1>
 65
 66  <refsect1>
 67    <title>ARGUMENTS</title>
 68    <variablelist>
 69      <varlistentry>
 70        <term>-n <replaceable class="parameter">number</replaceable></term>
 71        <listitem>
 72          <para>
 73            In place of generating one file, generates <option>number</option>
 74            (from 2 to 9) files, appending <option>number</option> to the name.
 75          </para>
 76        </listitem>
 77      </varlistentry>
 78
 79      <varlistentry>
 80        <term>size</term>
 81        <listitem>
 82          <para>
 83            The size of the file, in kilobytes, to generate.
 84          </para>
 85        </listitem>
 86      </varlistentry>
 87
 88      <varlistentry>
 89        <term>filename</term>
 90        <listitem>
 91          <para>
 92            The file name into which random data should be written.
 93          </para>
 94        </listitem>
 95      </varlistentry>
 96    </variablelist>
 97  </refsect1>
 98
 99  <refsect1>
100    <title>SEE ALSO</title>
101    <para>
102      <citerefentry>
103        <refentrytitle>rand</refentrytitle><manvolnum>3</manvolnum>
104      </citerefentry>,
105      <citerefentry>
106        <refentrytitle>arc4random</refentrytitle><manvolnum>3</manvolnum>
107      </citerefentry>
108    </para>
109  </refsect1>
110
111  <refsect1>
112    <title>AUTHOR</title>
113    <para><corpauthor>Internet Systems Consortium</corpauthor>
114    </para>
115  </refsect1>
116
117</refentry><!--
118 - Local variables:
119 - mode: sgml
120 - End:
121-->