summaryrefslogtreecommitdiff
path: root/src/testing
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2021-08-02 15:58:53 +0200
committerChristian Grothoff <christian@grothoff.org>2021-08-02 15:58:53 +0200
commitf3ed6ea694e83e45d257fb64b5ae23e73bc81465 (patch)
treeb48275a94cef9962f144bfef9e299c971248b85a /src/testing
parented7b39b035fa18b777b71ddc568deff2f7977c82 (diff)
downloadanastasis-f3ed6ea694e83e45d257fb64b5ae23e73bc81465.tar.gz
anastasis-f3ed6ea694e83e45d257fb64b5ae23e73bc81465.tar.bz2
anastasis-f3ed6ea694e83e45d257fb64b5ae23e73bc81465.zip
misc doxygen fixes
Diffstat (limited to 'src/testing')
-rw-r--r--src/testing/testing_api_cmd_config.c7
-rw-r--r--src/testing/testing_api_cmd_keyshare_lookup.c2
-rw-r--r--src/testing/testing_api_cmd_policy_lookup.c22
-rw-r--r--src/testing/testing_api_cmd_policy_store.c3
-rw-r--r--src/testing/testing_api_cmd_truth_store.c5
-rw-r--r--src/testing/testing_api_helpers.c2
-rw-r--r--src/testing/testing_api_trait_account_priv.c24
-rw-r--r--src/testing/testing_api_trait_account_pub.c24
-rw-r--r--src/testing/testing_api_trait_code.c28
-rw-r--r--src/testing/testing_api_trait_eks.c8
-rw-r--r--src/testing/testing_api_trait_hash.c2
11 files changed, 32 insertions, 95 deletions
diff --git a/src/testing/testing_api_cmd_config.c b/src/testing/testing_api_cmd_config.c
index 7ff42c9..cf6979c 100644
--- a/src/testing/testing_api_cmd_config.c
+++ b/src/testing/testing_api_cmd_config.c
@@ -14,12 +14,11 @@
TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/>
*/
/**
- * @file testing/testing_api_cmd_config.c
+ * @file anastasis/src/testing/testing_api_cmd_config.c
* @brief command to obtain the configuration of an anastasis backend service.
* @author Dennis Neufeld
* @author Dominik Meister
*/
-
#include "platform.h"
#include "anastasis_testing_lib.h"
#include <taler/taler_util.h>
@@ -59,7 +58,7 @@ struct ConfigState
/**
- * Function called with the results of a #ANASTASIS_config().
+ * Function called with the results of a #ANASTASIS_get_config().
*
* @param cls closure
* @param http_status HTTP status of the request
@@ -156,7 +155,7 @@ config_cleanup (void *cls,
* Offer internal data to other commands.
*
* @param cls closure
- * @param ret[out] result (could be anything)
+ * @param[out] ret result (could be anything)
* @param trait name of the trait
* @param index index number of the object to extract.
* @return #GNUNET_OK on success
diff --git a/src/testing/testing_api_cmd_keyshare_lookup.c b/src/testing/testing_api_cmd_keyshare_lookup.c
index efc8c9a..45e1e26 100644
--- a/src/testing/testing_api_cmd_keyshare_lookup.c
+++ b/src/testing/testing_api_cmd_keyshare_lookup.c
@@ -14,7 +14,7 @@
Anastasis; see the file COPYING.GPL. If not, see <http://www.gnu.org/licenses/>
*/
/**
- * @file testing/anastasis_api_keyshare_lookup.c
+ * @file testing/testing_api_cmd_keyshare_lookup.c
* @brief Testing of Implementation of the /truth GET
* @author Christian Grothoff
* @author Dennis Neufeld
diff --git a/src/testing/testing_api_cmd_policy_lookup.c b/src/testing/testing_api_cmd_policy_lookup.c
index 0906491..6608d90 100644
--- a/src/testing/testing_api_cmd_policy_lookup.c
+++ b/src/testing/testing_api_cmd_policy_lookup.c
@@ -69,11 +69,11 @@ struct PolicyLookupState
/**
- * Function called with the results of a #ANASTASIS_lookup().
+ * Function called with the results of a #ANASTASIS_policy_lookup().
*
* @param cls closure
* @param http_status HTTP status of the request
- * @param ud details about the lookup operation
+ * @param dd details about the lookup operation
*/
static void
policy_lookup_cb (void *cls,
@@ -197,16 +197,6 @@ policy_lookup_cleanup (void *cls,
}
-/**
- * Make the "policy lookup" command.
- *
- * @param label command label
- * @param anastasis_url base URL of the ANASTASIS serving
- * the policy store request.
- * @param http_status expected HTTP status.
- * @param upload_ref reference to upload command
- * @return the command
- */
struct TALER_TESTING_Command
ANASTASIS_TESTING_cmd_policy_lookup (const char *label,
const char *anastasis_url,
@@ -233,14 +223,6 @@ ANASTASIS_TESTING_cmd_policy_lookup (const char *label,
}
-/**
- * Make the "policy lookup" command for a non-existent upload.
- *
- * @param label command label
- * @param anastasis_url base URL of the ANASTASIS serving
- * the policy lookup request.
- * @return the command
- */
struct TALER_TESTING_Command
ANASTASIS_TESTING_cmd_policy_nx (const char *label,
const char *anastasis_url)
diff --git a/src/testing/testing_api_cmd_policy_store.c b/src/testing/testing_api_cmd_policy_store.c
index d5062c0..9f4a80a 100644
--- a/src/testing/testing_api_cmd_policy_store.c
+++ b/src/testing/testing_api_cmd_policy_store.c
@@ -125,10 +125,9 @@ struct PolicyStoreState
};
/**
- * Function called with the results of a #policy_store().
+ * Function called with the results of an #ANASTASIS_policy_store() operation.
*
* @param cls closure
- * @param http_status HTTP status of the request
* @param ud details about the upload operation
*/
static void
diff --git a/src/testing/testing_api_cmd_truth_store.c b/src/testing/testing_api_cmd_truth_store.c
index 40c4d32..816a285 100644
--- a/src/testing/testing_api_cmd_truth_store.c
+++ b/src/testing/testing_api_cmd_truth_store.c
@@ -112,11 +112,10 @@ struct TruthStoreState
};
/**
- * Function called with the results of a #truth_store().
+ * Function called with the results of an #ANASTASIS_truth_store()
+ * operation.
*
* @param cls closure
- * @param ec ANASTASIS error code
- * @param http_status HTTP status of the request
* @param ud details about the upload operation
*/
static void
diff --git a/src/testing/testing_api_helpers.c b/src/testing/testing_api_helpers.c
index fb3cb48..e64f506 100644
--- a/src/testing/testing_api_helpers.c
+++ b/src/testing/testing_api_helpers.c
@@ -18,7 +18,7 @@
*/
/**
- * @file testing/testing_api_helpers.c
+ * @file anastasis/src/testing/testing_api_helpers.c
* @brief helper functions for test library.
* @author Christian Grothoff
* @author Marcello Stanisci
diff --git a/src/testing/testing_api_trait_account_priv.c b/src/testing/testing_api_trait_account_priv.c
index a40e9d2..a666f7a 100644
--- a/src/testing/testing_api_trait_account_priv.c
+++ b/src/testing/testing_api_trait_account_priv.c
@@ -27,17 +27,9 @@
#define ANASTASIS_TESTING_TRAIT_ACCOUNT_PRIV "anastasis-account_priv"
-/**
- * Obtain an account private key from @a cmd.
- *
- * @param cmd command to extract the private key from.
- * @param index the private key's index number.
- * @param n[out] set to the private key coming from @a cmd.
- * @return #GNUNET_OK on success.
- */
int
-ANASTASIS_TESTING_get_trait_account_priv
- (const struct TALER_TESTING_Command *cmd,
+ANASTASIS_TESTING_get_trait_account_priv (
+ const struct TALER_TESTING_Command *cmd,
unsigned int index,
const struct ANASTASIS_CRYPTO_AccountPrivateKeyP **priv)
{
@@ -48,16 +40,9 @@ ANASTASIS_TESTING_get_trait_account_priv
}
-/**
- * Offer an account private key.
- *
- * @param index usually zero
- * @param priv the account_priv to offer.
- * @return #GNUNET_OK on success.
- */
struct TALER_TESTING_Trait
-ANASTASIS_TESTING_make_trait_account_priv
- (unsigned int index,
+ANASTASIS_TESTING_make_trait_account_priv (
+ unsigned int index,
const struct ANASTASIS_CRYPTO_AccountPrivateKeyP *priv)
{
struct TALER_TESTING_Trait ret = {
@@ -65,6 +50,7 @@ ANASTASIS_TESTING_make_trait_account_priv
.trait_name = ANASTASIS_TESTING_TRAIT_ACCOUNT_PRIV,
.ptr = (const void *) priv
};
+
return ret;
}
diff --git a/src/testing/testing_api_trait_account_pub.c b/src/testing/testing_api_trait_account_pub.c
index 19ba79f..9a6a45a 100644
--- a/src/testing/testing_api_trait_account_pub.c
+++ b/src/testing/testing_api_trait_account_pub.c
@@ -27,17 +27,9 @@
#define ANASTASIS_TESTING_TRAIT_ACCOUNT_PUB "anastasis-account_pub"
-/**
- * Obtain an account public key from @a cmd.
- *
- * @param cmd command to extract the public key from.
- * @param index the public key's index number.
- * @param n[out] set to the public key coming from @a cmd.
- * @return #GNUNET_OK on success.
- */
int
-ANASTASIS_TESTING_get_trait_account_pub
- (const struct TALER_TESTING_Command *cmd,
+ANASTASIS_TESTING_get_trait_account_pub (
+ const struct TALER_TESTING_Command *cmd,
unsigned int index,
const struct ANASTASIS_CRYPTO_AccountPublicKeyP **pub)
{
@@ -48,16 +40,9 @@ ANASTASIS_TESTING_get_trait_account_pub
}
-/**
- * Offer an account public key.
- *
- * @param index usually zero
- * @param h the account_pub to offer.
- * @return #GNUNET_OK on success.
- */
struct TALER_TESTING_Trait
-ANASTASIS_TESTING_make_trait_account_pub
- (unsigned int index,
+ANASTASIS_TESTING_make_trait_account_pub (
+ unsigned int index,
const struct ANASTASIS_CRYPTO_AccountPublicKeyP *h)
{
struct TALER_TESTING_Trait ret = {
@@ -65,6 +50,7 @@ ANASTASIS_TESTING_make_trait_account_pub
.trait_name = ANASTASIS_TESTING_TRAIT_ACCOUNT_PUB,
.ptr = (const void *) h
};
+
return ret;
}
diff --git a/src/testing/testing_api_trait_code.c b/src/testing/testing_api_trait_code.c
index 9989dec..5892065 100644
--- a/src/testing/testing_api_trait_code.c
+++ b/src/testing/testing_api_trait_code.c
@@ -17,7 +17,7 @@
<http://www.gnu.org/licenses/>
*/
/**
- * @file testing/testing_api_trait_string.c
+ * @file testing/testing_api_trait_code.c
* @brief traits to offers a code for a challenge
* @author Dominik Meister
* @author Christian Grothoff
@@ -28,17 +28,9 @@
#define ANASTASIS_TESTING_TRAIT_CODE "anastasis-code"
-/**
- * Obtain a code from @a cmd.
- *
- * @param cmd command to extract the number from.
- * @param index the number's index number.
- * @param n[out] set to the number coming from @a cmd.
- * @return #GNUNET_OK on success.
- */
int
-ANASTASIS_TESTING_get_trait_code
- (const struct TALER_TESTING_Command *cmd,
+ANASTASIS_TESTING_get_trait_code (
+ const struct TALER_TESTING_Command *cmd,
unsigned int index,
const char **code)
{
@@ -49,16 +41,9 @@ ANASTASIS_TESTING_get_trait_code
}
-/**
- * Offer a code.
- *
- * @param index the number's index number.
- * @param code the code to offer.
- * @return #GNUNET_OK on success.
- */
struct TALER_TESTING_Trait
-ANASTASIS_TESTING_make_trait_code
- (unsigned int index,
+ANASTASIS_TESTING_make_trait_code (
+ unsigned int index,
const char *code)
{
struct TALER_TESTING_Trait ret = {
@@ -66,8 +51,9 @@ ANASTASIS_TESTING_make_trait_code
.trait_name = ANASTASIS_TESTING_TRAIT_CODE,
.ptr = (const void *) code
};
+
return ret;
}
-/* end of testing_api_trait_string.c */
+/* end of testing_api_trait_code.c */
diff --git a/src/testing/testing_api_trait_eks.c b/src/testing/testing_api_trait_eks.c
index f374433..1c19233 100644
--- a/src/testing/testing_api_trait_eks.c
+++ b/src/testing/testing_api_trait_eks.c
@@ -29,8 +29,8 @@
int
-ANASTASIS_TESTING_get_trait_eks
- (const struct TALER_TESTING_Command *cmd,
+ANASTASIS_TESTING_get_trait_eks (
+ const struct TALER_TESTING_Command *cmd,
unsigned int index,
const struct ANASTASIS_CRYPTO_EncryptedKeyShareP **eks)
{
@@ -42,8 +42,8 @@ ANASTASIS_TESTING_get_trait_eks
struct TALER_TESTING_Trait
-ANASTASIS_TESTING_make_trait_eks
- (unsigned int index,
+ANASTASIS_TESTING_make_trait_eks (
+ unsigned int index,
const struct ANASTASIS_CRYPTO_EncryptedKeyShareP *eks)
{
struct TALER_TESTING_Trait ret = {
diff --git a/src/testing/testing_api_trait_hash.c b/src/testing/testing_api_trait_hash.c
index fb5015e..5f3a1a0 100644
--- a/src/testing/testing_api_trait_hash.c
+++ b/src/testing/testing_api_trait_hash.c
@@ -17,7 +17,7 @@
<http://www.gnu.org/licenses/>
*/
/**
- * @file testing/testing_api_trait_hash.c
+ * @file anastasis/src/testing/testing_api_trait_hash.c
* @brief traits to offer a hash
* @author Christian Grothoff
*/