diff options
Diffstat (limited to 'doc/libmicrohttpd.texi')
-rw-r--r-- | doc/libmicrohttpd.texi | 45 |
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 | ||
500 | Deprecated (use @code{MHD_OPTION_STRICT_FOR_CLIENT}). | ||
499 | Be pedantic about the protocol. | 501 | Be pedantic about the protocol. |
500 | Specifically, at the moment, this flag causes MHD to reject HTTP | 502 | Specifically, at the moment, this flag causes MHD to reject HTTP |
501 | 1.1 connections without a @code{Host} header. This is required by the | 503 | 1.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} | |||
504 | if you are testing clients against MHD, and @strong{OFF} in | 506 | if you are testing clients against MHD, and @strong{OFF} in |
505 | production. | 507 | production. |
506 | 508 | ||
507 | @item MHD_USE_PERMISSIVE_CHECKS | ||
508 | Be permissive about the protocol, allowing slight deviations that are | ||
509 | technically not allowed by the RFC. Specifically, at the moment, this | ||
510 | flag causes MHD to allow spaces in header field names. This is | ||
511 | disallowed 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 | |||
735 | zero, which means no limit on the number of connections | 730 | zero, which means no limit on the number of connections |
736 | from the same IP address. | 731 | from the same IP address. |
737 | 732 | ||
733 | @item MHD_OPTION_LISTEN_BACKLOG_SIZE | ||
734 | Set the size of the @code{listen()} back log queue of the TCP socket. | ||
735 | Takes an @code{unsigned int} as the argument. Default is the | ||
736 | platform-specific value of @code{SOMAXCONN}. | ||
737 | |||
738 | @item MHD_OPTION_STRICT_FOR_CLIENT | ||
739 | Specify how strict we should enforce the HTTP protocol. | ||
740 | Takes an @code{int} as the argument. Default is zero. | ||
741 | |||
742 | If set to 1, MHD will be strict about the protocol. Specifically, at | ||
743 | the moment, this flag uses MHD to reject HTTP 1.1 connections without | ||
744 | a "Host" header. This is required by the standard, but of course in | ||
745 | violation of the "be as liberal as possible in what you accept" norm. | ||
746 | It is recommended to set this to 1 if you are testing clients against | ||
747 | MHD, and 0 in production. | ||
748 | |||
749 | If set to -1 MHD will be permissive about the protocol, allowing | ||
750 | slight deviations that are technically not allowed by the | ||
751 | RFC. Specifically, at the moment, this flag causes MHD to allow spaces | ||
752 | in header field names. This is disallowed by the standard. | ||
753 | |||
754 | It is not recommended to set it to -1 on publicly available servers as | ||
755 | it 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 |
740 | Bind daemon to the supplied socket address. This option should be followed by a | 760 | Bind 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 | ||
2824 | Takes no extra arguments. | 2844 | Takes no extra arguments. |
2825 | 2845 | ||
2826 | @item MHD_CONNECTION_INFO_TIMEOUT | 2846 | @item MHD_CONNECTION_INFO_CONNECTION_TIMEOUT |
2827 | Returns pointer to an @code{unsigned int} that is the current timeout | 2847 | Returns pointer to an @code{unsigned int} that is the current timeout |
2828 | used for the connection (in seconds, 0 for no timeout). Note that | 2848 | used for the connection (in seconds, 0 for no timeout). Note that |
2829 | while suspended connections will not timeout, the timeout value | 2849 | while suspended connections will not timeout, the timeout value |
@@ -2831,6 +2851,15 @@ returned for suspended connections will be the timeout that the | |||
2831 | connection will use after it is resumed, and thus might not be zero. | 2851 | connection will use after it is resumed, and thus might not be zero. |
2832 | 2852 | ||
2833 | Takes no extra arguments. | 2853 | Takes no extra arguments. |
2854 | |||
2855 | @item MHD_CONNECTION_INFO_REQUEST_HEADER_SIZE | ||
2856 | @cindex performance | ||
2857 | Returns pointer to an @code{size_t} that represents the size of the | ||
2858 | HTTP header received from the client. Only valid after the first callback | ||
2859 | to the access handler. | ||
2860 | |||
2861 | Takes no extra arguments. | ||
2862 | |||
2834 | @end table | 2863 | @end table |
2835 | @end deftp | 2864 | @end deftp |
2836 | 2865 | ||