genrandom.docbook revision 3ec79bbc03fc5378a6cb37b276807cd40b5332aa
1126N/A<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
1126N/A "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
1126N/A [<!ENTITY mdash "&#8212;">]>
1126N/A<!--
1126N/A - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC")
1126N/A -
1126N/A - Permission to use, copy, modify, and/or distribute this software for any
1126N/A - purpose with or without fee is hereby granted, provided that the above
1126N/A - copyright notice and this permission notice appear in all copies.
1126N/A -
1126N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
1126N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
1126N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
1126N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
1126N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
1126N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
1126N/A - PERFORMANCE OF THIS SOFTWARE.
1126N/A-->
1126N/A
1126N/A<!-- $Id: genrandom.docbook,v 1.5 2010/05/17 04:38:45 marka Exp $ -->
1126N/A<refentry id="man.genrandom">
1126N/A <refentryinfo>
1126N/A <date>Feb 19, 2009</date>
1126N/A </refentryinfo>
5027N/A
5636N/A <refmeta>
1126N/A <refentrytitle><application>genrandom</application></refentrytitle>
1126N/A <manvolnum>8</manvolnum>
1126N/A <refmiscinfo>BIND9</refmiscinfo>
1126N/A </refmeta>
1126N/A
1126N/A <refnamediv>
1126N/A <refname><application>genrandom</application></refname>
1126N/A <refpurpose>generate a file containing random data</refpurpose>
1126N/A </refnamediv>
1126N/A
1126N/A <docinfo>
1126N/A <copyright>
2650N/A <year>2009</year>
2650N/A <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
2086N/A </copyright>
2086N/A </docinfo>
2086N/A
2086N/A <refsynopsisdiv>
1126N/A <cmdsynopsis>
1126N/A <command>genrandom</command>
1738N/A <arg><option>-n <replaceable class="parameter">number</replaceable></option></arg>
1738N/A <arg choice="req"><replaceable class="parameter">size</replaceable></arg>
2556N/A <arg choice="req"><replaceable class="parameter">filename</replaceable></arg>
1126N/A </cmdsynopsis>
1126N/A </refsynopsisdiv>
1311N/A
1126N/A <refsect1>
1126N/A <title>DESCRIPTION</title>
1126N/A <para>
1126N/A <command>genrandom</command>
1126N/A generates a file or a set of files containing a specified quantity
1126N/A of pseudo-random data, which can be used as a source of entropy for
1126N/A other commands on systems with no random device.
1126N/A </para>
1126N/A </refsect1>
1126N/A
1126N/A <refsect1>
1126N/A <title>ARGUMENTS</title>
1126N/A <variablelist>
1126N/A <varlistentry>
1126N/A <term>-n <replaceable class="parameter">number</replaceable></term>
1126N/A <listitem>
1126N/A <para>
1126N/A In place of generating one file, generates <option>number</option>
1126N/A (from 2 to 9) files, appending <option>number</option> to the name.
1126N/A </para>
1126N/A </listitem>
1126N/A </varlistentry>
1126N/A
1126N/A <varlistentry>
1126N/A <term>size</term>
1126N/A <listitem>
1126N/A <para>
1126N/A The size of the file, in kilobytes, to generate.
1126N/A </para>
1126N/A </listitem>
1126N/A </varlistentry>
1126N/A
1126N/A <varlistentry>
1126N/A <term>domain</term>
1126N/A <listitem>
1126N/A <para>
2086N/A The file name into which random data should be written.
1126N/A </para>
1126N/A </listitem>
1126N/A </varlistentry>
1126N/A </variablelist>
1126N/A </refsect1>
1126N/A
1126N/A <refsect1>
1126N/A <title>SEE ALSO</title>
1126N/A <para>
1126N/A <citerefentry>
2556N/A <refentrytitle>rand</refentrytitle><manvolnum>3</manvolnum>
2556N/A </citerefentry>,
2556N/A <citerefentry>
1126N/A <refentrytitle>arc4random</refentrytitle><manvolnum>3</manvolnum>
1126N/A </citerefentry>
1126N/A </para>
1126N/A </refsect1>
1126N/A
1126N/A <refsect1>
1126N/A <title>AUTHOR</title>
1126N/A <para><corpauthor>Internet Systems Consortium</corpauthor>
1126N/A </para>
1126N/A </refsect1>
1126N/A
1126N/A</refentry><!--
1126N/A - Local variables:
1496N/A - mode: sgml
1126N/A - End:
1496N/A-->
1496N/A