summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorSree Harsha Totakura <totakura@in.tum.de>2015-01-26 10:19:01 +0000
committerSree Harsha Totakura <totakura@in.tum.de>2015-01-26 10:19:01 +0000
commit519670a02e5be5ca92474d80a6117fc7a74a85d8 (patch)
treec0addde1b95180a1a238712160a7f62176d6dd34 /src
parentab92b2147ade8661f27dee580e30ebc13d839586 (diff)
- fix docu
Diffstat (limited to 'src')
-rw-r--r--src/include/gnunet_crypto_lib.h16
-rw-r--r--src/util/crypto_rsa.c9
2 files changed, 13 insertions, 12 deletions
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