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, 2014  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<refentry id="man.genrandom">
21  <refentryinfo>
22    <date>August 08, 2011</date>
23  </refentryinfo>
24
25  <refmeta>
26    <refentrytitle><application>genrandom</application></refentrytitle>
27    <manvolnum>8</manvolnum>
28    <refmiscinfo>BIND9</refmiscinfo>
29  </refmeta>
30
31  <refnamediv>
32    <refname><application>genrandom</application></refname>
33    <refpurpose>generate a file containing random data</refpurpose>
34  </refnamediv>
35
36  <docinfo>
37    <copyright>
38      <year>2009</year>
39      <year>2010</year>
40      <year>2011</year>
41      <year>2014</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-->
121