libmicrohttpd

HTTP/1.x server C library (MHD 1.x, stable)
Log | Files | Refs | Submodules | README | LICENSE

NEWS (17564B)


      1 Mon Jul 14 2025 05:03:07 PM CEST
      2 Released GNU libmicrohttpd 1.0.2.
      3 
      4     This is a bugfix release.
      5     It primarily fixes a double-close() bug on bind() errors.
      6 
      7     -- Christian Grothoff
      8 
      9 Fri 23 Feb 2024 21:00:00 UZT
     10 Released GNU libmicrohttpd 1.0.1.
     11 
     12     This is a correction release.
     13     This release mainly fixes and improves builds with non-default configure
     14     parameters.
     15 
     16     -- Evgeny Grin (Karlson2k)
     17 
     18 Thu 01 Feb 2024 15:00:00 CET
     19 Released GNU libmicrohttpd 1.0.0.
     20 
     21     This is the first non-bugfix release since version 0.9.75 and the first
     22     ever stable release of GNU libmicrohttpd. It is a huge one with new
     23     features and fixes.
     24 
     25     The major changes:
     26     * Rewritten parsing of clients' requests, fully aligned with current
     27       RFCs (9110 and 9112) requirements. Added detailed control of strict
     28       or lenient specification enforcement. Application may choose between
     29       more compatible mode or more strict and secure mode.
     30     * Reworked Digest Auth, greater enhanced support for current RFC 7617
     31       features. MHD currently is the only known server-side implementation
     32       with support for SHA-512/256, userhash and username in extended
     33       notation. At the same time the very old RFC2069 is supported, as
     34       well as MD5 and SHA-256.
     35     * Improved functionality in multi-threading environment, especially with
     36       external sockets polling modes.
     37     * Reworked Basic Auth, adding new convenient API functions.
     38     * Re-implemented GnuTLS initialisation. Now supported
     39       libmicrohttpd-specific system-wide configuration, as well as generic
     40       GnuTLS system-wide configuration. Application may adjust settings based
     41       on system configuration instead of specifying its own full
     42       configuration.
     43     * Tons of other new functionality and various fixes. For detailed changes
     44       see the ChangeLog or Git commit logs.
     45 
     46 
     47     Since last non-bugfix release there are 1062 commits added with
     48     67007 lines insertions and 26616 deletions.
     49 
     50     -- Evgeny Grin (Karlson2k)
     51 
     52 Sun 28 May 2023 18:00:00 MSK
     53 Released GNU libmicrohttpd 0.9.77.
     54 
     55     This is mostly a bugfix release.
     56     This version created by taking patches from the current development
     57     branch and back-porting them on top of version 0.9.76.
     58     The most notable changes are: some improvements for Digest and Basic
     59     authorizations, fixed efficiency for TLS upgraded connections, fixed
     60     processing of folded headers in requests, fixed functionality with
     61     blocking sockets, improved and fixed internal test-suite.
     62 
     63     The more detailed list of the important changes:
     64 
     65     API changes:
     66     + Added new function MHD_get_version_bin().
     67 
     68     Improvements and enhancements:
     69     * Digest Auth: changed algorithm identifiers in server generated
     70       headers from "md5" / "sha-256" to "MD5" / "SHA-256" to better match
     71       RFC (while clients should use caseless matching).
     72     * Improved Base64 decoding by new implementation with robust input
     73       data validation checks.
     74     * Improved configure for cross-compiling, for better compatibility
     75       with POSIX and for better compatibility with the latest compiler
     76       versions.
     77     * New internal tests: for Base64 decoding, Basic Auth and folded
     78       headers.
     79     * Supported new libcurl API in tests to mute deprecation warnings.
     80     * Supported ARM and ARM64 for VC compilers.
     81 
     82     Functionality changes:
     83     * any negative number returned by response data generation callback
     84       function is treated as an error. Previously negative values except
     85       predefined error codes could produce undefined behaviour.
     86     * Added handling of "DEBUG" preprocessor macro as an alias of "_DEBUG".
     87 
     88     Fixes:
     89     # Fixed functionality with blocking sockets.
     90     # Fixed very inefficient data pumping for upgraded TLS connections.
     91     # Fixed processing of folded headers in the requests.
     92     # Fixed data races when closing upgraded connection.
     93     # Removed duplication of "Connection: upgrade" header.
     94     # Digest auth: fixed thread sync to avoid "stale hash" results.
     95     # Fixed harmless unwanted extra data processing resulting in triggering
     96       of the assert.
     97     # Fixed tests for LTO.
     98     # Removed removed non-portable functions in examples.
     99     # Fixed delayed call of connection notification callback in
    100       thread-per-connection mode.
    101     # Fixed Address Sanitizer unpoison of memory when memory pool is
    102       destroyed. This fixed periodic ASAN error when used for a long time
    103       with the sanitizer.
    104     # Fixed compiler warnings in library code, examples, tests and configure
    105       checks.
    106     # New TLS certificates for test-suite: all with SAN fields and SHA-256
    107       hash.
    108     # Tests: fixed tests on Darwin 22.x (Ventura).
    109     # Tests: redesigned one tests group to avoid stress-testing of the OS.
    110 
    111     -- Evgeny Grin (Karlson2k)
    112 
    113 Sun 26 Feb 2023 17:49:30 CET
    114 Released GNU libmicrohttpd 0.9.76 hotfix. -CG
    115 
    116     This is a hotfix release.
    117     This only change since previous release is fixed potential DoS vector
    118     in MHD_PostProcessor discovered by Gynvael Coldwind and Dejan
    119     Alvadzijevic (CVE-2023-27371).
    120     While the researchers have not been able to exploit this attack vector
    121     when libmicrohttpd is compiled with the standard GNU C library, it is
    122     recommended that you update MHD as soon as possible if your
    123     applications are using (optional) MHD_PostProcessor functionality.
    124 
    125     -- Evgeny Grin (Karlson2k)
    126 
    127 Sun 26 Dec 2021 20:30:00 MSK
    128 Released GNU libmicrohttpd 0.9.75 -EG
    129 
    130     This is a correction release.
    131     The main improvement is the implementation of workaround for some
    132     OSes (like OpenBSD 7) where "monotonic" clock may jump back. Now
    133     MHD is able to automatically detect such situation and recover if
    134     the jump is small. This workaround is needed with increased
    135     accuracy of connection timeout introduced in previous version, as
    136     with lower accuracy (v0.9.73 and before) these jumpbacks were
    137     unnoticeable.
    138     Other changes: fixed some compiler, Makefile, and configure
    139     warnings on specific platforms; one test further improved.
    140 
    141     -- Evgeny Grin (Karlson2k)
    142 
    143 
    144 Sun 19 Dec 2021 18:30:00 MSK
    145 Released GNU libmicrohttpd 0.9.74
    146 
    147     This release brings a lot of fixes and improvements, and
    148     important new features.
    149     The most significant addition is the new experimental
    150     implementation of WebSockets contributed by David Gausmann. This
    151     implementation is not fully tested yet so currently it is disabled
    152     by default.
    153     Other changes include a lot of improvements and clarifications
    154     in doxy comments in microhttpd.h header file, improved compliance
    155     with the RFC HTTP specifications, the new implementation of reply
    156     header forming, the new implementation of request chunked encoding
    157     parsing, new automatic error replies, internal optimisations, and
    158     many important fixes, including fixes for long-standing bugs.
    159 
    160     More detailed list of notable changes:
    161 
    162     API changes:
    163     + Added new function MHD_get_reason_phrase_len_for().
    164     + Added MHD_CONNECTION_INFO_HTTP_STATUS type of information
    165       queried by MHD_get_connection_info().
    166     + Added new response flag MHD_RF_SEND_KEEP_ALIVE_HEADER to force
    167       sending of "keep-alive" header even if not required by RFC.
    168     + Added new response creation function
    169       MHD_create_response_from_buffer_with_free_callback_cls() with
    170       custom cleanup callback.
    171     + Added new response flag MHD_RF_HTTP_1_0_COMPATIBLE_STRICT with
    172       the same functionality as existing MHD_RF_HTTP_VERSION_1_0_ONLY
    173       flag. The old flag will be deprecated.
    174     + Added new response flag MHD_RF_HTTP_1_0_SERVER with the same
    175       functionality as existing MHD_RF_HTTP_VERSION_1_0_RESPONSE flag.
    176       The old flag will be deprecated.
    177 
    178     New features:
    179     + Added experimental WebSockets extension with separate header.
    180       Disabled by default as it is not fully tested yet.
    181     + Added '--enable-sanitizers[=address,undefined,leak,user-poison]'
    182       configure parameter (instead of '--enable-sanitizer'),
    183       implemented custom memory poisoning for memory pools.
    184 
    185     Improvements and enhancements:
    186     * Doxy function descriptions was corrected, clarified, extended,
    187       and improved. Now it should be much easier to learn MHD just by
    188       reading the headers.
    189     * Completely rewritten reply header forming. New implementation is
    190       more robust, simpler maintainable and expandable, and better
    191       follows RFC HTTP specifications.
    192     * Performance improvements: now HTTP version and request method are
    193       decoded one time only (previously MHD used string comparison many
    194       times during processing the data).
    195     * Rewritten request chunked payload decoding. The new
    196       implementation better conforms to the HTTP RFC, detects format
    197       problems earlier, replies to the clients with description of
    198       detected problems, handles untypical (but syntactically correct)
    199       values properly.
    200     * Added special replies for wrong/unsupported HTTP versions in
    201       requests, broken HTTP chunked encoding in requests,
    202     * As required by HTTP RFC, added automatic error replies if client
    203       used broken chunked encoding, too large chunk size, too large
    204       payload size, or broken Content-Length header.
    205     * Optimized connection's memory pool handling.
    206     * Changed timeout precision from one second to one millisecond.
    207     * Added some checks for incorrect user data, reporting problems in
    208       MHD log.
    209     * Improved performance of hash calculations functions by using
    210       compiler built-ins (if available).
    211     * Implemented SHA-1 calculations (required for WebSockets).
    212     * Added universal MSVC project that works with any (sufficiently
    213       new) version of MSVC.
    214     * Developed simple HTTP client to test MHD under very special
    215       conditions.
    216     * Implemented 45 new tests.
    217     * Improved existing tests to test more aspects of MHD.
    218     * Added check for correct results of system and libcurl functions.
    219     * Response headers are checked during forming of responses.
    220     * HTTPS tests were improved.
    221     * Added rebuild on W32 of all required files if files are missing.
    222     * Many internal optimisations and improvements.
    223 
    224     Functionality changes:
    225     * Keep-alive header is omitted by default for HTTP/1.1 connections.
    226       Use of header can be enforced by response flag.
    227     * Chunked encoding is used for HTTP/1.1 non-keep-alive connections
    228       for responses with unknown size. Previously MHD used "indication
    229       of the end of the response by closing connection" in such cases,
    230       however it is not correct for HTTP/1.1 connections as per HTTP
    231       RFC.
    232     * As required by HTTP RFC, use HTTP/1.1 version instead of HTTP/1.0
    233       in reply headers when client is HTTP/1.0 . HTTP/1.0 version can
    234       be enforced by response flag.
    235     * User response headers are used in replies in the same order as
    236       was added by application.
    237     * Allowed tab characters in response header values.
    238     * All custom "Connection:" response headers are automatically
    239       combined into single "Connection:" header.
    240     * "keep-alive" token silently dropped from custom "Connection:"
    241       response header. "Keep-alive" cannot be enforced and used
    242       automatically if possible.
    243     * Allow tab character in custom response header value.
    244     * Disallow space character in custom response header value.
    245     * Do not allow responses with 1xx codes for HTTP/1.0 requests.
    246     * Detected and reported incorrect "Upgrade" responses.
    247     * W32 targets are changed to Vista+ by default. XP is supported
    248       still.
    249 
    250     Fixes:
    251     # Fixed short busy-waiting (up to one second) when connection is
    252       going to be expired and closed.
    253     # Fixed handling of errors during start of new connection, fixed
    254       inability to accept new connections in thread-per-connection mode
    255       due to the missing decrement of number of daemon's connections if
    256       start of new thread is failed.
    257     # Fixed incorrect parsing of LFLF, LFCR, CRCR, and bare CR as
    258       single linefeed in request header and request chunked payload.
    259       Now only CRLF or bare LF are recognized as linefeed.
    260     # Fixed response chunked encoding handling. Now it works properly
    261       with non-keep-alive connection, with fixed size replies (if
    262       chunked was enforced by header), and in other situations.
    263     # Other fixes for chunked replies.
    264     # Fixed handling of custom connection timeout in thread-per-
    265       connection mode.
    266     # Fixed wrongly used MHD_REQUEST_TERMINATED_COMPLETED_OK code for
    267       application notification when MHD_REQUEST_TERMINATED_WITH_ERROR
    268       code must be used.
    269     # Fixed code MHD_REQUEST_TERMINATED_READ_ERROR not reported (code
    270       MHD_REQUEST_TERMINATED_WITH_ERROR was incorrectly used instead).
    271     # Fixed handling of request chunked encoding with untypical
    272       formatting.
    273     # Fixed processing of last part of hex-encoded values under
    274       certain conditions.
    275     # Fixed value returned for MHD_CONNECTION_INFO_REQUEST_HEADER_SIZE.
    276     # Fixed returned value for MHD_FEATURE_AUTOSUPPRESS_SIGPIPE on W32,
    277       now it is MHD_YES as W32 does not need SIGPIPE suppression.
    278     # Fixed portability of bitwise NOT for enums values.
    279     # Fixed SHA-256 and MD5 calculations with unaligned data.
    280     # Fixed incorrect caseless matching for HTTP version.
    281     # Fixed incorrect caseless matching for request method.
    282     # Fixed compatibility with old GnuTLS versions.
    283     # Fixed compiler warnings on 32-bits platforms.
    284     # Fixed blocking sockets setting in tests and examples for W32.
    285     # Fixed examples to really use libmagic if present.
    286     # HTTPS tests were fixed.
    287     # Fixed libcurl test with case-insensitive match for HTTP methods,
    288       method names must use case-sensitive match.
    289     # Fixed tests compatibility with old libcurl versions.
    290     # Fixed build on W32 with llvm-dlltool (this tool is too
    291       oversimplified)
    292 
    293     -- Evgeny Grin (Karlson2k)
    294 
    295 
    296 Sun 25 Apr 2021 14:00:00 MSK
    297 Released GNU libmicrohttpd 0.9.73
    298 
    299     This release brings new features, improvements, and a few fixes.
    300     The most important addition is the new function for vector-backed
    301     responses, based on the patch contributed by NASA engineers.
    302     Other changes include compatibility with autoconf 2.70+, improved
    303     testsuite compatibility with CI systems, fixed and improved MSVC
    304     builds, and implementation of ALPN support.
    305 
    306     More detailed list of notable changes:
    307 
    308     API changes:
    309     + Added new function MHD_create_response_from_iovec(), based on the
    310       patch provided by Lawrence Sebald and Damon N. Earp from NASA.
    311     + Added MHD_OPTION_SIGPIPE_HANDLED_BY_APP daemon option.
    312     + Added new function MHD_run_wait().
    313     + Added MHD_OPTION_TLS_NO_ALPN to disable usage of ALPN even if
    314       it is supported by TLS library.
    315 
    316     New features:
    317     + Added '--enable-heavy-tests' configure parameter (disabled by
    318       default).
    319     + Implemented support for ALPN.
    320 
    321     Improvements and enhancements:
    322     * Return timeout of zero also for connections awaiting cleanup.
    323     * Compatibility with autoconf >=2.70, used new autoconf features.
    324     * Warn user when custom logger option is not the first option.
    325     * Added information to the header about minimal MHD version when
    326       particular symbols were introduced.
    327     * Updated test certificates to be compatible with modern browsers.
    328     * Added on-fly detection of UNIX domain sockets and pipes, MHD does
    329       not try to use TCP/IP-specific socket options on them.
    330     * Report more detailed error description in the MHD log for send
    331       and receive errors.
    332     * Enabled bind port autodetection for MSVC builds.
    333 
    334     Fixes:
    335     # Fix PostProcessor to always properly stop iteration when
    336       application callback tells it to do so.
    337     # Fixed MD5 digest authorization broken when compiled without
    338       variable length arrays support (notably with MSVC).
    339     # Fixed detection of type of send errors on W32.
    340 
    341     -- Evgeny Grin (Karlson2k)
    342 
    343 
    344 Mon 28 Dec 2020 21:36:00 MSK
    345 Released GNU libmicrohttpd 0.9.72
    346 
    347     This release is mostly a bugfix release, with greatly improved
    348     compatibility with various OSes/kernels, including FreeBSD, Windows,
    349     OpenBSD, NetBSD, Darwin (macOS), Solaris. Performance is improved,
    350     especially with HTTPS connections and stay-alive HTTP connections.
    351 
    352     Notable changes since version 0.9.71:
    353 
    354     API changes:
    355     + New function MHD_create_response_from_pipe()
    356 
    357     Improvements and enhancements:
    358     * Fully rewritten code for buffering/pushing from kernel network buffers
    359       for compatibility with various OSes. Reduced number of additional
    360       sys-calls, network is better utilized, responses are delivered faster.
    361     * Restored optimal sendfile() usage on FreeBSD.
    362     * MHD now takes care about SIGPIPE handling by blocking it in internal
    363       threads and avoiding functions (like sendfile()) that could generate
    364       SIGPIPE when blocking of this signal is not possible.
    365 
    366     Fixes:
    367     # Fixed crash in PostProcessor.
    368     # Fixed several resources leaks in corner cases.
    369     # Improved thread sync, thread safety and fixed one use-after-free under
    370       special conditions during stopping of daemon.
    371     # Updated HTTP status codes, header names and methods from the
    372       registries.
    373     # Fixed functioning without listen socket and with internal threads.
    374     # Fixed streaming of chunked responses for both HTTP and HTTPS.
    375     # Various compatibility fixes.
    376 
    377     -- Evgeny Grin (Karlson2k)
    378 
    379 
    380 Tue Jan  9 20:52:48 MST 2007
    381 	Project posted.