summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2020-03-22 21:36:42 +0100
committerChristian Grothoff <christian@grothoff.org>2020-03-22 21:36:42 +0100
commit9add4cf40501b37d435830f2c0c718bf0ff2db72 (patch)
tree062fa3276820909598eaa9b860fd0ad7696fcc63
parenta90ea10d352489e27e8243c28162360d400fc31c (diff)
downloadexchange-9add4cf40501b37d435830f2c0c718bf0ff2db72.tar.gz
exchange-9add4cf40501b37d435830f2c0c718bf0ff2db72.tar.bz2
exchange-9add4cf40501b37d435830f2c0c718bf0ff2db72.zip
doxygen updates
-rw-r--r--contrib/microhttpd.tag54
-rw-r--r--src/auditor/report-lib.c2
-rw-r--r--src/auditor/report-lib.h2
-rw-r--r--src/auditor/taler-helper-auditor-wire.c1
-rw-r--r--src/exchange/taler-exchange-httpd_refreshes_reveal.c10
-rw-r--r--src/exchange/taler-exchange-httpd_refreshes_reveal.h4
-rw-r--r--src/include/taler_error_codes.h36
-rw-r--r--src/testing/testing_api_cmd_recoup.c1
8 files changed, 81 insertions, 29 deletions
diff --git a/contrib/microhttpd.tag b/contrib/microhttpd.tag
index b03d5871..5ae125e0 100644
--- a/contrib/microhttpd.tag
+++ b/contrib/microhttpd.tag
@@ -24,6 +24,42 @@
</member>
<member kind="define">
<type>#define</type>
+ <name>MHD_HTTP_BAD_REQUEST</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
+ <name>MHD_HTTP_URI_TOO_LONG</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
+ <name>MHD_HTTP_PAYLOAD_TOO_LARGE</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
+ <name>MHD_HTTP_REQUEST_TIMEOUT</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
+ <name>MHD_HTTP_ACCEPTED</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
+ <name>MHD_HTTP_NOT_FOUND</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
<name>MHD_HTTP_NO_CONTENT</name>
<anchorfile>microhttpd.h</anchorfile>
<arglist></arglist>
@@ -48,6 +84,24 @@
</member>
<member kind="define">
<type>#define</type>
+ <name>MHD_HTTP_FORBIDDEN</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
+ <name>MHD_HTTP_SERVICE_UNAVAILABLE</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
+ <name>MHD_HTTP_FAILED_DEPENDENCY</name>
+ <anchorfile>microhttpd.h</anchorfile>
+ <arglist></arglist>
+ </member>
+ <member kind="define">
+ <type>#define</type>
<name>MHD_HTTP_INTERNAL_SERVER_ERROR</name>
<anchorfile>microhttpd.h</anchorfile>
<arglist></arglist>
diff --git a/src/auditor/report-lib.c b/src/auditor/report-lib.c
index 3399b4cc..25a79c1b 100644
--- a/src/auditor/report-lib.c
+++ b/src/auditor/report-lib.c
@@ -366,7 +366,7 @@ transact (TALER_ARL_Analysis analysis,
* Initialize DB sessions and run the analysis.
*
* @param ana analysis to run
- * @param ana_cls closure for @ana
+ * @param ana_cls closure for @a ana
* @return #GNUNET_OK on success
*/
int
diff --git a/src/auditor/report-lib.h b/src/auditor/report-lib.h
index 84619a5d..fa634cf8 100644
--- a/src/auditor/report-lib.h
+++ b/src/auditor/report-lib.h
@@ -156,7 +156,7 @@ typedef enum GNUNET_DB_QueryStatus
* Initialize DB sessions and run the analysis.
*
* @param ana analysis to run
- * @param ana_cls closure for @ana
+ * @param ana_cls closure for @a ana
* @return #GNUNET_OK on success
*/
int
diff --git a/src/auditor/taler-helper-auditor-wire.c b/src/auditor/taler-helper-auditor-wire.c
index c52ce7a7..faf65a52 100644
--- a/src/auditor/taler-helper-auditor-wire.c
+++ b/src/auditor/taler-helper-auditor-wire.c
@@ -1908,7 +1908,6 @@ reserve_closed_cb (void *cls,
/**
* Start the database transactions and begin the audit.
*
- * @param cls NULL
* @return transaction status code
*/
static enum GNUNET_DB_QueryStatus
diff --git a/src/exchange/taler-exchange-httpd_refreshes_reveal.c b/src/exchange/taler-exchange-httpd_refreshes_reveal.c
index 876797ba..00b8592d 100644
--- a/src/exchange/taler-exchange-httpd_refreshes_reveal.c
+++ b/src/exchange/taler-exchange-httpd_refreshes_reveal.c
@@ -704,9 +704,9 @@ resolve_refreshes_reveal_denominations (struct TEH_KS_StateHandle *key_state,
{
rctx->ev_sigs[i].rsa_signature
= GNUNET_CRYPTO_rsa_sign_blinded (
- rctx->dkis[i]->denom_priv.rsa_private_key,
- rctx->rcds[i].coin_ev,
- rctx->rcds[i].coin_ev_size);
+ rctx->dkis[i]->denom_priv.rsa_private_key,
+ rctx->rcds[i].coin_ev,
+ rctx->rcds[i].coin_ev_size);
if (NULL == rctx->ev_sigs[i].rsa_signature)
{
GNUNET_break (0);
@@ -897,9 +897,9 @@ handle_refreshes_reveal_json (struct MHD_Connection *connection,
* Handle a "/refreshes/$RCH/reveal" request. This time, the client reveals the
* private transfer keys except for the cut-and-choose value returned from
* "/coins/$COIN_PUB/melt". This function parses the revealed keys and secrets and
- * ultimately passes everything to #resolve_refreshes_reveal_denominations()
+ * ultimately passes everything to resolve_refreshes_reveal_denominations()
* which will verify that the revealed information is valid then runs the
- * transaction in #refreshes_reveal_transaction() and finally returns the signed
+ * transaction in refreshes_reveal_transaction() and finally returns the signed
* refreshed coins.
*
* @param rh context of the handler
diff --git a/src/exchange/taler-exchange-httpd_refreshes_reveal.h b/src/exchange/taler-exchange-httpd_refreshes_reveal.h
index 8778c77f..076ec52d 100644
--- a/src/exchange/taler-exchange-httpd_refreshes_reveal.h
+++ b/src/exchange/taler-exchange-httpd_refreshes_reveal.h
@@ -32,9 +32,9 @@
* Handle a "/refreshes/$RCH/reveal" request. This time, the client reveals the
* private transfer keys except for the cut-and-choose value returned from
* "/coins/$COIN_PUB/melt". This function parses the revealed keys and secrets and
- * ultimately passes everything to #resolve_refresh_reveal_denominations()
+ * ultimately passes everything to resolve_refresh_reveal_denominations()
* which will verify that the revealed information is valid then runs the
- * transaction in #refresh_reveal_transaction() and finally returns the signed
+ * transaction in refresh_reveal_transaction() and finally returns the signed
* refreshed coins.
*
* @param rh context of the handler
diff --git a/src/include/taler_error_codes.h b/src/include/taler_error_codes.h
index 4d3442b0..258f5a59 100644
--- a/src/include/taler_error_codes.h
+++ b/src/include/taler_error_codes.h
@@ -93,7 +93,7 @@ enum TALER_ErrorCode
/**
* There is no endpoint defined for the URL provided by the client
- * (returned together with a #MHD_HTTP_NOT FOUND status code).
+ * (returned together with a #MHD_HTTP_NOT_FOUND status code).
*/
TALER_EC_ENDPOINT_UNKNOWN = 10,
@@ -107,7 +107,7 @@ enum TALER_ErrorCode
/**
* The number of segments included in the URI does not match the
* number of segments expected by the endpoint. (returned together
- * with a #MHD_HTTP_NOT FOUND status code).
+ * with a #MHD_HTTP_NOT_FOUND status code).
*/
TALER_EC_WRONG_NUMBER_OF_SEGMENTS = 12,
@@ -276,7 +276,7 @@ enum TALER_ErrorCode
* range for Taler amounts. This is not a client failure, as the coin
* value and fees come from the exchange's configuration. This
* response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_WITHDRAW_AMOUNT_FEE_OVERFLOW = 1102,
@@ -285,7 +285,7 @@ enum TALER_ErrorCode
* that is too big for the numeric range for Taler amounts. This is
* not a client failure, as the transaction history comes from the
* exchange's configuration. This response is provided with HTTP
- * status code #MHD_HTTP_INTERNAL_ERROR.
+ * status code #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_AMOUNT_DEPOSITS_OVERFLOW = 1103,
@@ -294,7 +294,7 @@ enum TALER_ErrorCode
* could not find the denomination key. This is not a client failure,
* as the transaction history comes from the exchange's configuration.
* This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_WITHDRAW_HISTORIC_DENOMINATION_KEY_NOT_FOUND = 1104,
@@ -303,7 +303,7 @@ enum TALER_ErrorCode
* big for the numeric range for Taler amounts. This is not a client
* failure, as the transaction history comes from the exchange's
* configuration. This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_WITHDRAW_AMOUNT_WITHDRAWALS_OVERFLOW = 1105,
@@ -312,21 +312,21 @@ enum TALER_ErrorCode
* have been no wire transfers made. This is not a client failure, as
* this is a database consistency issue of the exchange. This
* response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_WITHDRAW_RESERVE_WITHOUT_WIRE_TRANSFER = 1106,
/**
* The exchange failed to create the signature using the denomination
* key. This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_WITHDRAW_SIGNATURE_FAILED = 1107,
/**
* The exchange failed to store the withdraw operation in its
* database. This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_WITHDRAW_DB_STORE_ERROR = 1108,
@@ -334,7 +334,7 @@ enum TALER_ErrorCode
* The exchange failed to check against historic withdraw data from
* database (as part of ensuring the idempotency of the operation).
* This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_WITHDRAW_DB_FETCH_ERROR = 1109,
@@ -580,14 +580,14 @@ enum TALER_ErrorCode
* The exchange failed to check against historic melt data from
* database (as part of ensuring the idempotency of the operation).
* This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_MELT_DB_FETCH_ERROR = 1303,
/**
* The exchange failed to store session data in the database. This
* response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_MELT_DB_STORE_SESSION_ERROR = 1304,
@@ -674,7 +674,7 @@ enum TALER_ErrorCode
/**
* Failed to produce the blinded signatures over the coins to be
* returned. This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_REVEAL_SIGNING_ERROR = 1371,
@@ -688,21 +688,21 @@ enum TALER_ErrorCode
/**
* The exchange failed to retrieve valid session data from the
* database. This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_REVEAL_DB_FETCH_SESSION_ERROR = 1373,
/**
* The exchange failed to retrieve previously revealed data from the
* database. This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_REVEAL_DB_FETCH_REVEAL_ERROR = 1374,
/**
* The exchange failed to retrieve commitment data from the database.
* This response is provided with HTTP status code
- * #MHD_HTTP_INTERNAL_ERROR.
+ * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/
TALER_EC_REVEAL_DB_COMMIT_ERROR = 1375,
@@ -1434,7 +1434,7 @@ enum TALER_ErrorCode
/**
* The exchange charged a different wire fee than what it originally
* advertised, and it is higher. The response is provied with an HTTP
- * status of #MHD_HTTP_BAD_DEPENDENCY.
+ * status of #MHD_HTTP_FAILED_DEPENDENCY.
*/
TALER_EC_TRANSFERS_GET_JSON_BAD_WIRE_FEE = 2410,
@@ -1546,7 +1546,7 @@ enum TALER_ErrorCode
* The backend knows the instance that was supposed to support the
* tip, but it was not configured for tipping (i.e. has no exchange
* associated with it). Likely to be a configuration error. Returned
- * with an HTTP status code of "NOT FOUND".
+ * with an HTTP status code of #MHD_HTTP_NOT_FOUND.
*/
TALER_EC_TIP_AUTHORIZE_INSTANCE_DOES_NOT_TIP = 2701,
diff --git a/src/testing/testing_api_cmd_recoup.c b/src/testing/testing_api_cmd_recoup.c
index b0012f82..13d17835 100644
--- a/src/testing/testing_api_cmd_recoup.c
+++ b/src/testing/testing_api_cmd_recoup.c
@@ -520,7 +520,6 @@ revoke_run (void *cls,
* @param expected_response_code expected HTTP status code
* @param coin_reference reference to any command which
* offers a coin & reserve private key.
- * @param amount denomination to pay back.
* @param melt_reference NULL if coin was not refreshed
* @return the command.
*/