arne
/
cryptopp
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update documentation

master
Jeffrey Walton 2019-08-24 16:59:39 -04:00
parent a2c06c35b8
commit ff941db163
No known key found for this signature in database
GPG Key ID: B36AB348921B1838
1 changed files with 26 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
elgamal.h
View File

@ -51,6 +51,8 @@ public:
size_t GetMaxSymmetricPlaintextLength(size_t cipherTextLength) const size_t GetMaxSymmetricPlaintextLength(size_t cipherTextLength) const
{ {
unsigned int len = GetGroupParameters().GetModulus().ByteCount(); unsigned int len = GetGroupParameters().GetModulus().ByteCount();
CRYPTOPP_ASSERT(len >= 3);
if (cipherTextLength == len) if (cipherTextLength == len)
return STDMIN(255U, len-3); return STDMIN(255U, len-3);
else else
@ -95,6 +97,9 @@ public:
}; };
/// \brief ElGamal key agreement and encryption schemes default implementation /// \brief ElGamal key agreement and encryption schemes default implementation
/// \tparam BASE Base class implementation
/// \tparam SCHEME_OPTIONS Scheme options
/// \tparam Key ElGamal key classes
/// \since Crypto++ 1.0 /// \since Crypto++ 1.0
template <class BASE, class SCHEME_OPTIONS, class KEY> template <class BASE, class SCHEME_OPTIONS, class KEY>
class ElGamalObjectImpl : public DL_ObjectImplBase<BASE, SCHEME_OPTIONS, KEY>, public ElGamalBase class ElGamalObjectImpl : public DL_ObjectImplBase<BASE, SCHEME_OPTIONS, KEY>, public ElGamalBase
@ -116,6 +121,14 @@ protected:
const DL_SymmetricEncryptionAlgorithm & GetSymmetricEncryptionAlgorithm() const {return *this;} const DL_SymmetricEncryptionAlgorithm & GetSymmetricEncryptionAlgorithm() const {return *this;}
}; };
/// \brief ElGamal Public Key adapter
/// \tparam BASE PublicKey derived class
/// \details DL_PublicKey_ElGamal provides an override for GetAlgorithmID()
/// to utilize 1.3.14.7.2.1.1. Prior to DL_PublicKey_ElGamal, the ElGamal
/// keys used the OID from DSA due to DL_GroupParmaters_GFP().
/// \sa <A HREF="https://github.com/weidai11/cryptopp/issues/876">Issue 876</A>,
/// <A HREF="https://github.com/weidai11/cryptopp/issues/567">Issue 567</A>
/// \since Crypto++ 8.3
template <class BASE> template <class BASE>
struct DL_PublicKey_ElGamal : public BASE struct DL_PublicKey_ElGamal : public BASE
{ {
@ -125,6 +138,14 @@ struct DL_PublicKey_ElGamal : public BASE
} }
}; };
/// \brief ElGamal Private Key adapter
/// \tparam BASE PrivateKey derived class
/// \details DL_PrivateKey_ElGamal provides an override for GetAlgorithmID()
/// to utilize 1.3.14.7.2.1.1. Prior to DL_PrivateKey_ElGamal, the ElGamal
/// keys used the OID from DSA due to DL_GroupParmaters_GFP().
/// \sa <A HREF="https://github.com/weidai11/cryptopp/issues/876">Issue 876</A>,
/// <A HREF="https://github.com/weidai11/cryptopp/issues/567">Issue 567</A>
/// \since Crypto++ 8.3
template <class BASE> template <class BASE>
struct DL_PrivateKey_ElGamal : public BASE struct DL_PrivateKey_ElGamal : public BASE
{ {
@ -138,7 +159,9 @@ struct DL_PrivateKey_ElGamal : public BASE
/// \details The ElGamalKeys class used DL_PrivateKey_GFP_OldFormat and DL_PublicKey_GFP_OldFormat /// \details The ElGamalKeys class used DL_PrivateKey_GFP_OldFormat and DL_PublicKey_GFP_OldFormat
/// for the PrivateKey and PublicKey typedef from about Crypto++ 1.0 through Crypto++ 5.6.5. /// for the PrivateKey and PublicKey typedef from about Crypto++ 1.0 through Crypto++ 5.6.5.
/// At Crypto++ 6.0 the serialization format was cutover to standard PKCS8 and X509 encodings. /// At Crypto++ 6.0 the serialization format was cutover to standard PKCS8 and X509 encodings.
/// \sa <A HREF="https://github.com/weidai11/cryptopp/commit/a5a684d92986e8e2">Commit a5a684d92986e8e2</A> /// \sa <A HREF="https://github.com/weidai11/cryptopp/issues/876">Issue 876</A>,
/// <A HREF="https://github.com/weidai11/cryptopp/issues/567">Issue 567</A>
/// \since Crypto++ 1.0
struct ElGamalKeys struct ElGamalKeys
{ {
typedef DL_CryptoKeys_GFP::GroupParameters GroupParameters; typedef DL_CryptoKeys_GFP::GroupParameters GroupParameters;