From 5866b68fa7440cbbe39d1e06c310b3be8debf85e Mon Sep 17 00:00:00 2001 From: "Evgeny Grin (Karlson2k)" Date: Thu, 21 Jul 2022 20:47:29 +0300 Subject: [PATCH] Updated doxy for old Digest Auth API function This function supports new functionality now (extended notation) and this functionality is automatically available without rebuilding application. --- src/include/microhttpd.h | 11 ++++++++--- src/microhttpd/digestauth.c | 9 +++++++-- 2 files changed, 15 insertions(+), 5 deletions(-) diff --git a/src/include/microhttpd.h b/src/include/microhttpd.h index 670a990d..626d359e 100644 --- a/src/include/microhttpd.h +++ b/src/include/microhttpd.h @@ -96,7 +96,7 @@ extern "C" * they are parsed as decimal numbers. * Example: 0x01093001 = 1.9.30-1. */ -#define MHD_VERSION 0x00097521 +#define MHD_VERSION 0x00097522 /* If generic headers don't work on your platform, include headers which define 'va_list', 'size_t', 'ssize_t', 'intptr_t', 'off_t', @@ -4701,9 +4701,14 @@ MHD_digest_auth_get_username3 (struct MHD_Connection *connection); /** * Get the username from the authorization header sent by the client * + * This function supports username in standard and extended notations. + * "userhash" is not supported by this function. + * * @param connection The MHD connection structure - * @return NULL if no username could be found, a pointer - * to the username if found, free using #MHD_free(). + * @return NULL if no username could be found, username provided as + * "userhash" or memory allocation error occurred; + * a pointer to the username if found, free using #MHD_free(). + * @warning Returned value must be freed by #MHD_free(). * @deprecated use MHD_digest_auth_get_username3() * @ingroup authentication */ diff --git a/src/microhttpd/digestauth.c b/src/microhttpd/digestauth.c index 793209f9..0127a6d7 100644 --- a/src/microhttpd/digestauth.c +++ b/src/microhttpd/digestauth.c @@ -1189,10 +1189,15 @@ MHD_digest_auth_get_username3 (struct MHD_Connection *connection) /** * Get the username from the authorization header sent by the client * + * This function support username in standard and extended notations. + * "userhash" is not supported by this function. + * * @param connection The MHD connection structure - * @return NULL if no username could be found, a pointer - * to the username if found + * @return NULL if no username could be found, username provided as + * "userhash" or memory allocation error occurs; + * a pointer to the username if found, free using #MHD_free(). * @warning Returned value must be freed by #MHD_free(). + * @deprecated use MHD_digest_auth_get_username3() * @ingroup authentication */ _MHD_EXTERN char *