2 * nghttp2 - HTTP/2 C Library
4 * Copyright (c) 2014 Tatsuhiro Tsujikawa
6 * Permission is hereby granted, free of charge, to any person obtaining
7 * a copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sublicense, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice shall be
15 * included in all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
20 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
21 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
22 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
23 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 #ifndef NGHTTP2_OPTION_H
26 #define NGHTTP2_OPTION_H
30 #endif /* HAVE_CONFIG_H */
32 #include <nghttp2/nghttp2.h>
35 * Configuration options
39 * This option prevents the library from sending WINDOW_UPDATE for a
40 * connection automatically. If this option is set to nonzero, the
41 * library won't send WINDOW_UPDATE for DATA until application calls
42 * nghttp2_session_consume() to indicate the amount of consumed
43 * DATA. By default, this option is set to zero.
45 NGHTTP2_OPT_NO_AUTO_WINDOW_UPDATE = 1,
47 * This option sets the SETTINGS_MAX_CONCURRENT_STREAMS value of
48 * remote endpoint as if it is received in SETTINGS frame. Without
49 * specifying this option, before the local endpoint receives
50 * SETTINGS_MAX_CONCURRENT_STREAMS in SETTINGS frame from remote
51 * endpoint, SETTINGS_MAX_CONCURRENT_STREAMS is unlimited. This may
52 * cause problem if local endpoint submits lots of requests
53 * initially and sending them at once to the remote peer may lead to
54 * the rejection of some requests. Specifying this option to the
55 * sensible value, say 100, may avoid this kind of issue. This value
56 * will be overwritten if the local endpoint receives
57 * SETTINGS_MAX_CONCURRENT_STREAMS from the remote endpoint.
59 NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS = 1 << 1,
60 NGHTTP2_OPT_RECV_CLIENT_PREFACE = 1 << 2,
61 } nghttp2_option_flag;
64 * Struct to store option values for nghttp2_session.
66 struct nghttp2_option {
68 * Bitwise OR of nghttp2_option_flag to determine that which fields
71 uint32_t opt_set_mask;
73 * NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS
75 uint32_t peer_max_concurrent_streams;
77 * NGHTTP2_OPT_NO_AUTO_WINDOW_UPDATE
79 uint8_t no_auto_window_update;
81 * NGHTTP2_OPT_RECV_CLIENT_PREFACE
83 uint8_t recv_client_preface;
86 #endif /* NGHTTP2_OPTION_H */