aboutsummaryrefslogtreecommitdiffstats
path: root/doc/manpage.d/ipsec_ranbits.8.html
blob: 036b2a351371d73779aa400c009365245b57dbca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
Content-type: text/html

<HTML><HEAD><TITLE>Manpage of IPSEC_RANBITS</TITLE>
</HEAD><BODY>
<H1>IPSEC_RANBITS</H1>
Section: Maintenance Commands (8)<BR>Updated: 22 Aug 2000<BR><A HREF="#index">Index</A>
<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>


<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

ipsec ranbits - generate random bits in ASCII form
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>ipsec</B>

<B>ranbits</B>

[
<B>--quick</B>

] [
<B>--continuous</B>

] [
<B>--bytes</B>

] nbits
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<I>Ranbits</I>

obtains
<I>nbits</I>

(rounded up to the nearest byte)
high-quality random bits from
<I><A HREF="random.4.html">random</A></I>(4),

and emits them on standard output as an ASCII string.
The default output format is
<I><A HREF="datatot.3.html">datatot</A></I>(3)

<B>h</B>

format:
lowercase hexadecimal with a
<B>0x</B>

prefix and an underscore every 32 bits.
<P>

The
<B>--quick</B>

option produces quick-and-dirty random bits:
instead of using the high-quality random bits from
<I>/dev/random</I>,

which may take some time to supply the necessary bits if
<I>nbits</I>

is large,
<I>ranbits</I>

uses
<I>/dev/urandom</I>,

which yields prompt results but lower-quality randomness.
<P>

The
<B>--continuous</B>

option uses
<I><A HREF="datatot.3.html">datatot</A></I>(3)

<B>x</B>

output format, like
<B>h</B>

but without the underscores.
<P>

The
<B>--bytes</B>

option causes
<I>nbits</I>

to be interpreted as a byte count rather than a bit count.
<A NAME="lbAE">&nbsp;</A>
<H2>FILES</H2>

/dev/random, /dev/urandom
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>

<A HREF="ipsec_datatot.3.html">ipsec_datatot</A>(3), <A HREF="random.4.html">random</A>(4)
<A NAME="lbAG">&nbsp;</A>
<H2>HISTORY</H2>

Written for the Linux FreeS/WAN project
&lt;<A HREF="http://www.freeswan.org">http://www.freeswan.org</A>&gt;
by Henry Spencer.
<A NAME="lbAH">&nbsp;</A>
<H2>BUGS</H2>

There is an internal limit on
<I>nbits</I>,

currently 20000.
<P>

Without
<B>--quick</B>,

<I>ranbits</I>'s

run time is difficult to predict.
A request for a large number of bits,
at a time when the system's entropy pool is low on randomness,
may take quite a while to satisfy.
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">FILES</A><DD>
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
<DT><A HREF="#lbAG">HISTORY</A><DD>
<DT><A HREF="#lbAH">BUGS</A><DD>
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 21:40:18 GMT, November 11, 2003
</BODY>
</HTML>