contrib/bind9/bin/tools/genrandom.8

   1 .\" Copyright (C) 2009-2012 Internet Systems Consortium, Inc. ("ISC")
   2 .\"
   3 .\" Permission to use, copy, modify, and/or distribute this software for any
   4 .\" purpose with or without fee is hereby granted, provided that the above
   5 .\" copyright notice and this permission notice appear in all copies.
   6 .\"
   7 .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
   8 .\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
   9 .\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  10 .\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  11 .\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  12 .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  13 .\" PERFORMANCE OF THIS SOFTWARE.
  14 .\"
  15 .\" $Id$
  16 .\"
  17 .hy 0
  18 .ad l
  19 .\"     Title: genrandom
  20 .\"    Author:
  21 .\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>
  22 .\"      Date: Feb 19, 2009
  23 .\"    Manual: BIND9
  24 .\"    Source: BIND9
  25 .\"
  26 .TH "GENRANDOM" "8" "Feb 19, 2009" "BIND9" "BIND9"
  27 .\" disable hyphenation
  28 .nh
  29 .\" disable justification (adjust text to left margin only)
  30 .ad l
  31 .SH "NAME"
  32 genrandom \- generate a file containing random data
  33 .SH "SYNOPSIS"
  34 .HP 10
  35 \fBgenrandom\fR [\fB\-n\ \fR\fB\fInumber\fR\fR] {\fIsize\fR} {\fIfilename\fR}
  36 .SH "DESCRIPTION"
  37 .PP
  38 \fBgenrandom\fR
  39 generates a file or a set of files containing a specified quantity of pseudo\-random data, which can be used as a source of entropy for other commands on systems with no random device.
  40 .SH "ARGUMENTS"
  41 .PP
  42 \-n \fInumber\fR
  43 .RS 4
  44 In place of generating one file, generates
  45 \fBnumber\fR
  46 (from 2 to 9) files, appending
  47 \fBnumber\fR
  48 to the name.
  49 .RE
  50 .PP
  51 size
  52 .RS 4
  53 The size of the file, in kilobytes, to generate.
  54 .RE
  55 .PP
  56 filename
  57 .RS 4
  58 The file name into which random data should be written.
  59 .RE
  60 .SH "SEE ALSO"
  61 .PP
  62 \fBrand\fR(3),
  63 \fBarc4random\fR(3)
  64 .SH "AUTHOR"
  65 .PP
  66 Internet Systems Consortium
  67 .SH "COPYRIGHT"
  68 Copyright \(co 2009\-2012 Internet Systems Consortium, Inc. ("ISC")
  69 .br