diff options
author | Christian Grothoff <christian@grothoff.org> | 2018-10-16 20:42:54 +0200 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2018-10-16 20:44:39 +0200 |
commit | 9199e5aa3ac29235ee0326bf6ebc70882c63c268 (patch) | |
tree | dd4bcd6c8a1a6b2cdb7de3e5278b306127befcec /doc | |
parent | f7ab8b59a30cbd3c4e1b09906df2d4ffdff0472e (diff) | |
download | libmicrohttpd-9199e5aa3ac29235ee0326bf6ebc70882c63c268.tar.gz libmicrohttpd-9199e5aa3ac29235ee0326bf6ebc70882c63c268.zip |
From: Gauthier Haderer <ghaderer@wyplay.com>
Date: Mon, 15 Oct 2018 14:11:39 +0200
Subject: [PATCH] Add response flag to force version to 1.0 and maintain
connection management.
The existing MHD_RF_HTTP_VERSION_1_0_ONLY flag already changes MHD's
behavior to apply HTTP 1.0 rules for connection management. When
enabled, MHD sends a response using the same version as used in the
request (is this normal?).
What I want is MHD responding as a HTTP 1.0 server with support for
connection management headers would do. This is what the
MHD_RF_HTTP_VERSION_1_0_RESPONSE response flag is for.
You can even combine it with MHD_RF_HTTP_VERSION_1_0_ONLY to change the
response's HTTP version while maintaining strict compliance with HTTP
1.0 regarding connection management.
This solution is not perfect as this flag is set on the response which
is created after header processing. So MHD will behave as a HTTP 1.1
server until the response is queued. It means that an invalid HTTP 1.1
request will fail even if the response is sent with HTTP 1.0 and the
request would be valid if interpreted with this version. For example,
this request will fail in strict mode:
GET /dummy HTTP/1.1
as the Host header is missing and is mandatory in HTTP 1.1, but it
should succeed when interpreted with HTTP 1.0.
I don't think this is a big issue in practice. Besides, being able to
change the HTTP version on a response basis is really convenient when
using MHD in a test framework where we need to validate a client against
HTTP 1.1 AND HTTP 1.0.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/libmicrohttpd.texi | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/libmicrohttpd.texi b/doc/libmicrohttpd.texi index b61c94ff..2ecb64e6 100644 --- a/doc/libmicrohttpd.texi +++ b/doc/libmicrohttpd.texi | |||
@@ -1144,6 +1144,33 @@ Only respond in conservative HTTP 1.0-mode. In particular, | |||
1144 | do not (automatically) sent "Connection" headers and always | 1144 | do not (automatically) sent "Connection" headers and always |
1145 | close the connection after generating the response. | 1145 | close the connection after generating the response. |
1146 | 1146 | ||
1147 | By default, MHD will respond using the same HTTP version which | ||
1148 | was set in the request. You can also set the | ||
1149 | @code{MHD_RF_HTTP_VERSION_1_0_RESPONSE} flag to force version 1.0 | ||
1150 | in the response. | ||
1151 | |||
1152 | @item MHD_RF_HTTP_VERSION_1_0_RESPONSE | ||
1153 | Only respond in HTTP 1.0-mode. Contrary to the | ||
1154 | @code{MHD_RF_HTTP_VERSION_1_0_ONLY} flag, the response's HTTP version will | ||
1155 | always be set to 1.0 and ``Connection'' headers are still supported. | ||
1156 | |||
1157 | You can even combine this option with MHD_RF_HTTP_VERSION_1_0_ONLY to | ||
1158 | change the response's HTTP version while maintaining strict compliance | ||
1159 | with HTTP 1.0 regarding connection management. | ||
1160 | |||
1161 | This solution is not perfect as this flag is set on the response which | ||
1162 | is created after header processing. So MHD will behave as a HTTP 1.1 | ||
1163 | server until the response is queued. It means that an invalid HTTP 1.1 | ||
1164 | request will fail even if the response is sent with HTTP 1.0 and the | ||
1165 | request would be valid if interpreted with this version. For example, | ||
1166 | this request will fail in strict mode: | ||
1167 | |||
1168 | @verbatim | ||
1169 | GET / HTTP/1.1 | ||
1170 | @end verbatim | ||
1171 | |||
1172 | as the ``Host'' header is missing and is mandatory in HTTP 1.1, but it | ||
1173 | should succeed when interpreted with HTTP 1.0. | ||
1147 | @end table | 1174 | @end table |
1148 | @end deftp | 1175 | @end deftp |
1149 | 1176 | ||