~ubuntu-branches/ubuntu/saucy/s390-tools/saucy

« back to all changes in this revision

Viewing changes to man/prandom.4

  • Committer: Bazaar Package Importer
  • Author(s): Bastian Blank
  • Date: 2008-07-15 23:55:41 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20080715235541-r79vu6eqh4qim413
Tags: 1.6.2-1
* New upstream version.
* Install udev rules.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright 2007 Jan Glauber (jan.glauber@de.ibm.com)
 
2
.\"
 
3
.TH PRANDOM 4 "Jan 2007" "s390-tools"
 
4
 
 
5
.SH NAME
 
6
prandom \- kernel pseudo random number generator device for s390
 
7
.SH DESCRIPTION
 
8
The character special file \fI/dev/prandom\fP provides an interface to the 
 
9
pseudo random number generator. The s390 pseudo random number generator uses
 
10
the hardware accelerated cryptographic assist functions which are integrated
 
11
in the CPU. \fI/dev/prandom\fP is available starting with the z9 processor.
 
12
.LP
 
13
Reading from \fI/dev/prandom\fP is non-blocking. Any amount of data could
 
14
be read from the device.
 
15
.LP
 
16
The s390 pseudo random number generator provides cryptographically secure 
 
17
pseudo random numbers following the algorithm in ANSI X9.17. Entropy is added 
 
18
periodically to the generator to protect against a compromised key.
 
19
 
 
20
.LP
 
21
.SH CONFIGURATION
 
22
The \fI/dev/prandom\fP device node is generated by udev while loading the corresponding kernel
 
23
module or while booting a kernel with the generator built-in. By default
 
24
\fI/dev/prandom\fP is readable only by root. If it should be readable by every user
 
25
add the following to /etc/rules.d/50-udev.rules:
 
26
 
 
27
.nf
 
28
        KERNEL=="prandom",              MODE="0444", OPTIONS="last_rule"
 
29
.fi
 
30
 
 
31
.SH FILES
 
32
/dev/prandom
 
33
 
 
34
.SH SEE ALSO
 
35
Linux on zSeries: Device Drivers, Features and Commands