From 855922b2ca8c27c9a29f73df6f45cf132e4a7d85 Mon Sep 17 00:00:00 2001 From: Jeffrey Walton Date: Sun, 20 Aug 2017 04:59:41 -0400 Subject: Updated documentation --- padlkrng.h | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) (limited to 'padlkrng.h') diff --git a/padlkrng.h b/padlkrng.h index 1c83bff2..cd70b693 100644 --- a/padlkrng.h +++ b/padlkrng.h @@ -28,8 +28,9 @@ public: //! \brief Hardware generated random numbers using VIA XSTORE //! \details Some VIA processors provide a Security Engine called Padlock. The Padlock -//! Security Engine provides AES, SHA and a RNG. PadlockRNG provides access to the RNG. -//! \details The PadlockRNG uses an 8 byte FIFO buffer for random numbers. The +//! Security Engine provides AES, SHA and a RNG. The PadlockRNG class provides access +//! to the RNG. +//! \details The VIA generator uses an 8 byte FIFO buffer for random numbers. The //! generator can be configured to discard bits from the buffer to resist analysis. //! The divisor controls the number of bytes discarded. The formula for //! the discard amount is 2**divisor - 1. When divisor=0 no bits @@ -40,8 +41,8 @@ public: //! non-secure applications. Additionally, the Programmers Guide and SDK provided a //! different configuration in the sample code. //! \details You can operate the generator according to CRI recommendations by setting -//! divisor, reading one word (or partial word) at a time, and then inspecting -//! the MSR after each read. +//! divisor, reading one word (or partial word) at a time from the FIFO, and +//! then inspecting the MSR after each read. //! \details The audit report with recommendations is available on the Crypto++ wiki //! at VIA Padlock. //! \sa MaurerRandomnessTest() for random bit generators @@ -56,8 +57,9 @@ public: //! \brief Construct a PadlockRNG generator //! \param divisor the XSTORE divisor //! \details Some VIA processors provide a Security Engine called Padlock. The Padlock - //! Security Engine provides AES, SHA and a RNG. PadlockRNG provides access to the RNG. - //! \details The PadlockRNG uses an 8 byte FIFO buffer for random numbers. The + //! Security Engine provides AES, SHA and a RNG. The PadlockRNG class provides access + //! to the RNG. + //! \details The VIA generator uses an 8 byte FIFO buffer for random numbers. The //! generator can be configured to discard bits from the buffer to resist analysis. //! The divisor controls the number of bytes discarded. The formula for //! the discard amount is 2**divisor - 1. When divisor=0 no bits -- cgit v1.2.1