diff --git a/darn.h b/darn.h index 66b69de3..613a9b0d 100644 --- a/darn.h +++ b/darn.h @@ -11,6 +11,8 @@ /// \file darn.h /// \brief Classes for DARN RNG +/// \sa Power +/// ISA Version 3.0B /// \since Crypto++ 8.0 #ifndef CRYPTOPP_DARN_H @@ -22,8 +24,6 @@ NAMESPACE_BEGIN(CryptoPP) /// \brief Exception thrown when a DARN generator encounters /// a generator related error. -/// \sa Power -/// ISA Version 3.0B /// \since Crypto++ 8.0 class DARN_Err : public Exception { @@ -33,12 +33,16 @@ public: }; /// \brief Hardware generated random numbers using DARN instruction -/// \details DARN() provides access to Power9's random number generator. +/// \details DARN() provides access to Power9's random number generator. The +/// Crypto++ implementation provides conditioned random numbers from the +/// generator as opposed to raw random numbers. According to Power ISA 3.0B +/// manual, a conditioned random number has been processed by hardware to +/// reduce bias. A raw random number is unconditioned noise source output. /// \details According to Power ISA 3.0B manual, the random number generator -/// provided by this instruction is NIST SP800-90B and SP800-90C compliant to -/// the extent possible given the completeness of the standards at the time -/// the hardware is designed. The random number generator provides a minimum -/// of 0.5 bits of entropy per bit. +/// provided by the darn instruction is NIST SP800-90B and SP800-90C +/// compliant to the extent possible given the completeness of the standards +/// at the time the hardware is designed. The random number generator provides +/// a minimum of 0.5 bits of entropy per bit. /// \par Wraps /// darn instruction /// \sa Power