-doxygen fixes

This commit is contained in:
Özgür Kesim 2023-07-16 13:33:08 +02:00
parent 3ce29a711b
commit 77f99b6363
Signed by: oec
GPG Key ID: 3D76A56D79EDD9D7
3 changed files with 19 additions and 17 deletions

View File

@ -2993,9 +2993,8 @@ typedef void
* *
* @param curl_ctx The curl context * @param curl_ctx The curl context
* @param exchange_url The base url of the exchange * @param exchange_url The base url of the exchange
* @param reserve_priv The pivate key to the reserve
* @param num_coins The number of elements in @e coin_inputs and @e alg_values * @param num_coins The number of elements in @e coin_inputs and @e alg_values
* @param coins_input The input for the coins to withdraw, same as in the previous call to /age-withdraw * @param coin_inputs The input for the coins to withdraw, same as in the previous call to /age-withdraw
* @param alg_values The algorithm specific parameters per coin, from the result to the previous call to /age-withdraw * @param alg_values The algorithm specific parameters per coin, from the result to the previous call to /age-withdraw
* @param noreveal_index The index into each of the kappa coin candidates, that should not be revealed to the exchange * @param noreveal_index The index into each of the kappa coin candidates, that should not be revealed to the exchange
* @param h_commitment The commmitment from the previous call to /age-withdraw * @param h_commitment The commmitment from the previous call to /age-withdraw
@ -3010,7 +3009,7 @@ TALER_EXCHANGE_age_withdraw_reveal (
struct GNUNET_CURL_Context *curl_ctx, struct GNUNET_CURL_Context *curl_ctx,
const char *exchange_url, const char *exchange_url,
size_t num_coins, size_t num_coins,
const struct TALER_EXCHANGE_AgeWithdrawCoinInput coins_input[static const struct TALER_EXCHANGE_AgeWithdrawCoinInput coin_inputs[static
num_coins], num_coins],
const struct TALER_ExchangeWithdrawValues alg_values[static num_coins], const struct TALER_ExchangeWithdrawValues alg_values[static num_coins],
uint8_t noreveal_index, uint8_t noreveal_index,

View File

@ -319,14 +319,14 @@ struct TALER_EXCHANGE_AgeWithdrawHandle
void *callback_cls; void *callback_cls;
/* The Handler for the actual call to the exchange */ /* The Handler for the actual call to the exchange */
struct TALER_EXCHANGE_AgeWithdrawBlindedHandle *protocol_handler; struct TALER_EXCHANGE_AgeWithdrawBlindedHandle *procotol_handle;
}; };
/** /**
* We got a 200 OK response for the /reserves/$RESERVE_PUB/age-withdraw operation. * We got a 200 OK response for the /reserves/$RESERVE_PUB/age-withdraw operation.
* Extract the noreveal_index and return it to the caller. * Extract the noreveal_index and return it to the caller.
* *
* @param awh operation handle * @param awbh operation handle
* @param j_response reply from the exchange * @param j_response reply from the exchange
* @return #GNUNET_OK on success, #GNUNET_SYSERR on errors * @return #GNUNET_OK on success, #GNUNET_SYSERR on errors
*/ */
@ -616,7 +616,7 @@ handle_reserve_age_withdraw_blinded_finished (
/** /**
* Runs the actual age-withdraw operation with the blinded planchets. * Runs the actual age-withdraw operation with the blinded planchets.
* *
* @param[in,out] awh age withdraw handler * @param[in,out] awbh age withdraw handler
*/ */
static void static void
perform_protocol ( perform_protocol (
@ -828,7 +828,7 @@ call_age_withdraw_blinded (
awh->coin_data[n].planchet_details[i]; awh->coin_data[n].planchet_details[i];
} }
awh->protocol_handler = awh->procotol_handle =
TALER_EXCHANGE_age_withdraw_blinded ( TALER_EXCHANGE_age_withdraw_blinded (
awh->curl_ctx, awh->curl_ctx,
awh->keys, awh->keys,
@ -844,7 +844,7 @@ call_age_withdraw_blinded (
/** /**
* Prepares the request URL for the age-withdraw request * Prepares the request URL for the age-withdraw request
* *
* @param awh The handler * @param awbh The handler
* @param exchange_url The base-URL to the exchange * @param exchange_url The base-URL to the exchange
*/ */
static static
@ -1121,7 +1121,7 @@ TALER_EXCHANGE_age_withdraw (
awh = GNUNET_new (struct TALER_EXCHANGE_AgeWithdrawHandle); awh = GNUNET_new (struct TALER_EXCHANGE_AgeWithdrawHandle);
awh->exchange_url = exchange_url; awh->exchange_url = exchange_url;
awh->keys = keys; awh->keys = TALER_EXCHANGE_keys_incref (keys);
awh->curl_ctx = curl_ctx; awh->curl_ctx = curl_ctx;
awh->reserve_priv = reserve_priv; awh->reserve_priv = reserve_priv;
awh->callback = res_cb; awh->callback = res_cb;
@ -1171,9 +1171,9 @@ TALER_EXCHANGE_age_withdraw_cancel (
TALER_denom_pub_free (&cd->denom_pub.key); TALER_denom_pub_free (&cd->denom_pub.key);
} }
GNUNET_free (awh->coin_data); GNUNET_free (awh->coin_data);
TALER_EXCHANGE_keys_decref (awh->keys);
TALER_EXCHANGE_age_withdraw_blinded_cancel (awh->protocol_handler); TALER_EXCHANGE_age_withdraw_blinded_cancel (awh->procotol_handle);
awh->protocol_handler = NULL; awh->procotol_handle = NULL;
GNUNET_free (awh); GNUNET_free (awh);
} }
@ -1220,9 +1220,15 @@ TALER_EXCHANGE_age_withdraw_blinded_cancel (
if (NULL == awbh) if (NULL == awbh)
return; return;
// TODO[oec]: curl stuff Cleanup if (NULL != awbh->job)
{
GNUNET_CURL_job_cancel (awbh->job);
awbh->job = NULL;
}
GNUNET_free (awbh->request_url);
TALER_EXCHANGE_keys_decref (awbh->keys); TALER_EXCHANGE_keys_decref (awbh->keys);
TALER_curl_easy_post_finished (&awbh->post_ctx);
GNUNET_free (awbh);
} }

View File

@ -163,8 +163,6 @@ reveal_coin (
* *
* @param awrh operation handle * @param awrh operation handle
* @param j_response reply from the exchange * @param j_response reply from the exchange
* @param num_coins The (expected) number of revealed coins
* @param[in,out] revealed_coins The @e num_coins revealed coins to populate
* @return #GNUNET_OK on success, #GNUNET_SYSERR on errors * @return #GNUNET_OK on success, #GNUNET_SYSERR on errors
*/ */
static enum GNUNET_GenericReturnValue static enum GNUNET_GenericReturnValue
@ -417,7 +415,6 @@ prepare_url (
* *
* @param curl_ctx The context for CURL * @param curl_ctx The context for CURL
* @param awrh The handler * @param awrh The handler
* @param reveal_inputs The secrets of the coin candidates
*/ */
static static
void void