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-->
122