libmicrohttpd

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

NEWS (17827B)


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