Merge pull request #92 from QuasarApp/task_84

Header and doxygen update
This commit is contained in:
Oleg-designer 2021-05-14 19:52:38 +03:00 committed by GitHub
commit 8b44c00121
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 26 additions and 20 deletions

View File

@ -703,7 +703,7 @@ FILE_VERSION_FILTER =
# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
# tag is left empty.
LAYOUT_FILE = /res/DoxyStyle/DoxygenLayout.xml
LAYOUT_FILE = src/mini-gmp/CMake/DoxyStyle/DoxygenLayout.xml
# The CITE_BIB_FILES tag can be used to specify one or more bib files containing
# the reference definitions. This must be a list of .bib files. The .bib
@ -1195,7 +1195,7 @@ HTML_STYLESHEET =
# list). For an example see the documentation.
# This tag requires that the tag GENERATE_HTML is set to YES.
HTML_EXTRA_STYLESHEET = res/DoxyStyle/doxygenStyles.css
HTML_EXTRA_STYLESHEET = src/mini-gmp/CMake/DoxyStyle/doxygenStyles.css
# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
# other source files which should be copied to the HTML output directory. Note

View File

@ -69,6 +69,7 @@ To ensure reliable protection, it is recommended to use an exponent size of at l
* @brief generatePairKey Generate RSA pair keys.
* @param pubKey Return value of pablic key.
* @param privKey Return value of private key.
* @param rsa Encryption key length. See more information in ::QRSAEncryption::
* @warning The keys will not be the same if you generate RSA keys of different sizes.
* @return true if all good.
*/
@ -80,6 +81,7 @@ To ensure reliable protection, it is recommended to use an exponent size of at l
* @param pubKey Return value of public key.
* @param privKey Return value of private key.
* @param genesis random bytes of arbitrary size.
* @param rsa Encryption key length.
* This option allows you to generate a key pair that is attached to a given set of bytes.
* Example if you set the value to 0xFF, then you will always get the same key pair attached to this value.
* This can be convenient if you have some kind of super key by which you want to generate a pair of RSA keys.
@ -93,42 +95,46 @@ To ensure reliable protection, it is recommended to use an exponent size of at l
/**
* @brief encode Static implementation of encode.
* @param rawData
* @param pubKey
* @param rsa
* @param blockSizeMode
* @return
* @param rawData Encode rawData.
* @param pubKey Public key. Public key size must be equals size of RSA class.
* @param rsa Encryption key length.
* @param blockSizeMode Block size. See the BlockSize enum class.
* @return The encoded data.
* @note This is wrapper for a static method.
*/
static QByteArray encode(const QByteArray &rawData, const QByteArray &pubKey,
Rsa rsa, BlockSize blockSizeMode = BlockSize::Auto);
/**
* @brief decode Static implementation of decode.
* @param rawData
* @param privKey
* @param rsa
* @param blockSizeMode
* @return
* @param rawData Ecoded data.
* @param privKey Private RSA key.
* @param rsa Encryption key length.
* @param blockSizeMode Block size mode see the BlockSize enum class.
* @return Decoded data.
* @note This is wrapper for a static method.
*/
static QByteArray decode(const QByteArray &rawData, const QByteArray &privKey,
Rsa rsa, BlockSize blockSizeMode = BlockSize::Auto);
/**
* @brief signMessage Static implementation of signMessage.
* @param rawData
* @param privKey
* @param rsa
* @return
* @param rawData The raw data for signature.
* @param privKey The private key.
* @param rsa Encryption key length.
* @return The signed message.
* @note This is wrapper for a static method.
*/
static QByteArray signMessage(QByteArray rawData, const QByteArray &privKey,
Rsa rsa);
/**
* @brief checkSignMessage Static implementation of checkSignMessage.
* @param rawData
* @param pubKey
* @param rsa
* @return
* @param rawData The raw data for verification.
* @param pubKey The public key.
* @param rsa Encryption key length.
* @return True if data sigend.
* @note This is wrapper for a static method.
*/
static bool checkSignMessage(const QByteArray &rawData, const QByteArray &pubKey,
Rsa rsa);