taler/exchange
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doxygen updates

Browse Source
This commit is contained in:
Christian Grothoff 2020-03-22 21:36:42 +01:00
parent a90ea10d35
commit 9add4cf405
No known key found for this signature in database
GPG Key ID: 939E6BE1E29FC3CC
8 changed files with 81 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
contrib/microhttpd.tag
View File

@ -22,6 +22,42 @@
<anchorfile>microhttpd.h</anchorfile> <anchorfile>microhttpd.h</anchorfile>
<arglist></arglist> <arglist></arglist>
</member> </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"> <member kind="define">
<type>#define</type> <type>#define</type>
<name>MHD_HTTP_NO_CONTENT</name> <name>MHD_HTTP_NO_CONTENT</name>
@ -46,6 +82,24 @@
<anchorfile>microhttpd.h</anchorfile> <anchorfile>microhttpd.h</anchorfile>
<arglist></arglist> <arglist></arglist>
</member> </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"> <member kind="define">
<type>#define</type> <type>#define</type>
<name>MHD_HTTP_INTERNAL_SERVER_ERROR</name> <name>MHD_HTTP_INTERNAL_SERVER_ERROR</name>

2
src/auditor/report-lib.c
View File

@ -366,7 +366,7 @@ transact (TALER_ARL_Analysis analysis,
* Initialize DB sessions and run the analysis. * Initialize DB sessions and run the analysis.
* *
* @param ana analysis to run * @param ana analysis to run
* @param ana_cls closure for @ana * @param ana_cls closure for @a ana
* @return #GNUNET_OK on success * @return #GNUNET_OK on success
*/ */
int int

2
src/auditor/report-lib.h
View File

@ -156,7 +156,7 @@ typedef enum GNUNET_DB_QueryStatus
* Initialize DB sessions and run the analysis. * Initialize DB sessions and run the analysis.
* *
* @param ana analysis to run * @param ana analysis to run
* @param ana_cls closure for @ana * @param ana_cls closure for @a ana
* @return #GNUNET_OK on success * @return #GNUNET_OK on success
*/ */
int int

1
src/auditor/taler-helper-auditor-wire.c
View File

@ -1908,7 +1908,6 @@ reserve_closed_cb (void *cls,
/** /**
* Start the database transactions and begin the audit. * Start the database transactions and begin the audit.
* *
* @param cls NULL
* @return transaction status code * @return transaction status code
*/ */
static enum GNUNET_DB_QueryStatus static enum GNUNET_DB_QueryStatus

10
src/exchange/taler-exchange-httpd_refreshes_reveal.c
View File

@ -704,9 +704,9 @@ resolve_refreshes_reveal_denominations (struct TEH_KS_StateHandle *key_state,
{ {
rctx->ev_sigs[i].rsa_signature rctx->ev_sigs[i].rsa_signature
= GNUNET_CRYPTO_rsa_sign_blinded ( = GNUNET_CRYPTO_rsa_sign_blinded (
rctx->dkis[i]->denom_priv.rsa_private_key, rctx->dkis[i]->denom_priv.rsa_private_key,
rctx->rcds[i].coin_ev, rctx->rcds[i].coin_ev,
rctx->rcds[i].coin_ev_size); rctx->rcds[i].coin_ev_size);
if (NULL == rctx->ev_sigs[i].rsa_signature) if (NULL == rctx->ev_sigs[i].rsa_signature)
{ {
GNUNET_break (0); 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 * Handle a "/refreshes/$RCH/reveal" request. This time, the client reveals the
* private transfer keys except for the cut-and-choose value returned from * 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 * "/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 * 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. * refreshed coins.
* *
* @param rh context of the handler * @param rh context of the handler

4
src/exchange/taler-exchange-httpd_refreshes_reveal.h
View File

@ -32,9 +32,9 @@
* Handle a "/refreshes/$RCH/reveal" request. This time, the client reveals the * Handle a "/refreshes/$RCH/reveal" request. This time, the client reveals the
* private transfer keys except for the cut-and-choose value returned from * 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 * "/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 * 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. * refreshed coins.
* *
* @param rh context of the handler * @param rh context of the handler

36
src/include/taler_error_codes.h
View File

@ -93,7 +93,7 @@ enum TALER_ErrorCode
/** /**
* There is no endpoint defined for the URL provided by the client * 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, TALER_EC_ENDPOINT_UNKNOWN = 10,
@ -107,7 +107,7 @@ enum TALER_ErrorCode
/** /**
* The number of segments included in the URI does not match the * The number of segments included in the URI does not match the
* number of segments expected by the endpoint. (returned together * 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, 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 * range for Taler amounts. This is not a client failure, as the coin
* value and fees come from the exchange's configuration. This * value and fees come from the exchange's configuration. This
* response is provided with HTTP status code * response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_WITHDRAW_AMOUNT_FEE_OVERFLOW = 1102, 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 * that is too big for the numeric range for Taler amounts. This is
* not a client failure, as the transaction history comes from the * not a client failure, as the transaction history comes from the
* exchange's configuration. This response is provided with HTTP * 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, 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, * could not find the denomination key. This is not a client failure,
* as the transaction history comes from the exchange's configuration. * as the transaction history comes from the exchange's configuration.
* This response is provided with HTTP status code * 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, 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 * big for the numeric range for Taler amounts. This is not a client
* failure, as the transaction history comes from the exchange's * failure, as the transaction history comes from the exchange's
* configuration. This response is provided with HTTP status code * 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, 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 * have been no wire transfers made. This is not a client failure, as
* this is a database consistency issue of the exchange. This * this is a database consistency issue of the exchange. This
* response is provided with HTTP status code * response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_WITHDRAW_RESERVE_WITHOUT_WIRE_TRANSFER = 1106, TALER_EC_WITHDRAW_RESERVE_WITHOUT_WIRE_TRANSFER = 1106,
/** /**
* The exchange failed to create the signature using the denomination * The exchange failed to create the signature using the denomination
* key. This response is provided with HTTP status code * key. This response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_WITHDRAW_SIGNATURE_FAILED = 1107, TALER_EC_WITHDRAW_SIGNATURE_FAILED = 1107,
/** /**
* The exchange failed to store the withdraw operation in its * The exchange failed to store the withdraw operation in its
* database. This response is provided with HTTP status code * 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, TALER_EC_WITHDRAW_DB_STORE_ERROR = 1108,
@ -334,7 +334,7 @@ enum TALER_ErrorCode
* The exchange failed to check against historic withdraw data from * The exchange failed to check against historic withdraw data from
* database (as part of ensuring the idempotency of the operation). * database (as part of ensuring the idempotency of the operation).
* This response is provided with HTTP status code * This response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_WITHDRAW_DB_FETCH_ERROR = 1109, TALER_EC_WITHDRAW_DB_FETCH_ERROR = 1109,
@ -580,14 +580,14 @@ enum TALER_ErrorCode
* The exchange failed to check against historic melt data from * The exchange failed to check against historic melt data from
* database (as part of ensuring the idempotency of the operation). * database (as part of ensuring the idempotency of the operation).
* This response is provided with HTTP status code * This response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_MELT_DB_FETCH_ERROR = 1303, TALER_EC_MELT_DB_FETCH_ERROR = 1303,
/** /**
* The exchange failed to store session data in the database. This * The exchange failed to store session data in the database. This
* response is provided with HTTP status code * response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_MELT_DB_STORE_SESSION_ERROR = 1304, 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 * Failed to produce the blinded signatures over the coins to be
* returned. This response is provided with HTTP status code * returned. This response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_REVEAL_SIGNING_ERROR = 1371, TALER_EC_REVEAL_SIGNING_ERROR = 1371,
@ -688,21 +688,21 @@ enum TALER_ErrorCode
/** /**
* The exchange failed to retrieve valid session data from the * The exchange failed to retrieve valid session data from the
* database. This response is provided with HTTP status code * 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, TALER_EC_REVEAL_DB_FETCH_SESSION_ERROR = 1373,
/** /**
* The exchange failed to retrieve previously revealed data from the * The exchange failed to retrieve previously revealed data from the
* database. This response is provided with HTTP status code * 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, TALER_EC_REVEAL_DB_FETCH_REVEAL_ERROR = 1374,
/** /**
* The exchange failed to retrieve commitment data from the database. * The exchange failed to retrieve commitment data from the database.
* This response is provided with HTTP status code * This response is provided with HTTP status code
* #MHD_HTTP_INTERNAL_ERROR. * #MHD_HTTP_INTERNAL_SERVER_ERROR.
*/ */
TALER_EC_REVEAL_DB_COMMIT_ERROR = 1375, 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 * The exchange charged a different wire fee than what it originally
* advertised, and it is higher. The response is provied with an HTTP * 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, 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 * The backend knows the instance that was supposed to support the
* tip, but it was not configured for tipping (i.e. has no exchange * tip, but it was not configured for tipping (i.e. has no exchange
* associated with it). Likely to be a configuration error. Returned * 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, TALER_EC_TIP_AUTHORIZE_INSTANCE_DOES_NOT_TIP = 2701,

1
src/testing/testing_api_cmd_recoup.c
View File

@ -520,7 +520,6 @@ revoke_run (void *cls,
* @param expected_response_code expected HTTP status code * @param expected_response_code expected HTTP status code
* @param coin_reference reference to any command which * @param coin_reference reference to any command which
* offers a coin & reserve private key. * offers a coin & reserve private key.
* @param amount denomination to pay back.
* @param melt_reference NULL if coin was not refreshed * @param melt_reference NULL if coin was not refreshed
* @return the command. * @return the command.
*/ */