aboutsummaryrefslogtreecommitdiff
path: root/doc/libmicrohttpd.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/libmicrohttpd.texi')
-rw-r--r--doc/libmicrohttpd.texi45
1 files changed, 37 insertions, 8 deletions
diff --git a/doc/libmicrohttpd.texi b/doc/libmicrohttpd.texi
index 7e95155b..bdbe3de7 100644
--- a/doc/libmicrohttpd.texi
+++ b/doc/libmicrohttpd.texi
@@ -496,6 +496,8 @@ that IPv4 addresses are returned by MHD in the IPv6-mapped format
496(the 'struct sockaddr_in6' format will be used for IPv4 and IPv6). 496(the 'struct sockaddr_in6' format will be used for IPv4 and IPv6).
497 497
498@item MHD_USE_PEDANTIC_CHECKS 498@item MHD_USE_PEDANTIC_CHECKS
499@cindex deprecated
500Deprecated (use @code{MHD_OPTION_STRICT_FOR_CLIENT}).
499Be pedantic about the protocol. 501Be pedantic about the protocol.
500Specifically, at the moment, this flag causes MHD to reject HTTP 502Specifically, at the moment, this flag causes MHD to reject HTTP
5011.1 connections without a @code{Host} header. This is required by the 5031.1 connections without a @code{Host} header. This is required by the
@@ -504,13 +506,6 @@ in what you accept'' norm. It is recommended to turn this @strong{ON}
504if you are testing clients against MHD, and @strong{OFF} in 506if you are testing clients against MHD, and @strong{OFF} in
505production. 507production.
506 508
507@item MHD_USE_PERMISSIVE_CHECKS
508Be permissive about the protocol, allowing slight deviations that are
509technically not allowed by the RFC. Specifically, at the moment, this
510flag causes MHD to allow spaces in header field names. This is
511disallowed by the standard.
512
513
514@item MHD_USE_POLL 509@item MHD_USE_POLL
515@cindex FD_SETSIZE 510@cindex FD_SETSIZE
516@cindex poll 511@cindex poll
@@ -735,6 +730,31 @@ should be followed by an @code{unsigned int}. The default is
735zero, which means no limit on the number of connections 730zero, which means no limit on the number of connections
736from the same IP address. 731from the same IP address.
737 732
733@item MHD_OPTION_LISTEN_BACKLOG_SIZE
734Set the size of the @code{listen()} back log queue of the TCP socket.
735Takes an @code{unsigned int} as the argument. Default is the
736platform-specific value of @code{SOMAXCONN}.
737
738@item MHD_OPTION_STRICT_FOR_CLIENT
739Specify how strict we should enforce the HTTP protocol.
740Takes an @code{int} as the argument. Default is zero.
741
742If set to 1, MHD will be strict about the protocol. Specifically, at
743the moment, this flag uses MHD to reject HTTP 1.1 connections without
744a "Host" header. This is required by the standard, but of course in
745violation of the "be as liberal as possible in what you accept" norm.
746It is recommended to set this to 1 if you are testing clients against
747MHD, and 0 in production.
748
749If set to -1 MHD will be permissive about the protocol, allowing
750slight deviations that are technically not allowed by the
751RFC. Specifically, at the moment, this flag causes MHD to allow spaces
752in header field names. This is disallowed by the standard.
753
754It is not recommended to set it to -1 on publicly available servers as
755it may potentially lower level of protection.
756
757
738@item MHD_OPTION_SOCK_ADDR 758@item MHD_OPTION_SOCK_ADDR
739@cindex bind, restricting bind 759@cindex bind, restricting bind
740Bind daemon to the supplied socket address. This option should be followed by a 760Bind daemon to the supplied socket address. This option should be followed by a
@@ -2823,7 +2843,7 @@ socket was first accepted. Note that this is NOT the same as the
2823 2843
2824Takes no extra arguments. 2844Takes no extra arguments.
2825 2845
2826@item MHD_CONNECTION_INFO_TIMEOUT 2846@item MHD_CONNECTION_INFO_CONNECTION_TIMEOUT
2827Returns pointer to an @code{unsigned int} that is the current timeout 2847Returns pointer to an @code{unsigned int} that is the current timeout
2828used for the connection (in seconds, 0 for no timeout). Note that 2848used for the connection (in seconds, 0 for no timeout). Note that
2829while suspended connections will not timeout, the timeout value 2849while suspended connections will not timeout, the timeout value
@@ -2831,6 +2851,15 @@ returned for suspended connections will be the timeout that the
2831connection will use after it is resumed, and thus might not be zero. 2851connection will use after it is resumed, and thus might not be zero.
2832 2852
2833Takes no extra arguments. 2853Takes no extra arguments.
2854
2855@item MHD_CONNECTION_INFO_REQUEST_HEADER_SIZE
2856@cindex performance
2857Returns pointer to an @code{size_t} that represents the size of the
2858HTTP header received from the client. Only valid after the first callback
2859to the access handler.
2860
2861Takes no extra arguments.
2862
2834@end table 2863@end table
2835@end deftp 2864@end deftp
2836 2865