/contrib/bind9/bin/tools/genrandom.docbook
Unknown | 121 lines | 109 code | 12 blank | 0 comment | 0 complexity | 793975e5e2b40d3d2875ad73cdde37ea MD5 | raw file
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 "—">]> 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-->