diff options
author | Jeffrey Walton <noloader@gmail.com> | 2020-12-08 00:15:19 -0500 |
---|---|---|
committer | Jeffrey Walton <noloader@gmail.com> | 2020-12-08 00:15:19 -0500 |
commit | 07899488150b0e0e8ac714c014f9a6e245f911a7 (patch) | |
tree | 4de8809f4c7061dffa06e6013a0a1912f80c55f0 /dsa.h | |
parent | ac6987f3aee8fedd52a08f8d6e9b7d5ad28559bb (diff) | |
download | cryptopp-git-07899488150b0e0e8ac714c014f9a6e245f911a7.tar.gz |
Update documentation
Diffstat (limited to 'dsa.h')
-rw-r--r-- | dsa.h | 5 |
1 files changed, 5 insertions, 0 deletions
@@ -33,10 +33,15 @@ enum DSASignatureFormat { /// \param signature byte buffer for the existing signature encoding
/// \param signatureLen the length of the existing signature encoding buffer
/// \param fromFormat the source signature format
+/// \return the number of bytes written during encoding
/// \details This function converts between these formats, and returns length
/// of signature in the target format. If <tt>toFormat == DSA_P1363</tt>, then
/// <tt>bufferSize</tt> must equal <tt>publicKey.SignatureLength()</tt> or
/// <tt>verifier.SignatureLength()</tt>.
+/// \details If the destination buffer is too small then the output of the
+/// encoded <tt>r</tt> and <tt>s</tt> will be truncated. Be sure to provide
+/// an adequately sized buffer and check the return value for the number of
+/// bytes written.
/// \sa <A HREF="http://www.cryptopp.com/wiki/DSAConvertSignatureFormat">DSAConvertSignatureFormat</A>
/// on the Crypto++ wiki.
/// \since Crypto++ 1.0
|