/*

     This file is part of libmicrohttpd

     Copyright (C) 2006-2017 Christian Grothoff (and other contributing authors)

     This library is free software; you can redistribute it and/or

     modify it under the terms of the GNU Lesser General Public

     License as published by the Free Software Foundation; either

     version 2.1 of the License, or (at your option) any later version.

     This library is distributed in the hope that it will be useful,

     but WITHOUT ANY WARRANTY; without even the implied warranty of

     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

     Lesser General Public License for more details.

     You should have received a copy of the GNU Lesser General Public

     License along with this library; if not, write to the Free Software

     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA

*/

/**

 * @file microhttpd.h

 * @brief public interface to libmicrohttpd

 * @author Christian Grothoff

 * @author Karlson2k (Evgeny Grin)

 * @author Chris GauthierDickey

 *

 * All symbols defined in this header start with MHD.  MHD is a small

 * HTTP daemon library.  As such, it does not have any API for logging

 * errors (you can only enable or disable logging to stderr).  Also,

 * it may not support all of the HTTP features directly, where

 * applicable, portions of HTTP may have to be handled by clients of

 * the library.

 *

 * The library is supposed to handle everything that it must handle

 * (because the API would not allow clients to do this), such as basic

 * connection management; however, detailed interpretations of headers

 * -- such as range requests -- and HTTP methods are left to clients.

 * The library does understand HEAD and will only send the headers of

 * the response and not the body, even if the client supplied a body.

 * The library also understands headers that control connection

 * management (specifically, "Connection: close" and "Expect: 100

 * continue" are understood and handled automatically).

 *

 * MHD understands POST data and is able to decode certain formats

 * (at the moment only "application/x-www-form-urlencoded" and

 * "mulitpart/formdata"). Unsupported encodings and large POST

 * submissions may require the application to manually process

 * the stream, which is provided to the main application (and thus can be

 * processed, just not conveniently by MHD).

 *

 * The header file defines various constants used by the HTTP protocol.

 * This does not mean that MHD actually interprets all of these

 * values.  The provided constants are exported as a convenience

 * for users of the library.  MHD does not verify that transmitted

 * HTTP headers are part of the standard specification; users of the

 * library are free to define their own extensions of the HTTP

 * standard and use those with MHD.

 *

 * All functions are guaranteed to be completely reentrant and

 * thread-safe (with the exception of #MHD_set_connection_value,

 * which must only be used in a particular context).

 *

 *

 * @defgroup event event-loop control

 * MHD API to start and stop the HTTP server and manage the event loop.

 * @defgroup response generation of responses

 * MHD API used to generate responses.

 * @defgroup request handling of requests

 * MHD API used to access information about requests.

 * @defgroup authentication HTTP authentication

 * MHD API related to basic and digest HTTP authentication.

 * @defgroup logging logging

 * MHD API to mange logging and error handling

 * @defgroup specialized misc. specialized functions

 * This group includes functions that do not fit into any particular

 * category and that are rarely used.

 */

#ifndef MHD_MICROHTTPD_H

#define MHD_MICROHTTPD_H

#ifdef __cplusplus

extern "C"

{

#if 0                           /* keep Emacsens' auto-indent happy */

}

#endif

#endif

/* While we generally would like users to use a configure-driven

   build process which detects which headers are present and

   hence works on any platform, we use "standard" includes here

   to build out-of-the-box for beginning users on common systems.

   If generic headers don't work on your platform, include headers

   which define 'va_list', 'size_t', 'ssize_t', 'intptr_t',

   'uint16_t', 'uint32_t', 'uint64_t', 'off_t', 'struct sockaddr',

   'socklen_t', 'fd_set' and "#define MHD_PLATFORM_H" before

   including "microhttpd.h". Then the following "standard"

   includes won't be used (which might be a good idea, especially

   on platforms where they do not exist).

   */

#ifndef MHD_PLATFORM_H

#include <stdarg.h>

#include <stdint.h>

#include <sys/types.h>

#if defined(_WIN32) && !defined(__CYGWIN__)

#include <ws2tcpip.h>

#if defined(_MSC_FULL_VER) && !defined (_SSIZE_T_DEFINED)

#define _SSIZE_T_DEFINED

typedef intptr_t ssize_t;

#endif /* !_SSIZE_T_DEFINED */

#else

#include <unistd.h>

#include <sys/time.h>

#include <sys/socket.h>

#endif

#endif

#if defined(__CYGWIN__) && !defined(_SYS_TYPES_FD_SET)

/* Do not define __USE_W32_SOCKETS under Cygwin! */

#error Cygwin with winsock fd_set is not supported

#endif

/**

 * Current version of the library.

 * 0x01093001 = 1.9.30-1.

 */

#define MHD_VERSION 0x00095900

/**

 * MHD-internal return code for "YES".

 */

#define MHD_YES 1

/**

 * MHD-internal return code for "NO".

 */

#define MHD_NO 0

/**

 * MHD digest auth internal code for an invalid nonce.

 */

#define MHD_INVALID_NONCE -1

/**

 * Constant used to indicate unknown size (use when

 * creating a response).

 */

#ifdef UINT64_MAX

#define MHD_SIZE_UNKNOWN UINT64_MAX

#else

#define MHD_SIZE_UNKNOWN  ((uint64_t) -1LL)

#endif

#ifdef SIZE_MAX

#define MHD_CONTENT_READER_END_OF_STREAM SIZE_MAX

#define MHD_CONTENT_READER_END_WITH_ERROR (SIZE_MAX - 1)

#else

#define MHD_CONTENT_READER_END_OF_STREAM ((size_t) -1LL)

#define MHD_CONTENT_READER_END_WITH_ERROR (((size_t) -1LL) - 1)

#endif

#ifndef _MHD_EXTERN

#if defined(_WIN32) && defined(MHD_W32LIB)

#define _MHD_EXTERN extern

#elif defined (_WIN32) && defined(MHD_W32DLL)

/* Define MHD_W32DLL when using MHD as W32 .DLL to speed up linker a little */

#define _MHD_EXTERN __declspec(dllimport)

#else

#define _MHD_EXTERN extern

#endif

#endif

#ifndef MHD_SOCKET_DEFINED

/**

 * MHD_socket is type for socket FDs

 */

#if !defined(_WIN32) || defined(_SYS_TYPES_FD_SET)

#define MHD_POSIX_SOCKETS 1

typedef int MHD_socket;

#define MHD_INVALID_SOCKET (-1)

#else /* !defined(_WIN32) || defined(_SYS_TYPES_FD_SET) */

#define MHD_WINSOCK_SOCKETS 1

#include <winsock2.h>

typedef SOCKET MHD_socket;

#define MHD_INVALID_SOCKET (INVALID_SOCKET)

#endif /* !defined(_WIN32) || defined(_SYS_TYPES_FD_SET) */

#define MHD_SOCKET_DEFINED 1

#endif /* MHD_SOCKET_DEFINED */

/**

 * Define MHD_NO_DEPRECATION before including "microhttpd.h" to disable deprecation messages

 */

#ifdef MHD_NO_DEPRECATION

#define _MHD_DEPR_MACRO(msg)

#define _MHD_NO_DEPR_IN_MACRO 1

#define _MHD_DEPR_IN_MACRO(msg)

#define _MHD_NO_DEPR_FUNC 1

#define _MHD_DEPR_FUNC(msg)

#endif /* MHD_NO_DEPRECATION */

#ifndef _MHD_DEPR_MACRO

#if defined(_MSC_FULL_VER) && _MSC_VER+0 >= 1500

/* VS 2008 or later */

/* Stringify macros */

#define _MHD_INSTRMACRO(a) #a

#define _MHD_STRMACRO(a) _MHD_INSTRMACRO(a)

/* deprecation message */

#define _MHD_DEPR_MACRO(msg) __pragma(message(__FILE__ "(" _MHD_STRMACRO(__LINE__)"): warning: " msg))

#define _MHD_DEPR_IN_MACRO(msg) _MHD_DEPR_MACRO(msg)

#elif defined(__clang__) || defined (__GNUC_PATCHLEVEL__)

/* clang or GCC since 3.0 */

#define _MHD_GCC_PRAG(x) _Pragma (#x)

#if (defined(__clang__) && (__clang_major__+0 >= 5 ||			\

			    (!defined(__apple_build_version__) && (__clang_major__+0  > 3 || (__clang_major__+0 == 3 && __clang_minor__ >= 3))))) || \

  __GNUC__+0 > 4 || (__GNUC__+0 == 4 && __GNUC_MINOR__+0 >= 8)

/* clang >= 3.3 (or XCode's clang >= 5.0) or

   GCC >= 4.8 */

#define _MHD_DEPR_MACRO(msg) _MHD_GCC_PRAG(GCC warning msg)

#define _MHD_DEPR_IN_MACRO(msg) _MHD_DEPR_MACRO(msg)

#else /* older clang or GCC */

/* clang < 3.3, XCode's clang < 5.0, 3.0 <= GCC < 4.8 */

#define _MHD_DEPR_MACRO(msg) _MHD_GCC_PRAG(message msg)

#if (defined(__clang__) && (__clang_major__+0  > 2 || (__clang_major__+0 == 2 && __clang_minor__ >= 9))) /* FIXME: clang >= 2.9, earlier versions not tested */

/* clang handles inline pragmas better than GCC */

#define _MHD_DEPR_IN_MACRO(msg) _MHD_DEPR_MACRO(msg)

#endif /* clang >= 2.9 */

#endif  /* older clang or GCC */

/* #elif defined(SOMEMACRO) */ /* add compiler-specific macros here if required */

#endif /* clang || GCC >= 3.0 */

#endif /* !_MHD_DEPR_MACRO */

#ifndef _MHD_DEPR_MACRO

#define _MHD_DEPR_MACRO(msg)

#endif /* !_MHD_DEPR_MACRO */

#ifndef _MHD_DEPR_IN_MACRO

#define _MHD_NO_DEPR_IN_MACRO 1

#define _MHD_DEPR_IN_MACRO(msg)

#endif /* !_MHD_DEPR_IN_MACRO */

#ifndef _MHD_DEPR_FUNC

#if defined(_MSC_FULL_VER) && _MSC_VER+0 >= 1400

/* VS 2005 or later */

#define _MHD_DEPR_FUNC(msg) __declspec(deprecated(msg))

#elif defined(_MSC_FULL_VER) && _MSC_VER+0 >= 1310

/* VS .NET 2003 deprecation do not support custom messages */

#define _MHD_DEPR_FUNC(msg) __declspec(deprecated)

#elif (__GNUC__+0 >= 5) || (defined (__clang__) && \

  (__clang_major__+0 > 2 || (__clang_major__+0 == 2 && __clang_minor__ >= 9)))  /* FIXME: earlier versions not tested */

/* GCC >= 5.0 or clang >= 2.9 */

#define _MHD_DEPR_FUNC(msg) __attribute__((deprecated(msg)))

#elif defined (__clang__) || __GNUC__+0 > 3 || (__GNUC__+0 == 3 && __GNUC_MINOR__+0 >= 1)

/* 3.1 <= GCC < 5.0 or clang < 2.9 */

/* old GCC-style deprecation do not support custom messages */

#define _MHD_DEPR_FUNC(msg) __attribute__((__deprecated__))

/* #elif defined(SOMEMACRO) */ /* add compiler-specific macros here if required */

#endif /* clang < 2.9 || GCC >= 3.1 */

#endif /* !_MHD_DEPR_FUNC */

#ifndef _MHD_DEPR_FUNC

#define _MHD_NO_DEPR_FUNC 1

#define _MHD_DEPR_FUNC(msg)

#endif /* !_MHD_DEPR_FUNC */

/**

 * Not all architectures and `printf()`'s support the `long long` type.

 * This gives the ability to replace `long long` with just a `long`,

 * standard `int` or a `short`.

 */

#ifndef MHD_LONG_LONG

/**

 * @deprecated use #MHD_UNSIGNED_LONG_LONG instead!

 */

#define MHD_LONG_LONG long long

#define MHD_UNSIGNED_LONG_LONG unsigned long long

#else /* MHD_LONG_LONG */

_MHD_DEPR_MACRO("Macro MHD_LONG_LONG is deprecated, use MHD_UNSIGNED_LONG_LONG")

#endif

/**

 * Format string for printing a variable of type #MHD_LONG_LONG.

 * You should only redefine this if you also define #MHD_LONG_LONG.

 */

#ifndef MHD_LONG_LONG_PRINTF

/**

 * @deprecated use #MHD_UNSIGNED_LONG_LONG_PRINTF instead!

 */

#define MHD_LONG_LONG_PRINTF "ll"

#define MHD_UNSIGNED_LONG_LONG_PRINTF "%llu"

#else /* MHD_LONG_LONG_PRINTF */

_MHD_DEPR_MACRO("Macro MHD_LONG_LONG_PRINTF is deprecated, use MHD_UNSIGNED_LONG_LONG_PRINTF")

#endif

/**

 * @defgroup httpcode HTTP response codes.

 * These are the status codes defined for HTTP responses.

 * @{

 */

/* See http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml */

#define MHD_HTTP_CONTINUE 100

#define MHD_HTTP_SWITCHING_PROTOCOLS 101

#define MHD_HTTP_PROCESSING 102

#define MHD_HTTP_OK 200

#define MHD_HTTP_CREATED 201

#define MHD_HTTP_ACCEPTED 202

#define MHD_HTTP_NON_AUTHORITATIVE_INFORMATION 203

#define MHD_HTTP_NO_CONTENT 204

#define MHD_HTTP_RESET_CONTENT 205

#define MHD_HTTP_PARTIAL_CONTENT 206

#define MHD_HTTP_MULTI_STATUS 207

#define MHD_HTTP_ALREADY_REPORTED 208

#define MHD_HTTP_IM_USED 226

#define MHD_HTTP_MULTIPLE_CHOICES 300

#define MHD_HTTP_MOVED_PERMANENTLY 301

#define MHD_HTTP_FOUND 302

#define MHD_HTTP_SEE_OTHER 303

#define MHD_HTTP_NOT_MODIFIED 304

#define MHD_HTTP_USE_PROXY 305

#define MHD_HTTP_SWITCH_PROXY 306

#define MHD_HTTP_TEMPORARY_REDIRECT 307

#define MHD_HTTP_PERMANENT_REDIRECT 308

#define MHD_HTTP_BAD_REQUEST 400

#define MHD_HTTP_UNAUTHORIZED 401

#define MHD_HTTP_PAYMENT_REQUIRED 402

#define MHD_HTTP_FORBIDDEN 403

#define MHD_HTTP_NOT_FOUND 404

#define MHD_HTTP_METHOD_NOT_ALLOWED 405

#define MHD_HTTP_NOT_ACCEPTABLE 406

/** @deprecated */

#define MHD_HTTP_METHOD_NOT_ACCEPTABLE \

  _MHD_DEPR_IN_MACRO("Value MHD_HTTP_METHOD_NOT_ACCEPTABLE is deprecated, use MHD_HTTP_NOT_ACCEPTABLE") 406

#define MHD_HTTP_PROXY_AUTHENTICATION_REQUIRED 407

#define MHD_HTTP_REQUEST_TIMEOUT 408

#define MHD_HTTP_CONFLICT 409

#define MHD_HTTP_GONE 410

#define MHD_HTTP_LENGTH_REQUIRED 411

#define MHD_HTTP_PRECONDITION_FAILED 412

#define MHD_HTTP_PAYLOAD_TOO_LARGE 413

/** @deprecated */

#define MHD_HTTP_REQUEST_ENTITY_TOO_LARGE \

  _MHD_DEPR_IN_MACRO("Value MHD_HTTP_REQUEST_ENTITY_TOO_LARGE is deprecated, use MHD_HTTP_PAYLOAD_TOO_LARGE") 413

#define MHD_HTTP_URI_TOO_LONG 414

/** @deprecated */

#define MHD_HTTP_REQUEST_URI_TOO_LONG \

  _MHD_DEPR_IN_MACRO("Value MHD_HTTP_REQUEST_URI_TOO_LONG is deprecated, use MHD_HTTP_URI_TOO_LONG") 414

#define MHD_HTTP_UNSUPPORTED_MEDIA_TYPE 415

#define MHD_HTTP_RANGE_NOT_SATISFIABLE 416

/** @deprecated */

#define MHD_HTTP_REQUESTED_RANGE_NOT_SATISFIABLE \

  _MHD_DEPR_IN_MACRO("Value MHD_HTTP_REQUESTED_RANGE_NOT_SATISFIABLE is deprecated, use MHD_HTTP_RANGE_NOT_SATISFIABLE") 416

#define MHD_HTTP_EXPECTATION_FAILED 417

#define MHD_HTTP_MISDIRECTED_REQUEST 421

#define MHD_HTTP_UNPROCESSABLE_ENTITY 422

#define MHD_HTTP_LOCKED 423

#define MHD_HTTP_FAILED_DEPENDENCY 424

#define MHD_HTTP_UNORDERED_COLLECTION 425

#define MHD_HTTP_UPGRADE_REQUIRED 426

#define MHD_HTTP_PRECONDITION_REQUIRED 428

#define MHD_HTTP_TOO_MANY_REQUESTS 429

#define MHD_HTTP_REQUEST_HEADER_FIELDS_TOO_LARGE 431

#define MHD_HTTP_NO_RESPONSE 444

#define MHD_HTTP_RETRY_WITH 449

#define MHD_HTTP_BLOCKED_BY_WINDOWS_PARENTAL_CONTROLS 450

#define MHD_HTTP_UNAVAILABLE_FOR_LEGAL_REASONS 451

#define MHD_HTTP_INTERNAL_SERVER_ERROR 500

#define MHD_HTTP_NOT_IMPLEMENTED 501

#define MHD_HTTP_BAD_GATEWAY 502

#define MHD_HTTP_SERVICE_UNAVAILABLE 503

#define MHD_HTTP_GATEWAY_TIMEOUT 504

#define MHD_HTTP_HTTP_VERSION_NOT_SUPPORTED 505

#define MHD_HTTP_VARIANT_ALSO_NEGOTIATES 506

#define MHD_HTTP_INSUFFICIENT_STORAGE 507

#define MHD_HTTP_LOOP_DETECTED 508

#define MHD_HTTP_BANDWIDTH_LIMIT_EXCEEDED 509

#define MHD_HTTP_NOT_EXTENDED 510

#define MHD_HTTP_NETWORK_AUTHENTICATION_REQUIRED 511

/** @} */ /* end of group httpcode */

/**

 * Returns the string reason phrase for a response code.

 *

 * If we don't have a string for a status code, we give the first

 * message in that status code class.

 */

_MHD_EXTERN const char *

MHD_get_reason_phrase_for (unsigned int code);

/**

 * Flag to be or-ed with MHD_HTTP status code for

 * SHOUTcast.  This will cause the response to begin

 * with the SHOUTcast "ICY" line instad of "HTTP".

 * @ingroup specialized

 */

#define MHD_ICY_FLAG ((uint32_t)(((uint32_t)1) << 31))

/**

 * @defgroup headers HTTP headers

 * These are the standard headers found in HTTP requests and responses.

 * See: http://www.iana.org/assignments/message-headers/message-headers.xml

 * Registry Version 2017-01-27

 * @{

 */

/* Main HTTP headers. */

/* Standard.      RFC7231, Section 5.3.2 */

#define MHD_HTTP_HEADER_ACCEPT "Accept"

/* Standard.      RFC7231, Section 5.3.3 */

#define MHD_HTTP_HEADER_ACCEPT_CHARSET "Accept-Charset"

/* Standard.      RFC7231, Section 5.3.4; RFC7694, Section 3 */

#define MHD_HTTP_HEADER_ACCEPT_ENCODING "Accept-Encoding"

/* Standard.      RFC7231, Section 5.3.5 */

#define MHD_HTTP_HEADER_ACCEPT_LANGUAGE "Accept-Language"

/* Standard.      RFC7233, Section 2.3 */

#define MHD_HTTP_HEADER_ACCEPT_RANGES "Accept-Ranges"

/* Standard.      RFC7234, Section 5.1 */

#define MHD_HTTP_HEADER_AGE "Age"

/* Standard.      RFC7231, Section 7.4.1 */

#define MHD_HTTP_HEADER_ALLOW "Allow"

/* Standard.      RFC7235, Section 4.2 */

#define MHD_HTTP_HEADER_AUTHORIZATION "Authorization"

/* Standard.      RFC7234, Section 5.2 */

#define MHD_HTTP_HEADER_CACHE_CONTROL "Cache-Control"

/* Reserved.      RFC7230, Section 8.1 */

#define MHD_HTTP_HEADER_CLOSE "Close"

/* Standard.      RFC7230, Section 6.1 */

#define MHD_HTTP_HEADER_CONNECTION "Connection"

/* Standard.      RFC7231, Section 3.1.2.2 */

#define MHD_HTTP_HEADER_CONTENT_ENCODING "Content-Encoding"

/* Standard.      RFC7231, Section 3.1.3.2 */

#define MHD_HTTP_HEADER_CONTENT_LANGUAGE "Content-Language"

/* Standard.      RFC7230, Section 3.3.2 */

#define MHD_HTTP_HEADER_CONTENT_LENGTH "Content-Length"

/* Standard.      RFC7231, Section 3.1.4.2 */

#define MHD_HTTP_HEADER_CONTENT_LOCATION "Content-Location"

/* Standard.      RFC7233, Section 4.2 */

#define MHD_HTTP_HEADER_CONTENT_RANGE "Content-Range"

/* Standard.      RFC7231, Section 3.1.1.5 */

#define MHD_HTTP_HEADER_CONTENT_TYPE "Content-Type"

/* Standard.      RFC7231, Section 7.1.1.2 */

#define MHD_HTTP_HEADER_DATE "Date"

/* Standard.      RFC7232, Section 2.3 */

#define MHD_HTTP_HEADER_ETAG "ETag"

/* Standard.      RFC7231, Section 5.1.1 */

#define MHD_HTTP_HEADER_EXPECT "Expect"

/* Standard.      RFC7234, Section 5.3 */

#define MHD_HTTP_HEADER_EXPIRES "Expires"

/* Standard.      RFC7231, Section 5.5.1 */

#define MHD_HTTP_HEADER_FROM "From"

/* Standard.      RFC7230, Section 5.4 */

#define MHD_HTTP_HEADER_HOST "Host"

/* Standard.      RFC7232, Section 3.1 */

#define MHD_HTTP_HEADER_IF_MATCH "If-Match"

/* Standard.      RFC7232, Section 3.3 */

#define MHD_HTTP_HEADER_IF_MODIFIED_SINCE "If-Modified-Since"

/* Standard.      RFC7232, Section 3.2 */

#define MHD_HTTP_HEADER_IF_NONE_MATCH "If-None-Match"

/* Standard.      RFC7233, Section 3.2 */

#define MHD_HTTP_HEADER_IF_RANGE "If-Range"

/* Standard.      RFC7232, Section 3.4 */

#define MHD_HTTP_HEADER_IF_UNMODIFIED_SINCE "If-Unmodified-Since"

/* Standard.      RFC7232, Section 2.2 */

#define MHD_HTTP_HEADER_LAST_MODIFIED "Last-Modified"

/* Standard.      RFC7231, Section 7.1.2 */

#define MHD_HTTP_HEADER_LOCATION "Location"

/* Standard.      RFC7231, Section 5.1.2 */

#define MHD_HTTP_HEADER_MAX_FORWARDS "Max-Forwards"

/* Standard.      RFC7231, Appendix A.1 */

#define MHD_HTTP_HEADER_MIME_VERSION "MIME-Version"

/* Standard.      RFC7234, Section 5.4 */

#define MHD_HTTP_HEADER_PRAGMA "Pragma"

/* Standard.      RFC7235, Section 4.3 */

#define MHD_HTTP_HEADER_PROXY_AUTHENTICATE "Proxy-Authenticate"

/* Standard.      RFC7235, Section 4.4 */

#define MHD_HTTP_HEADER_PROXY_AUTHORIZATION "Proxy-Authorization"

/* Standard.      RFC7233, Section 3.1 */

#define MHD_HTTP_HEADER_RANGE "Range"

/* Standard.      RFC7231, Section 5.5.2 */

#define MHD_HTTP_HEADER_REFERER "Referer"

/* Standard.      RFC7231, Section 7.1.3 */

#define MHD_HTTP_HEADER_RETRY_AFTER "Retry-After"

/* Standard.      RFC7231, Section 7.4.2 */

#define MHD_HTTP_HEADER_SERVER "Server"

/* Standard.      RFC7230, Section 4.3 */

#define MHD_HTTP_HEADER_TE "TE"

/* Standard.      RFC7230, Section 4.4 */

#define MHD_HTTP_HEADER_TRAILER "Trailer"

/* Standard.      RFC7230, Section 3.3.1 */

#define MHD_HTTP_HEADER_TRANSFER_ENCODING "Transfer-Encoding"

/* Standard.      RFC7230, Section 6.7 */

#define MHD_HTTP_HEADER_UPGRADE "Upgrade"

/* Standard.      RFC7231, Section 5.5.3 */

#define MHD_HTTP_HEADER_USER_AGENT "User-Agent"

/* Standard.      RFC7231, Section 7.1.4 */

#define MHD_HTTP_HEADER_VARY "Vary"

/* Standard.      RFC7230, Section 5.7.1 */

#define MHD_HTTP_HEADER_VIA "Via"

/* Standard.      RFC7235, Section 4.1 */

#define MHD_HTTP_HEADER_WWW_AUTHENTICATE "WWW-Authenticate"

/* Standard.      RFC7234, Section 5.5 */

#define MHD_HTTP_HEADER_WARNING "Warning"

/* Additional HTTP headers. */

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_A_IM "A-IM"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_ACCEPT_ADDITIONS "Accept-Additions"

/* Informational. RFC7089 */

#define MHD_HTTP_HEADER_ACCEPT_DATETIME "Accept-Datetime"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_ACCEPT_FEATURES "Accept-Features"

/* No category.   RFC5789 */

#define MHD_HTTP_HEADER_ACCEPT_PATCH "Accept-Patch"

/* Standard.      RFC7639, Section 2 */

#define MHD_HTTP_HEADER_ALPN "ALPN"

/* Standard.      RFC7838 */

#define MHD_HTTP_HEADER_ALT_SVC "Alt-Svc"

/* Standard.      RFC7838 */

#define MHD_HTTP_HEADER_ALT_USED "Alt-Used"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_ALTERNATES "Alternates"

/* No category.   RFC4437 */

#define MHD_HTTP_HEADER_APPLY_TO_REDIRECT_REF "Apply-To-Redirect-Ref"

/* Experimental.  RFC8053, Section 4 */

#define MHD_HTTP_HEADER_AUTHENTICATION_CONTROL "Authentication-Control"

/* Standard.      RFC7615, Section 3 */

#define MHD_HTTP_HEADER_AUTHENTICATION_INFO "Authentication-Info"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_C_EXT "C-Ext"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_C_MAN "C-Man"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_C_OPT "C-Opt"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_C_PEP "C-PEP"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_C_PEP_INFO "C-PEP-Info"

/* Standard.      RFC7809, Section 7.1 */

#define MHD_HTTP_HEADER_CALDAV_TIMEZONES "CalDAV-Timezones"

/* Obsoleted.     RFC2068; RFC2616 */

#define MHD_HTTP_HEADER_CONTENT_BASE "Content-Base"

/* Standard.      RFC6266 */

#define MHD_HTTP_HEADER_CONTENT_DISPOSITION "Content-Disposition"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_CONTENT_ID "Content-ID"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_CONTENT_MD5 "Content-MD5"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_CONTENT_SCRIPT_TYPE "Content-Script-Type"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_CONTENT_STYLE_TYPE "Content-Style-Type"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_CONTENT_VERSION "Content-Version"

/* Standard.      RFC6265 */

#define MHD_HTTP_HEADER_COOKIE "Cookie"

/* Obsoleted.     RFC2965; RFC6265 */

#define MHD_HTTP_HEADER_COOKIE2 "Cookie2"

/* Standard.      RFC5323 */

#define MHD_HTTP_HEADER_DASL "DASL"

/* Standard.      RFC4918 */

#define MHD_HTTP_HEADER_DAV "DAV"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_DEFAULT_STYLE "Default-Style"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_DELTA_BASE "Delta-Base"

/* Standard.      RFC4918 */

#define MHD_HTTP_HEADER_DEPTH "Depth"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_DERIVED_FROM "Derived-From"

/* Standard.      RFC4918 */

#define MHD_HTTP_HEADER_DESTINATION "Destination"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_DIFFERENTIAL_ID "Differential-ID"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_DIGEST "Digest"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_EXT "Ext"

/* Standard.      RFC7239 */

#define MHD_HTTP_HEADER_FORWARDED "Forwarded"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_GETPROFILE "GetProfile"

/* Experimental.  RFC7486, Section 6.1.1 */

#define MHD_HTTP_HEADER_HOBAREG "Hobareg"

/* Standard.      RFC7540, Section 3.2.1 */

#define MHD_HTTP_HEADER_HTTP2_SETTINGS "HTTP2-Settings"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_IM "IM"

/* Standard.      RFC4918 */

#define MHD_HTTP_HEADER_IF "If"

/* Standard.      RFC6638 */

#define MHD_HTTP_HEADER_IF_SCHEDULE_TAG_MATCH "If-Schedule-Tag-Match"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_KEEP_ALIVE "Keep-Alive"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_LABEL "Label"

/* No category.   RFC5988 */

#define MHD_HTTP_HEADER_LINK "Link"

/* Standard.      RFC4918 */

#define MHD_HTTP_HEADER_LOCK_TOKEN "Lock-Token"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_MAN "Man"

/* Informational. RFC7089 */

#define MHD_HTTP_HEADER_MEMENTO_DATETIME "Memento-Datetime"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_METER "Meter"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_NEGOTIATE "Negotiate"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_OPT "Opt"

/* Experimental.  RFC8053, Section 3 */

#define MHD_HTTP_HEADER_OPTIONAL_WWW_AUTHENTICATE "Optional-WWW-Authenticate"

/* Standard.      RFC4229 */

#define MHD_HTTP_HEADER_ORDERING_TYPE "Ordering-Type"

/* Standard.      RFC6454 */

#define MHD_HTTP_HEADER_ORIGIN "Origin"

/* Standard.      RFC4918 */

#define MHD_HTTP_HEADER_OVERWRITE "Overwrite"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_P3P "P3P"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PEP "PEP"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PICS_LABEL "PICS-Label"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PEP_INFO "Pep-Info"

/* Standard.      RFC4229 */

#define MHD_HTTP_HEADER_POSITION "Position"

/* Standard.      RFC7240 */

#define MHD_HTTP_HEADER_PREFER "Prefer"

/* Standard.      RFC7240 */

#define MHD_HTTP_HEADER_PREFERENCE_APPLIED "Preference-Applied"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PROFILEOBJECT "ProfileObject"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PROTOCOL "Protocol"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PROTOCOL_INFO "Protocol-Info"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PROTOCOL_QUERY "Protocol-Query"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PROTOCOL_REQUEST "Protocol-Request"

/* Standard.      RFC7615, Section 4 */

#define MHD_HTTP_HEADER_PROXY_AUTHENTICATION_INFO "Proxy-Authentication-Info"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PROXY_FEATURES "Proxy-Features"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PROXY_INSTRUCTION "Proxy-Instruction"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_PUBLIC "Public"

/* Standard.      RFC7469 */

#define MHD_HTTP_HEADER_PUBLIC_KEY_PINS "Public-Key-Pins"

/* Standard.      RFC7469 */

#define MHD_HTTP_HEADER_PUBLIC_KEY_PINS_REPORT_ONLY "Public-Key-Pins-Report-Only"

/* No category.   RFC4437 */

#define MHD_HTTP_HEADER_REDIRECT_REF "Redirect-Ref"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_SAFE "Safe"

/* Standard.      RFC6638 */

#define MHD_HTTP_HEADER_SCHEDULE_REPLY "Schedule-Reply"

/* Standard.      RFC6638 */

#define MHD_HTTP_HEADER_SCHEDULE_TAG "Schedule-Tag"

/* Standard.      RFC6455 */

#define MHD_HTTP_HEADER_SEC_WEBSOCKET_ACCEPT "Sec-WebSocket-Accept"

/* Standard.      RFC6455 */

#define MHD_HTTP_HEADER_SEC_WEBSOCKET_EXTENSIONS "Sec-WebSocket-Extensions"

/* Standard.      RFC6455 */

#define MHD_HTTP_HEADER_SEC_WEBSOCKET_KEY "Sec-WebSocket-Key"

/* Standard.      RFC6455 */

#define MHD_HTTP_HEADER_SEC_WEBSOCKET_PROTOCOL "Sec-WebSocket-Protocol"

/* Standard.      RFC6455 */

#define MHD_HTTP_HEADER_SEC_WEBSOCKET_VERSION "Sec-WebSocket-Version"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_SECURITY_SCHEME "Security-Scheme"

/* Standard.      RFC6265 */

#define MHD_HTTP_HEADER_SET_COOKIE "Set-Cookie"

/* Obsoleted.     RFC2965; RFC6265 */

#define MHD_HTTP_HEADER_SET_COOKIE2 "Set-Cookie2"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_SETPROFILE "SetProfile"

/* Standard.      RFC5023 */

#define MHD_HTTP_HEADER_SLUG "SLUG"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_SOAPACTION "SoapAction"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_STATUS_URI "Status-URI"

/* Standard.      RFC6797 */

#define MHD_HTTP_HEADER_STRICT_TRANSPORT_SECURITY "Strict-Transport-Security"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_SURROGATE_CAPABILITY "Surrogate-Capability"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_SURROGATE_CONTROL "Surrogate-Control"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_TCN "TCN"

/* Standard.      RFC4918 */

#define MHD_HTTP_HEADER_TIMEOUT "Timeout"

/* Standard.      RFC8030, Section 5.4 */

#define MHD_HTTP_HEADER_TOPIC "Topic"

/* Standard.      RFC8030, Section 5.2 */

#define MHD_HTTP_HEADER_TTL "TTL"

/* Standard.      RFC8030, Section 5.3 */

#define MHD_HTTP_HEADER_URGENCY "Urgency"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_URI "URI"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_VARIANT_VARY "Variant-Vary"

/* No category.   RFC4229 */

#define MHD_HTTP_HEADER_WANT_DIGEST "Want-Digest"

/* Informational. RFC7034 */

#define MHD_HTTP_HEADER_X_FRAME_OPTIONS "X-Frame-Options"

/* Some provisional headers. */

#define MHD_HTTP_HEADER_ACCESS_CONTROL_ALLOW_ORIGIN "Access-Control-Allow-Origin"

/** @} */ /* end of group headers */

/**

 * @defgroup versions HTTP versions

 * These strings should be used to match against the first line of the

 * HTTP header.

 * @{

 */

#define MHD_HTTP_VERSION_1_0 "HTTP/1.0"

#define MHD_HTTP_VERSION_1_1 "HTTP/1.1"

/** @} */ /* end of group versions */

/**

 * @defgroup methods HTTP methods

 * HTTP methods (as strings).

 * See: http://www.iana.org/assignments/http-methods/http-methods.xml

 * Registry Version 2015-05-19

 * @{

 */

/* Main HTTP methods. */

/* Not safe. Not idempotent. RFC7231, Section 4.3.6. */

#define MHD_HTTP_METHOD_CONNECT "CONNECT"

/* Not safe. Idempotent.     RFC7231, Section 4.3.5. */

#define MHD_HTTP_METHOD_DELETE "DELETE"

/* Safe.     Idempotent.     RFC7231, Section 4.3.1. */

#define MHD_HTTP_METHOD_GET "GET"

/* Safe.     Idempotent.     RFC7231, Section 4.3.2. */

#define MHD_HTTP_METHOD_HEAD "HEAD"

/* Safe.     Idempotent.     RFC7231, Section 4.3.7. */

#define MHD_HTTP_METHOD_OPTIONS "OPTIONS"

/* Not safe. Not idempotent. RFC7231, Section 4.3.3. */

#define MHD_HTTP_METHOD_POST "POST"

/* Not safe. Idempotent.     RFC7231, Section 4.3.4. */

#define MHD_HTTP_METHOD_PUT "PUT"

/* Safe.     Idempotent.     RFC7231, Section 4.3.8. */

#define MHD_HTTP_METHOD_TRACE "TRACE"

/* Additional HTTP methods. */

/* Not safe. Idempotent.     RFC3744, Section 8.1. */

#define MHD_HTTP_METHOD_ACL "ACL"

/* Not safe. Idempotent.     RFC3253, Section 12.6. */

#define MHD_HTTP_METHOD_BASELINE_CONTROL "BASELINE-CONTROL"

/* Not safe. Idempotent.     RFC5842, Section 4. */

#define MHD_HTTP_METHOD_BIND "BIND"

/* Not safe. Idempotent.     RFC3253, Section 4.4, Section 9.4. */

#define MHD_HTTP_METHOD_CHECKIN "CHECKIN"

/* Not safe. Idempotent.     RFC3253, Section 4.3, Section 8.8. */

#define MHD_HTTP_METHOD_CHECKOUT "CHECKOUT"

/* Not safe. Idempotent.     RFC4918, Section 9.8. */

#define MHD_HTTP_METHOD_COPY "COPY"

/* Not safe. Idempotent.     RFC3253, Section 8.2. */

#define MHD_HTTP_METHOD_LABEL "LABEL"

/* Not safe. Idempotent.     RFC2068, Section 19.6.1.2. */

#define MHD_HTTP_METHOD_LINK "LINK"

/* Not safe. Not idempotent. RFC4918, Section 9.10. */

#define MHD_HTTP_METHOD_LOCK "LOCK"

/* Not safe. Idempotent.     RFC3253, Section 11.2. */

#define MHD_HTTP_METHOD_MERGE "MERGE"

/* Not safe. Idempotent.     RFC3253, Section 13.5. */

#define MHD_HTTP_METHOD_MKACTIVITY "MKACTIVITY"

/* Not safe. Idempotent.     RFC4791, Section 5.3.1. */

#define MHD_HTTP_METHOD_MKCALENDAR "MKCALENDAR"

/* Not safe. Idempotent.     RFC4918, Section 9.3. */

#define MHD_HTTP_METHOD_MKCOL "MKCOL"

/* Not safe. Idempotent.     RFC4437, Section 6. */

#define MHD_HTTP_METHOD_MKREDIRECTREF "MKREDIRECTREF"

/* Not safe. Idempotent.     RFC3253, Section 6.3. */

#define MHD_HTTP_METHOD_MKWORKSPACE "MKWORKSPACE"

/* Not safe. Idempotent.     RFC4918, Section 9.9. */

#define MHD_HTTP_METHOD_MOVE "MOVE"

/* Not safe. Idempotent.     RFC3648, Section 7. */

#define MHD_HTTP_METHOD_ORDERPATCH "ORDERPATCH"

/* Not safe. Not idempotent. RFC5789, Section 2. */

#define MHD_HTTP_METHOD_PATCH "PATCH"

/* Safe.     Idempotent.     RFC7540, Section 3.5. */

#define MHD_HTTP_METHOD_PRI "PRI"

/* Safe.     Idempotent.     RFC4918, Section 9.1. */

#define MHD_HTTP_METHOD_PROPFIND "PROPFIND"

/* Not safe. Idempotent.     RFC4918, Section 9.2. */

#define MHD_HTTP_METHOD_PROPPATCH "PROPPATCH"

/* Not safe. Idempotent.     RFC5842, Section 6. */

#define MHD_HTTP_METHOD_REBIND "REBIND"

/* Safe.     Idempotent.     RFC3253, Section 3.6. */

#define MHD_HTTP_METHOD_REPORT "REPORT"

/* Safe.     Idempotent.     RFC5323, Section 2. */

#define MHD_HTTP_METHOD_SEARCH "SEARCH"

/* Not safe. Idempotent.     RFC5842, Section 5. */

#define MHD_HTTP_METHOD_UNBIND "UNBIND"

/* Not safe. Idempotent.     RFC3253, Section 4.5. */

#define MHD_HTTP_METHOD_UNCHECKOUT "UNCHECKOUT"

/* Not safe. Idempotent.     RFC2068, Section 19.6.1.3. */

#define MHD_HTTP_METHOD_UNLINK "UNLINK"

/* Not safe. Idempotent.     RFC4918, Section 9.11. */

#define MHD_HTTP_METHOD_UNLOCK "UNLOCK"

/* Not safe. Idempotent.     RFC3253, Section 7.1. */

#define MHD_HTTP_METHOD_UPDATE "UPDATE"

/* Not safe. Idempotent.     RFC4437, Section 7. */

#define MHD_HTTP_METHOD_UPDATEREDIRECTREF "UPDATEREDIRECTREF"

/* Not safe. Idempotent.     RFC3253, Section 3.5. */

#define MHD_HTTP_METHOD_VERSION_CONTROL "VERSION-CONTROL"

/** @} */ /* end of group methods */

/**

 * @defgroup postenc HTTP POST encodings

 * See also: http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4

 * @{

 */

#define MHD_HTTP_POST_ENCODING_FORM_URLENCODED "application/x-www-form-urlencoded"

#define MHD_HTTP_POST_ENCODING_MULTIPART_FORMDATA "multipart/form-data"

/** @} */ /* end of group postenc */

/**

 * @brief Handle for the daemon (listening on a socket for HTTP traffic).

 * @ingroup event

 */

struct MHD_Daemon;

/**

 * @brief Handle for a connection / HTTP request.

 *

 * With HTTP/1.1, multiple requests can be run over the same

 * connection.  However, MHD will only show one request per TCP

 * connection to the client at any given time.

 * @ingroup request

 */

struct MHD_Connection;

/**

 * @brief Handle for a response.

 * @ingroup response

 */

struct MHD_Response;

/**

 * @brief Handle for POST processing.

 * @ingroup response

 */

struct MHD_PostProcessor;

/**

 * @brief Flags for the `struct MHD_Daemon`.

 *

 * Note that MHD will run automatically in background thread(s) only

 * if #MHD_USE_INTERNAL_POLLING_THREAD is used. Otherwise caller (application)

 * must use #MHD_run() or #MHD_run_from_select() to have MHD processed

 * network connections and data.

 *

 * Starting the daemon may also fail if a particular option is not

 * implemented or not supported on the target platform (i.e. no

 * support for TLS, epoll or IPv6).