function is used by device drivers
and other kernel processes to pass data
that is considered (at least partially) stochastic
to the entropy device.
The caller should pass a pointer (to no more than 16 bytes) of
contains the number of bytes pointed to.
The caller should
estimate the number of random bits
in the sample,
and pass this in
If the estimated number of bits per sample is an integer, then
is used, and
for low-entropy samples,
entropy can be supplied in
(This is considered to be
1024 bits of entropy.)
is chosen from
RANDOM_WRITE, RANDOM_KEYBOARD, RANDOM_MOUSE, RANDOM_NET
and is used to indicate the source of the entropy.
Interrupt harvesting has been simplified
for the kernel programmer.
If a device driver registers an interrupt handler
then it is only necessary to
bit in the
argument to have that interrupt source
be used for entropy harvesting.