Clarify the effect of nghttp2_option_set_no_http_messaging

This commit is contained in:
Tatsuhiro Tsujikawa 2017-04-29 21:00:20 +09:00
parent 196673bbce
commit f2c539dc70
2 changed files with 8 additions and 2 deletions

View File

@ -116,7 +116,10 @@ briefly describe what the library does in this area. In the following
description, without loss of generality we omit CONTINUATION frame description, without loss of generality we omit CONTINUATION frame
since they must follow HEADERS frame and are processed atomically. In since they must follow HEADERS frame and are processed atomically. In
other words, they are just one big HEADERS frame. To disable these other words, they are just one big HEADERS frame. To disable these
validations, use `nghttp2_option_set_no_http_messaging()`. validations, use `nghttp2_option_set_no_http_messaging()`. Please
note that disabling this feature does not change the fundamental
client and server model of HTTP. That is, even if the validation is
disabled, only client can send requests.
For HTTP request, including those carried by PUSH_PROMISE, HTTP For HTTP request, including those carried by PUSH_PROMISE, HTTP
message starts with one HEADERS frame containing request headers. It message starts with one HEADERS frame containing request headers. It

View File

@ -2448,7 +2448,10 @@ nghttp2_option_set_no_recv_client_magic(nghttp2_option *option, int val);
* <https://tools.ietf.org/html/rfc7540#section-8>`_. See * <https://tools.ietf.org/html/rfc7540#section-8>`_. See
* :ref:`http-messaging` section for details. For those applications * :ref:`http-messaging` section for details. For those applications
* who use nghttp2 library as non-HTTP use, give nonzero to |val| to * who use nghttp2 library as non-HTTP use, give nonzero to |val| to
* disable this enforcement. * disable this enforcement. Please note that disabling this feature
* does not change the fundamental client and server model of HTTP.
* That is, even if the validation is disabled, only client can send
* requests.
*/ */
NGHTTP2_EXTERN void nghttp2_option_set_no_http_messaging(nghttp2_option *option, NGHTTP2_EXTERN void nghttp2_option_set_no_http_messaging(nghttp2_option *option,
int val); int val);