116 lines
3.6 KiB
Groff
116 lines
3.6 KiB
Groff
.\" $NetBSD: rndctl.8,v 1.9 2001/06/05 11:22:52 wiz Exp $
|
|
.\"
|
|
.\" Copyright (c) 1997 Michael Graff
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.Dd October 12, 1997
|
|
.Dt RNDCTL 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm rndctl
|
|
.Nd in-kernel random number generator management tool
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Fl CEce
|
|
.Op Fl t Ar devtype
|
|
.Op Fl d Ar devname
|
|
.Nm ""
|
|
.Fl ls
|
|
.Op Fl t Ar devtype
|
|
.Op Fl d Ar devname
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
program displays statistics on the current state of the
|
|
.Xr rnd 4
|
|
pseudo-driver, and allows the administrator to control which sources
|
|
are allowed to contribute to the randomness pool maintained by
|
|
.Xr rnd 4 ,
|
|
as well as whether a given source is counts as strongly random.
|
|
.Sh OPTIONS
|
|
The following options are available:
|
|
.Bl -tag -width 123456
|
|
.It Fl C
|
|
Disable collection of timing information for the given
|
|
device name or device type.
|
|
.It Fl c
|
|
Enable collection of timing information for the given
|
|
device name of device type.
|
|
.It Fl E
|
|
Disable entropy estimation from the collected timing information for
|
|
the given device name or device type. If collection is still enabled,
|
|
timing information is still collected and mixed into the internal
|
|
entropy pool, but no entropy is assumed to be present.
|
|
.It Fl e
|
|
Enable entropy estimation using the collected timing information
|
|
for the given device name or device type.
|
|
.It Fl s
|
|
Display statistics on the current state of the random collection pool.
|
|
.It Fl l
|
|
List all sources, or, if the
|
|
.Fl t
|
|
or
|
|
.Fl d
|
|
flags are specified, only those specified by the
|
|
.Ar devtype
|
|
or
|
|
.Ar devname
|
|
specified.
|
|
.It Fl t
|
|
All devices of type
|
|
.Ar devtype
|
|
are altered or displayed.
|
|
.It Fl d
|
|
Only the device named
|
|
.Ar devname
|
|
is altered or displayed.
|
|
.El
|
|
.Sh WARNINGS
|
|
Turning on entropy estimation from unsafe or predictable sources will
|
|
weaken system security, while turning on entropy collection from such
|
|
sources may weaken system security.
|
|
.Pp
|
|
Care should be taken when using this command.
|
|
.Sh FILES
|
|
.Bl -tag -width /dev/urandomx -compact
|
|
.It Pa /dev/random
|
|
Returns ``good'' values only
|
|
.It Pa /dev/urandom
|
|
Always returns data, degenerates to a pseudo-random generator
|
|
.El
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
program was first made available in
|
|
.Nx 1.3 .
|
|
.Sh AUTHOR
|
|
The
|
|
.Nm
|
|
program was written by Michael Graff <explorer@flame.org>.
|
|
.Sh SEE ALSO
|
|
.Xr rnd 4 ,
|
|
.Xr rnd 9
|