55 lines
1.9 KiB
Plaintext
55 lines
1.9 KiB
Plaintext
|
=======================================================
|
||
|
|
qrngd test program (qrngtest)
|
||
|
|
=======================================================
|
||
|
|
|
||
|
|
Description:
|
||
|
|
The qrngtest test program is used to verify that the hardware,
|
||
|
|
kernel driver and qrngd daemon are working correctly. By default
|
||
|
|
it opens the "/dev/random" device and does complete testing in a very
|
||
|
|
short period of time around ~3-5 seconds.
|
||
|
|
|
||
|
|
It can be run interactively for more test options.
|
||
|
|
|
||
|
|
It requires msm RNG driver (/dev/hw_random) for daemon.
|
||
|
|
It requires the system random device (/dev/random) for testing.
|
||
|
|
|
||
|
|
Parameters:
|
||
|
|
It will accept the following optional arguments:
|
||
|
|
-c run continuously
|
||
|
|
-q do not display run-time status
|
||
|
|
-r <device name> random input device (default: /dev/random)
|
||
|
|
-h help (this page)\n";
|
||
|
|
|
||
|
|
The default parameters should work fine for automated testing.
|
||
|
|
|
||
|
|
Return:
|
||
|
|
It will return 0 if all test cases succeed otherwise it
|
||
|
|
returns a value < 0:
|
||
|
|
|
||
|
|
EXIT_NO_ERRROR 0
|
||
|
|
EXIT_BAD_PARAMETER -1
|
||
|
|
EXIT_COULD_NOT_OPEN_DEVICE -2
|
||
|
|
EXIT_COULD_NOT_READ_DEVICE -3
|
||
|
|
EXIT_TIMED_OUT_READING_DEVICE -4
|
||
|
|
EXIT_RANDOM_TEST_FAILED -5
|
||
|
|
|
||
|
|
Usage:
|
||
|
|
The qrngtest program by default does not require any parameters for automatic
|
||
|
|
testing. By default the program opens "/dev/random", this will test the
|
||
|
|
hardware, driver daemon and random number subsystem for Linux.
|
||
|
|
|
||
|
|
If for some reason the test fails, the user can specify,
|
||
|
|
"qrngtest -r /dev/hw_random" and this will only test the driver and hardware
|
||
|
|
to help troubleshoot any issues that may arise.
|
||
|
|
|
||
|
|
Details:
|
||
|
|
The test runs 100 iterations of the test. Each iteration reads in 8KB of
|
||
|
|
random data and checks it for randomness. The test will fail if the
|
||
|
|
"/dev/random" device or any other valid specified device is read blocked,
|
||
|
|
fails to give random numbers or just cannot open the device. Everything
|
||
|
|
must work correctly to get a return of 0 (zero).
|
||
|
|
|
||
|
|
Targets:
|
||
|
|
8x60
|
||
|
|
|