diff options
author | Christian Grothoff <christian@grothoff.org> | 2021-08-02 15:58:53 +0200 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2021-08-02 15:58:53 +0200 |
commit | f3ed6ea694e83e45d257fb64b5ae23e73bc81465 (patch) | |
tree | b48275a94cef9962f144bfef9e299c971248b85a /src/testing | |
parent | ed7b39b035fa18b777b71ddc568deff2f7977c82 (diff) | |
download | anastasis-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.c | 7 | ||||
-rw-r--r-- | src/testing/testing_api_cmd_keyshare_lookup.c | 2 | ||||
-rw-r--r-- | src/testing/testing_api_cmd_policy_lookup.c | 22 | ||||
-rw-r--r-- | src/testing/testing_api_cmd_policy_store.c | 3 | ||||
-rw-r--r-- | src/testing/testing_api_cmd_truth_store.c | 5 | ||||
-rw-r--r-- | src/testing/testing_api_helpers.c | 2 | ||||
-rw-r--r-- | src/testing/testing_api_trait_account_priv.c | 24 | ||||
-rw-r--r-- | src/testing/testing_api_trait_account_pub.c | 24 | ||||
-rw-r--r-- | src/testing/testing_api_trait_code.c | 28 | ||||
-rw-r--r-- | src/testing/testing_api_trait_eks.c | 8 | ||||
-rw-r--r-- | src/testing/testing_api_trait_hash.c | 2 |
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 */ |