From 519670a02e5be5ca92474d80a6117fc7a74a85d8 Mon Sep 17 00:00:00 2001 From: Sree Harsha Totakura Date: Mon, 26 Jan 2015 10:19:01 +0000 Subject: - fix docu --- src/include/gnunet_crypto_lib.h | 16 ++++++++-------- src/util/crypto_rsa.c | 9 +++++---- 2 files changed, 13 insertions(+), 12 deletions(-) (limited to 'src') diff --git a/src/include/gnunet_crypto_lib.h b/src/include/gnunet_crypto_lib.h index 6f777a562..38ef966a9 100644 --- a/src/include/gnunet_crypto_lib.h +++ b/src/include/gnunet_crypto_lib.h @@ -1644,8 +1644,7 @@ GNUNET_CRYPTO_rsa_signature_free (struct GNUNET_CRYPTO_rsa_Signature *sig); /** - * Encode the given signature in a format suitable for - * storing it into a file. + * Encode the given signature in a format suitable for storing it into a file. * * @param sig the signature * @param[out] buffer set to a buffer with the encoded key @@ -1657,8 +1656,8 @@ GNUNET_CRYPTO_rsa_signature_encode (const struct GNUNET_CRYPTO_rsa_Signature *si /** - * Decode the signature from the data-format back - * to the "normal", internal format. + * Decode the signature from the data-format back to the "normal", internal + * format. * * @param buf the buffer where the public key data is stored * @param len the length of the data in @a buf @@ -1670,9 +1669,9 @@ GNUNET_CRYPTO_rsa_signature_decode (const char *buf, /** - * Unblind a signature made on blinding signature purpose. The signature - * purpose should have been generated with #GNUNET_CRYPTO_rsa_sign() using - * a message that was generated with #GNUNET_CRYPTO_rsa_blind(). + * Unblind a blind-signed signature. The signature should have been generated + * with #GNUNET_CRYPTO_rsa_sign() using a hash that was blinded with + * #GNUNET_CRYPTO_rsa_blind(). * * @param sig the signature made on the blinded signature purpose * @param bkey the blinding key used to blind the signature purpose @@ -1686,7 +1685,8 @@ GNUNET_CRYPTO_rsa_unblind (struct GNUNET_CRYPTO_rsa_Signature *sig, /** - * Verify signature with the given hash. + * Verify whether the given hash corresponds to the given signature and the + * signature is valid with respect to the given public key. * * @param hash the message to verify to match the @a sig * @param sig signature that is being validated diff --git a/src/util/crypto_rsa.c b/src/util/crypto_rsa.c index ba8639365..7e64515e2 100644 --- a/src/util/crypto_rsa.c +++ b/src/util/crypto_rsa.c @@ -690,9 +690,9 @@ GNUNET_CRYPTO_rsa_signature_decode (const char *buf, /** - * Unblind a signature made on blinding signature purpose. The signature - * purpose should have been generated with #GNUNET_CRYPTO_rsa_sign() using - * a message that was generated with #GNUNET_CRYPTO_rsa_blind(). + * Unblind a blind-signed signature. The signature should have been generated + * with #GNUNET_CRYPTO_rsa_sign() using a hash that was blinded with + * #GNUNET_CRYPTO_rsa_blind(). * * @param sig the signature made on the blinded signature purpose * @param bkey the blinding key used to blind the signature purpose @@ -758,7 +758,8 @@ GNUNET_CRYPTO_rsa_unblind (struct GNUNET_CRYPTO_rsa_Signature *sig, /** - * Verify signature with the given hash. + * Verify whether the given hash corresponds to the given signature and the + * signature is valid with respect to the given public key. * * @param hash hash of the message to verify to match the @a sig * @param sig signature that is being validated -- cgit v1.2.3