Updated documentation

pull/263/head
Jeffrey Walton 2016-09-09 04:45:20 -04:00
parent 24cbd7c451
commit b7300a96ae
1 changed files with 22 additions and 0 deletions

View File

@ -2,6 +2,13 @@
//! \file keccak.h //! \file keccak.h
//! \brief Classes for Keccak message digests //! \brief Classes for Keccak message digests
//! \details The Keccak classes use F1600 and XOF byte 0x80, which is effectively
//! the behavior specified by NIST at round three of the selection process. If you
//! desire FIPS 202 behavior, then use SHA3 classes.
//! \details Keccak will likely change in the future to accomodate extensibility of the
//! round function and the XOF functions.
//! \details Perform the following to specify a different digest size. It will use F1600 and 0x80.
//! <pre>Keccack_192 : public Keccack
//! \sa <a href="http://en.wikipedia.org/wiki/Keccak">Keccak</a> //! \sa <a href="http://en.wikipedia.org/wiki/Keccak">Keccak</a>
#ifndef CRYPTOPP_KECCAK_H #ifndef CRYPTOPP_KECCAK_H
@ -14,6 +21,21 @@ NAMESPACE_BEGIN(CryptoPP)
//! \class Keccak //! \class Keccak
//! \brief Keccak message digest base class //! \brief Keccak message digest base class
//! \details The Keccak classes use F1600 and XOF byte 0x80, which is effectively
//! the behavior specified by NIST at round three of the selection process. If you
//! desire FIPS 202 behavior, then use SHA3 classes.
//! \details Keccak will likely change in the future to accomodate extensibility of the
//! round function and the XOF functions.
//! \details Perform the following to specify a different digest size. The class will use F1600, 0x80,
//! and a new vaue for <tt>r()</tt> (which will be <tt>200-2*24 = 152</tt>).
//! <pre>Keccack_192 : public Keccack
//! {
//! public:
//! CRYPTOPP_CONSTANT(DIGESTSIZE = 24)
//! Keccack_192() : Keccack(DIGESTSIZE) {}
//! };
//! </pre>
//!
class Keccak : public HashTransformation class Keccak : public HashTransformation
{ {
public: public: