/contrib/bind9/bin/tools/genrandom.docbook

https://bitbucket.org/freebsd/freebsd-head/ · 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 "&#8212;">]>
  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. <!-- $Id$ -->
  20. <refentry id="man.genrandom">
  21. <refentryinfo>
  22. <date>Feb 19, 2009</date>
  23. </refentryinfo>
  24. <refmeta>
  25. <refentrytitle><application>genrandom</application></refentrytitle>
  26. <manvolnum>8</manvolnum>
  27. <refmiscinfo>BIND9</refmiscinfo>
  28. </refmeta>
  29. <refnamediv>
  30. <refname><application>genrandom</application></refname>
  31. <refpurpose>generate a file containing random data</refpurpose>
  32. </refnamediv>
  33. <docinfo>
  34. <copyright>
  35. <year>2009</year>
  36. <year>2010</year>
  37. <year>2011</year>
  38. <year>2012</year>
  39. <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
  40. </copyright>
  41. </docinfo>
  42. <refsynopsisdiv>
  43. <cmdsynopsis>
  44. <command>genrandom</command>
  45. <arg><option>-n <replaceable class="parameter">number</replaceable></option></arg>
  46. <arg choice="req"><replaceable class="parameter">size</replaceable></arg>
  47. <arg choice="req"><replaceable class="parameter">filename</replaceable></arg>
  48. </cmdsynopsis>
  49. </refsynopsisdiv>
  50. <refsect1>
  51. <title>DESCRIPTION</title>
  52. <para>
  53. <command>genrandom</command>
  54. generates a file or a set of files containing a specified quantity
  55. of pseudo-random data, which can be used as a source of entropy for
  56. other commands on systems with no random device.
  57. </para>
  58. </refsect1>
  59. <refsect1>
  60. <title>ARGUMENTS</title>
  61. <variablelist>
  62. <varlistentry>
  63. <term>-n <replaceable class="parameter">number</replaceable></term>
  64. <listitem>
  65. <para>
  66. In place of generating one file, generates <option>number</option>
  67. (from 2 to 9) files, appending <option>number</option> to the name.
  68. </para>
  69. </listitem>
  70. </varlistentry>
  71. <varlistentry>
  72. <term>size</term>
  73. <listitem>
  74. <para>
  75. The size of the file, in kilobytes, to generate.
  76. </para>
  77. </listitem>
  78. </varlistentry>
  79. <varlistentry>
  80. <term>filename</term>
  81. <listitem>
  82. <para>
  83. The file name into which random data should be written.
  84. </para>
  85. </listitem>
  86. </varlistentry>
  87. </variablelist>
  88. </refsect1>
  89. <refsect1>
  90. <title>SEE ALSO</title>
  91. <para>
  92. <citerefentry>
  93. <refentrytitle>rand</refentrytitle><manvolnum>3</manvolnum>
  94. </citerefentry>,
  95. <citerefentry>
  96. <refentrytitle>arc4random</refentrytitle><manvolnum>3</manvolnum>
  97. </citerefentry>
  98. </para>
  99. </refsect1>
  100. <refsect1>
  101. <title>AUTHOR</title>
  102. <para><corpauthor>Internet Systems Consortium</corpauthor>
  103. </para>
  104. </refsect1>
  105. </refentry><!--
  106. - Local variables:
  107. - mode: sgml
  108. - End:
  109. -->