commit 05b24189c534bae6d270ce32d122a2d767c50ab6
parent b6568fa0fd9590bf4812c2488950e49df5d098d5
Author: Christian Grothoff <grothoff@gnunet.org>
Date: Thu, 16 Jul 2026 00:05:47 +0200
-doc fixes
Diffstat:
7 files changed, 18 insertions(+), 12 deletions(-)
diff --git a/src/challenger/challenger-httpd.c b/src/challenger/challenger-httpd.c
@@ -163,7 +163,7 @@ url_handler (void *cls,
void **con_cls)
{
static struct CH_RequestHandler handlers[] = {
- /* Landing page, tell humans to go away. */
+ /* Landing page, redirects the user-agent to the SPA at /webui/. */
{
.url = "/",
.method = MHD_HTTP_METHOD_GET,
diff --git a/src/challengerdb/challenge_set_address_and_pin.c b/src/challengerdb/challenge_set_address_and_pin.c
@@ -56,8 +56,9 @@ CHALLENGERDB_challenge_set_address_and_pin (struct
Note that this is deliberately a subtraction from 'now', not
'now + retransmission_frequency': the value is compared against a
timestamp in the *past*. GNUNET_TIME_absolute_subtract() saturates at
- zero rather than underflowing, so a FOREVER frequency correctly
- degrades to "never retransmit". */
+ zero rather than underflowing, so a FOREVER frequency degrades to
+ "never *re*transmit" (the initial PIN, sent when last_tx_time is still 0,
+ is unaffected). */
struct GNUNET_TIME_Absolute retransmit_cutoff
= GNUNET_TIME_absolute_subtract (now,
retransmission_frequency);
diff --git a/src/challengerdb/pg.c b/src/challengerdb/pg.c
@@ -40,7 +40,7 @@ unsigned long long CH_PG_prep_gen_;
* database. Gives the application a chance to run some
* per-connection initialization logic.
*
- * @param pg database conntext in the auditor
+ * @param pg challenger database context
* @param pq database connection handle
*/
static void
diff --git a/src/challengerdb/pg_helper.h b/src/challengerdb/pg_helper.h
@@ -7,7 +7,7 @@
Foundation; either version 3, or (at your option) any later version.
Challenger is distributed in the hope that it will be useful, but WITHOUT ANY
- WARRANTY; without even the implied warranty of ANASTASISABILITY or FITNESS FOR
+ WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
diff --git a/src/challengerdb/test_challenger_db.c b/src/challengerdb/test_challenger_db.c
@@ -14,7 +14,7 @@
Challenger; see the file COPYING. If not, see <http://www.gnu.org/licenses/>
*/
/**
- * @file sync/test_challenger_db.c
+ * @file challengerdb/test_challenger_db.c
* @brief testcase for challenger postgres db plugin
* @author Christian Grothoff
*/
diff --git a/src/include/challenger-database/client_add.h b/src/include/challenger-database/client_add.h
@@ -31,14 +31,19 @@ struct CHALLENGERDB_PostgresContext;
* @param cls
* @param client_url URL of the client
* @param client_secret authorization secret for the client
- * @param[out] client_id set to the client ID on success
- * @return transaction status
+ * @param[out] client_id set to the client ID on success; left at 0 if the
+ * client already exists (duplicate URI: ON CONFLICT DO NOTHING)
+ * @return transaction status:
+ * #GNUNET_DB_STATUS_SUCCESS_ONE_RESULT if the client was added
+ * #GNUNET_DB_STATUS_SUCCESS_NO_RESULTS if a client with this URI already
+ * exists (nothing inserted, @a client_id left 0)
+ * #GNUNET_DB_STATUS_HARD_ERROR on failure
*/
enum GNUNET_DB_QueryStatus
CHALLENGERDB_client_add (struct CHALLENGERDB_PostgresContext *ctx,
- const char *client_url,
- const char *client_secret,
- uint64_t *client_id);
+ const char *client_url,
+ const char *client_secret,
+ uint64_t *client_id);
#endif
diff --git a/src/include/challenger-database/client_check.h b/src/include/challenger-database/client_check.h
@@ -54,7 +54,7 @@ CHALLENGERDB_client_check (
* @param cls
* @param client_url client redirect URL (if known)
* @param client_secret secret of the client
- * @param[out] set to client_id ID of the client if found
+ * @param[out] client_id set to the ID of the client if found
* @return transaction status
*/
enum GNUNET_DB_QueryStatus
