Remove building with NOCRYPTO option
[minix.git] / external / bsd / bind / dist / bin / tools / genrandom.docbook
blobecc206a5496cef3ad78f1b610ab30a26bfde1f43
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 -->
20 <refentry id="man.genrandom">
21   <refentryinfo>
22     <date>August 08, 2011</date>
23   </refentryinfo>
25   <refmeta>
26     <refentrytitle><application>genrandom</application></refentrytitle>
27     <manvolnum>8</manvolnum>
28     <refmiscinfo>BIND9</refmiscinfo>
29   </refmeta>
31   <refnamediv>
32     <refname><application>genrandom</application></refname>
33     <refpurpose>generate a file containing random data</refpurpose>
34   </refnamediv>
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>
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>
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>
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>
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>
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>
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>
110   <refsect1>
111     <title>AUTHOR</title>
112     <para><corpauthor>Internet Systems Consortium</corpauthor>
113     </para>
114   </refsect1>
116 </refentry><!--
117  - Local variables:
118  - mode: sgml
119  - End: