contrib/bind9/bin/tools/genrandom.html

   1 <!--
   2  - Copyright (C) 2009-2011, 2014, 2015 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 <html>
  17 <head>
  18 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  19 <title>genrandom</title>
  20 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
  21 </head>
  22 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
  23 <a name="man.genrandom"></a><div class="titlepage"></div>
  24 <div class="refnamediv">
  25 <h2>Name</h2>
  26 <p><span class="application">genrandom</span> &#8212; generate a file containing random data</p>
  27 </div>
  28 <div class="refsynopsisdiv">
  29 <h2>Synopsis</h2>
  30 <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>
  31 </div>
  32 <div class="refsection">
  33 <a name="id-1.7"></a><h2>DESCRIPTION</h2>
  34 <p>
  35       <span class="command"><strong>genrandom</strong></span>
  36       generates a file or a set of files containing a specified quantity
  37       of pseudo-random data, which can be used as a source of entropy for
  38       other commands on systems with no random device.
  39     </p>
  40 </div>
  41 <div class="refsection">
  42 <a name="id-1.8"></a><h2>ARGUMENTS</h2>
  43 <div class="variablelist"><dl class="variablelist">
  44 <dt><span class="term">-n <em class="replaceable"><code>number</code></em></span></dt>
  45 <dd><p>
  46             In place of generating one file, generates <code class="option">number</code>
  47             (from 2 to 9) files, appending <code class="option">number</code> to the name.
  48           </p></dd>
  49 <dt><span class="term">size</span></dt>
  50 <dd><p>
  51             The size of the file, in kilobytes, to generate.
  52           </p></dd>
  53 <dt><span class="term">filename</span></dt>
  54 <dd><p>
  55             The file name into which random data should be written.
  56           </p></dd>
  57 </dl></div>
  58 </div>
  59 <div class="refsection">
  60 <a name="id-1.9"></a><h2>SEE ALSO</h2>
  61 <p>
  62       <span class="citerefentry"><span class="refentrytitle">rand</span>(3)</span>,
  63       <span class="citerefentry"><span class="refentrytitle">arc4random</span>(3)</span>
  64     </p>
  65 </div>
  66 </div></body>
  67 </html>