Clarify INTERNAL_ERROR_ARC4RANDOM_GETENTROPY_FAIL

Update #3239.
This commit is contained in:
Sebastian Huber 2017-11-20 08:08:30 +01:00
parent e2a1a3ab2a
commit 70f23e475b
2 changed files with 6 additions and 2 deletions

View File

@ -21,7 +21,10 @@ turn are used by various cryptographic functions.
suitable for such applications. suitable for such applications.
The :c:func:`getentropy` implementation must fill the specified memory region The :c:func:`getentropy` implementation must fill the specified memory region
of the given size with random numbers and return 0 on success. of the given size with random numbers and return 0 on success. A non-zero
return may cause the :c:macro:`INTERNAL_ERROR_ARC4RANDOM_GETENTROPY_FAIL`
internal error by one of the
`ARC4RANDOM(3) <https://man.openbsd.org/arc4random.3>`_ functions.
In general, for embedded systems it is not easy to get some real entropy. Normally, In general, for embedded systems it is not easy to get some real entropy. Normally,
that can only be reached with some extra hardware support. Some microcontrollers that can only be reached with some extra hardware support. Some microcontrollers

View File

@ -390,7 +390,8 @@ INTERNAL_ERROR_ILLEGAL_USE_OF_FLOATING_POINT_UNIT (38)
INTERNAL_ERROR_ARC4RANDOM_GETENTROPY_FAIL (39) INTERNAL_ERROR_ARC4RANDOM_GETENTROPY_FAIL (39)
A :c:func:`getentropy` system call failed in one of the `ARC4RANDOM(3) A :c:func:`getentropy` system call failed in one of the `ARC4RANDOM(3)
<https://man.openbsd.org/arc4random.3>`_ functions. <https://man.openbsd.org/arc4random.3>`_ functions. This fatal error can
only be fixed with a different implementation of :c:func:`getentropy`.
Operations Operations
========== ==========