freeswan/doc/manpage.d/ipsec_ranbits.8.html

   1 Content-type: text/html
   2
   3 <HTML><HEAD><TITLE>Manpage of IPSEC_RANBITS</TITLE>
   4 </HEAD><BODY>
   5 <H1>IPSEC_RANBITS</H1>
   6 Section: Maintenance Commands (8)<BR>Updated: 22 Aug 2000<BR><A HREF="#index">Index</A>
   7 <A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
   8
   9
  10 <A NAME="lbAB">&nbsp;</A>
  11 <H2>NAME</H2>
  12
  13 ipsec ranbits - generate random bits in ASCII form
  14 <A NAME="lbAC">&nbsp;</A>
  15 <H2>SYNOPSIS</H2>
  16
  17 <B>ipsec</B>
  18
  19 <B>ranbits</B>
  20
  21 [
  22 <B>--quick</B>
  23
  24 ] [
  25 <B>--continuous</B>
  26
  27 ] [
  28 <B>--bytes</B>
  29
  30 ] nbits
  31 <A NAME="lbAD">&nbsp;</A>
  32 <H2>DESCRIPTION</H2>
  33
  34 <I>Ranbits</I>
  35
  36 obtains
  37 <I>nbits</I>
  38
  39 (rounded up to the nearest byte)
  40 high-quality random bits from
  41 <I><A HREF="random.4.html">random</A></I>(4),
  42
  43 and emits them on standard output as an ASCII string.
  44 The default output format is
  45 <I><A HREF="datatot.3.html">datatot</A></I>(3)
  46
  47 <B>h</B>
  48
  49 format:
  50 lowercase hexadecimal with a
  51 <B>0x</B>
  52
  53 prefix and an underscore every 32 bits.
  54 <P>
  55
  56 The
  57 <B>--quick</B>
  58
  59 option produces quick-and-dirty random bits:
  60 instead of using the high-quality random bits from
  61 <I>/dev/random</I>,
  62
  63 which may take some time to supply the necessary bits if
  64 <I>nbits</I>
  65
  66 is large,
  67 <I>ranbits</I>
  68
  69 uses
  70 <I>/dev/urandom</I>,
  71
  72 which yields prompt results but lower-quality randomness.
  73 <P>
  74
  75 The
  76 <B>--continuous</B>
  77
  78 option uses
  79 <I><A HREF="datatot.3.html">datatot</A></I>(3)
  80
  81 <B>x</B>
  82
  83 output format, like
  84 <B>h</B>
  85
  86 but without the underscores.
  87 <P>
  88
  89 The
  90 <B>--bytes</B>
  91
  92 option causes
  93 <I>nbits</I>
  94
  95 to be interpreted as a byte count rather than a bit count.
  96 <A NAME="lbAE">&nbsp;</A>
  97 <H2>FILES</H2>
  98
  99 /dev/random, /dev/urandom
 100 <A NAME="lbAF">&nbsp;</A>
 101 <H2>SEE ALSO</H2>
 102
 103 <A HREF="ipsec_datatot.3.html">ipsec_datatot</A>(3), <A HREF="random.4.html">random</A>(4)
 104 <A NAME="lbAG">&nbsp;</A>
 105 <H2>HISTORY</H2>
 106
 107 Written for the Linux FreeS/WAN project
 108 &lt;<A HREF="http://www.freeswan.org">http://www.freeswan.org</A>&gt;
 109 by Henry Spencer.
 110 <A NAME="lbAH">&nbsp;</A>
 111 <H2>BUGS</H2>
 112
 113 There is an internal limit on
 114 <I>nbits</I>,
 115
 116 currently 20000.
 117 <P>
 118
 119 Without
 120 <B>--quick</B>,
 121
 122 <I>ranbits</I>'s
 123
 124 run time is difficult to predict.
 125 A request for a large number of bits,
 126 at a time when the system's entropy pool is low on randomness,
 127 may take quite a while to satisfy.
 128 <P>
 129
 130 <HR>
 131 <A NAME="index">&nbsp;</A><H2>Index</H2>
 132 <DL>
 133 <DT><A HREF="#lbAB">NAME</A><DD>
 134 <DT><A HREF="#lbAC">SYNOPSIS</A><DD>
 135 <DT><A HREF="#lbAD">DESCRIPTION</A><DD>
 136 <DT><A HREF="#lbAE">FILES</A><DD>
 137 <DT><A HREF="#lbAF">SEE ALSO</A><DD>
 138 <DT><A HREF="#lbAG">HISTORY</A><DD>
 139 <DT><A HREF="#lbAH">BUGS</A><DD>
 140 </DL>
 141 <HR>
 142 This document was created by
 143 <A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
 144 using the manual pages.<BR>
 145 Time: 05:09:32 GMT, June 19, 2001
 146 </BODY>
 147 </HTML>