contrib/bind9/bin/tools/genrandom.html

   1 <!--
   2  - Copyright (C) 2009-2012 Internet Systems Consortium, Inc. ("ISC")
   3  -
   4  - Permission to use, copy, modify, and/or distribute this software for any
   5  - purpose with or without fee is hereby granted, provided that the above
   6  - copyright notice and this permission notice appear in all copies.
   7  -
   8  - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
   9  - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  10  - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  11  - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  12  - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  13  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  14  - PERFORMANCE OF THIS SOFTWARE.
  15 -->
  16 <!-- $Id$ -->
  17 <html>
  18 <head>
  19 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  20 <title>genrandom</title>
  21 <meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
  22 </head>
  23 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
  24 <a name="man.genrandom"></a><div class="titlepage"></div>
  25 <div class="refnamediv">
  26 <h2>Name</h2>
  27 <p><span class="application">genrandom</span> &#8212; generate a file containing random data</p>
  28 </div>
  29 <div class="refsynopsisdiv">
  30 <h2>Synopsis</h2>
  31 <div class="cmdsynopsis"><p><code class="command">genrandom</code>  [<code class="option">-n <em class="replaceable"><code>number</code></em></code>] {<em class="replaceable"><code>size</code></em>} {<em class="replaceable"><code>filename</code></em>}</p></div>
  32 </div>
  33 <div class="refsect1" lang="en">
  34 <a name="id2543370"></a><h2>DESCRIPTION</h2>
  35 <p>
  36       <span><strong class="command">genrandom</strong></span>
  37       generates a file or a set of files containing a specified quantity
  38       of pseudo-random data, which can be used as a source of entropy for
  39       other commands on systems with no random device.
  40     </p>
  41 </div>
  42 <div class="refsect1" lang="en">
  43 <a name="id2543383"></a><h2>ARGUMENTS</h2>
  44 <div class="variablelist"><dl>
  45 <dt><span class="term">-n <em class="replaceable"><code>number</code></em></span></dt>
  46 <dd><p>
  47             In place of generating one file, generates <code class="option">number</code>
  48             (from 2 to 9) files, appending <code class="option">number</code> to the name.
  49           </p></dd>
  50 <dt><span class="term">size</span></dt>
  51 <dd><p>
  52             The size of the file, in kilobytes, to generate.
  53           </p></dd>
  54 <dt><span class="term">filename</span></dt>
  55 <dd><p>
  56             The file name into which random data should be written.
  57           </p></dd>
  58 </dl></div>
  59 </div>
  60 <div class="refsect1" lang="en">
  61 <a name="id2543444"></a><h2>SEE ALSO</h2>
  62 <p>
  63       <span class="citerefentry"><span class="refentrytitle">rand</span>(3)</span>,
  64       <span class="citerefentry"><span class="refentrytitle">arc4random</span>(3)</span>
  65     </p>
  66 </div>
  67 <div class="refsect1" lang="en">
  68 <a name="id2543470"></a><h2>AUTHOR</h2>
  69 <p><span class="corpauthor">Internet Systems Consortium</span>
  70     </p>
  71 </div>
  72 </div></body>
  73 </html>