Skip to main content

libnghttp2_sys/
lib.rs

1#![allow(bad_style)]
2#![allow(rustdoc::bare_urls)]
3/* automatically generated by rust-bindgen 0.72.1 */
4
5#[doc = " @typedef\n\n :type:`nghttp2_ssize` is a signed counterpart of size_t."]
6pub type nghttp2_ssize = isize;
7#[repr(C)]
8#[derive(Debug, Copy, Clone)]
9pub struct nghttp2_session {
10    _unused: [u8; 0],
11}
12#[doc = " @struct\n\n This struct is what `nghttp2_version()` returns.  It holds\n information about the particular nghttp2 version."]
13#[repr(C)]
14#[derive(Debug, Copy, Clone)]
15pub struct nghttp2_info {
16    #[doc = " Age of this struct.  This instance of nghttp2 sets it to\n :macro:`NGHTTP2_VERSION_AGE` but a future version may bump it and\n add more struct fields at the bottom"]
17    pub age: ::std::os::raw::c_int,
18    #[doc = " the :macro:`NGHTTP2_VERSION_NUM` number (since age ==1)"]
19    pub version_num: ::std::os::raw::c_int,
20    #[doc = " points to the :macro:`NGHTTP2_VERSION` string (since age ==1)"]
21    pub version_str: *const ::std::os::raw::c_char,
22    #[doc = " points to the :macro:`NGHTTP2_PROTO_VERSION_ID` string this\n instance implements (since age ==1)"]
23    pub proto_str: *const ::std::os::raw::c_char,
24}
25#[doc = " Invalid argument passed."]
26pub const NGHTTP2_ERR_INVALID_ARGUMENT: nghttp2_error = -501;
27#[doc = " Out of buffer space."]
28pub const NGHTTP2_ERR_BUFFER_ERROR: nghttp2_error = -502;
29#[doc = " The specified protocol version is not supported."]
30pub const NGHTTP2_ERR_UNSUPPORTED_VERSION: nghttp2_error = -503;
31#[doc = " Used as a return value from :type:`nghttp2_send_callback2`,\n :type:`nghttp2_recv_callback` and\n :type:`nghttp2_send_data_callback` to indicate that the operation\n would block."]
32pub const NGHTTP2_ERR_WOULDBLOCK: nghttp2_error = -504;
33#[doc = " General protocol error"]
34pub const NGHTTP2_ERR_PROTO: nghttp2_error = -505;
35#[doc = " The frame is invalid."]
36pub const NGHTTP2_ERR_INVALID_FRAME: nghttp2_error = -506;
37#[doc = " The peer performed a shutdown on the connection."]
38pub const NGHTTP2_ERR_EOF: nghttp2_error = -507;
39#[doc = " Used as a return value from\n :func:`nghttp2_data_source_read_callback2` to indicate that data\n transfer is postponed.  See\n :func:`nghttp2_data_source_read_callback2` for details."]
40pub const NGHTTP2_ERR_DEFERRED: nghttp2_error = -508;
41#[doc = " Stream ID has reached the maximum value.  Therefore no stream ID\n is available."]
42pub const NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE: nghttp2_error = -509;
43#[doc = " The stream is already closed; or the stream ID is invalid."]
44pub const NGHTTP2_ERR_STREAM_CLOSED: nghttp2_error = -510;
45#[doc = " RST_STREAM has been added to the outbound queue.  The stream is\n in closing state."]
46pub const NGHTTP2_ERR_STREAM_CLOSING: nghttp2_error = -511;
47#[doc = " The transmission is not allowed for this stream (e.g., a frame\n with END_STREAM flag set has already sent)."]
48pub const NGHTTP2_ERR_STREAM_SHUT_WR: nghttp2_error = -512;
49#[doc = " The stream ID is invalid."]
50pub const NGHTTP2_ERR_INVALID_STREAM_ID: nghttp2_error = -513;
51#[doc = " The state of the stream is not valid (e.g., DATA cannot be sent\n to the stream if response HEADERS has not been sent)."]
52pub const NGHTTP2_ERR_INVALID_STREAM_STATE: nghttp2_error = -514;
53#[doc = " Another DATA frame has already been deferred."]
54pub const NGHTTP2_ERR_DEFERRED_DATA_EXIST: nghttp2_error = -515;
55#[doc = " Starting new stream is not allowed (e.g., GOAWAY has been sent\n and/or received)."]
56pub const NGHTTP2_ERR_START_STREAM_NOT_ALLOWED: nghttp2_error = -516;
57#[doc = " GOAWAY has already been sent."]
58pub const NGHTTP2_ERR_GOAWAY_ALREADY_SENT: nghttp2_error = -517;
59#[doc = " The received frame contains the invalid header block (e.g., There\n are duplicate header names; or the header names are not encoded\n in US-ASCII character set and not lower cased; or the header name\n is zero-length string; or the header value contains multiple\n in-sequence NUL bytes)."]
60pub const NGHTTP2_ERR_INVALID_HEADER_BLOCK: nghttp2_error = -518;
61#[doc = " Indicates that the context is not suitable to perform the\n requested operation."]
62pub const NGHTTP2_ERR_INVALID_STATE: nghttp2_error = -519;
63#[doc = " The user callback function failed due to the temporal error."]
64pub const NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE: nghttp2_error = -521;
65#[doc = " The length of the frame is invalid, either too large or too small."]
66pub const NGHTTP2_ERR_FRAME_SIZE_ERROR: nghttp2_error = -522;
67#[doc = " Header block inflate/deflate error."]
68pub const NGHTTP2_ERR_HEADER_COMP: nghttp2_error = -523;
69#[doc = " Flow control error"]
70pub const NGHTTP2_ERR_FLOW_CONTROL: nghttp2_error = -524;
71#[doc = " Insufficient buffer size given to function."]
72pub const NGHTTP2_ERR_INSUFF_BUFSIZE: nghttp2_error = -525;
73#[doc = " Callback was paused by the application"]
74pub const NGHTTP2_ERR_PAUSE: nghttp2_error = -526;
75#[doc = " There are too many in-flight SETTING frame and no more\n transmission of SETTINGS is allowed."]
76pub const NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGS: nghttp2_error = -527;
77#[doc = " The server push is disabled."]
78pub const NGHTTP2_ERR_PUSH_DISABLED: nghttp2_error = -528;
79#[doc = " DATA or HEADERS frame for a given stream has been already\n submitted and has not been fully processed yet.  Application\n should wait for the transmission of the previously submitted\n frame before submitting another."]
80pub const NGHTTP2_ERR_DATA_EXIST: nghttp2_error = -529;
81#[doc = " The current session is closing due to a connection error or\n `nghttp2_session_terminate_session()` is called."]
82pub const NGHTTP2_ERR_SESSION_CLOSING: nghttp2_error = -530;
83#[doc = " Invalid HTTP header field was received and stream is going to be\n closed."]
84pub const NGHTTP2_ERR_HTTP_HEADER: nghttp2_error = -531;
85#[doc = " Violation in HTTP messaging rule."]
86pub const NGHTTP2_ERR_HTTP_MESSAGING: nghttp2_error = -532;
87#[doc = " Stream was refused."]
88pub const NGHTTP2_ERR_REFUSED_STREAM: nghttp2_error = -533;
89#[doc = " Unexpected internal error, but recovered."]
90pub const NGHTTP2_ERR_INTERNAL: nghttp2_error = -534;
91#[doc = " Indicates that a processing was canceled."]
92pub const NGHTTP2_ERR_CANCEL: nghttp2_error = -535;
93#[doc = " When a local endpoint expects to receive SETTINGS frame, it\n receives an other type of frame."]
94pub const NGHTTP2_ERR_SETTINGS_EXPECTED: nghttp2_error = -536;
95#[doc = " When a local endpoint receives too many settings entries\n in a single SETTINGS frame."]
96pub const NGHTTP2_ERR_TOO_MANY_SETTINGS: nghttp2_error = -537;
97#[doc = " The errors < :enum:`nghttp2_error.NGHTTP2_ERR_FATAL` mean that\n the library is under unexpected condition and processing was\n terminated (e.g., out of memory).  If application receives this\n error code, it must stop using that :type:`nghttp2_session`\n object and only allowed operation for that object is deallocate\n it using `nghttp2_session_del()`."]
98pub const NGHTTP2_ERR_FATAL: nghttp2_error = -900;
99#[doc = " Out of memory.  This is a fatal error."]
100pub const NGHTTP2_ERR_NOMEM: nghttp2_error = -901;
101#[doc = " The user callback function failed.  This is a fatal error."]
102pub const NGHTTP2_ERR_CALLBACK_FAILURE: nghttp2_error = -902;
103#[doc = " Invalid client magic (see :macro:`NGHTTP2_CLIENT_MAGIC`) was\n received and further processing is not possible."]
104pub const NGHTTP2_ERR_BAD_CLIENT_MAGIC: nghttp2_error = -903;
105#[doc = " Possible flooding by peer was detected in this HTTP/2 session.\n Flooding is measured by how many PING and SETTINGS frames with\n ACK flag set are queued for transmission.  These frames are\n response for the peer initiated frames, and peer can cause memory\n exhaustion on server side to send these frames forever and does\n not read network."]
106pub const NGHTTP2_ERR_FLOODED: nghttp2_error = -904;
107#[doc = " When a local endpoint receives too many CONTINUATION frames\n following a HEADER frame."]
108pub const NGHTTP2_ERR_TOO_MANY_CONTINUATIONS: nghttp2_error = -905;
109#[doc = " @enum\n\n Error codes used in this library.  The code range is [-999, -500],\n inclusive. The following values are defined:"]
110pub type nghttp2_error = ::std::os::raw::c_int;
111#[doc = " @struct\n\n The object representing single contiguous buffer."]
112#[repr(C)]
113#[derive(Debug, Copy, Clone)]
114pub struct nghttp2_vec {
115    #[doc = " The pointer to the buffer."]
116    pub base: *mut u8,
117    #[doc = " The length of the buffer."]
118    pub len: usize,
119}
120#[repr(C)]
121#[derive(Debug, Copy, Clone)]
122pub struct nghttp2_rcbuf {
123    _unused: [u8; 0],
124}
125unsafe extern "C" {
126    #[doc = " @function\n\n Increments the reference count of |rcbuf| by 1."]
127    pub fn nghttp2_rcbuf_incref(rcbuf: *mut nghttp2_rcbuf);
128}
129unsafe extern "C" {
130    #[doc = " @function\n\n Decrements the reference count of |rcbuf| by 1.  If the reference\n count becomes zero, the object pointed by |rcbuf| will be freed.\n In this case, application must not use |rcbuf| again."]
131    pub fn nghttp2_rcbuf_decref(rcbuf: *mut nghttp2_rcbuf);
132}
133unsafe extern "C" {
134    #[doc = " @function\n\n Returns the underlying buffer managed by |rcbuf|."]
135    pub fn nghttp2_rcbuf_get_buf(rcbuf: *mut nghttp2_rcbuf) -> nghttp2_vec;
136}
137unsafe extern "C" {
138    #[doc = " @function\n\n Returns nonzero if the underlying buffer is statically allocated,\n and 0 otherwise. This can be useful for language bindings that wish\n to avoid creating duplicate strings for these buffers."]
139    pub fn nghttp2_rcbuf_is_static(rcbuf: *const nghttp2_rcbuf) -> ::std::os::raw::c_int;
140}
141#[doc = " No flag set."]
142pub const NGHTTP2_NV_FLAG_NONE: nghttp2_nv_flag = 0;
143#[doc = " Indicates that this name/value pair must not be indexed (\"Literal\n Header Field never Indexed\" representation must be used in HPACK\n encoding).  Other implementation calls this bit as \"sensitive\"."]
144pub const NGHTTP2_NV_FLAG_NO_INDEX: nghttp2_nv_flag = 1;
145#[doc = " This flag is set solely by application.  If this flag is set, the\n library does not make a copy of header field name.  This could\n improve performance."]
146pub const NGHTTP2_NV_FLAG_NO_COPY_NAME: nghttp2_nv_flag = 2;
147#[doc = " This flag is set solely by application.  If this flag is set, the\n library does not make a copy of header field value.  This could\n improve performance."]
148pub const NGHTTP2_NV_FLAG_NO_COPY_VALUE: nghttp2_nv_flag = 4;
149#[doc = " @enum\n\n The flags for header field name/value pair."]
150pub type nghttp2_nv_flag = ::std::os::raw::c_uint;
151#[doc = " @struct\n\n The name/value pair, which mainly used to represent header fields."]
152#[repr(C)]
153#[derive(Debug, Copy, Clone)]
154pub struct nghttp2_nv {
155    #[doc = " The |name| byte string.  If this struct is presented from library\n (e.g., :type:`nghttp2_on_frame_recv_callback`), |name| is\n guaranteed to be NULL-terminated.  For some callbacks\n (:type:`nghttp2_before_frame_send_callback`,\n :type:`nghttp2_on_frame_send_callback`, and\n :type:`nghttp2_on_frame_not_send_callback`), it may not be\n NULL-terminated if header field is passed from application with\n the flag :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`).\n When application is constructing this struct, |name| is not\n required to be NULL-terminated."]
156    pub name: *mut u8,
157    #[doc = " The |value| byte string.  If this struct is presented from\n library (e.g., :type:`nghttp2_on_frame_recv_callback`), |value|\n is guaranteed to be NULL-terminated.  For some callbacks\n (:type:`nghttp2_before_frame_send_callback`,\n :type:`nghttp2_on_frame_send_callback`, and\n :type:`nghttp2_on_frame_not_send_callback`), it may not be\n NULL-terminated if header field is passed from application with\n the flag :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE`).\n When application is constructing this struct, |value| is not\n required to be NULL-terminated."]
158    pub value: *mut u8,
159    #[doc = " The length of the |name|, excluding terminating NULL."]
160    pub namelen: usize,
161    #[doc = " The length of the |value|, excluding terminating NULL."]
162    pub valuelen: usize,
163    #[doc = " Bitwise OR of one or more of :type:`nghttp2_nv_flag`."]
164    pub flags: u8,
165}
166#[doc = " The DATA frame."]
167pub const NGHTTP2_DATA: nghttp2_frame_type = 0;
168#[doc = " The HEADERS frame."]
169pub const NGHTTP2_HEADERS: nghttp2_frame_type = 1;
170#[doc = " The PRIORITY frame."]
171pub const NGHTTP2_PRIORITY: nghttp2_frame_type = 2;
172#[doc = " The RST_STREAM frame."]
173pub const NGHTTP2_RST_STREAM: nghttp2_frame_type = 3;
174#[doc = " The SETTINGS frame."]
175pub const NGHTTP2_SETTINGS: nghttp2_frame_type = 4;
176#[doc = " The PUSH_PROMISE frame."]
177pub const NGHTTP2_PUSH_PROMISE: nghttp2_frame_type = 5;
178#[doc = " The PING frame."]
179pub const NGHTTP2_PING: nghttp2_frame_type = 6;
180#[doc = " The GOAWAY frame."]
181pub const NGHTTP2_GOAWAY: nghttp2_frame_type = 7;
182#[doc = " The WINDOW_UPDATE frame."]
183pub const NGHTTP2_WINDOW_UPDATE: nghttp2_frame_type = 8;
184#[doc = " The CONTINUATION frame.  This frame type won't be passed to any\n callbacks because the library processes this frame type and its\n preceding HEADERS/PUSH_PROMISE as a single frame."]
185pub const NGHTTP2_CONTINUATION: nghttp2_frame_type = 9;
186#[doc = " The ALTSVC frame, which is defined in `RFC 7383\n <https://tools.ietf.org/html/rfc7838#section-4>`_."]
187pub const NGHTTP2_ALTSVC: nghttp2_frame_type = 10;
188#[doc = " The ORIGIN frame, which is defined by `RFC 8336\n <https://tools.ietf.org/html/rfc8336>`_."]
189pub const NGHTTP2_ORIGIN: nghttp2_frame_type = 12;
190#[doc = " The PRIORITY_UPDATE frame, which is defined by :rfc:`9218`."]
191pub const NGHTTP2_PRIORITY_UPDATE: nghttp2_frame_type = 16;
192#[doc = " @enum\n\n The frame types in HTTP/2 specification."]
193pub type nghttp2_frame_type = ::std::os::raw::c_uint;
194#[doc = " No flag set."]
195pub const NGHTTP2_FLAG_NONE: nghttp2_flag = 0;
196#[doc = " The END_STREAM flag."]
197pub const NGHTTP2_FLAG_END_STREAM: nghttp2_flag = 1;
198#[doc = " The END_HEADERS flag."]
199pub const NGHTTP2_FLAG_END_HEADERS: nghttp2_flag = 4;
200#[doc = " The ACK flag."]
201pub const NGHTTP2_FLAG_ACK: nghttp2_flag = 1;
202#[doc = " The PADDED flag."]
203pub const NGHTTP2_FLAG_PADDED: nghttp2_flag = 8;
204#[doc = " The PRIORITY flag."]
205pub const NGHTTP2_FLAG_PRIORITY: nghttp2_flag = 32;
206#[doc = " @enum\n\n The flags for HTTP/2 frames.  This enum defines all flags for all\n frames."]
207pub type nghttp2_flag = ::std::os::raw::c_uint;
208#[doc = " SETTINGS_HEADER_TABLE_SIZE"]
209pub const NGHTTP2_SETTINGS_HEADER_TABLE_SIZE: nghttp2_settings_id = 1;
210#[doc = " SETTINGS_ENABLE_PUSH"]
211pub const NGHTTP2_SETTINGS_ENABLE_PUSH: nghttp2_settings_id = 2;
212#[doc = " SETTINGS_MAX_CONCURRENT_STREAMS"]
213pub const NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS: nghttp2_settings_id = 3;
214#[doc = " SETTINGS_INITIAL_WINDOW_SIZE"]
215pub const NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE: nghttp2_settings_id = 4;
216#[doc = " SETTINGS_MAX_FRAME_SIZE"]
217pub const NGHTTP2_SETTINGS_MAX_FRAME_SIZE: nghttp2_settings_id = 5;
218#[doc = " SETTINGS_MAX_HEADER_LIST_SIZE"]
219pub const NGHTTP2_SETTINGS_MAX_HEADER_LIST_SIZE: nghttp2_settings_id = 6;
220#[doc = " SETTINGS_ENABLE_CONNECT_PROTOCOL\n (`RFC 8441 <https://tools.ietf.org/html/rfc8441>`_)"]
221pub const NGHTTP2_SETTINGS_ENABLE_CONNECT_PROTOCOL: nghttp2_settings_id = 8;
222#[doc = " SETTINGS_NO_RFC7540_PRIORITIES (:rfc:`9218`)"]
223pub const NGHTTP2_SETTINGS_NO_RFC7540_PRIORITIES: nghttp2_settings_id = 9;
224#[doc = " @enum\n The SETTINGS ID."]
225pub type nghttp2_settings_id = ::std::os::raw::c_uint;
226#[doc = " No errors."]
227pub const NGHTTP2_NO_ERROR: nghttp2_error_code = 0;
228#[doc = " PROTOCOL_ERROR"]
229pub const NGHTTP2_PROTOCOL_ERROR: nghttp2_error_code = 1;
230#[doc = " INTERNAL_ERROR"]
231pub const NGHTTP2_INTERNAL_ERROR: nghttp2_error_code = 2;
232#[doc = " FLOW_CONTROL_ERROR"]
233pub const NGHTTP2_FLOW_CONTROL_ERROR: nghttp2_error_code = 3;
234#[doc = " SETTINGS_TIMEOUT"]
235pub const NGHTTP2_SETTINGS_TIMEOUT: nghttp2_error_code = 4;
236#[doc = " STREAM_CLOSED"]
237pub const NGHTTP2_STREAM_CLOSED: nghttp2_error_code = 5;
238#[doc = " FRAME_SIZE_ERROR"]
239pub const NGHTTP2_FRAME_SIZE_ERROR: nghttp2_error_code = 6;
240#[doc = " REFUSED_STREAM"]
241pub const NGHTTP2_REFUSED_STREAM: nghttp2_error_code = 7;
242#[doc = " CANCEL"]
243pub const NGHTTP2_CANCEL: nghttp2_error_code = 8;
244#[doc = " COMPRESSION_ERROR"]
245pub const NGHTTP2_COMPRESSION_ERROR: nghttp2_error_code = 9;
246#[doc = " CONNECT_ERROR"]
247pub const NGHTTP2_CONNECT_ERROR: nghttp2_error_code = 10;
248#[doc = " ENHANCE_YOUR_CALM"]
249pub const NGHTTP2_ENHANCE_YOUR_CALM: nghttp2_error_code = 11;
250#[doc = " INADEQUATE_SECURITY"]
251pub const NGHTTP2_INADEQUATE_SECURITY: nghttp2_error_code = 12;
252#[doc = " HTTP_1_1_REQUIRED"]
253pub const NGHTTP2_HTTP_1_1_REQUIRED: nghttp2_error_code = 13;
254#[doc = " @enum\n The status codes for the RST_STREAM and GOAWAY frames."]
255pub type nghttp2_error_code = ::std::os::raw::c_uint;
256#[doc = " @struct\n The frame header."]
257#[repr(C)]
258#[derive(Debug, Copy, Clone)]
259pub struct nghttp2_frame_hd {
260    #[doc = " The length field of this frame, excluding frame header."]
261    pub length: usize,
262    #[doc = " The stream identifier (aka, stream ID)"]
263    pub stream_id: i32,
264    #[doc = " The type of this frame.  See `nghttp2_frame_type`."]
265    pub type_: u8,
266    #[doc = " The flags."]
267    pub flags: u8,
268    #[doc = " Reserved bit in frame header.  Currently, this is always set to 0\n and application should not expect something useful in here."]
269    pub reserved: u8,
270}
271#[doc = " @union\n\n This union represents the some kind of data source passed to\n :type:`nghttp2_data_source_read_callback2`."]
272#[repr(C)]
273#[derive(Copy, Clone)]
274pub union nghttp2_data_source {
275    #[doc = " The integer field, suitable for a file descriptor."]
276    pub fd: ::std::os::raw::c_int,
277    #[doc = " The pointer to an arbitrary object."]
278    pub ptr: *mut ::std::os::raw::c_void,
279}
280#[doc = " No flag set."]
281pub const NGHTTP2_DATA_FLAG_NONE: nghttp2_data_flag = 0;
282#[doc = " Indicates EOF was sensed."]
283pub const NGHTTP2_DATA_FLAG_EOF: nghttp2_data_flag = 1;
284#[doc = " Indicates that END_STREAM flag must not be set even if\n NGHTTP2_DATA_FLAG_EOF is set.  Usually this flag is used to send\n trailer fields with `nghttp2_submit_request2()` or\n `nghttp2_submit_response2()`."]
285pub const NGHTTP2_DATA_FLAG_NO_END_STREAM: nghttp2_data_flag = 2;
286#[doc = " Indicates that application will send complete DATA frame in\n :type:`nghttp2_send_data_callback`."]
287pub const NGHTTP2_DATA_FLAG_NO_COPY: nghttp2_data_flag = 4;
288#[doc = " @enum\n\n The flags used to set in |data_flags| output parameter in\n :type:`nghttp2_data_source_read_callback2`."]
289pub type nghttp2_data_flag = ::std::os::raw::c_uint;
290#[doc = " @functypedef\n\n .. warning::\n\n   Deprecated.  Use :type:`nghttp2_data_source_read_callback2`\n   instead.\n\n Callback function invoked when the library wants to read data from\n the |source|.  The read data is sent in the stream |stream_id|.\n The implementation of this function must read at most |length|\n bytes of data from |source| (or possibly other places) and store\n them in |buf| and return number of data stored in |buf|.  If EOF is\n reached, set :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_EOF` flag\n in |*data_flags|.\n\n Sometime it is desirable to avoid copying data into |buf| and let\n application to send data directly.  To achieve this, set\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_COPY` to\n |*data_flags| (and possibly other flags, just like when we do\n copy), and return the number of bytes to send without copying data\n into |buf|.  The library, seeing\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_COPY`, will invoke\n :type:`nghttp2_send_data_callback`.  The application must send\n complete DATA frame in that callback.\n\n If this callback is set by `nghttp2_submit_request()`,\n `nghttp2_submit_response()` or `nghttp2_submit_headers()` and\n `nghttp2_submit_data()` with flag parameter\n :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM` set, and\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_EOF` flag is set to\n |*data_flags|, DATA frame will have END_STREAM flag set.  Usually,\n this is expected behaviour and all are fine.  One exception is send\n trailer fields.  You cannot send trailer fields after sending frame\n with END_STREAM set.  To avoid this problem, one can set\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_END_STREAM` along\n with :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_EOF` to signal the\n library not to set END_STREAM in DATA frame.  Then application can\n use `nghttp2_submit_trailer()` to send trailer fields.\n `nghttp2_submit_trailer()` can be called inside this callback.\n\n If the application wants to postpone DATA frames (e.g.,\n asynchronous I/O, or reading data blocks for long time), it is\n achieved by returning :enum:`nghttp2_error.NGHTTP2_ERR_DEFERRED`\n without reading any data in this invocation.  The library removes\n DATA frame from the outgoing queue temporarily.  To move back\n deferred DATA frame to outgoing queue, call\n `nghttp2_session_resume_data()`.\n\n By default, |length| is limited to 16KiB at maximum.  If peer\n allows larger frames, application can enlarge transmission buffer\n size.  See :type:`nghttp2_data_source_read_length_callback` for\n more details.\n\n If the application just wants to return from\n `nghttp2_session_send()` or `nghttp2_session_mem_send()` without\n sending anything, return :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE`.\n\n In case of error, there are 2 choices. Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will\n close the stream by issuing RST_STREAM with\n :enum:`nghttp2_error_code.NGHTTP2_INTERNAL_ERROR`.  If a different\n error code is desirable, use `nghttp2_submit_rst_stream()` with a\n desired error code and then return\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.\n Returning :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` will\n signal the entire session failure."]
291pub type nghttp2_data_source_read_callback = ::std::option::Option<
292    unsafe extern "C" fn(
293        session: *mut nghttp2_session,
294        stream_id: i32,
295        buf: *mut u8,
296        length: usize,
297        data_flags: *mut u32,
298        source: *mut nghttp2_data_source,
299        user_data: *mut ::std::os::raw::c_void,
300    ) -> isize,
301>;
302#[doc = " @functypedef\n\n Callback function invoked when the library wants to read data from\n the |source|.  The read data is sent in the stream |stream_id|.\n The implementation of this function must read at most |length|\n bytes of data from |source| (or possibly other places) and store\n them in |buf| and return number of data stored in |buf|.  If EOF is\n reached, set :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_EOF` flag\n in |*data_flags|.\n\n Sometime it is desirable to avoid copying data into |buf| and let\n application to send data directly.  To achieve this, set\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_COPY` to\n |*data_flags| (and possibly other flags, just like when we do\n copy), and return the number of bytes to send without copying data\n into |buf|.  The library, seeing\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_COPY`, will invoke\n :type:`nghttp2_send_data_callback`.  The application must send\n complete DATA frame in that callback.\n\n If this callback is set by `nghttp2_submit_request2()`,\n `nghttp2_submit_response2()` or `nghttp2_submit_headers()` and\n `nghttp2_submit_data2()` with flag parameter\n :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM` set, and\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_EOF` flag is set to\n |*data_flags|, DATA frame will have END_STREAM flag set.  Usually,\n this is expected behaviour and all are fine.  One exception is send\n trailer fields.  You cannot send trailer fields after sending frame\n with END_STREAM set.  To avoid this problem, one can set\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_END_STREAM` along\n with :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_EOF` to signal the\n library not to set END_STREAM in DATA frame.  Then application can\n use `nghttp2_submit_trailer()` to send trailer fields.\n `nghttp2_submit_trailer()` can be called inside this callback.\n\n If the application wants to postpone DATA frames (e.g.,\n asynchronous I/O, or reading data blocks for long time), it is\n achieved by returning :enum:`nghttp2_error.NGHTTP2_ERR_DEFERRED`\n without reading any data in this invocation.  The library removes\n DATA frame from the outgoing queue temporarily.  To move back\n deferred DATA frame to outgoing queue, call\n `nghttp2_session_resume_data()`.\n\n By default, |length| is limited to 16KiB at maximum.  If peer\n allows larger frames, application can enlarge transmission buffer\n size.  See :type:`nghttp2_data_source_read_length_callback` for\n more details.\n\n If the application just wants to return from\n `nghttp2_session_send()` or `nghttp2_session_mem_send2()` without\n sending anything, return :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE`.\n\n In case of error, there are 2 choices. Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will\n close the stream by issuing RST_STREAM with\n :enum:`nghttp2_error_code.NGHTTP2_INTERNAL_ERROR`.  If a different\n error code is desirable, use `nghttp2_submit_rst_stream()` with a\n desired error code and then return\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.\n Returning :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` will\n signal the entire session failure."]
303pub type nghttp2_data_source_read_callback2 = ::std::option::Option<
304    unsafe extern "C" fn(
305        session: *mut nghttp2_session,
306        stream_id: i32,
307        buf: *mut u8,
308        length: usize,
309        data_flags: *mut u32,
310        source: *mut nghttp2_data_source,
311        user_data: *mut ::std::os::raw::c_void,
312    ) -> nghttp2_ssize,
313>;
314#[doc = " @struct\n\n .. warning::\n\n   Deprecated.  Use :type:`nghttp2_data_provider2` instead.\n\n This struct represents the data source and the way to read a chunk\n of data from it."]
315#[repr(C)]
316#[derive(Copy, Clone)]
317pub struct nghttp2_data_provider {
318    #[doc = " The data source."]
319    pub source: nghttp2_data_source,
320    #[doc = " The callback function to read a chunk of data from the |source|."]
321    pub read_callback: nghttp2_data_source_read_callback,
322}
323#[doc = " @struct\n\n This struct represents the data source and the way to read a chunk\n of data from it."]
324#[repr(C)]
325#[derive(Copy, Clone)]
326pub struct nghttp2_data_provider2 {
327    #[doc = " The data source."]
328    pub source: nghttp2_data_source,
329    #[doc = " The callback function to read a chunk of data from the |source|."]
330    pub read_callback: nghttp2_data_source_read_callback2,
331}
332#[doc = " @struct\n\n The DATA frame.  The received data is delivered via\n :type:`nghttp2_on_data_chunk_recv_callback`."]
333#[repr(C)]
334#[derive(Debug, Copy, Clone)]
335pub struct nghttp2_data {
336    pub hd: nghttp2_frame_hd,
337    #[doc = " The length of the padding in this frame.  This includes PAD_HIGH\n and PAD_LOW."]
338    pub padlen: usize,
339}
340#[doc = " The HEADERS frame is opening new stream, which is analogous to\n SYN_STREAM in SPDY."]
341pub const NGHTTP2_HCAT_REQUEST: nghttp2_headers_category = 0;
342#[doc = " The HEADERS frame is the first response headers, which is\n analogous to SYN_REPLY in SPDY."]
343pub const NGHTTP2_HCAT_RESPONSE: nghttp2_headers_category = 1;
344#[doc = " The HEADERS frame is the first headers sent against reserved\n stream."]
345pub const NGHTTP2_HCAT_PUSH_RESPONSE: nghttp2_headers_category = 2;
346#[doc = " The HEADERS frame which does not apply for the above categories,\n which is analogous to HEADERS in SPDY.  If non-final response\n (e.g., status 1xx) is used, final response HEADERS frame will be\n categorized here."]
347pub const NGHTTP2_HCAT_HEADERS: nghttp2_headers_category = 3;
348#[doc = " @enum\n\n The category of HEADERS, which indicates the role of the frame.  In\n HTTP/2 spec, request, response, push response and other arbitrary\n headers (e.g., trailer fields) are all called just HEADERS.  To\n give the application the role of incoming HEADERS frame, we define\n several categories."]
349pub type nghttp2_headers_category = ::std::os::raw::c_uint;
350#[doc = " @struct\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n The structure to specify stream dependency."]
351#[repr(C)]
352#[derive(Debug, Copy, Clone)]
353pub struct nghttp2_priority_spec {
354    #[doc = " The stream ID of the stream to depend on.  Specifying 0 makes\n stream not depend any other stream."]
355    pub stream_id: i32,
356    #[doc = " The weight of this dependency."]
357    pub weight: i32,
358    #[doc = " nonzero means exclusive dependency"]
359    pub exclusive: u8,
360}
361#[doc = " @struct\n\n The HEADERS frame.  It has the following members:"]
362#[repr(C)]
363#[derive(Debug, Copy, Clone)]
364pub struct nghttp2_headers {
365    #[doc = " The frame header."]
366    pub hd: nghttp2_frame_hd,
367    #[doc = " The length of the padding in this frame.  This includes PAD_HIGH\n and PAD_LOW."]
368    pub padlen: usize,
369    #[doc = " .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n The priority specification"]
370    pub pri_spec: nghttp2_priority_spec,
371    #[doc = " The name/value pairs."]
372    pub nva: *mut nghttp2_nv,
373    #[doc = " The number of name/value pairs in |nva|."]
374    pub nvlen: usize,
375    #[doc = " The category of this HEADERS frame."]
376    pub cat: nghttp2_headers_category,
377}
378#[doc = " @struct\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n The PRIORITY frame.  It has the following members:"]
379#[repr(C)]
380#[derive(Debug, Copy, Clone)]
381pub struct nghttp2_priority {
382    #[doc = " The frame header."]
383    pub hd: nghttp2_frame_hd,
384    #[doc = " The priority specification."]
385    pub pri_spec: nghttp2_priority_spec,
386}
387#[doc = " @struct\n\n The RST_STREAM frame.  It has the following members:"]
388#[repr(C)]
389#[derive(Debug, Copy, Clone)]
390pub struct nghttp2_rst_stream {
391    #[doc = " The frame header."]
392    pub hd: nghttp2_frame_hd,
393    #[doc = " The error code.  See :type:`nghttp2_error_code`."]
394    pub error_code: u32,
395}
396#[doc = " @struct\n\n The SETTINGS ID/Value pair.  It has the following members:"]
397#[repr(C)]
398#[derive(Debug, Copy, Clone)]
399pub struct nghttp2_settings_entry {
400    #[doc = " The SETTINGS ID.  See :type:`nghttp2_settings_id`."]
401    pub settings_id: i32,
402    #[doc = " The value of this entry."]
403    pub value: u32,
404}
405#[doc = " @struct\n\n The SETTINGS frame.  It has the following members:"]
406#[repr(C)]
407#[derive(Debug, Copy, Clone)]
408pub struct nghttp2_settings {
409    #[doc = " The frame header."]
410    pub hd: nghttp2_frame_hd,
411    #[doc = " The number of SETTINGS ID/Value pairs in |iv|."]
412    pub niv: usize,
413    #[doc = " The pointer to the array of SETTINGS ID/Value pair."]
414    pub iv: *mut nghttp2_settings_entry,
415}
416#[doc = " @struct\n\n The PUSH_PROMISE frame.  It has the following members:"]
417#[repr(C)]
418#[derive(Debug, Copy, Clone)]
419pub struct nghttp2_push_promise {
420    #[doc = " The frame header."]
421    pub hd: nghttp2_frame_hd,
422    #[doc = " The length of the padding in this frame.  This includes PAD_HIGH\n and PAD_LOW."]
423    pub padlen: usize,
424    #[doc = " The name/value pairs."]
425    pub nva: *mut nghttp2_nv,
426    #[doc = " The number of name/value pairs in |nva|."]
427    pub nvlen: usize,
428    #[doc = " The promised stream ID"]
429    pub promised_stream_id: i32,
430    #[doc = " Reserved bit.  Currently this is always set to 0 and application\n should not expect something useful in here."]
431    pub reserved: u8,
432}
433#[doc = " @struct\n\n The PING frame.  It has the following members:"]
434#[repr(C)]
435#[derive(Debug, Copy, Clone)]
436pub struct nghttp2_ping {
437    #[doc = " The frame header."]
438    pub hd: nghttp2_frame_hd,
439    #[doc = " The opaque data"]
440    pub opaque_data: [u8; 8usize],
441}
442#[doc = " @struct\n\n The GOAWAY frame.  It has the following members:"]
443#[repr(C)]
444#[derive(Debug, Copy, Clone)]
445pub struct nghttp2_goaway {
446    #[doc = " The frame header."]
447    pub hd: nghttp2_frame_hd,
448    #[doc = " The last stream stream ID."]
449    pub last_stream_id: i32,
450    #[doc = " The error code.  See :type:`nghttp2_error_code`."]
451    pub error_code: u32,
452    #[doc = " The additional debug data"]
453    pub opaque_data: *mut u8,
454    #[doc = " The length of |opaque_data| member."]
455    pub opaque_data_len: usize,
456    #[doc = " Reserved bit.  Currently this is always set to 0 and application\n should not expect something useful in here."]
457    pub reserved: u8,
458}
459#[doc = " @struct\n\n The WINDOW_UPDATE frame.  It has the following members:"]
460#[repr(C)]
461#[derive(Debug, Copy, Clone)]
462pub struct nghttp2_window_update {
463    #[doc = " The frame header."]
464    pub hd: nghttp2_frame_hd,
465    #[doc = " The window size increment."]
466    pub window_size_increment: i32,
467    #[doc = " Reserved bit.  Currently this is always set to 0 and application\n should not expect something useful in here."]
468    pub reserved: u8,
469}
470#[doc = " @struct\n\n The extension frame.  It has following members:"]
471#[repr(C)]
472#[derive(Debug, Copy, Clone)]
473pub struct nghttp2_extension {
474    #[doc = " The frame header."]
475    pub hd: nghttp2_frame_hd,
476    #[doc = " The pointer to extension payload.  The exact pointer type is\n determined by hd.type.\n\n Currently, no extension is supported.  This is a place holder for\n the future extensions."]
477    pub payload: *mut ::std::os::raw::c_void,
478}
479#[doc = " @union\n\n This union includes all frames to pass them to various function\n calls as nghttp2_frame type.  The CONTINUATION frame is omitted\n from here because the library deals with it internally."]
480#[repr(C)]
481#[derive(Copy, Clone)]
482pub union nghttp2_frame {
483    #[doc = " The frame header, which is convenient to inspect frame header."]
484    pub hd: nghttp2_frame_hd,
485    #[doc = " The DATA frame."]
486    pub data: nghttp2_data,
487    #[doc = " The HEADERS frame."]
488    pub headers: nghttp2_headers,
489    #[doc = " The PRIORITY frame."]
490    pub priority: nghttp2_priority,
491    #[doc = " The RST_STREAM frame."]
492    pub rst_stream: nghttp2_rst_stream,
493    #[doc = " The SETTINGS frame."]
494    pub settings: nghttp2_settings,
495    #[doc = " The PUSH_PROMISE frame."]
496    pub push_promise: nghttp2_push_promise,
497    #[doc = " The PING frame."]
498    pub ping: nghttp2_ping,
499    #[doc = " The GOAWAY frame."]
500    pub goaway: nghttp2_goaway,
501    #[doc = " The WINDOW_UPDATE frame."]
502    pub window_update: nghttp2_window_update,
503    #[doc = " The extension frame."]
504    pub ext: nghttp2_extension,
505}
506#[doc = " @functypedef\n\n .. warning::\n\n   Deprecated.  Use :type:`nghttp2_send_callback2` instead.\n\n Callback function invoked when |session| wants to send data to the\n remote peer.  The implementation of this function must send at most\n |length| bytes of data stored in |data|.  The |flags| is currently\n not used and always 0. It must return the number of bytes sent if\n it succeeds.  If it cannot send any single byte without blocking,\n it must return :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`.  For\n other errors, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  The\n |user_data| pointer is the third argument passed in to the call to\n `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.\n\n This callback is required if the application uses\n `nghttp2_session_send()` to send data to the remote endpoint.  If\n the application uses solely `nghttp2_session_mem_send()` instead,\n this callback function is unnecessary.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_send_callback()`.\n\n .. note::\n\n   The |length| may be very small.  If that is the case, and\n   application disables Nagle algorithm (``TCP_NODELAY``), then just\n   writing |data| to the network stack leads to very small packet,\n   and it is very inefficient.  An application should be responsible\n   to buffer up small chunks of data as necessary to avoid this\n   situation."]
507pub type nghttp2_send_callback = ::std::option::Option<
508    unsafe extern "C" fn(
509        session: *mut nghttp2_session,
510        data: *const u8,
511        length: usize,
512        flags: ::std::os::raw::c_int,
513        user_data: *mut ::std::os::raw::c_void,
514    ) -> isize,
515>;
516#[doc = " @functypedef\n\n Callback function invoked when |session| wants to send data to the\n remote peer.  The implementation of this function must send at most\n |length| bytes of data stored in |data|.  The |flags| is currently\n not used and always 0. It must return the number of bytes sent if\n it succeeds.  If it cannot send any single byte without blocking,\n it must return :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`.  For\n other errors, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  The\n |user_data| pointer is the third argument passed in to the call to\n `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.\n\n This callback is required if the application uses\n `nghttp2_session_send()` to send data to the remote endpoint.  If\n the application uses solely `nghttp2_session_mem_send2()` instead,\n this callback function is unnecessary.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_send_callback2()`.\n\n .. note::\n\n   The |length| may be very small.  If that is the case, and\n   application disables Nagle algorithm (``TCP_NODELAY``), then just\n   writing |data| to the network stack leads to very small packet,\n   and it is very inefficient.  An application should be responsible\n   to buffer up small chunks of data as necessary to avoid this\n   situation."]
517pub type nghttp2_send_callback2 = ::std::option::Option<
518    unsafe extern "C" fn(
519        session: *mut nghttp2_session,
520        data: *const u8,
521        length: usize,
522        flags: ::std::os::raw::c_int,
523        user_data: *mut ::std::os::raw::c_void,
524    ) -> nghttp2_ssize,
525>;
526#[doc = " @functypedef\n\n Callback function invoked when\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_COPY` is used in\n :type:`nghttp2_data_source_read_callback` to send complete DATA\n frame.\n\n The |frame| is a DATA frame to send.  The |framehd| is the\n serialized frame header (9 bytes). The |length| is the length of\n application data to send (this does not include padding).  The\n |source| is the same pointer passed to\n :type:`nghttp2_data_source_read_callback`.\n\n The application first must send frame header |framehd| of length 9\n bytes.  If ``frame->data.padlen > 0``, send 1 byte of value\n ``frame->data.padlen - 1``.  Then send exactly |length| bytes of\n application data.  Finally, if ``frame->data.padlen > 1``, send\n ``frame->data.padlen - 1`` bytes of zero as padding.\n\n The application has to send complete DATA frame in this callback.\n If all data were written successfully, return 0.\n\n If it cannot send any data at all, just return\n :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`; the library will call\n this callback with the same parameters later (It is recommended to\n send complete DATA frame at once in this function to deal with\n error; if partial frame data has already sent, it is impossible to\n send another data in that state, and all we can do is tear down\n connection).  When data is fully processed, but application wants\n to make `nghttp2_session_mem_send2()` or `nghttp2_session_send()`\n return immediately without processing next frames, return\n :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE`.  If application decided to\n reset this stream, return\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`, then\n the library will send RST_STREAM with INTERNAL_ERROR as error code.\n The application can also return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`, which will\n result in connection closure.  Returning any other value is treated\n as :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` is returned."]
527pub type nghttp2_send_data_callback = ::std::option::Option<
528    unsafe extern "C" fn(
529        session: *mut nghttp2_session,
530        frame: *mut nghttp2_frame,
531        framehd: *const u8,
532        length: usize,
533        source: *mut nghttp2_data_source,
534        user_data: *mut ::std::os::raw::c_void,
535    ) -> ::std::os::raw::c_int,
536>;
537#[doc = " @functypedef\n\n .. warning::\n\n   Deprecated.  Use :type:`nghttp2_recv_callback2` instead.\n\n Callback function invoked when |session| wants to receive data from\n the remote peer.  The implementation of this function must read at\n most |length| bytes of data and store it in |buf|.  The |flags| is\n currently not used and always 0.  It must return the number of\n bytes written in |buf| if it succeeds.  If it cannot read any\n single byte without blocking, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`.  If it gets EOF\n before it reads any single byte, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_EOF`.  For other errors, it must\n return :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n Returning 0 is treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`.  The |user_data|\n pointer is the third argument passed in to the call to\n `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.\n\n This callback is required if the application uses\n `nghttp2_session_recv()` to receive data from the remote endpoint.\n If the application uses solely `nghttp2_session_mem_recv()`\n instead, this callback function is unnecessary.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_recv_callback()`."]
538pub type nghttp2_recv_callback = ::std::option::Option<
539    unsafe extern "C" fn(
540        session: *mut nghttp2_session,
541        buf: *mut u8,
542        length: usize,
543        flags: ::std::os::raw::c_int,
544        user_data: *mut ::std::os::raw::c_void,
545    ) -> isize,
546>;
547#[doc = " @functypedef\n\n Callback function invoked when |session| wants to receive data from\n the remote peer.  The implementation of this function must read at\n most |length| bytes of data and store it in |buf|.  The |flags| is\n currently not used and always 0.  It must return the number of\n bytes written in |buf| if it succeeds.  If it cannot read any\n single byte without blocking, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`.  If it gets EOF\n before it reads any single byte, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_EOF`.  For other errors, it must\n return :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n Returning 0 is treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`.  The |user_data|\n pointer is the third argument passed in to the call to\n `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.\n\n This callback is required if the application uses\n `nghttp2_session_recv()` to receive data from the remote endpoint.\n If the application uses solely `nghttp2_session_mem_recv2()`\n instead, this callback function is unnecessary.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_recv_callback2()`."]
548pub type nghttp2_recv_callback2 = ::std::option::Option<
549    unsafe extern "C" fn(
550        session: *mut nghttp2_session,
551        buf: *mut u8,
552        length: usize,
553        flags: ::std::os::raw::c_int,
554        user_data: *mut ::std::os::raw::c_void,
555    ) -> nghttp2_ssize,
556>;
557#[doc = " @functypedef\n\n Callback function invoked by `nghttp2_session_recv()` and\n `nghttp2_session_mem_recv2()` when a frame is received.  The\n |user_data| pointer is the third argument passed in to the call to\n `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.\n\n If frame is HEADERS or PUSH_PROMISE, the ``nva`` and ``nvlen``\n member of their data structure are always ``NULL`` and 0\n respectively.  The header name/value pairs are emitted via\n :type:`nghttp2_on_header_callback`.\n\n Only HEADERS and DATA frame can signal the end of incoming data.\n If ``frame->hd.flags & NGHTTP2_FLAG_END_STREAM`` is nonzero, the\n |frame| is the last frame from the remote peer in this stream.\n\n This callback won't be called for CONTINUATION frames.\n HEADERS/PUSH_PROMISE + CONTINUATIONs are treated as single frame.\n\n The implementation of this function must return 0 if it succeeds.\n If nonzero value is returned, it is treated as fatal error and\n `nghttp2_session_recv()` and `nghttp2_session_mem_recv2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_frame_recv_callback()`."]
558pub type nghttp2_on_frame_recv_callback = ::std::option::Option<
559    unsafe extern "C" fn(
560        session: *mut nghttp2_session,
561        frame: *const nghttp2_frame,
562        user_data: *mut ::std::os::raw::c_void,
563    ) -> ::std::os::raw::c_int,
564>;
565#[doc = " @functypedef\n\n Callback function invoked by `nghttp2_session_recv()` and\n `nghttp2_session_mem_recv2()` when an invalid non-DATA frame is\n received.  The error is indicated by the |lib_error_code|, which is\n one of the values defined in :type:`nghttp2_error`.  When this\n callback function is invoked, the library automatically submits\n either RST_STREAM or GOAWAY frame.  The |user_data| pointer is the\n third argument passed in to the call to\n `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.\n\n If frame is HEADERS or PUSH_PROMISE, the ``nva`` and ``nvlen``\n member of their data structure are always ``NULL`` and 0\n respectively.\n\n The implementation of this function must return 0 if it succeeds.\n If nonzero is returned, it is treated as fatal error and\n `nghttp2_session_recv()` and `nghttp2_session_mem_recv2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_invalid_frame_recv_callback()`."]
566pub type nghttp2_on_invalid_frame_recv_callback = ::std::option::Option<
567    unsafe extern "C" fn(
568        session: *mut nghttp2_session,
569        frame: *const nghttp2_frame,
570        lib_error_code: ::std::os::raw::c_int,
571        user_data: *mut ::std::os::raw::c_void,
572    ) -> ::std::os::raw::c_int,
573>;
574#[doc = " @functypedef\n\n Callback function invoked when a chunk of data in DATA frame is\n received.  The |stream_id| is the stream ID this DATA frame belongs\n to.  The |flags| is the flags of DATA frame which this data chunk\n is contained.  ``(flags & NGHTTP2_FLAG_END_STREAM) != 0`` does not\n necessarily mean this chunk of data is the last one in the stream.\n You should use :type:`nghttp2_on_frame_recv_callback` to know all\n data frames are received.  The |user_data| pointer is the third\n argument passed in to the call to `nghttp2_session_client_new()` or\n `nghttp2_session_server_new()`.\n\n If the application uses `nghttp2_session_mem_recv2()`, it can\n return :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE` to make\n `nghttp2_session_mem_recv2()` return without processing further\n input bytes.  The memory by pointed by the |data| is retained until\n `nghttp2_session_mem_recv2()` or `nghttp2_session_recv()` is\n called.  The application must retain the input bytes which was used\n to produce the |data| parameter, because it may refer to the memory\n region included in the input bytes.\n\n The implementation of this function must return 0 if it succeeds.\n If nonzero is returned, it is treated as fatal error, and\n `nghttp2_session_recv()` and `nghttp2_session_mem_recv2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_data_chunk_recv_callback()`."]
575pub type nghttp2_on_data_chunk_recv_callback = ::std::option::Option<
576    unsafe extern "C" fn(
577        session: *mut nghttp2_session,
578        flags: u8,
579        stream_id: i32,
580        data: *const u8,
581        len: usize,
582        user_data: *mut ::std::os::raw::c_void,
583    ) -> ::std::os::raw::c_int,
584>;
585#[doc = " @functypedef\n\n Callback function invoked just before the non-DATA frame |frame| is\n sent.  The |user_data| pointer is the third argument passed in to\n the call to `nghttp2_session_client_new()` or\n `nghttp2_session_server_new()`.\n\n The implementation of this function must return 0 if it succeeds.\n It can also return :enum:`nghttp2_error.NGHTTP2_ERR_CANCEL` to\n cancel the transmission of the given frame.\n\n If there is a fatal error while executing this callback, the\n implementation should return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`, which makes\n `nghttp2_session_send()` and `nghttp2_session_mem_send2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n If the other value is returned, it is treated as if\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` is returned.\n But the implementation should not rely on this since the library\n may define new return value to extend its capability.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_before_frame_send_callback()`."]
586pub type nghttp2_before_frame_send_callback = ::std::option::Option<
587    unsafe extern "C" fn(
588        session: *mut nghttp2_session,
589        frame: *const nghttp2_frame,
590        user_data: *mut ::std::os::raw::c_void,
591    ) -> ::std::os::raw::c_int,
592>;
593#[doc = " @functypedef\n\n Callback function invoked after the frame |frame| is sent.  The\n |user_data| pointer is the third argument passed in to the call to\n `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.\n\n The implementation of this function must return 0 if it succeeds.\n If nonzero is returned, it is treated as fatal error and\n `nghttp2_session_send()` and `nghttp2_session_mem_send2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_frame_send_callback()`."]
594pub type nghttp2_on_frame_send_callback = ::std::option::Option<
595    unsafe extern "C" fn(
596        session: *mut nghttp2_session,
597        frame: *const nghttp2_frame,
598        user_data: *mut ::std::os::raw::c_void,
599    ) -> ::std::os::raw::c_int,
600>;
601#[doc = " @functypedef\n\n Callback function invoked after the non-DATA frame |frame| is not\n sent because of the error.  The error is indicated by the\n |lib_error_code|, which is one of the values defined in\n :type:`nghttp2_error`.  The |user_data| pointer is the third\n argument passed in to the call to `nghttp2_session_client_new()` or\n `nghttp2_session_server_new()`.\n\n The implementation of this function must return 0 if it succeeds.\n If nonzero is returned, it is treated as fatal error and\n `nghttp2_session_send()` and `nghttp2_session_mem_send2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n `nghttp2_session_get_stream_user_data()` can be used to get\n associated data.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_frame_not_send_callback()`."]
602pub type nghttp2_on_frame_not_send_callback = ::std::option::Option<
603    unsafe extern "C" fn(
604        session: *mut nghttp2_session,
605        frame: *const nghttp2_frame,
606        lib_error_code: ::std::os::raw::c_int,
607        user_data: *mut ::std::os::raw::c_void,
608    ) -> ::std::os::raw::c_int,
609>;
610#[doc = " @functypedef\n\n Callback function invoked when the stream |stream_id| is closed.\n The reason of closure is indicated by the |error_code|.  The\n |error_code| is usually one of :enum:`nghttp2_error_code`, but that\n is not guaranteed.  The stream_user_data, which was specified in\n `nghttp2_submit_request2()` or `nghttp2_submit_headers()`, is still\n available in this function.  The |user_data| pointer is the third\n argument passed in to the call to `nghttp2_session_client_new()` or\n `nghttp2_session_server_new()`.\n\n This function is also called for a stream in reserved state.\n\n The implementation of this function must return 0 if it succeeds.\n If nonzero is returned, it is treated as fatal error and\n `nghttp2_session_recv()`, `nghttp2_session_mem_recv2()`,\n `nghttp2_session_send()`, and `nghttp2_session_mem_send2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_stream_close_callback()`."]
611pub type nghttp2_on_stream_close_callback = ::std::option::Option<
612    unsafe extern "C" fn(
613        session: *mut nghttp2_session,
614        stream_id: i32,
615        error_code: u32,
616        user_data: *mut ::std::os::raw::c_void,
617    ) -> ::std::os::raw::c_int,
618>;
619#[doc = " @functypedef\n\n Callback function invoked when the reception of header block in\n HEADERS or PUSH_PROMISE is started.  Each header name/value pair\n will be emitted by :type:`nghttp2_on_header_callback`.\n\n The ``frame->hd.flags`` may not have\n :enum:`nghttp2_flag.NGHTTP2_FLAG_END_HEADERS` flag set, which\n indicates that one or more CONTINUATION frames are involved.  But\n the application does not need to care about that because the header\n name/value pairs are emitted transparently regardless of\n CONTINUATION frames.\n\n The server applications probably create an object to store\n information about new stream if ``frame->hd.type ==\n NGHTTP2_HEADERS`` and ``frame->headers.cat ==\n NGHTTP2_HCAT_REQUEST``.  If |session| is configured as server side,\n ``frame->headers.cat`` is either ``NGHTTP2_HCAT_REQUEST``\n containing request headers or ``NGHTTP2_HCAT_HEADERS`` containing\n trailer fields and never get PUSH_PROMISE in this callback.\n\n For the client applications, ``frame->hd.type`` is either\n ``NGHTTP2_HEADERS`` or ``NGHTTP2_PUSH_PROMISE``.  In case of\n ``NGHTTP2_HEADERS``, ``frame->headers.cat ==\n NGHTTP2_HCAT_RESPONSE`` means that it is the first response\n headers, but it may be non-final response which is indicated by 1xx\n status code.  In this case, there may be zero or more HEADERS frame\n with ``frame->headers.cat == NGHTTP2_HCAT_HEADERS`` which has\n non-final response code and finally client gets exactly one HEADERS\n frame with ``frame->headers.cat == NGHTTP2_HCAT_HEADERS``\n containing final response headers (non-1xx status code).  The\n trailer fields also has ``frame->headers.cat ==\n NGHTTP2_HCAT_HEADERS`` which does not contain any status code.\n\n Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will\n close the stream (promised stream if frame is PUSH_PROMISE) by\n issuing RST_STREAM with\n :enum:`nghttp2_error_code.NGHTTP2_INTERNAL_ERROR`.  In this case,\n :type:`nghttp2_on_header_callback` and\n :type:`nghttp2_on_frame_recv_callback` will not be invoked.  If a\n different error code is desirable, use\n `nghttp2_submit_rst_stream()` with a desired error code and then\n return :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.\n Again, use ``frame->push_promise.promised_stream_id`` as stream_id\n parameter in `nghttp2_submit_rst_stream()` if frame is\n PUSH_PROMISE.\n\n The implementation of this function must return 0 if it succeeds.\n It can return\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` to\n reset the stream (promised stream if frame is PUSH_PROMISE).  For\n critical errors, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the other\n value is returned, it is treated as if\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` is returned.  If\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` is returned,\n `nghttp2_session_mem_recv2()` function will immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_begin_headers_callback()`."]
620pub type nghttp2_on_begin_headers_callback = ::std::option::Option<
621    unsafe extern "C" fn(
622        session: *mut nghttp2_session,
623        frame: *const nghttp2_frame,
624        user_data: *mut ::std::os::raw::c_void,
625    ) -> ::std::os::raw::c_int,
626>;
627#[doc = " @functypedef\n\n Callback function invoked when a header name/value pair is received\n for the |frame|.  The |name| of length |namelen| is header name.\n The |value| of length |valuelen| is header value.  The |flags| is\n bitwise OR of one or more of :type:`nghttp2_nv_flag`.\n\n If :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_INDEX` is set in\n |flags|, the receiver must not index this name/value pair when\n forwarding it to the next hop.  More specifically, \"Literal Header\n Field never Indexed\" representation must be used in HPACK encoding.\n\n When this callback is invoked, ``frame->hd.type`` is either\n :enum:`nghttp2_frame_type.NGHTTP2_HEADERS` or\n :enum:`nghttp2_frame_type.NGHTTP2_PUSH_PROMISE`.  After all header\n name/value pairs are processed with this callback, and no error has\n been detected, :type:`nghttp2_on_frame_recv_callback` will be\n invoked.  If there is an error in decompression,\n :type:`nghttp2_on_frame_recv_callback` for the |frame| will not be\n invoked.\n\n Both |name| and |value| are guaranteed to be NULL-terminated.  The\n |namelen| and |valuelen| do not include terminal NULL.  If\n `nghttp2_option_set_no_http_messaging()` is used with nonzero\n value, NULL character may be included in |name| or |value| before\n terminating NULL.\n\n Please note that unless `nghttp2_option_set_no_http_messaging()` is\n used, nghttp2 library does perform validation against the |name|\n and the |value| using `nghttp2_check_header_name()` and\n `nghttp2_check_header_value()`.  In addition to this, nghttp2\n performs validation based on HTTP Messaging rule, which is briefly\n explained in :ref:`http-messaging` section.\n\n If the application uses `nghttp2_session_mem_recv2()`, it can\n return :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE` to make\n `nghttp2_session_mem_recv2()` return without processing further\n input bytes.  The memory pointed by |frame|, |name| and |value|\n parameters are retained until `nghttp2_session_mem_recv2()` or\n `nghttp2_session_recv()` is called.  The application must retain\n the input bytes which was used to produce these parameters, because\n it may refer to the memory region included in the input bytes.\n\n Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will\n close the stream (promised stream if frame is PUSH_PROMISE) by\n issuing RST_STREAM with\n :enum:`nghttp2_error_code.NGHTTP2_INTERNAL_ERROR`.  In this case,\n :type:`nghttp2_on_header_callback` and\n :type:`nghttp2_on_frame_recv_callback` will not be invoked.  If a\n different error code is desirable, use\n `nghttp2_submit_rst_stream()` with a desired error code and then\n return :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.\n Again, use ``frame->push_promise.promised_stream_id`` as stream_id\n parameter in `nghttp2_submit_rst_stream()` if frame is\n PUSH_PROMISE.\n\n The implementation of this function must return 0 if it succeeds.\n It may return :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE` or\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.  For\n other critical failures, it must return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the other\n nonzero value is returned, it is treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` is returned,\n `nghttp2_session_recv()` and `nghttp2_session_mem_recv2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_header_callback()`.\n\n .. warning::\n\n   Application should properly limit the total buffer size to store\n   incoming header fields.  Without it, peer may send large number\n   of header fields or large header fields to cause out of memory in\n   local endpoint.  Due to how HPACK works, peer can do this\n   effectively without using much memory on their own."]
628pub type nghttp2_on_header_callback = ::std::option::Option<
629    unsafe extern "C" fn(
630        session: *mut nghttp2_session,
631        frame: *const nghttp2_frame,
632        name: *const u8,
633        namelen: usize,
634        value: *const u8,
635        valuelen: usize,
636        flags: u8,
637        user_data: *mut ::std::os::raw::c_void,
638    ) -> ::std::os::raw::c_int,
639>;
640#[doc = " @functypedef\n\n Callback function invoked when a header name/value pair is received\n for the |frame|.  The |name| is header name.  The |value| is header\n value.  The |flags| is bitwise OR of one or more of\n :type:`nghttp2_nv_flag`.\n\n This callback behaves like :type:`nghttp2_on_header_callback`,\n except that |name| and |value| are stored in reference counted\n buffer.  If application wishes to keep these references without\n copying them, use `nghttp2_rcbuf_incref()` to increment their\n reference count.  It is the application's responsibility to call\n `nghttp2_rcbuf_decref()` if they called `nghttp2_rcbuf_incref()` so\n as not to leak memory.  If the |session| is created by\n `nghttp2_session_server_new3()` or `nghttp2_session_client_new3()`,\n the function to free memory is the one belongs to the mem\n parameter.  As long as this free function alives, |name| and\n |value| can live after |session| was destroyed."]
641pub type nghttp2_on_header_callback2 = ::std::option::Option<
642    unsafe extern "C" fn(
643        session: *mut nghttp2_session,
644        frame: *const nghttp2_frame,
645        name: *mut nghttp2_rcbuf,
646        value: *mut nghttp2_rcbuf,
647        flags: u8,
648        user_data: *mut ::std::os::raw::c_void,
649    ) -> ::std::os::raw::c_int,
650>;
651#[doc = " @functypedef\n\n Callback function invoked when an invalid header name/value pair is\n received for the |frame|.\n\n The parameter and behaviour are similar to\n :type:`nghttp2_on_header_callback`.  The difference is that this\n callback is only invoked when an invalid header name/value pair is\n received which is treated as stream error if this callback returns\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` and\n :type:`nghttp2_on_invalid_header_callback2` is not set.  Only\n invalid regular header field are passed to this callback.  In other\n words, invalid pseudo header field is not passed to this callback.\n Also header fields which includes upper cased latter are also\n treated as error without passing them to this callback.\n\n This callback is only considered if HTTP messaging validation is\n turned on (which is on by default, see\n `nghttp2_option_set_no_http_messaging()`).\n\n With this callback, application inspects the incoming invalid\n field, and it also can reset stream from this callback by returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.  By\n default, the error code is\n :enum:`nghttp2_error_code.NGHTTP2_PROTOCOL_ERROR`.  To change the\n error code, call `nghttp2_submit_rst_stream()` with the error code\n of choice in addition to returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.\n\n If 0 is returned, the header field is ignored, and the stream is\n not reset."]
652pub type nghttp2_on_invalid_header_callback = ::std::option::Option<
653    unsafe extern "C" fn(
654        session: *mut nghttp2_session,
655        frame: *const nghttp2_frame,
656        name: *const u8,
657        namelen: usize,
658        value: *const u8,
659        valuelen: usize,
660        flags: u8,
661        user_data: *mut ::std::os::raw::c_void,
662    ) -> ::std::os::raw::c_int,
663>;
664#[doc = " @functypedef\n\n Callback function invoked when an invalid header name/value pair is\n received for the |frame|.\n\n The parameter and behaviour are similar to\n :type:`nghttp2_on_header_callback2`.  The difference is that this\n callback is only invoked when an invalid header name/value pair is\n received which is silently ignored if neither this callback nor\n :type:`nghttp2_on_invalid_header_callback` is set.  Only invalid\n regular header field are passed to this callback.  In other words,\n invalid pseudo header field is not passed to this callback.  Also\n header fields which includes upper cased latter are also treated as\n error without passing them to this callback.\n\n This callback is only considered if HTTP messaging validation is\n turned on (which is on by default, see\n `nghttp2_option_set_no_http_messaging()`).\n\n With this callback, application inspects the incoming invalid\n field, and it also can reset stream from this callback by returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.  By\n default, the error code is\n :enum:`nghttp2_error_code.NGHTTP2_INTERNAL_ERROR`.  To change the\n error code, call `nghttp2_submit_rst_stream()` with the error code\n of choice in addition to returning\n :enum:`nghttp2_error.NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`."]
665pub type nghttp2_on_invalid_header_callback2 = ::std::option::Option<
666    unsafe extern "C" fn(
667        session: *mut nghttp2_session,
668        frame: *const nghttp2_frame,
669        name: *mut nghttp2_rcbuf,
670        value: *mut nghttp2_rcbuf,
671        flags: u8,
672        user_data: *mut ::std::os::raw::c_void,
673    ) -> ::std::os::raw::c_int,
674>;
675#[doc = " @functypedef\n\n .. warning::\n\n   Deprecated.  Use :type:`nghttp2_select_padding_callback2`\n   instead.\n\n Callback function invoked when the library asks application how\n many padding bytes are required for the transmission of the\n |frame|.  The application must choose the total length of payload\n including padded bytes in range [frame->hd.length, max_payloadlen],\n inclusive.  Choosing number not in this range will be treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  Returning\n ``frame->hd.length`` means no padding is added.  Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` will make\n `nghttp2_session_send()` and `nghttp2_session_mem_send()` functions\n immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_select_padding_callback()`."]
676pub type nghttp2_select_padding_callback = ::std::option::Option<
677    unsafe extern "C" fn(
678        session: *mut nghttp2_session,
679        frame: *const nghttp2_frame,
680        max_payloadlen: usize,
681        user_data: *mut ::std::os::raw::c_void,
682    ) -> isize,
683>;
684#[doc = " @functypedef\n\n Callback function invoked when the library asks application how\n many padding bytes are required for the transmission of the\n |frame|.  The application must choose the total length of payload\n including padded bytes in range [frame->hd.length, max_payloadlen],\n inclusive.  Choosing number not in this range will be treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  Returning\n ``frame->hd.length`` means no padding is added.  Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` will make\n `nghttp2_session_send()` and `nghttp2_session_mem_send2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_select_padding_callback2()`."]
685pub type nghttp2_select_padding_callback2 = ::std::option::Option<
686    unsafe extern "C" fn(
687        session: *mut nghttp2_session,
688        frame: *const nghttp2_frame,
689        max_payloadlen: usize,
690        user_data: *mut ::std::os::raw::c_void,
691    ) -> nghttp2_ssize,
692>;
693#[doc = " @functypedef\n\n .. warning::\n\n   Deprecated.  Use\n   :type:`nghttp2_data_source_read_length_callback2` instead.\n\n Callback function invoked when library wants to get max length of\n data to send data to the remote peer.  The implementation of this\n function should return a value in the following range.  [1,\n min(|session_remote_window_size|, |stream_remote_window_size|,\n |remote_max_frame_size|)].  If a value greater than this range is\n returned than the max allow value will be used.  Returning a value\n smaller than this range is treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  The\n |frame_type| is provided for future extensibility and identifies\n the type of frame (see :type:`nghttp2_frame_type`) for which to get\n the length for.  Currently supported frame types are:\n :enum:`nghttp2_frame_type.NGHTTP2_DATA`.\n\n This callback can be used to control the length in bytes for which\n :type:`nghttp2_data_source_read_callback` is allowed to send to the\n remote endpoint.  This callback is optional.  Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` will signal the\n entire session failure.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_data_source_read_length_callback()`."]
694pub type nghttp2_data_source_read_length_callback = ::std::option::Option<
695    unsafe extern "C" fn(
696        session: *mut nghttp2_session,
697        frame_type: u8,
698        stream_id: i32,
699        session_remote_window_size: i32,
700        stream_remote_window_size: i32,
701        remote_max_frame_size: u32,
702        user_data: *mut ::std::os::raw::c_void,
703    ) -> isize,
704>;
705#[doc = " @functypedef\n\n Callback function invoked when library wants to get max length of\n data to send data to the remote peer.  The implementation of this\n function should return a value in the following range.  [1,\n min(|session_remote_window_size|, |stream_remote_window_size|,\n |remote_max_frame_size|)].  If a value greater than this range is\n returned than the max allow value will be used.  Returning a value\n smaller than this range is treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  The\n |frame_type| is provided for future extensibility and identifies\n the type of frame (see :type:`nghttp2_frame_type`) for which to get\n the length for.  Currently supported frame types are:\n :enum:`nghttp2_frame_type.NGHTTP2_DATA`.\n\n This callback can be used to control the length in bytes for which\n :type:`nghttp2_data_source_read_callback` is allowed to send to the\n remote endpoint.  This callback is optional.  Returning\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE` will signal the\n entire session failure.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_data_source_read_length_callback2()`."]
706pub type nghttp2_data_source_read_length_callback2 = ::std::option::Option<
707    unsafe extern "C" fn(
708        session: *mut nghttp2_session,
709        frame_type: u8,
710        stream_id: i32,
711        session_remote_window_size: i32,
712        stream_remote_window_size: i32,
713        remote_max_frame_size: u32,
714        user_data: *mut ::std::os::raw::c_void,
715    ) -> nghttp2_ssize,
716>;
717#[doc = " @functypedef\n\n Callback function invoked when a frame header is received.  The\n |hd| points to received frame header.\n\n Unlike :type:`nghttp2_on_frame_recv_callback`, this callback will\n also be called when frame header of CONTINUATION frame is received.\n\n If both :type:`nghttp2_on_begin_frame_callback` and\n :type:`nghttp2_on_begin_headers_callback` are set and HEADERS or\n PUSH_PROMISE is received, :type:`nghttp2_on_begin_frame_callback`\n will be called first.\n\n The implementation of this function must return 0 if it succeeds.\n If nonzero value is returned, it is treated as fatal error and\n `nghttp2_session_recv()` and `nghttp2_session_mem_recv2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n\n To set this callback to :type:`nghttp2_session_callbacks`, use\n `nghttp2_session_callbacks_set_on_begin_frame_callback()`."]
718pub type nghttp2_on_begin_frame_callback = ::std::option::Option<
719    unsafe extern "C" fn(
720        session: *mut nghttp2_session,
721        hd: *const nghttp2_frame_hd,
722        user_data: *mut ::std::os::raw::c_void,
723    ) -> ::std::os::raw::c_int,
724>;
725#[doc = " @functypedef\n\n Callback function invoked when chunk of extension frame payload is\n received.  The |hd| points to frame header.  The received\n chunk is |data| of length |len|.\n\n The implementation of this function must return 0 if it succeeds.\n\n To abort processing this extension frame, return\n :enum:`nghttp2_error.NGHTTP2_ERR_CANCEL`.\n\n If fatal error occurred, application should return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  In this case,\n `nghttp2_session_recv()` and `nghttp2_session_mem_recv2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the other\n values are returned, currently they are treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`."]
726pub type nghttp2_on_extension_chunk_recv_callback = ::std::option::Option<
727    unsafe extern "C" fn(
728        session: *mut nghttp2_session,
729        hd: *const nghttp2_frame_hd,
730        data: *const u8,
731        len: usize,
732        user_data: *mut ::std::os::raw::c_void,
733    ) -> ::std::os::raw::c_int,
734>;
735#[doc = " @functypedef\n\n Callback function invoked when library asks the application to\n unpack extension payload from its wire format.  The extension\n payload has been passed to the application using\n :type:`nghttp2_on_extension_chunk_recv_callback`.  The frame header\n is already unpacked by the library and provided as |hd|.\n\n To receive extension frames, the application must tell desired\n extension frame type to the library using\n `nghttp2_option_set_user_recv_extension_type()`.\n\n The implementation of this function may store the pointer to the\n created object as a result of unpacking in |*payload|, and returns\n 0.  The pointer stored in |*payload| is opaque to the library, and\n the library does not own its pointer.  |*payload| is initialized as\n ``NULL``.  The |*payload| is available as ``frame->ext.payload`` in\n :type:`nghttp2_on_frame_recv_callback`.  Therefore if application\n can free that memory inside :type:`nghttp2_on_frame_recv_callback`\n callback.  Of course, application has a liberty not to use\n |*payload|, and do its own mechanism to process extension frames.\n\n To abort processing this extension frame, return\n :enum:`nghttp2_error.NGHTTP2_ERR_CANCEL`.\n\n If fatal error occurred, application should return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  In this case,\n `nghttp2_session_recv()` and `nghttp2_session_mem_recv2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the other\n values are returned, currently they are treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`."]
736pub type nghttp2_unpack_extension_callback = ::std::option::Option<
737    unsafe extern "C" fn(
738        session: *mut nghttp2_session,
739        payload: *mut *mut ::std::os::raw::c_void,
740        hd: *const nghttp2_frame_hd,
741        user_data: *mut ::std::os::raw::c_void,
742    ) -> ::std::os::raw::c_int,
743>;
744#[doc = " @functypedef\n\n .. warning::\n\n   Deprecated.  Use :type:`nghttp2_pack_extension_callback2`\n   instead.\n\n Callback function invoked when library asks the application to pack\n extension payload in its wire format.  The frame header will be\n packed by library.  Application must pack payload only.\n ``frame->ext.payload`` is the object passed to\n `nghttp2_submit_extension()` as payload parameter.  Application\n must pack extension payload to the |buf| of its capacity |len|\n bytes.  The |len| is at least 16KiB.\n\n The implementation of this function should return the number of\n bytes written into |buf| when it succeeds.\n\n To abort processing this extension frame, return\n :enum:`nghttp2_error.NGHTTP2_ERR_CANCEL`, and\n :type:`nghttp2_on_frame_not_send_callback` will be invoked.\n\n If fatal error occurred, application should return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  In this case,\n `nghttp2_session_send()` and `nghttp2_session_mem_send()` functions\n immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the other\n values are returned, currently they are treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the return\n value is strictly larger than |len|, it is treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`."]
745pub type nghttp2_pack_extension_callback = ::std::option::Option<
746    unsafe extern "C" fn(
747        session: *mut nghttp2_session,
748        buf: *mut u8,
749        len: usize,
750        frame: *const nghttp2_frame,
751        user_data: *mut ::std::os::raw::c_void,
752    ) -> isize,
753>;
754#[doc = " @functypedef\n\n Callback function invoked when library asks the application to pack\n extension payload in its wire format.  The frame header will be\n packed by library.  Application must pack payload only.\n ``frame->ext.payload`` is the object passed to\n `nghttp2_submit_extension()` as payload parameter.  Application\n must pack extension payload to the |buf| of its capacity |len|\n bytes.  The |len| is at least 16KiB.\n\n The implementation of this function should return the number of\n bytes written into |buf| when it succeeds.\n\n To abort processing this extension frame, return\n :enum:`nghttp2_error.NGHTTP2_ERR_CANCEL`, and\n :type:`nghttp2_on_frame_not_send_callback` will be invoked.\n\n If fatal error occurred, application should return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  In this case,\n `nghttp2_session_send()` and `nghttp2_session_mem_send2()`\n functions immediately return\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the other\n values are returned, currently they are treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  If the return\n value is strictly larger than |len|, it is treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`."]
755pub type nghttp2_pack_extension_callback2 = ::std::option::Option<
756    unsafe extern "C" fn(
757        session: *mut nghttp2_session,
758        buf: *mut u8,
759        len: usize,
760        frame: *const nghttp2_frame,
761        user_data: *mut ::std::os::raw::c_void,
762    ) -> nghttp2_ssize,
763>;
764#[doc = " @functypedef\n\n .. warning::\n\n   Deprecated.  Use :type:`nghttp2_error_callback2` instead.\n\n Callback function invoked when library provides the error message\n intended for human consumption.  This callback is solely for\n debugging purpose.  The |msg| is typically NULL-terminated string\n of length |len|.  |len| does not include the sentinel NULL\n character.\n\n The format of error message may change between nghttp2 library\n versions.  The application should not depend on the particular\n format.\n\n Normally, application should return 0 from this callback.  If fatal\n error occurred while doing something in this callback, application\n should return :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n In this case, library will return immediately with return value\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  Currently, if\n nonzero value is returned from this callback, they are treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`, but application\n should not rely on this details."]
765pub type nghttp2_error_callback = ::std::option::Option<
766    unsafe extern "C" fn(
767        session: *mut nghttp2_session,
768        msg: *const ::std::os::raw::c_char,
769        len: usize,
770        user_data: *mut ::std::os::raw::c_void,
771    ) -> ::std::os::raw::c_int,
772>;
773#[doc = " @functypedef\n\n Callback function invoked when library provides the error code, and\n message.  This callback is solely for debugging purpose.\n |lib_error_code| is one of error code defined in\n :enum:`nghttp2_error`.  The |msg| is typically NULL-terminated\n string of length |len|, and intended for human consumption.  |len|\n does not include the sentinel NULL character.\n\n The format of error message may change between nghttp2 library\n versions.  The application should not depend on the particular\n format.\n\n Normally, application should return 0 from this callback.  If fatal\n error occurred while doing something in this callback, application\n should return :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.\n In this case, library will return immediately with return value\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`.  Currently, if\n nonzero value is returned from this callback, they are treated as\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`, but application\n should not rely on this details."]
774pub type nghttp2_error_callback2 = ::std::option::Option<
775    unsafe extern "C" fn(
776        session: *mut nghttp2_session,
777        lib_error_code: ::std::os::raw::c_int,
778        msg: *const ::std::os::raw::c_char,
779        len: usize,
780        user_data: *mut ::std::os::raw::c_void,
781    ) -> ::std::os::raw::c_int,
782>;
783#[doc = " @functypedef\n\n Callback function invoked when unpredictable data of |destlen|\n bytes are needed.  The implementation must write unpredictable data\n of |destlen| bytes into the buffer pointed by |dest|."]
784pub type nghttp2_rand_callback =
785    ::std::option::Option<unsafe extern "C" fn(dest: *mut u8, destlen: usize)>;
786#[repr(C)]
787#[derive(Debug, Copy, Clone)]
788pub struct nghttp2_session_callbacks {
789    _unused: [u8; 0],
790}
791unsafe extern "C" {
792    #[doc = " @function\n\n Initializes |*callbacks_ptr| with NULL values.\n\n The initialized object can be used when initializing multiple\n :type:`nghttp2_session` objects.\n\n When the application finished using this object, it can use\n `nghttp2_session_callbacks_del()` to free its memory.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
793    pub fn nghttp2_session_callbacks_new(
794        callbacks_ptr: *mut *mut nghttp2_session_callbacks,
795    ) -> ::std::os::raw::c_int;
796}
797unsafe extern "C" {
798    #[doc = " @function\n\n Frees any resources allocated for |callbacks|.  If |callbacks| is\n ``NULL``, this function does nothing."]
799    pub fn nghttp2_session_callbacks_del(callbacks: *mut nghttp2_session_callbacks);
800}
801unsafe extern "C" {
802    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_session_callbacks_set_send_callback2()`\n   with :type:`nghttp2_send_callback2` instead.\n\n Sets callback function invoked when a session wants to send data to\n the remote peer.  This callback is not necessary if the application\n uses solely `nghttp2_session_mem_send()` to serialize data to\n transmit."]
803    pub fn nghttp2_session_callbacks_set_send_callback(
804        cbs: *mut nghttp2_session_callbacks,
805        send_callback: nghttp2_send_callback,
806    );
807}
808unsafe extern "C" {
809    #[doc = " @function\n\n Sets callback function invoked when a session wants to send data to\n the remote peer.  This callback is not necessary if the application\n uses solely `nghttp2_session_mem_send2()` to serialize data to\n transmit."]
810    pub fn nghttp2_session_callbacks_set_send_callback2(
811        cbs: *mut nghttp2_session_callbacks,
812        send_callback: nghttp2_send_callback2,
813    );
814}
815unsafe extern "C" {
816    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_session_callbacks_set_recv_callback2()`\n   with :type:`nghttp2_recv_callback2` instead.\n\n Sets callback function invoked when the a session wants to receive\n data from the remote peer.  This callback is not necessary if the\n application uses solely `nghttp2_session_mem_recv()` to process\n received data."]
817    pub fn nghttp2_session_callbacks_set_recv_callback(
818        cbs: *mut nghttp2_session_callbacks,
819        recv_callback: nghttp2_recv_callback,
820    );
821}
822unsafe extern "C" {
823    #[doc = " @function\n\n Sets callback function invoked when the a session wants to receive\n data from the remote peer.  This callback is not necessary if the\n application uses solely `nghttp2_session_mem_recv2()` to process\n received data."]
824    pub fn nghttp2_session_callbacks_set_recv_callback2(
825        cbs: *mut nghttp2_session_callbacks,
826        recv_callback: nghttp2_recv_callback2,
827    );
828}
829unsafe extern "C" {
830    #[doc = " @function\n\n Sets callback function invoked by `nghttp2_session_recv()` and\n `nghttp2_session_mem_recv2()` when a frame is received."]
831    pub fn nghttp2_session_callbacks_set_on_frame_recv_callback(
832        cbs: *mut nghttp2_session_callbacks,
833        on_frame_recv_callback: nghttp2_on_frame_recv_callback,
834    );
835}
836unsafe extern "C" {
837    #[doc = " @function\n\n Sets callback function invoked by `nghttp2_session_recv()` and\n `nghttp2_session_mem_recv2()` when an invalid non-DATA frame is\n received."]
838    pub fn nghttp2_session_callbacks_set_on_invalid_frame_recv_callback(
839        cbs: *mut nghttp2_session_callbacks,
840        on_invalid_frame_recv_callback: nghttp2_on_invalid_frame_recv_callback,
841    );
842}
843unsafe extern "C" {
844    #[doc = " @function\n\n Sets callback function invoked when a chunk of data in DATA frame\n is received."]
845    pub fn nghttp2_session_callbacks_set_on_data_chunk_recv_callback(
846        cbs: *mut nghttp2_session_callbacks,
847        on_data_chunk_recv_callback: nghttp2_on_data_chunk_recv_callback,
848    );
849}
850unsafe extern "C" {
851    #[doc = " @function\n\n Sets callback function invoked before a non-DATA frame is sent."]
852    pub fn nghttp2_session_callbacks_set_before_frame_send_callback(
853        cbs: *mut nghttp2_session_callbacks,
854        before_frame_send_callback: nghttp2_before_frame_send_callback,
855    );
856}
857unsafe extern "C" {
858    #[doc = " @function\n\n Sets callback function invoked after a frame is sent."]
859    pub fn nghttp2_session_callbacks_set_on_frame_send_callback(
860        cbs: *mut nghttp2_session_callbacks,
861        on_frame_send_callback: nghttp2_on_frame_send_callback,
862    );
863}
864unsafe extern "C" {
865    #[doc = " @function\n\n Sets callback function invoked when a non-DATA frame is not sent\n because of an error."]
866    pub fn nghttp2_session_callbacks_set_on_frame_not_send_callback(
867        cbs: *mut nghttp2_session_callbacks,
868        on_frame_not_send_callback: nghttp2_on_frame_not_send_callback,
869    );
870}
871unsafe extern "C" {
872    #[doc = " @function\n\n Sets callback function invoked when the stream is closed."]
873    pub fn nghttp2_session_callbacks_set_on_stream_close_callback(
874        cbs: *mut nghttp2_session_callbacks,
875        on_stream_close_callback: nghttp2_on_stream_close_callback,
876    );
877}
878unsafe extern "C" {
879    #[doc = " @function\n\n Sets callback function invoked when the reception of header block\n in HEADERS or PUSH_PROMISE is started."]
880    pub fn nghttp2_session_callbacks_set_on_begin_headers_callback(
881        cbs: *mut nghttp2_session_callbacks,
882        on_begin_headers_callback: nghttp2_on_begin_headers_callback,
883    );
884}
885unsafe extern "C" {
886    #[doc = " @function\n\n Sets callback function invoked when a header name/value pair is\n received.  If both\n `nghttp2_session_callbacks_set_on_header_callback()` and\n `nghttp2_session_callbacks_set_on_header_callback2()` are used to\n set callbacks, the latter has the precedence."]
887    pub fn nghttp2_session_callbacks_set_on_header_callback(
888        cbs: *mut nghttp2_session_callbacks,
889        on_header_callback: nghttp2_on_header_callback,
890    );
891}
892unsafe extern "C" {
893    #[doc = " @function\n\n Sets callback function invoked when a header name/value pair is\n received."]
894    pub fn nghttp2_session_callbacks_set_on_header_callback2(
895        cbs: *mut nghttp2_session_callbacks,
896        on_header_callback2: nghttp2_on_header_callback2,
897    );
898}
899unsafe extern "C" {
900    #[doc = " @function\n\n Sets callback function invoked when an invalid header name/value\n pair is received.  If both\n `nghttp2_session_callbacks_set_on_invalid_header_callback()` and\n `nghttp2_session_callbacks_set_on_invalid_header_callback2()` are\n used to set callbacks, the latter takes the precedence."]
901    pub fn nghttp2_session_callbacks_set_on_invalid_header_callback(
902        cbs: *mut nghttp2_session_callbacks,
903        on_invalid_header_callback: nghttp2_on_invalid_header_callback,
904    );
905}
906unsafe extern "C" {
907    #[doc = " @function\n\n Sets callback function invoked when an invalid header name/value\n pair is received."]
908    pub fn nghttp2_session_callbacks_set_on_invalid_header_callback2(
909        cbs: *mut nghttp2_session_callbacks,
910        on_invalid_header_callback2: nghttp2_on_invalid_header_callback2,
911    );
912}
913unsafe extern "C" {
914    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use\n   `nghttp2_session_callbacks_set_select_padding_callback2()` with\n   :type:`nghttp2_select_padding_callback2` instead.\n\n Sets callback function invoked when the library asks application\n how many padding bytes are required for the transmission of the\n given frame."]
915    pub fn nghttp2_session_callbacks_set_select_padding_callback(
916        cbs: *mut nghttp2_session_callbacks,
917        select_padding_callback: nghttp2_select_padding_callback,
918    );
919}
920unsafe extern "C" {
921    #[doc = " @function\n\n Sets callback function invoked when the library asks application\n how many padding bytes are required for the transmission of the\n given frame."]
922    pub fn nghttp2_session_callbacks_set_select_padding_callback2(
923        cbs: *mut nghttp2_session_callbacks,
924        select_padding_callback: nghttp2_select_padding_callback2,
925    );
926}
927unsafe extern "C" {
928    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use\n   `nghttp2_session_callbacks_set_data_source_read_length_callback2()`\n   with :type:`nghttp2_data_source_read_length_callback2` instead.\n\n Sets callback function determine the length allowed in\n :type:`nghttp2_data_source_read_callback`."]
929    pub fn nghttp2_session_callbacks_set_data_source_read_length_callback(
930        cbs: *mut nghttp2_session_callbacks,
931        data_source_read_length_callback: nghttp2_data_source_read_length_callback,
932    );
933}
934unsafe extern "C" {
935    #[doc = " @function\n\n Sets callback function determine the length allowed in\n :type:`nghttp2_data_source_read_callback2`."]
936    pub fn nghttp2_session_callbacks_set_data_source_read_length_callback2(
937        cbs: *mut nghttp2_session_callbacks,
938        data_source_read_length_callback: nghttp2_data_source_read_length_callback2,
939    );
940}
941unsafe extern "C" {
942    #[doc = " @function\n\n Sets callback function invoked when a frame header is received."]
943    pub fn nghttp2_session_callbacks_set_on_begin_frame_callback(
944        cbs: *mut nghttp2_session_callbacks,
945        on_begin_frame_callback: nghttp2_on_begin_frame_callback,
946    );
947}
948unsafe extern "C" {
949    #[doc = " @function\n\n Sets callback function invoked when\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_COPY` is used in\n :type:`nghttp2_data_source_read_callback2` to avoid data copy."]
950    pub fn nghttp2_session_callbacks_set_send_data_callback(
951        cbs: *mut nghttp2_session_callbacks,
952        send_data_callback: nghttp2_send_data_callback,
953    );
954}
955unsafe extern "C" {
956    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use\n   `nghttp2_session_callbacks_set_pack_extension_callback2()` with\n   :type:`nghttp2_pack_extension_callback2` instead.\n\n Sets callback function invoked when the library asks the\n application to pack extension frame payload in wire format."]
957    pub fn nghttp2_session_callbacks_set_pack_extension_callback(
958        cbs: *mut nghttp2_session_callbacks,
959        pack_extension_callback: nghttp2_pack_extension_callback,
960    );
961}
962unsafe extern "C" {
963    #[doc = " @function\n\n Sets callback function invoked when the library asks the\n application to pack extension frame payload in wire format."]
964    pub fn nghttp2_session_callbacks_set_pack_extension_callback2(
965        cbs: *mut nghttp2_session_callbacks,
966        pack_extension_callback: nghttp2_pack_extension_callback2,
967    );
968}
969unsafe extern "C" {
970    #[doc = " @function\n\n Sets callback function invoked when the library asks the\n application to unpack extension frame payload from wire format."]
971    pub fn nghttp2_session_callbacks_set_unpack_extension_callback(
972        cbs: *mut nghttp2_session_callbacks,
973        unpack_extension_callback: nghttp2_unpack_extension_callback,
974    );
975}
976unsafe extern "C" {
977    #[doc = " @function\n\n Sets callback function invoked when chunk of extension frame\n payload is received."]
978    pub fn nghttp2_session_callbacks_set_on_extension_chunk_recv_callback(
979        cbs: *mut nghttp2_session_callbacks,
980        on_extension_chunk_recv_callback: nghttp2_on_extension_chunk_recv_callback,
981    );
982}
983unsafe extern "C" {
984    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use\n   `nghttp2_session_callbacks_set_error_callback2()` with\n   :type:`nghttp2_error_callback2` instead.\n\n Sets callback function invoked when library tells error message to\n the application.\n\n If both :type:`nghttp2_error_callback` and\n :type:`nghttp2_error_callback2` are set, the latter takes\n precedence."]
985    pub fn nghttp2_session_callbacks_set_error_callback(
986        cbs: *mut nghttp2_session_callbacks,
987        error_callback: nghttp2_error_callback,
988    );
989}
990unsafe extern "C" {
991    #[doc = " @function\n\n Sets callback function invoked when library tells error code, and\n message to the application.\n\n If both :type:`nghttp2_error_callback` and\n :type:`nghttp2_error_callback2` are set, the latter takes\n precedence."]
992    pub fn nghttp2_session_callbacks_set_error_callback2(
993        cbs: *mut nghttp2_session_callbacks,
994        error_callback2: nghttp2_error_callback2,
995    );
996}
997unsafe extern "C" {
998    #[doc = " @function\n\n Sets callback function invoked when unpredictable data is needed.\n Although this callback is optional due to the backward\n compatibility, it is recommended to specify it to harden the\n runtime behavior against suspicious activities of a remote\n endpoint."]
999    pub fn nghttp2_session_callbacks_set_rand_callback(
1000        cbs: *mut nghttp2_session_callbacks,
1001        rand_callback: nghttp2_rand_callback,
1002    );
1003}
1004#[doc = " @functypedef\n\n Custom memory allocator to replace malloc().  The |mem_user_data|\n is the mem_user_data member of :type:`nghttp2_mem` structure."]
1005pub type nghttp2_malloc = ::std::option::Option<
1006    unsafe extern "C" fn(
1007        size: usize,
1008        mem_user_data: *mut ::std::os::raw::c_void,
1009    ) -> *mut ::std::os::raw::c_void,
1010>;
1011#[doc = " @functypedef\n\n Custom memory allocator to replace free().  The |mem_user_data| is\n the mem_user_data member of :type:`nghttp2_mem` structure."]
1012pub type nghttp2_free = ::std::option::Option<
1013    unsafe extern "C" fn(
1014        ptr: *mut ::std::os::raw::c_void,
1015        mem_user_data: *mut ::std::os::raw::c_void,
1016    ),
1017>;
1018#[doc = " @functypedef\n\n Custom memory allocator to replace calloc().  The |mem_user_data|\n is the mem_user_data member of :type:`nghttp2_mem` structure."]
1019pub type nghttp2_calloc = ::std::option::Option<
1020    unsafe extern "C" fn(
1021        nmemb: usize,
1022        size: usize,
1023        mem_user_data: *mut ::std::os::raw::c_void,
1024    ) -> *mut ::std::os::raw::c_void,
1025>;
1026#[doc = " @functypedef\n\n Custom memory allocator to replace realloc().  The |mem_user_data|\n is the mem_user_data member of :type:`nghttp2_mem` structure."]
1027pub type nghttp2_realloc = ::std::option::Option<
1028    unsafe extern "C" fn(
1029        ptr: *mut ::std::os::raw::c_void,
1030        size: usize,
1031        mem_user_data: *mut ::std::os::raw::c_void,
1032    ) -> *mut ::std::os::raw::c_void,
1033>;
1034#[doc = " @struct\n\n Custom memory allocator functions and user defined pointer.  The\n |mem_user_data| member is passed to each allocator function.  This\n can be used, for example, to achieve per-session memory pool.\n\n In the following example code, ``my_malloc``, ``my_free``,\n ``my_calloc`` and ``my_realloc`` are the replacement of the\n standard allocators ``malloc``, ``free``, ``calloc`` and\n ``realloc`` respectively::\n\n     void *my_malloc_cb(size_t size, void *mem_user_data) {\n       return my_malloc(size);\n     }\n\n     void my_free_cb(void *ptr, void *mem_user_data) { my_free(ptr); }\n\n     void *my_calloc_cb(size_t nmemb, size_t size, void *mem_user_data) {\n       return my_calloc(nmemb, size);\n     }\n\n     void *my_realloc_cb(void *ptr, size_t size, void *mem_user_data) {\n       return my_realloc(ptr, size);\n     }\n\n     void session_new() {\n       nghttp2_session *session;\n       nghttp2_session_callbacks *callbacks;\n       nghttp2_mem mem = {NULL, my_malloc_cb, my_free_cb, my_calloc_cb,\n                          my_realloc_cb};\n\n       ...\n\n       nghttp2_session_client_new3(&session, callbacks, NULL, NULL, &mem);\n\n       ...\n     }"]
1035#[repr(C)]
1036#[derive(Debug, Copy, Clone)]
1037pub struct nghttp2_mem {
1038    #[doc = " An arbitrary user supplied data.  This is passed to each\n allocator function."]
1039    pub mem_user_data: *mut ::std::os::raw::c_void,
1040    #[doc = " Custom allocator function to replace malloc()."]
1041    pub malloc: nghttp2_malloc,
1042    #[doc = " Custom allocator function to replace free()."]
1043    pub free: nghttp2_free,
1044    #[doc = " Custom allocator function to replace calloc()."]
1045    pub calloc: nghttp2_calloc,
1046    #[doc = " Custom allocator function to replace realloc()."]
1047    pub realloc: nghttp2_realloc,
1048}
1049#[repr(C)]
1050#[derive(Debug, Copy, Clone)]
1051pub struct nghttp2_option {
1052    _unused: [u8; 0],
1053}
1054unsafe extern "C" {
1055    #[doc = " @function\n\n Initializes |*option_ptr| with default values.\n\n When the application finished using this object, it can use\n `nghttp2_option_del()` to free its memory.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1056    pub fn nghttp2_option_new(option_ptr: *mut *mut nghttp2_option) -> ::std::os::raw::c_int;
1057}
1058unsafe extern "C" {
1059    #[doc = " @function\n\n Frees any resources allocated for |option|.  If |option| is\n ``NULL``, this function does nothing."]
1060    pub fn nghttp2_option_del(option: *mut nghttp2_option);
1061}
1062unsafe extern "C" {
1063    #[doc = " @function\n\n This option prevents the library from sending WINDOW_UPDATE for a\n connection automatically.  If this option is set to nonzero, the\n library won't send WINDOW_UPDATE for DATA until application calls\n `nghttp2_session_consume()` to indicate the consumed amount of\n data.  Don't use `nghttp2_submit_window_update()` for this purpose.\n By default, this option is set to zero."]
1064    pub fn nghttp2_option_set_no_auto_window_update(
1065        option: *mut nghttp2_option,
1066        val: ::std::os::raw::c_int,
1067    );
1068}
1069unsafe extern "C" {
1070    #[doc = " @function\n\n This option sets the SETTINGS_MAX_CONCURRENT_STREAMS value of\n remote endpoint as if it is received in SETTINGS frame.  Without\n specifying this option, the maximum number of outgoing concurrent\n streams is initially limited to 100 to avoid issues when the local\n endpoint submits lots of requests before receiving initial SETTINGS\n frame from the remote endpoint, since sending them at once to the\n remote endpoint could lead to rejection of some of the requests.\n This value will be overwritten when the local endpoint receives\n initial SETTINGS frame from the remote endpoint, either to the\n value advertised in SETTINGS_MAX_CONCURRENT_STREAMS or to the\n default value (unlimited) if none was advertised."]
1071    pub fn nghttp2_option_set_peer_max_concurrent_streams(option: *mut nghttp2_option, val: u32);
1072}
1073unsafe extern "C" {
1074    #[doc = " @function\n\n By default, nghttp2 library, if configured as server, requires\n first 24 bytes of client magic byte string (MAGIC).  In most cases,\n this will simplify the implementation of server.  But sometimes\n server may want to detect the application protocol based on first\n few bytes on clear text communication.\n\n If this option is used with nonzero |val|, nghttp2 library does not\n handle MAGIC.  It still checks following SETTINGS frame.  This\n means that applications should deal with MAGIC by themselves.\n\n If this option is not used or used with zero value, if MAGIC does\n not match :macro:`NGHTTP2_CLIENT_MAGIC`, `nghttp2_session_recv()`\n and `nghttp2_session_mem_recv2()` will return error\n :enum:`nghttp2_error.NGHTTP2_ERR_BAD_CLIENT_MAGIC`, which is fatal\n error."]
1075    pub fn nghttp2_option_set_no_recv_client_magic(
1076        option: *mut nghttp2_option,
1077        val: ::std::os::raw::c_int,
1078    );
1079}
1080unsafe extern "C" {
1081    #[doc = " @function\n\n By default, nghttp2 library enforces subset of HTTP Messaging rules\n described in `HTTP/2 specification, section 8\n <https://tools.ietf.org/html/rfc7540#section-8>`_.  See\n :ref:`http-messaging` section for details.  For those applications\n who use nghttp2 library as non-HTTP use, give nonzero to |val| to\n disable this enforcement.  Please note that disabling this feature\n does not change the fundamental client and server model of HTTP.\n That is, even if the validation is disabled, only client can send\n requests."]
1082    pub fn nghttp2_option_set_no_http_messaging(
1083        option: *mut nghttp2_option,
1084        val: ::std::os::raw::c_int,
1085    );
1086}
1087unsafe extern "C" {
1088    #[doc = " @function\n\n RFC 7540 does not enforce any limit on the number of incoming\n reserved streams (in RFC 7540 terms, streams in reserved (remote)\n state).  This only affects client side, since only server can push\n streams.  Malicious server can push arbitrary number of streams,\n and make client's memory exhausted.  This option can set the\n maximum number of such incoming streams to avoid possible memory\n exhaustion.  If this option is set, and pushed streams are\n automatically closed on reception, without calling user provided\n callback, if they exceed the given limit.  The default value is\n 200.  If session is configured as server side, this option has no\n effect.  Server can control the number of streams to push."]
1089    pub fn nghttp2_option_set_max_reserved_remote_streams(option: *mut nghttp2_option, val: u32);
1090}
1091unsafe extern "C" {
1092    #[doc = " @function\n\n Sets extension frame type the application is willing to handle with\n user defined callbacks (see\n :type:`nghttp2_on_extension_chunk_recv_callback` and\n :type:`nghttp2_unpack_extension_callback`).  The |type| is\n extension frame type, and must be strictly greater than 0x9.\n Otherwise, this function does nothing.  The application can call\n this function multiple times to set more than one frame type to\n receive.  The application does not have to call this function if it\n just sends extension frames."]
1093    pub fn nghttp2_option_set_user_recv_extension_type(option: *mut nghttp2_option, type_: u8);
1094}
1095unsafe extern "C" {
1096    #[doc = " @function\n\n Sets extension frame type the application is willing to receive\n using builtin handler.  The |type| is the extension frame type to\n receive, and must be strictly greater than 0x9.  Otherwise, this\n function does nothing.  The application can call this function\n multiple times to set more than one frame type to receive.  The\n application does not have to call this function if it just sends\n extension frames.\n\n If same frame type is passed to both\n `nghttp2_option_set_builtin_recv_extension_type()` and\n `nghttp2_option_set_user_recv_extension_type()`, the latter takes\n precedence."]
1097    pub fn nghttp2_option_set_builtin_recv_extension_type(option: *mut nghttp2_option, type_: u8);
1098}
1099unsafe extern "C" {
1100    #[doc = " @function\n\n This option prevents the library from sending PING frame with ACK\n flag set automatically when PING frame without ACK flag set is\n received.  If this option is set to nonzero, the library won't send\n PING frame with ACK flag set in the response for incoming PING\n frame.  The application can send PING frame with ACK flag set using\n `nghttp2_submit_ping()` with :enum:`nghttp2_flag.NGHTTP2_FLAG_ACK`\n as flags parameter."]
1101    pub fn nghttp2_option_set_no_auto_ping_ack(
1102        option: *mut nghttp2_option,
1103        val: ::std::os::raw::c_int,
1104    );
1105}
1106unsafe extern "C" {
1107    #[doc = " @function\n\n This option sets the maximum length of header block (a set of\n header fields per one HEADERS frame) to send.  The length of a\n given set of header fields is calculated using\n `nghttp2_hd_deflate_bound()`.  The default value is 64KiB.  If\n application attempts to send header fields larger than this limit,\n the transmission of the frame fails with error code\n :enum:`nghttp2_error.NGHTTP2_ERR_FRAME_SIZE_ERROR`."]
1108    pub fn nghttp2_option_set_max_send_header_block_length(option: *mut nghttp2_option, val: usize);
1109}
1110unsafe extern "C" {
1111    #[doc = " @function\n\n This option sets the maximum dynamic table size for deflating\n header fields.  The default value is 4KiB.  In HTTP/2, receiver of\n deflated header block can specify maximum dynamic table size.  The\n actual maximum size is the minimum of the size receiver specified\n and this option value."]
1112    pub fn nghttp2_option_set_max_deflate_dynamic_table_size(
1113        option: *mut nghttp2_option,
1114        val: usize,
1115    );
1116}
1117unsafe extern "C" {
1118    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Closed streams are not retained anymore.\n\n This function works as before, but it does not take any effect\n against :type:`nghttp2_session`."]
1119    pub fn nghttp2_option_set_no_closed_streams(
1120        option: *mut nghttp2_option,
1121        val: ::std::os::raw::c_int,
1122    );
1123}
1124unsafe extern "C" {
1125    #[doc = " @function\n\n This function sets the maximum number of outgoing SETTINGS ACK and\n PING ACK frames retained in :type:`nghttp2_session` object.  If\n more than those frames are retained, the peer is considered to be\n misbehaving and session will be closed.  The default value is 1000."]
1126    pub fn nghttp2_option_set_max_outbound_ack(option: *mut nghttp2_option, val: usize);
1127}
1128unsafe extern "C" {
1129    #[doc = " @function\n\n This function sets the maximum number of SETTINGS entries per\n SETTINGS frame that will be accepted. If more than those entries\n are received, the peer is considered to be misbehaving and session\n will be closed. The default value is 32."]
1130    pub fn nghttp2_option_set_max_settings(option: *mut nghttp2_option, val: usize);
1131}
1132unsafe extern "C" {
1133    #[doc = " @function\n\n .. warning::\n    Deprecated.  :rfc:`7540` priorities have been removed.\n\n This function works as before, but it does not take any effect\n against :type:`nghttp2_session`."]
1134    pub fn nghttp2_option_set_server_fallback_rfc7540_priorities(
1135        option: *mut nghttp2_option,
1136        val: ::std::os::raw::c_int,
1137    );
1138}
1139unsafe extern "C" {
1140    #[doc = " @function\n\n This option, if set to nonzero, turns off RFC 9113 leading and\n trailing white spaces validation against HTTP field value.  Some\n important fields, such as HTTP/2 pseudo header fields, are\n validated more strictly and this option does not apply to them."]
1141    pub fn nghttp2_option_set_no_rfc9113_leading_and_trailing_ws_validation(
1142        option: *mut nghttp2_option,
1143        val: ::std::os::raw::c_int,
1144    );
1145}
1146unsafe extern "C" {
1147    #[doc = " @function\n\n This function sets the rate limit for the incoming stream reset\n (RST_STREAM frame).  It is server use only.  It is a token-bucket\n based rate limiter.  |burst| specifies the number of tokens that is\n initially available.  The maximum number of tokens is capped to\n this value.  |rate| specifies the number of tokens that are\n regenerated per second.  An incoming RST_STREAM consumes one token.\n If there is no token available, GOAWAY is sent to tear down the\n connection.  |burst| and |rate| default to 1000 and 33\n respectively."]
1148    pub fn nghttp2_option_set_stream_reset_rate_limit(
1149        option: *mut nghttp2_option,
1150        burst: u64,
1151        rate: u64,
1152    );
1153}
1154unsafe extern "C" {
1155    #[doc = " @function\n\n This function sets the maximum number of CONTINUATION frames\n following an incoming HEADER frame.  If more than those frames are\n received, the remote endpoint is considered to be misbehaving and\n session will be closed.  The default value is 8."]
1156    pub fn nghttp2_option_set_max_continuations(option: *mut nghttp2_option, val: usize);
1157}
1158unsafe extern "C" {
1159    #[doc = " @function\n\n This function sets the rate limit for the \"glitches\", the\n suspicious activities from a remote endpoint.  It is a token-bucket\n based rate limiter.  |burst| specifies the number of tokens that is\n initially available.  The maximum number of tokens is capped to\n this value.  |rate| specifies the number of tokens that are\n regenerated per second.  When a suspicious activity is detected,\n some amount of tokens are consumed.  If there is no token\n available, GOAWAY is sent to tear down the connection.  |burst| and\n |rate| default to 1000 and 33 respectively."]
1160    pub fn nghttp2_option_set_glitch_rate_limit(option: *mut nghttp2_option, burst: u64, rate: u64);
1161}
1162unsafe extern "C" {
1163    #[doc = " @function\n\n Initializes |*session_ptr| for client use.  The all members of\n |callbacks| are copied to |*session_ptr|.  Therefore |*session_ptr|\n does not store |callbacks|.  The |user_data| is an arbitrary user\n supplied data, which will be passed to the callback functions.\n\n The :type:`nghttp2_send_callback2` must be specified.  If the\n application code uses `nghttp2_session_recv()`, the\n :type:`nghttp2_recv_callback` must be specified.  The other members\n of |callbacks| can be ``NULL``.\n\n If this function fails, |*session_ptr| is left untouched.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1164    pub fn nghttp2_session_client_new(
1165        session_ptr: *mut *mut nghttp2_session,
1166        callbacks: *const nghttp2_session_callbacks,
1167        user_data: *mut ::std::os::raw::c_void,
1168    ) -> ::std::os::raw::c_int;
1169}
1170unsafe extern "C" {
1171    #[doc = " @function\n\n Initializes |*session_ptr| for server use.  The all members of\n |callbacks| are copied to |*session_ptr|. Therefore |*session_ptr|\n does not store |callbacks|.  The |user_data| is an arbitrary user\n supplied data, which will be passed to the callback functions.\n\n The :type:`nghttp2_send_callback2` must be specified.  If the\n application code uses `nghttp2_session_recv()`, the\n :type:`nghttp2_recv_callback` must be specified.  The other members\n of |callbacks| can be ``NULL``.\n\n If this function fails, |*session_ptr| is left untouched.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1172    pub fn nghttp2_session_server_new(
1173        session_ptr: *mut *mut nghttp2_session,
1174        callbacks: *const nghttp2_session_callbacks,
1175        user_data: *mut ::std::os::raw::c_void,
1176    ) -> ::std::os::raw::c_int;
1177}
1178unsafe extern "C" {
1179    #[doc = " @function\n\n Like `nghttp2_session_client_new()`, but with additional options\n specified in the |option|.\n\n The |option| can be ``NULL`` and the call is equivalent to\n `nghttp2_session_client_new()`.\n\n This function does not take ownership |option|.  The application is\n responsible for freeing |option| if it finishes using the object.\n\n The library code does not refer to |option| after this function\n returns.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1180    pub fn nghttp2_session_client_new2(
1181        session_ptr: *mut *mut nghttp2_session,
1182        callbacks: *const nghttp2_session_callbacks,
1183        user_data: *mut ::std::os::raw::c_void,
1184        option: *const nghttp2_option,
1185    ) -> ::std::os::raw::c_int;
1186}
1187unsafe extern "C" {
1188    #[doc = " @function\n\n Like `nghttp2_session_server_new()`, but with additional options\n specified in the |option|.\n\n The |option| can be ``NULL`` and the call is equivalent to\n `nghttp2_session_server_new()`.\n\n This function does not take ownership |option|.  The application is\n responsible for freeing |option| if it finishes using the object.\n\n The library code does not refer to |option| after this function\n returns.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1189    pub fn nghttp2_session_server_new2(
1190        session_ptr: *mut *mut nghttp2_session,
1191        callbacks: *const nghttp2_session_callbacks,
1192        user_data: *mut ::std::os::raw::c_void,
1193        option: *const nghttp2_option,
1194    ) -> ::std::os::raw::c_int;
1195}
1196unsafe extern "C" {
1197    #[doc = " @function\n\n Like `nghttp2_session_client_new2()`, but with additional custom\n memory allocator specified in the |mem|.\n\n The |mem| can be ``NULL`` and the call is equivalent to\n `nghttp2_session_client_new2()`.\n\n This function does not take ownership |mem|.  The application is\n responsible for freeing |mem|.\n\n The library code does not refer to |mem| pointer after this\n function returns, so the application can safely free it.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1198    pub fn nghttp2_session_client_new3(
1199        session_ptr: *mut *mut nghttp2_session,
1200        callbacks: *const nghttp2_session_callbacks,
1201        user_data: *mut ::std::os::raw::c_void,
1202        option: *const nghttp2_option,
1203        mem: *mut nghttp2_mem,
1204    ) -> ::std::os::raw::c_int;
1205}
1206unsafe extern "C" {
1207    #[doc = " @function\n\n Like `nghttp2_session_server_new2()`, but with additional custom\n memory allocator specified in the |mem|.\n\n The |mem| can be ``NULL`` and the call is equivalent to\n `nghttp2_session_server_new2()`.\n\n This function does not take ownership |mem|.  The application is\n responsible for freeing |mem|.\n\n The library code does not refer to |mem| pointer after this\n function returns, so the application can safely free it.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1208    pub fn nghttp2_session_server_new3(
1209        session_ptr: *mut *mut nghttp2_session,
1210        callbacks: *const nghttp2_session_callbacks,
1211        user_data: *mut ::std::os::raw::c_void,
1212        option: *const nghttp2_option,
1213        mem: *mut nghttp2_mem,
1214    ) -> ::std::os::raw::c_int;
1215}
1216unsafe extern "C" {
1217    #[doc = " @function\n\n Frees any resources allocated for |session|.  If |session| is\n ``NULL``, this function does nothing."]
1218    pub fn nghttp2_session_del(session: *mut nghttp2_session);
1219}
1220unsafe extern "C" {
1221    #[doc = " @function\n\n Sends pending frames to the remote peer.\n\n This function retrieves the highest prioritized frame from the\n outbound queue and sends it to the remote peer.  It does this as\n many times as possible until the user callback\n :type:`nghttp2_send_callback2` returns\n :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`, the outbound queue\n becomes empty or flow control is triggered (remote window size\n becomes depleted or maximum number of concurrent streams is\n reached).  This function calls several callback functions which are\n passed when initializing the |session|.  Here is the simple time\n chart which tells when each callback is invoked:\n\n 1. Get the next frame to send from outbound queue.\n\n 2. Prepare transmission of the frame.\n\n 3. If the control frame cannot be sent because some preconditions\n    are not met (e.g., request HEADERS cannot be sent after GOAWAY),\n    :type:`nghttp2_on_frame_not_send_callback` is invoked.  Abort\n    the following steps.\n\n 4. If the frame is HEADERS, PUSH_PROMISE or DATA,\n    :type:`nghttp2_select_padding_callback` is invoked.\n\n 5. If the frame is request HEADERS, the stream is opened here.\n\n 6. :type:`nghttp2_before_frame_send_callback` is invoked.\n\n 7. If :enum:`nghttp2_error.NGHTTP2_ERR_CANCEL` is returned from\n    :type:`nghttp2_before_frame_send_callback`, the current frame\n    transmission is canceled, and\n    :type:`nghttp2_on_frame_not_send_callback` is invoked.  Abort\n    the following steps.\n\n 8. :type:`nghttp2_send_callback2` is invoked one or more times to\n    send the frame.\n\n 9. :type:`nghttp2_on_frame_send_callback` is invoked.\n\n 10. If the transmission of the frame triggers closure of the\n     stream, the stream is closed and\n     :type:`nghttp2_on_stream_close_callback` is invoked.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`\n     The callback function failed."]
1222    pub fn nghttp2_session_send(session: *mut nghttp2_session) -> ::std::os::raw::c_int;
1223}
1224unsafe extern "C" {
1225    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_session_mem_send2()` instead.\n\n Returns the serialized data to send.\n\n This function behaves like `nghttp2_session_send()` except that it\n does not use :type:`nghttp2_send_callback` to transmit data.\n Instead, it assigns the pointer to the serialized data to the\n |*data_ptr| and returns its length.  The other callbacks are called\n in the same way as they are in `nghttp2_session_send()`.\n\n If no data is available to send, this function returns 0.\n\n This function may not return all serialized data in one invocation.\n To get all data, call this function repeatedly until it returns 0\n or one of negative error codes.\n\n The assigned |*data_ptr| is valid until the next call of\n `nghttp2_session_mem_send()` or `nghttp2_session_send()`.\n\n The caller must send all data before sending the next chunk of\n data.\n\n This function returns the length of the data pointed by the\n |*data_ptr| if it succeeds, or one of the following negative error\n codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n\n .. note::\n\n   This function may produce very small byte string.  If that is the\n   case, and application disables Nagle algorithm (``TCP_NODELAY``),\n   then writing this small chunk leads to very small packet, and it\n   is very inefficient.  An application should be responsible to\n   buffer up small chunks of data as necessary to avoid this\n   situation."]
1226    pub fn nghttp2_session_mem_send(
1227        session: *mut nghttp2_session,
1228        data_ptr: *mut *const u8,
1229    ) -> isize;
1230}
1231unsafe extern "C" {
1232    #[doc = " @function\n\n Returns the serialized data to send.\n\n This function behaves like `nghttp2_session_send()` except that it\n does not use :type:`nghttp2_send_callback2` to transmit data.\n Instead, it assigns the pointer to the serialized data to the\n |*data_ptr| and returns its length.  The other callbacks are called\n in the same way as they are in `nghttp2_session_send()`.\n\n If no data is available to send, this function returns 0.\n\n This function may not return all serialized data in one invocation.\n To get all data, call this function repeatedly until it returns 0\n or one of negative error codes.\n\n The assigned |*data_ptr| is valid until the next call of\n `nghttp2_session_mem_send2()` or `nghttp2_session_send()`.\n\n The caller must send all data before sending the next chunk of\n data.\n\n This function returns the length of the data pointed by the\n |*data_ptr| if it succeeds, or one of the following negative error\n codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n\n .. note::\n\n   This function may produce very small byte string.  If that is the\n   case, and application disables Nagle algorithm (``TCP_NODELAY``),\n   then writing this small chunk leads to very small packet, and it\n   is very inefficient.  An application should be responsible to\n   buffer up small chunks of data as necessary to avoid this\n   situation."]
1233    pub fn nghttp2_session_mem_send2(
1234        session: *mut nghttp2_session,
1235        data_ptr: *mut *const u8,
1236    ) -> nghttp2_ssize;
1237}
1238unsafe extern "C" {
1239    #[doc = " @function\n\n Receives frames from the remote peer.\n\n This function receives as many frames as possible until the user\n callback :type:`nghttp2_recv_callback` returns\n :enum:`nghttp2_error.NGHTTP2_ERR_WOULDBLOCK`.  This function calls\n several callback functions which are passed when initializing the\n |session|.  Here is the simple time chart which tells when each\n callback is invoked:\n\n 1. :type:`nghttp2_recv_callback` is invoked one or more times to\n    receive frame header.\n\n 2. When frame header is received,\n    :type:`nghttp2_on_begin_frame_callback` is invoked.\n\n 3. If the frame is DATA frame:\n\n    1. :type:`nghttp2_recv_callback` is invoked to receive DATA\n       payload. For each chunk of data,\n       :type:`nghttp2_on_data_chunk_recv_callback` is invoked.\n\n    2. If one DATA frame is completely received,\n       :type:`nghttp2_on_frame_recv_callback` is invoked.  If the\n       reception of the frame triggers the closure of the stream,\n       :type:`nghttp2_on_stream_close_callback` is invoked.\n\n 4. If the frame is the control frame:\n\n    1. :type:`nghttp2_recv_callback` is invoked one or more times to\n       receive whole frame.\n\n    2. If the received frame is valid, then following actions are\n       taken.  If the frame is either HEADERS or PUSH_PROMISE,\n       :type:`nghttp2_on_begin_headers_callback` is invoked.  Then\n       :type:`nghttp2_on_header_callback` is invoked for each header\n       name/value pair.  For invalid header field,\n       :type:`nghttp2_on_invalid_header_callback` is called.  After\n       all name/value pairs are emitted successfully,\n       :type:`nghttp2_on_frame_recv_callback` is invoked.  For other\n       frames, :type:`nghttp2_on_frame_recv_callback` is invoked.\n       If the reception of the frame triggers the closure of the\n       stream, :type:`nghttp2_on_stream_close_callback` is invoked.\n\n    3. If the received frame is unpacked but is interpreted as\n       invalid, :type:`nghttp2_on_invalid_frame_recv_callback` is\n       invoked.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_EOF`\n     The remote peer did shutdown on the connection.\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`\n     The callback function failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_BAD_CLIENT_MAGIC`\n     Invalid client magic was detected.  This error only returns\n     when |session| was configured as server and\n     `nghttp2_option_set_no_recv_client_magic()` is not used with\n     nonzero value.\n :enum:`nghttp2_error.NGHTTP2_ERR_FLOODED`\n     Flooding was detected in this HTTP/2 session, and it must be\n     closed.  This is most likely caused by misbehaviour of peer."]
1240    pub fn nghttp2_session_recv(session: *mut nghttp2_session) -> ::std::os::raw::c_int;
1241}
1242unsafe extern "C" {
1243    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_session_mem_recv2()` instead.\n\n Processes data |in| as an input from the remote endpoint.  The\n |inlen| indicates the number of bytes to receive in the |in|.\n\n This function behaves like `nghttp2_session_recv()` except that it\n does not use :type:`nghttp2_recv_callback` to receive data; the\n |in| is the only data for the invocation of this function.  If all\n bytes are processed, this function returns.  The other callbacks\n are called in the same way as they are in `nghttp2_session_recv()`.\n\n In the current implementation, this function always tries to\n processes |inlen| bytes of input data unless either an error occurs or\n :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE` is returned from\n :type:`nghttp2_on_header_callback` or\n :type:`nghttp2_on_data_chunk_recv_callback`.  If\n :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE` is used, the return value\n includes the number of bytes which was used to produce the data or\n frame for the callback.\n\n This function returns the number of processed bytes, or one of the\n following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`\n     The callback function failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_BAD_CLIENT_MAGIC`\n     Invalid client magic was detected.  This error only returns\n     when |session| was configured as server and\n     `nghttp2_option_set_no_recv_client_magic()` is not used with\n     nonzero value.\n :enum:`nghttp2_error.NGHTTP2_ERR_FLOODED`\n     Flooding was detected in this HTTP/2 session, and it must be\n     closed.  This is most likely caused by misbehaviour of peer."]
1244    pub fn nghttp2_session_mem_recv(
1245        session: *mut nghttp2_session,
1246        in_: *const u8,
1247        inlen: usize,
1248    ) -> isize;
1249}
1250unsafe extern "C" {
1251    #[doc = " @function\n\n Processes data |in| as an input from the remote endpoint.  The\n |inlen| indicates the number of bytes to receive in the |in|.\n\n This function behaves like `nghttp2_session_recv()` except that it\n does not use :type:`nghttp2_recv_callback` to receive data; the\n |in| is the only data for the invocation of this function.  If all\n bytes are processed, this function returns.  The other callbacks\n are called in the same way as they are in `nghttp2_session_recv()`.\n\n In the current implementation, this function always tries to\n processes |inlen| bytes of input data unless either an error occurs or\n :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE` is returned from\n :type:`nghttp2_on_header_callback` or\n :type:`nghttp2_on_data_chunk_recv_callback`.  If\n :enum:`nghttp2_error.NGHTTP2_ERR_PAUSE` is used, the return value\n includes the number of bytes which was used to produce the data or\n frame for the callback.\n\n This function returns the number of processed bytes, or one of the\n following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_CALLBACK_FAILURE`\n     The callback function failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_BAD_CLIENT_MAGIC`\n     Invalid client magic was detected.  This error only returns\n     when |session| was configured as server and\n     `nghttp2_option_set_no_recv_client_magic()` is not used with\n     nonzero value.\n :enum:`nghttp2_error.NGHTTP2_ERR_FLOODED`\n     Flooding was detected in this HTTP/2 session, and it must be\n     closed.  This is most likely caused by misbehaviour of peer."]
1252    pub fn nghttp2_session_mem_recv2(
1253        session: *mut nghttp2_session,
1254        in_: *const u8,
1255        inlen: usize,
1256    ) -> nghttp2_ssize;
1257}
1258unsafe extern "C" {
1259    #[doc = " @function\n\n Puts back previously deferred DATA frame in the stream |stream_id|\n to the outbound queue.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The stream does not exist; or no deferred data exist.\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1260    pub fn nghttp2_session_resume_data(
1261        session: *mut nghttp2_session,
1262        stream_id: i32,
1263    ) -> ::std::os::raw::c_int;
1264}
1265unsafe extern "C" {
1266    #[doc = " @function\n\n Returns nonzero value if |session| wants to receive data from the\n remote peer.\n\n If both `nghttp2_session_want_read()` and\n `nghttp2_session_want_write()` return 0, the application should\n drop the connection."]
1267    pub fn nghttp2_session_want_read(session: *mut nghttp2_session) -> ::std::os::raw::c_int;
1268}
1269unsafe extern "C" {
1270    #[doc = " @function\n\n Returns nonzero value if |session| wants to send data to the remote\n peer.\n\n If both `nghttp2_session_want_read()` and\n `nghttp2_session_want_write()` return 0, the application should\n drop the connection."]
1271    pub fn nghttp2_session_want_write(session: *mut nghttp2_session) -> ::std::os::raw::c_int;
1272}
1273unsafe extern "C" {
1274    #[doc = " @function\n\n Returns stream_user_data for the stream |stream_id|.  The\n stream_user_data is provided by `nghttp2_submit_request2()`,\n `nghttp2_submit_headers()` or\n `nghttp2_session_set_stream_user_data()`.  Unless it is set using\n `nghttp2_session_set_stream_user_data()`, if the stream is\n initiated by the remote endpoint, stream_user_data is always\n ``NULL``.  If the stream does not exist, this function returns\n ``NULL``."]
1275    pub fn nghttp2_session_get_stream_user_data(
1276        session: *mut nghttp2_session,
1277        stream_id: i32,
1278    ) -> *mut ::std::os::raw::c_void;
1279}
1280unsafe extern "C" {
1281    #[doc = " @function\n\n Sets the |stream_user_data| to the stream denoted by the\n |stream_id|.  If a stream user data is already set to the stream,\n it is replaced with the |stream_user_data|.  It is valid to specify\n ``NULL`` in the |stream_user_data|, which nullifies the associated\n data pointer.\n\n It is valid to set the |stream_user_data| to the stream reserved by\n PUSH_PROMISE frame.\n\n This function returns 0 if it succeeds, or one of following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The stream does not exist"]
1282    pub fn nghttp2_session_set_stream_user_data(
1283        session: *mut nghttp2_session,
1284        stream_id: i32,
1285        stream_user_data: *mut ::std::os::raw::c_void,
1286    ) -> ::std::os::raw::c_int;
1287}
1288unsafe extern "C" {
1289    #[doc = " @function\n\n Sets |user_data| to |session|, overwriting the existing user data\n specified in `nghttp2_session_client_new()`, or\n `nghttp2_session_server_new()`."]
1290    pub fn nghttp2_session_set_user_data(
1291        session: *mut nghttp2_session,
1292        user_data: *mut ::std::os::raw::c_void,
1293    );
1294}
1295unsafe extern "C" {
1296    #[doc = " @function\n\n Returns the number of frames in the outbound queue.  This does not\n include the deferred DATA frames."]
1297    pub fn nghttp2_session_get_outbound_queue_size(session: *mut nghttp2_session) -> usize;
1298}
1299unsafe extern "C" {
1300    #[doc = " @function\n\n Returns the number of DATA payload in bytes received without\n WINDOW_UPDATE transmission for the stream |stream_id|.  The local\n (receive) window size can be adjusted by\n `nghttp2_submit_window_update()`.  This function takes into account\n that and returns effective data length.  In particular, if the\n local window size is reduced by submitting negative\n window_size_increment with `nghttp2_submit_window_update()`, this\n function returns the number of bytes less than actually received.\n\n This function returns -1 if it fails."]
1301    pub fn nghttp2_session_get_stream_effective_recv_data_length(
1302        session: *mut nghttp2_session,
1303        stream_id: i32,
1304    ) -> i32;
1305}
1306unsafe extern "C" {
1307    #[doc = " @function\n\n Returns the local (receive) window size for the stream |stream_id|.\n The local window size can be adjusted by\n `nghttp2_submit_window_update()`.  This function takes into account\n that and returns effective window size.\n\n This function does not take into account the amount of received\n data from the remote endpoint.  Use\n `nghttp2_session_get_stream_local_window_size()` to know the amount\n of data the remote endpoint can send without receiving stream level\n WINDOW_UPDATE frame.  Note that each stream is still subject to the\n connection level flow control.\n\n This function returns -1 if it fails."]
1308    pub fn nghttp2_session_get_stream_effective_local_window_size(
1309        session: *mut nghttp2_session,
1310        stream_id: i32,
1311    ) -> i32;
1312}
1313unsafe extern "C" {
1314    #[doc = " @function\n\n Returns the amount of flow-controlled payload (e.g., DATA) that the\n remote endpoint can send without receiving stream level\n WINDOW_UPDATE frame.  It is also subject to the connection level\n flow control.  So the actual amount of data to send is\n min(`nghttp2_session_get_stream_local_window_size()`,\n `nghttp2_session_get_local_window_size()`).\n\n This function returns -1 if it fails."]
1315    pub fn nghttp2_session_get_stream_local_window_size(
1316        session: *mut nghttp2_session,
1317        stream_id: i32,
1318    ) -> i32;
1319}
1320unsafe extern "C" {
1321    #[doc = " @function\n\n Returns the number of DATA payload in bytes received without\n WINDOW_UPDATE transmission for a connection.  The local (receive)\n window size can be adjusted by `nghttp2_submit_window_update()`.\n This function takes into account that and returns effective data\n length.  In particular, if the local window size is reduced by\n submitting negative window_size_increment with\n `nghttp2_submit_window_update()`, this function returns the number\n of bytes less than actually received.\n\n This function returns -1 if it fails."]
1322    pub fn nghttp2_session_get_effective_recv_data_length(session: *mut nghttp2_session) -> i32;
1323}
1324unsafe extern "C" {
1325    #[doc = " @function\n\n Returns the local (receive) window size for a connection.  The\n local window size can be adjusted by\n `nghttp2_submit_window_update()`.  This function takes into account\n that and returns effective window size.\n\n This function does not take into account the amount of received\n data from the remote endpoint.  Use\n `nghttp2_session_get_local_window_size()` to know the amount of\n data the remote endpoint can send without receiving\n connection-level WINDOW_UPDATE frame.  Note that each stream is\n still subject to the stream level flow control.\n\n This function returns -1 if it fails."]
1326    pub fn nghttp2_session_get_effective_local_window_size(session: *mut nghttp2_session) -> i32;
1327}
1328unsafe extern "C" {
1329    #[doc = " @function\n\n Returns the amount of flow-controlled payload (e.g., DATA) that the\n remote endpoint can send without receiving connection level\n WINDOW_UPDATE frame.  Note that each stream is still subject to the\n stream level flow control (see\n `nghttp2_session_get_stream_local_window_size()`).\n\n This function returns -1 if it fails."]
1330    pub fn nghttp2_session_get_local_window_size(session: *mut nghttp2_session) -> i32;
1331}
1332unsafe extern "C" {
1333    #[doc = " @function\n\n Returns the remote window size for a given stream |stream_id|.\n\n This is the amount of flow-controlled payload (e.g., DATA) that the\n local endpoint can send without stream level WINDOW_UPDATE.  There\n is also connection level flow control, so the effective size of\n payload that the local endpoint can actually send is\n min(`nghttp2_session_get_stream_remote_window_size()`,\n `nghttp2_session_get_remote_window_size()`).\n\n This function returns -1 if it fails."]
1334    pub fn nghttp2_session_get_stream_remote_window_size(
1335        session: *mut nghttp2_session,
1336        stream_id: i32,
1337    ) -> i32;
1338}
1339unsafe extern "C" {
1340    #[doc = " @function\n\n Returns the remote window size for a connection.\n\n This function always succeeds."]
1341    pub fn nghttp2_session_get_remote_window_size(session: *mut nghttp2_session) -> i32;
1342}
1343unsafe extern "C" {
1344    #[doc = " @function\n\n Returns 1 if local peer half closed the given stream |stream_id|.\n Returns 0 if it did not.  Returns -1 if no such stream exists."]
1345    pub fn nghttp2_session_get_stream_local_close(
1346        session: *mut nghttp2_session,
1347        stream_id: i32,
1348    ) -> ::std::os::raw::c_int;
1349}
1350unsafe extern "C" {
1351    #[doc = " @function\n\n Returns 1 if remote peer half closed the given stream |stream_id|.\n Returns 0 if it did not.  Returns -1 if no such stream exists."]
1352    pub fn nghttp2_session_get_stream_remote_close(
1353        session: *mut nghttp2_session,
1354        stream_id: i32,
1355    ) -> ::std::os::raw::c_int;
1356}
1357unsafe extern "C" {
1358    #[doc = " @function\n\n Returns the current dynamic table size of HPACK inflater, including\n the overhead 32 bytes per entry described in RFC 7541."]
1359    pub fn nghttp2_session_get_hd_inflate_dynamic_table_size(
1360        session: *mut nghttp2_session,
1361    ) -> usize;
1362}
1363unsafe extern "C" {
1364    #[doc = " @function\n\n Returns the current dynamic table size of HPACK deflater including\n the overhead 32 bytes per entry described in RFC 7541."]
1365    pub fn nghttp2_session_get_hd_deflate_dynamic_table_size(
1366        session: *mut nghttp2_session,
1367    ) -> usize;
1368}
1369unsafe extern "C" {
1370    #[doc = " @function\n\n Signals the session so that the connection should be terminated.\n\n The last stream ID is the minimum value between the stream ID of a\n stream for which :type:`nghttp2_on_frame_recv_callback` was called\n most recently and the last stream ID we have sent to the peer\n previously.\n\n The |error_code| is the error code of this GOAWAY frame.  The\n pre-defined error code is one of :enum:`nghttp2_error_code`.\n\n After the transmission, both `nghttp2_session_want_read()` and\n `nghttp2_session_want_write()` return 0.\n\n This function should be called when the connection should be\n terminated after sending GOAWAY.  If the remaining streams should\n be processed after GOAWAY, use `nghttp2_submit_goaway()` instead.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1371    pub fn nghttp2_session_terminate_session(
1372        session: *mut nghttp2_session,
1373        error_code: u32,
1374    ) -> ::std::os::raw::c_int;
1375}
1376unsafe extern "C" {
1377    #[doc = " @function\n\n Signals the session so that the connection should be terminated.\n\n This function behaves like `nghttp2_session_terminate_session()`,\n but the last stream ID can be specified by the application for fine\n grained control of stream.  The HTTP/2 specification does not allow\n last_stream_id to be increased.  So the actual value sent as\n last_stream_id is the minimum value between the given\n |last_stream_id| and the last_stream_id we have previously sent to\n the peer.\n\n The |last_stream_id| is peer's stream ID or 0.  So if |session| is\n initialized as client, |last_stream_id| must be even or 0.  If\n |session| is initialized as server, |last_stream_id| must be odd or\n 0.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |last_stream_id| is invalid."]
1378    pub fn nghttp2_session_terminate_session2(
1379        session: *mut nghttp2_session,
1380        last_stream_id: i32,
1381        error_code: u32,
1382    ) -> ::std::os::raw::c_int;
1383}
1384unsafe extern "C" {
1385    #[doc = " @function\n\n Signals to the client that the server started graceful shutdown\n procedure.\n\n This function is only usable for server.  If this function is\n called with client side session, this function returns\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`.\n\n To gracefully shutdown HTTP/2 session, server should call this\n function to send GOAWAY with last_stream_id (1u << 31) - 1.  And\n after some delay (e.g., 1 RTT), send another GOAWAY with the stream\n ID that the server has some processing using\n `nghttp2_submit_goaway()`.  See also\n `nghttp2_session_get_last_proc_stream_id()`.\n\n Unlike `nghttp2_submit_goaway()`, this function just sends GOAWAY\n and does nothing more.  This is a mere indication to the client\n that session shutdown is imminent.  The application should call\n `nghttp2_submit_goaway()` with appropriate last_stream_id after\n this call.\n\n If one or more GOAWAY frame have been already sent by either\n `nghttp2_submit_goaway()` or `nghttp2_session_terminate_session()`,\n this function has no effect.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     The |session| is initialized as client."]
1386    pub fn nghttp2_submit_shutdown_notice(session: *mut nghttp2_session) -> ::std::os::raw::c_int;
1387}
1388unsafe extern "C" {
1389    #[doc = " @function\n\n Returns the value of SETTINGS |id| notified by a remote endpoint.\n The |id| must be one of values defined in\n :enum:`nghttp2_settings_id`."]
1390    pub fn nghttp2_session_get_remote_settings(
1391        session: *mut nghttp2_session,
1392        id: nghttp2_settings_id,
1393    ) -> u32;
1394}
1395unsafe extern "C" {
1396    #[doc = " @function\n\n Returns the value of SETTINGS |id| of local endpoint acknowledged\n by the remote endpoint.  The |id| must be one of the values defined\n in :enum:`nghttp2_settings_id`."]
1397    pub fn nghttp2_session_get_local_settings(
1398        session: *mut nghttp2_session,
1399        id: nghttp2_settings_id,
1400    ) -> u32;
1401}
1402unsafe extern "C" {
1403    #[doc = " @function\n\n Tells the |session| that next stream ID is |next_stream_id|.  The\n |next_stream_id| must be equal or greater than the value returned\n by `nghttp2_session_get_next_stream_id()`.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |next_stream_id| is strictly less than the value\n     `nghttp2_session_get_next_stream_id()` returns; or\n     |next_stream_id| is invalid (e.g., even integer for client, or\n     odd integer for server)."]
1404    pub fn nghttp2_session_set_next_stream_id(
1405        session: *mut nghttp2_session,
1406        next_stream_id: i32,
1407    ) -> ::std::os::raw::c_int;
1408}
1409unsafe extern "C" {
1410    #[doc = " @function\n\n Returns the next outgoing stream ID.  Notice that return type is\n uint32_t.  If we run out of stream ID for this session, this\n function returns 1 << 31."]
1411    pub fn nghttp2_session_get_next_stream_id(session: *mut nghttp2_session) -> u32;
1412}
1413unsafe extern "C" {
1414    #[doc = " @function\n\n Tells the |session| that |size| bytes for a stream denoted by\n |stream_id| were consumed by application and are ready to\n WINDOW_UPDATE.  The consumed bytes are counted towards both\n connection and stream level WINDOW_UPDATE (see\n `nghttp2_session_consume_connection()` and\n `nghttp2_session_consume_stream()` to update consumption\n independently).  This function is intended to be used without\n automatic window update (see\n `nghttp2_option_set_no_auto_window_update()`).\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     Automatic WINDOW_UPDATE is not disabled."]
1415    pub fn nghttp2_session_consume(
1416        session: *mut nghttp2_session,
1417        stream_id: i32,
1418        size: usize,
1419    ) -> ::std::os::raw::c_int;
1420}
1421unsafe extern "C" {
1422    #[doc = " @function\n\n Like `nghttp2_session_consume()`, but this only tells library that\n |size| bytes were consumed only for connection level.  Note that\n HTTP/2 maintains connection and stream level flow control windows\n independently.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     Automatic WINDOW_UPDATE is not disabled."]
1423    pub fn nghttp2_session_consume_connection(
1424        session: *mut nghttp2_session,
1425        size: usize,
1426    ) -> ::std::os::raw::c_int;
1427}
1428unsafe extern "C" {
1429    #[doc = " @function\n\n Like `nghttp2_session_consume()`, but this only tells library that\n |size| bytes were consumed only for stream denoted by |stream_id|.\n Note that HTTP/2 maintains connection and stream level flow control\n windows independently.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     Automatic WINDOW_UPDATE is not disabled."]
1430    pub fn nghttp2_session_consume_stream(
1431        session: *mut nghttp2_session,
1432        stream_id: i32,
1433        size: usize,
1434    ) -> ::std::os::raw::c_int;
1435}
1436unsafe extern "C" {
1437    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function is noop.  It always returns 0."]
1438    pub fn nghttp2_session_change_stream_priority(
1439        session: *mut nghttp2_session,
1440        stream_id: i32,
1441        pri_spec: *const nghttp2_priority_spec,
1442    ) -> ::std::os::raw::c_int;
1443}
1444unsafe extern "C" {
1445    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function is noop.  It always returns 0."]
1446    pub fn nghttp2_session_create_idle_stream(
1447        session: *mut nghttp2_session,
1448        stream_id: i32,
1449        pri_spec: *const nghttp2_priority_spec,
1450    ) -> ::std::os::raw::c_int;
1451}
1452unsafe extern "C" {
1453    #[doc = " @function\n\n .. warning::\n\n   This function is deprecated in favor of\n   `nghttp2_session_upgrade2()`, because this function lacks the\n   parameter to tell the library the request method used in the\n   original HTTP request.  This information is required for client\n   to validate actual response body length against content-length\n   header field (see `nghttp2_option_set_no_http_messaging()`).  If\n   HEAD is used in request, the length of response body must be 0\n   regardless of value included in content-length header field.\n\n Performs post-process of HTTP Upgrade request.  This function can\n be called from both client and server, but the behavior is very\n different in each other.\n\n If called from client side, the |settings_payload| must be the\n value sent in ``HTTP2-Settings`` header field and must be decoded\n by base64url decoder.  The |settings_payloadlen| is the length of\n |settings_payload|.  The |settings_payload| is unpacked and its\n setting values will be submitted using `nghttp2_submit_settings()`.\n This means that the client application code does not need to submit\n SETTINGS by itself.  The stream with stream ID=1 is opened and the\n |stream_user_data| is used for its stream_user_data.  The opened\n stream becomes half-closed (local) state.\n\n If called from server side, the |settings_payload| must be the\n value received in ``HTTP2-Settings`` header field and must be\n decoded by base64url decoder.  The |settings_payloadlen| is the\n length of |settings_payload|.  It is treated as if the SETTINGS\n frame with that payload is received.  Thus, callback functions for\n the reception of SETTINGS frame will be invoked.  The stream with\n stream ID=1 is opened.  The |stream_user_data| is ignored.  The\n opened stream becomes half-closed (remote).\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |settings_payload| is badly formed.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     The stream ID 1 is already used or closed; or is not available."]
1454    pub fn nghttp2_session_upgrade(
1455        session: *mut nghttp2_session,
1456        settings_payload: *const u8,
1457        settings_payloadlen: usize,
1458        stream_user_data: *mut ::std::os::raw::c_void,
1459    ) -> ::std::os::raw::c_int;
1460}
1461unsafe extern "C" {
1462    #[doc = " @function\n\n Performs post-process of HTTP Upgrade request.  This function can\n be called from both client and server, but the behavior is very\n different in each other.\n\n If called from client side, the |settings_payload| must be the\n value sent in ``HTTP2-Settings`` header field and must be decoded\n by base64url decoder.  The |settings_payloadlen| is the length of\n |settings_payload|.  The |settings_payload| is unpacked and its\n setting values will be submitted using `nghttp2_submit_settings()`.\n This means that the client application code does not need to submit\n SETTINGS by itself.  The stream with stream ID=1 is opened and the\n |stream_user_data| is used for its stream_user_data.  The opened\n stream becomes half-closed (local) state.\n\n If called from server side, the |settings_payload| must be the\n value received in ``HTTP2-Settings`` header field and must be\n decoded by base64url decoder.  The |settings_payloadlen| is the\n length of |settings_payload|.  It is treated as if the SETTINGS\n frame with that payload is received.  Thus, callback functions for\n the reception of SETTINGS frame will be invoked.  The stream with\n stream ID=1 is opened.  The |stream_user_data| is ignored.  The\n opened stream becomes half-closed (remote).\n\n If the request method is HEAD, pass nonzero value to\n |head_request|.  Otherwise, pass 0.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |settings_payload| is badly formed.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     The stream ID 1 is already used or closed; or is not available."]
1463    pub fn nghttp2_session_upgrade2(
1464        session: *mut nghttp2_session,
1465        settings_payload: *const u8,
1466        settings_payloadlen: usize,
1467        head_request: ::std::os::raw::c_int,
1468        stream_user_data: *mut ::std::os::raw::c_void,
1469    ) -> ::std::os::raw::c_int;
1470}
1471unsafe extern "C" {
1472    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_pack_settings_payload2()` instead.\n\n Serializes the SETTINGS values |iv| in the |buf|.  The size of the\n |buf| is specified by |buflen|.  The number of entries in the |iv|\n array is given by |niv|.  The required space in |buf| for the |niv|\n entries is ``6*niv`` bytes and if the given buffer is too small, an\n error is returned.  This function is used mainly for creating a\n SETTINGS payload to be sent with the ``HTTP2-Settings`` header\n field in an HTTP Upgrade request.  The data written in |buf| is NOT\n base64url encoded and the application is responsible for encoding.\n\n This function returns the number of bytes written in |buf|, or one\n of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |iv| contains duplicate settings ID or invalid value.\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`\n     The provided |buflen| size is too small to hold the output."]
1473    pub fn nghttp2_pack_settings_payload(
1474        buf: *mut u8,
1475        buflen: usize,
1476        iv: *const nghttp2_settings_entry,
1477        niv: usize,
1478    ) -> isize;
1479}
1480unsafe extern "C" {
1481    #[doc = " @function\n\n Serializes the SETTINGS values |iv| in the |buf|.  The size of the\n |buf| is specified by |buflen|.  The number of entries in the |iv|\n array is given by |niv|.  The required space in |buf| for the |niv|\n entries is ``6*niv`` bytes and if the given buffer is too small, an\n error is returned.  This function is used mainly for creating a\n SETTINGS payload to be sent with the ``HTTP2-Settings`` header\n field in an HTTP Upgrade request.  The data written in |buf| is NOT\n base64url encoded and the application is responsible for encoding.\n\n This function returns the number of bytes written in |buf|, or one\n of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |iv| contains duplicate settings ID or invalid value.\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`\n     The provided |buflen| size is too small to hold the output."]
1482    pub fn nghttp2_pack_settings_payload2(
1483        buf: *mut u8,
1484        buflen: usize,
1485        iv: *const nghttp2_settings_entry,
1486        niv: usize,
1487    ) -> nghttp2_ssize;
1488}
1489unsafe extern "C" {
1490    #[doc = " @function\n\n Returns string describing the |lib_error_code|.  The\n |lib_error_code| must be one of the :enum:`nghttp2_error`."]
1491    pub fn nghttp2_strerror(lib_error_code: ::std::os::raw::c_int)
1492        -> *const ::std::os::raw::c_char;
1493}
1494unsafe extern "C" {
1495    #[doc = " @function\n\n Returns string representation of HTTP/2 error code |error_code|\n (e.g., ``PROTOCOL_ERROR`` is returned if ``error_code ==\n NGHTTP2_PROTOCOL_ERROR``).  If string representation is unknown for\n given |error_code|, this function returns string ``unknown``."]
1496    pub fn nghttp2_http2_strerror(error_code: u32) -> *const ::std::os::raw::c_char;
1497}
1498unsafe extern "C" {
1499    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n Initializes |pri_spec| with the |stream_id| of the stream to depend\n on with |weight| and its exclusive flag.  If |exclusive| is\n nonzero, exclusive flag is set.\n\n The |weight| must be in [:macro:`NGHTTP2_MIN_WEIGHT`,\n :macro:`NGHTTP2_MAX_WEIGHT`], inclusive."]
1500    pub fn nghttp2_priority_spec_init(
1501        pri_spec: *mut nghttp2_priority_spec,
1502        stream_id: i32,
1503        weight: i32,
1504        exclusive: ::std::os::raw::c_int,
1505    );
1506}
1507unsafe extern "C" {
1508    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n Initializes |pri_spec| with the default values.  The default values\n are: stream_id = 0, weight = :macro:`NGHTTP2_DEFAULT_WEIGHT` and\n exclusive = 0."]
1509    pub fn nghttp2_priority_spec_default_init(pri_spec: *mut nghttp2_priority_spec);
1510}
1511unsafe extern "C" {
1512    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n Returns nonzero if the |pri_spec| is filled with default values."]
1513    pub fn nghttp2_priority_spec_check_default(
1514        pri_spec: *const nghttp2_priority_spec,
1515    ) -> ::std::os::raw::c_int;
1516}
1517unsafe extern "C" {
1518    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_submit_request2()` instead.\n\n Submits HEADERS frame and optionally one or more DATA frames.\n\n The |pri_spec| is ignored.\n\n The |nva| is an array of name/value pair :type:`nghttp2_nv` with\n |nvlen| elements.  The application is responsible to include\n required pseudo-header fields (header field whose name starts with\n \":\") in |nva| and must place pseudo-headers before regular header\n fields.\n\n This function creates copies of all name/value pairs in |nva|.  It\n also lower-cases all names in |nva|.  The order of elements in\n |nva| is preserved.  For header fields with\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME` and\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE` are set,\n header field name and value are not copied respectively.  With\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`, application\n is responsible to pass header field name in lowercase.  The\n application should maintain the references to them until\n :type:`nghttp2_on_frame_send_callback` or\n :type:`nghttp2_on_frame_not_send_callback` is called.\n\n HTTP/2 specification has requirement about header fields in the\n request HEADERS.  See the specification for more details.\n\n If |data_prd| is not ``NULL``, it provides data which will be sent\n in subsequent DATA frames.  In this case, a method that allows\n request message bodies\n (https://tools.ietf.org/html/rfc7231#section-4) must be specified\n with ``:method`` key in |nva| (e.g. ``POST``).  This function does\n not take ownership of the |data_prd|.  The function copies the\n members of the |data_prd|.  If |data_prd| is ``NULL``, HEADERS have\n END_STREAM set.  The |stream_user_data| is data associated to the\n stream opened by this request and can be an arbitrary pointer,\n which can be retrieved later by\n `nghttp2_session_get_stream_user_data()`.\n\n This function returns assigned stream ID if it succeeds, or one of\n the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE`\n     No stream ID is available because maximum stream ID was\n     reached.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     The |session| is server session.\n\n .. warning::\n\n   This function returns assigned stream ID if it succeeds.  But\n   that stream is not created yet.  The application must not submit\n   frame to that stream ID before\n   :type:`nghttp2_before_frame_send_callback` is called for this\n   frame.  This means `nghttp2_session_get_stream_user_data()` does\n   not work before the callback.  But\n   `nghttp2_session_set_stream_user_data()` handles this situation\n   specially, and it can set data to a stream during this period.\n"]
1519    pub fn nghttp2_submit_request(
1520        session: *mut nghttp2_session,
1521        pri_spec: *const nghttp2_priority_spec,
1522        nva: *const nghttp2_nv,
1523        nvlen: usize,
1524        data_prd: *const nghttp2_data_provider,
1525        stream_user_data: *mut ::std::os::raw::c_void,
1526    ) -> i32;
1527}
1528unsafe extern "C" {
1529    #[doc = " @function\n\n Submits HEADERS frame and optionally one or more DATA frames.\n\n The |pri_spec| is ignored.\n\n The |nva| is an array of name/value pair :type:`nghttp2_nv` with\n |nvlen| elements.  The application is responsible to include\n required pseudo-header fields (header field whose name starts with\n \":\") in |nva| and must place pseudo-headers before regular header\n fields.\n\n This function creates copies of all name/value pairs in |nva|.  It\n also lower-cases all names in |nva|.  The order of elements in\n |nva| is preserved.  For header fields with\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME` and\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE` are set,\n header field name and value are not copied respectively.  With\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`, application\n is responsible to pass header field name in lowercase.  The\n application should maintain the references to them until\n :type:`nghttp2_on_frame_send_callback` or\n :type:`nghttp2_on_frame_not_send_callback` is called.\n\n HTTP/2 specification has requirement about header fields in the\n request HEADERS.  See the specification for more details.\n\n If |data_prd| is not ``NULL``, it provides data which will be sent\n in subsequent DATA frames.  In this case, a method that allows\n request message bodies\n (https://tools.ietf.org/html/rfc7231#section-4) must be specified\n with ``:method`` key in |nva| (e.g. ``POST``).  This function does\n not take ownership of the |data_prd|.  The function copies the\n members of the |data_prd|.  If |data_prd| is ``NULL``, HEADERS have\n END_STREAM set.  The |stream_user_data| is data associated to the\n stream opened by this request and can be an arbitrary pointer,\n which can be retrieved later by\n `nghttp2_session_get_stream_user_data()`.\n\n This function returns assigned stream ID if it succeeds, or one of\n the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE`\n     No stream ID is available because maximum stream ID was\n     reached.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     The |session| is server session.\n\n .. warning::\n\n   This function returns assigned stream ID if it succeeds.  But\n   that stream is not created yet.  The application must not submit\n   frame to that stream ID before\n   :type:`nghttp2_before_frame_send_callback` is called for this\n   frame.  This means `nghttp2_session_get_stream_user_data()` does\n   not work before the callback.  But\n   `nghttp2_session_set_stream_user_data()` handles this situation\n   specially, and it can set data to a stream during this period.\n"]
1530    pub fn nghttp2_submit_request2(
1531        session: *mut nghttp2_session,
1532        pri_spec: *const nghttp2_priority_spec,
1533        nva: *const nghttp2_nv,
1534        nvlen: usize,
1535        data_prd: *const nghttp2_data_provider2,
1536        stream_user_data: *mut ::std::os::raw::c_void,
1537    ) -> i32;
1538}
1539unsafe extern "C" {
1540    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_submit_response2()` instead.\n\n Submits response HEADERS frame and optionally one or more DATA\n frames against the stream |stream_id|.\n\n The |nva| is an array of name/value pair :type:`nghttp2_nv` with\n |nvlen| elements.  The application is responsible to include\n required pseudo-header fields (header field whose name starts with\n \":\") in |nva| and must place pseudo-headers before regular header\n fields.\n\n This function creates copies of all name/value pairs in |nva|.  It\n also lower-cases all names in |nva|.  The order of elements in\n |nva| is preserved.  For header fields with\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME` and\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE` are set,\n header field name and value are not copied respectively.  With\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`, application\n is responsible to pass header field name in lowercase.  The\n application should maintain the references to them until\n :type:`nghttp2_on_frame_send_callback` or\n :type:`nghttp2_on_frame_not_send_callback` is called.\n\n HTTP/2 specification has requirement about header fields in the\n response HEADERS.  See the specification for more details.\n\n If |data_prd| is not ``NULL``, it provides data which will be sent\n in subsequent DATA frames.  This function does not take ownership\n of the |data_prd|.  The function copies the members of the\n |data_prd|.  If |data_prd| is ``NULL``, HEADERS will have\n END_STREAM flag set.\n\n This method can be used as normal HTTP response and push response.\n When pushing a resource using this function, the |session| must be\n configured using `nghttp2_session_server_new()` or its variants and\n the target stream denoted by the |stream_id| must be reserved using\n `nghttp2_submit_push_promise()`.\n\n To send non-final response headers (e.g., HTTP status 101), don't\n use this function because this function half-closes the outbound\n stream.  Instead, use `nghttp2_submit_headers()` for this purpose.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0.\n :enum:`nghttp2_error.NGHTTP2_ERR_DATA_EXIST`\n     DATA or HEADERS has been already submitted and not fully\n     processed yet.  Normally, this does not happen, but when\n     application wrongly calls `nghttp2_submit_response()` twice,\n     this may happen.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     The |session| is client session.\n\n .. warning::\n\n   Calling this function twice for the same stream ID may lead to\n   program crash.  It is generally considered to a programming error\n   to commit response twice."]
1541    pub fn nghttp2_submit_response(
1542        session: *mut nghttp2_session,
1543        stream_id: i32,
1544        nva: *const nghttp2_nv,
1545        nvlen: usize,
1546        data_prd: *const nghttp2_data_provider,
1547    ) -> ::std::os::raw::c_int;
1548}
1549unsafe extern "C" {
1550    #[doc = " @function\n\n Submits response HEADERS frame and optionally one or more DATA\n frames against the stream |stream_id|.\n\n The |nva| is an array of name/value pair :type:`nghttp2_nv` with\n |nvlen| elements.  The application is responsible to include\n required pseudo-header fields (header field whose name starts with\n \":\") in |nva| and must place pseudo-headers before regular header\n fields.\n\n This function creates copies of all name/value pairs in |nva|.  It\n also lower-cases all names in |nva|.  The order of elements in\n |nva| is preserved.  For header fields with\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME` and\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE` are set,\n header field name and value are not copied respectively.  With\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`, application\n is responsible to pass header field name in lowercase.  The\n application should maintain the references to them until\n :type:`nghttp2_on_frame_send_callback` or\n :type:`nghttp2_on_frame_not_send_callback` is called.\n\n HTTP/2 specification has requirement about header fields in the\n response HEADERS.  See the specification for more details.\n\n If |data_prd| is not ``NULL``, it provides data which will be sent\n in subsequent DATA frames.  This function does not take ownership\n of the |data_prd|.  The function copies the members of the\n |data_prd|.  If |data_prd| is ``NULL``, HEADERS will have\n END_STREAM flag set.\n\n This method can be used as normal HTTP response and push response.\n When pushing a resource using this function, the |session| must be\n configured using `nghttp2_session_server_new()` or its variants and\n the target stream denoted by the |stream_id| must be reserved using\n `nghttp2_submit_push_promise()`.\n\n To send non-final response headers (e.g., HTTP status 101), don't\n use this function because this function half-closes the outbound\n stream.  Instead, use `nghttp2_submit_headers()` for this purpose.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0.\n :enum:`nghttp2_error.NGHTTP2_ERR_DATA_EXIST`\n     DATA or HEADERS has been already submitted and not fully\n     processed yet.  Normally, this does not happen, but when\n     application wrongly calls `nghttp2_submit_response2()` twice,\n     this may happen.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     The |session| is client session.\n\n .. warning::\n\n   Calling this function twice for the same stream ID may lead to\n   program crash.  It is generally considered to a programming error\n   to commit response twice."]
1551    pub fn nghttp2_submit_response2(
1552        session: *mut nghttp2_session,
1553        stream_id: i32,
1554        nva: *const nghttp2_nv,
1555        nvlen: usize,
1556        data_prd: *const nghttp2_data_provider2,
1557    ) -> ::std::os::raw::c_int;
1558}
1559unsafe extern "C" {
1560    #[doc = " @function\n\n Submits trailer fields HEADERS against the stream |stream_id|.\n\n The |nva| is an array of name/value pair :type:`nghttp2_nv` with\n |nvlen| elements.  The application must not include pseudo-header\n fields (headers whose names starts with \":\") in |nva|.\n\n This function creates copies of all name/value pairs in |nva|.  It\n also lower-cases all names in |nva|.  The order of elements in\n |nva| is preserved.  For header fields with\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME` and\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE` are set,\n header field name and value are not copied respectively.  With\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`, application\n is responsible to pass header field name in lowercase.  The\n application should maintain the references to them until\n :type:`nghttp2_on_frame_send_callback` or\n :type:`nghttp2_on_frame_not_send_callback` is called.\n\n For server, trailer fields must follow response HEADERS or response\n DATA without END_STREAM flat set.  The library does not enforce\n this requirement, and applications should do this for themselves.\n If `nghttp2_submit_trailer()` is called before any response HEADERS\n submission (usually by `nghttp2_submit_response2()`), the content\n of |nva| will be sent as response headers, which will result in\n error.\n\n This function has the same effect with `nghttp2_submit_headers()`,\n with flags = :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM` and both\n pri_spec and stream_user_data to NULL.\n\n To submit trailer fields after `nghttp2_submit_response2()` is\n called, the application has to specify\n :type:`nghttp2_data_provider2` to `nghttp2_submit_response2()`.\n Inside of :type:`nghttp2_data_source_read_callback2`, when setting\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_EOF`, also set\n :enum:`nghttp2_data_flag.NGHTTP2_DATA_FLAG_NO_END_STREAM`.  After\n that, the application can send trailer fields using\n `nghttp2_submit_trailer()`.  `nghttp2_submit_trailer()` can be used\n inside :type:`nghttp2_data_source_read_callback2`.\n\n This function returns 0 if it succeeds and |stream_id| is -1.\n Otherwise, this function returns 0 if it succeeds, or one of the\n following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0."]
1561    pub fn nghttp2_submit_trailer(
1562        session: *mut nghttp2_session,
1563        stream_id: i32,
1564        nva: *const nghttp2_nv,
1565        nvlen: usize,
1566    ) -> ::std::os::raw::c_int;
1567}
1568unsafe extern "C" {
1569    #[doc = " @function\n\n Submits HEADERS frame. The |flags| is bitwise OR of the\n following values:\n\n * :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM`\n\n If |flags| includes :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM`,\n this frame has END_STREAM flag set.\n\n The library handles the CONTINUATION frame internally and it\n correctly sets END_HEADERS to the last sequence of the PUSH_PROMISE\n or CONTINUATION frame.\n\n If the |stream_id| is -1, this frame is assumed as request (i.e.,\n request HEADERS frame which opens new stream).  In this case, the\n assigned stream ID will be returned.  Otherwise, specify stream ID\n in |stream_id|.\n\n The |pri_spec| is ignored.\n\n The |nva| is an array of name/value pair :type:`nghttp2_nv` with\n |nvlen| elements.  The application is responsible to include\n required pseudo-header fields (header field whose name starts with\n \":\") in |nva| and must place pseudo-headers before regular header\n fields.\n\n This function creates copies of all name/value pairs in |nva|.  It\n also lower-cases all names in |nva|.  The order of elements in\n |nva| is preserved.  For header fields with\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME` and\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE` are set,\n header field name and value are not copied respectively.  With\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`, application\n is responsible to pass header field name in lowercase.  The\n application should maintain the references to them until\n :type:`nghttp2_on_frame_send_callback` or\n :type:`nghttp2_on_frame_not_send_callback` is called.\n\n The |stream_user_data| is a pointer to an arbitrary data which is\n associated to the stream this frame will open.  Therefore it is\n only used if this frame opens streams, in other words, it changes\n stream state from idle or reserved to open.\n\n This function is low-level in a sense that the application code can\n specify flags directly.  For usual HTTP request,\n `nghttp2_submit_request2()` is useful.  Likewise, for HTTP\n response, prefer `nghttp2_submit_response2()`.\n\n This function returns newly assigned stream ID if it succeeds and\n |stream_id| is -1.  Otherwise, this function returns 0 if it\n succeeds, or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE`\n     No stream ID is available because maximum stream ID was\n     reached.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0.\n :enum:`nghttp2_error.NGHTTP2_ERR_DATA_EXIST`\n     DATA or HEADERS has been already submitted and not fully\n     processed yet.  This happens if stream denoted by |stream_id|\n     is in reserved state.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     The |stream_id| is -1, and |session| is server session.\n\n .. warning::\n\n   This function returns assigned stream ID if it succeeds and\n   |stream_id| is -1.  But that stream is not opened yet.  The\n   application must not submit frame to that stream ID before\n   :type:`nghttp2_before_frame_send_callback` is called for this\n   frame.\n"]
1570    pub fn nghttp2_submit_headers(
1571        session: *mut nghttp2_session,
1572        flags: u8,
1573        stream_id: i32,
1574        pri_spec: *const nghttp2_priority_spec,
1575        nva: *const nghttp2_nv,
1576        nvlen: usize,
1577        stream_user_data: *mut ::std::os::raw::c_void,
1578    ) -> i32;
1579}
1580unsafe extern "C" {
1581    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_submit_data2()` instead.\n\n Submits one or more DATA frames to the stream |stream_id|.  The\n data to be sent are provided by |data_prd|.  If |flags| contains\n :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM`, the last DATA frame\n has END_STREAM flag set.\n\n This function does not take ownership of the |data_prd|.  The\n function copies the members of the |data_prd|.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_DATA_EXIST`\n     DATA or HEADERS has been already submitted and not fully\n     processed yet.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0.\n :enum:`nghttp2_error.NGHTTP2_ERR_STREAM_CLOSED`\n     The stream was already closed; or the |stream_id| is invalid.\n\n .. note::\n\n   Currently, only one DATA or HEADERS is allowed for a stream at a\n   time.  Submitting these frames more than once before first DATA\n   or HEADERS is finished results in\n   :enum:`nghttp2_error.NGHTTP2_ERR_DATA_EXIST` error code.  The\n   earliest callback which tells that previous frame is done is\n   :type:`nghttp2_on_frame_send_callback`.  In side that callback,\n   new data can be submitted using `nghttp2_submit_data()`.  Of\n   course, all data except for last one must not have\n   :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM` flag set in |flags|.\n   This sounds a bit complicated, and we recommend to use\n   `nghttp2_submit_request()` and `nghttp2_submit_response()` to\n   avoid this cascading issue.  The experience shows that for HTTP\n   use, these two functions are enough to implement both client and\n   server."]
1582    pub fn nghttp2_submit_data(
1583        session: *mut nghttp2_session,
1584        flags: u8,
1585        stream_id: i32,
1586        data_prd: *const nghttp2_data_provider,
1587    ) -> ::std::os::raw::c_int;
1588}
1589unsafe extern "C" {
1590    #[doc = " @function\n\n Submits one or more DATA frames to the stream |stream_id|.  The\n data to be sent are provided by |data_prd|.  If |flags| contains\n :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM`, the last DATA frame\n has END_STREAM flag set.\n\n This function does not take ownership of the |data_prd|.  The\n function copies the members of the |data_prd|.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_DATA_EXIST`\n     DATA or HEADERS has been already submitted and not fully\n     processed yet.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0.\n :enum:`nghttp2_error.NGHTTP2_ERR_STREAM_CLOSED`\n     The stream was already closed; or the |stream_id| is invalid.\n\n .. note::\n\n   Currently, only one DATA or HEADERS is allowed for a stream at a\n   time.  Submitting these frames more than once before first DATA\n   or HEADERS is finished results in\n   :enum:`nghttp2_error.NGHTTP2_ERR_DATA_EXIST` error code.  The\n   earliest callback which tells that previous frame is done is\n   :type:`nghttp2_on_frame_send_callback`.  In side that callback,\n   new data can be submitted using `nghttp2_submit_data2()`.  Of\n   course, all data except for last one must not have\n   :enum:`nghttp2_flag.NGHTTP2_FLAG_END_STREAM` flag set in |flags|.\n   This sounds a bit complicated, and we recommend to use\n   `nghttp2_submit_request2()` and `nghttp2_submit_response2()` to\n   avoid this cascading issue.  The experience shows that for HTTP\n   use, these two functions are enough to implement both client and\n   server."]
1591    pub fn nghttp2_submit_data2(
1592        session: *mut nghttp2_session,
1593        flags: u8,
1594        stream_id: i32,
1595        data_prd: *const nghttp2_data_provider2,
1596    ) -> ::std::os::raw::c_int;
1597}
1598unsafe extern "C" {
1599    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function is noop.  It always returns 0."]
1600    pub fn nghttp2_submit_priority(
1601        session: *mut nghttp2_session,
1602        flags: u8,
1603        stream_id: i32,
1604        pri_spec: *const nghttp2_priority_spec,
1605    ) -> ::std::os::raw::c_int;
1606}
1607#[doc = " @struct\n\n :type:`nghttp2_extpri` is :rfc:`9218` extensible priorities\n specification for a stream."]
1608#[repr(C)]
1609#[derive(Debug, Copy, Clone)]
1610pub struct nghttp2_extpri {
1611    #[doc = " :member:`urgency` is the urgency of a stream, it must be in\n [:macro:`NGHTTP2_EXTPRI_URGENCY_HIGH`,\n :macro:`NGHTTP2_EXTPRI_URGENCY_LOW`], inclusive, and 0 is the\n highest urgency."]
1612    pub urgency: u32,
1613    #[doc = " :member:`inc` indicates that a content can be processed\n incrementally or not.  If inc is 0, it cannot be processed\n incrementally.  If inc is 1, it can be processed incrementally.\n Other value is not permitted."]
1614    pub inc: ::std::os::raw::c_int,
1615}
1616unsafe extern "C" {
1617    #[doc = " @function\n\n Submits RST_STREAM frame to cancel/reject the stream |stream_id|\n with the error code |error_code|.\n\n The pre-defined error code is one of :enum:`nghttp2_error_code`.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0."]
1618    pub fn nghttp2_submit_rst_stream(
1619        session: *mut nghttp2_session,
1620        flags: u8,
1621        stream_id: i32,
1622        error_code: u32,
1623    ) -> ::std::os::raw::c_int;
1624}
1625unsafe extern "C" {
1626    #[doc = " @function\n\n Stores local settings and submits SETTINGS frame.  The |iv| is the\n pointer to the array of :type:`nghttp2_settings_entry`.  The |niv|\n indicates the number of :type:`nghttp2_settings_entry`.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n This function does not take ownership of the |iv|.  This function\n copies all the elements in the |iv|.\n\n While updating individual stream's local window size, if the window\n size becomes strictly larger than NGHTTP2_MAX_WINDOW_SIZE,\n RST_STREAM is issued against such a stream.\n\n SETTINGS with :enum:`nghttp2_flag.NGHTTP2_FLAG_ACK` is\n automatically submitted by the library and application could not\n send it at its will.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |iv| contains invalid value (e.g., initial window size\n     strictly greater than (1 << 31) - 1.\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1627    pub fn nghttp2_submit_settings(
1628        session: *mut nghttp2_session,
1629        flags: u8,
1630        iv: *const nghttp2_settings_entry,
1631        niv: usize,
1632    ) -> ::std::os::raw::c_int;
1633}
1634unsafe extern "C" {
1635    #[doc = " @function\n\n Submits PUSH_PROMISE frame.\n\n The |flags| is currently ignored.  The library handles the\n CONTINUATION frame internally and it correctly sets END_HEADERS to\n the last sequence of the PUSH_PROMISE or CONTINUATION frame.\n\n The |stream_id| must be client initiated stream ID.\n\n The |nva| is an array of name/value pair :type:`nghttp2_nv` with\n |nvlen| elements.  The application is responsible to include\n required pseudo-header fields (header field whose name starts with\n \":\") in |nva| and must place pseudo-headers before regular header\n fields.\n\n This function creates copies of all name/value pairs in |nva|.  It\n also lower-cases all names in |nva|.  The order of elements in\n |nva| is preserved.  For header fields with\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME` and\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_VALUE` are set,\n header field name and value are not copied respectively.  With\n :enum:`nghttp2_nv_flag.NGHTTP2_NV_FLAG_NO_COPY_NAME`, application\n is responsible to pass header field name in lowercase.  The\n application should maintain the references to them until\n :type:`nghttp2_on_frame_send_callback` or\n :type:`nghttp2_on_frame_not_send_callback` is called.\n\n The |promised_stream_user_data| is a pointer to an arbitrary data\n which is associated to the promised stream this frame will open and\n make it in reserved state.  It is available using\n `nghttp2_session_get_stream_user_data()`.  The application can\n access it in :type:`nghttp2_before_frame_send_callback` and\n :type:`nghttp2_on_frame_send_callback` of this frame.\n\n The client side is not allowed to use this function.\n\n To submit response headers and data, use\n `nghttp2_submit_response2()`.\n\n This function returns assigned promised stream ID if it succeeds,\n or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_PROTO`\n     This function was invoked when |session| is initialized as\n     client.\n :enum:`nghttp2_error.NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE`\n     No stream ID is available because maximum stream ID was\n     reached.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is 0; The |stream_id| does not designate stream\n     that peer initiated.\n :enum:`nghttp2_error.NGHTTP2_ERR_STREAM_CLOSED`\n     The stream was already closed; or the |stream_id| is invalid.\n\n .. warning::\n\n   This function returns assigned promised stream ID if it succeeds.\n   As of 1.16.0, stream object for pushed resource is created when\n   this function succeeds.  In that case, the application can submit\n   push response for the promised frame.\n\n   In 1.15.0 or prior versions, pushed stream is not opened yet when\n   this function succeeds.  The application must not submit frame to\n   that stream ID before :type:`nghttp2_before_frame_send_callback`\n   is called for this frame.\n"]
1636    pub fn nghttp2_submit_push_promise(
1637        session: *mut nghttp2_session,
1638        flags: u8,
1639        stream_id: i32,
1640        nva: *const nghttp2_nv,
1641        nvlen: usize,
1642        promised_stream_user_data: *mut ::std::os::raw::c_void,
1643    ) -> i32;
1644}
1645unsafe extern "C" {
1646    #[doc = " @function\n\n Submits PING frame.  You don't have to send PING back when you\n received PING frame.  The library automatically submits PING frame\n in this case.\n\n The |flags| is bitwise OR of 0 or more of the following value.\n\n * :enum:`nghttp2_flag.NGHTTP2_FLAG_ACK`\n\n Unless `nghttp2_option_set_no_auto_ping_ack()` is used, the |flags|\n should be :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n If the |opaque_data| is non ``NULL``, then it should point to the 8\n bytes array of memory to specify opaque data to send with PING\n frame.  If the |opaque_data| is ``NULL``, zero-cleared 8 bytes will\n be sent as opaque data.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1647    pub fn nghttp2_submit_ping(
1648        session: *mut nghttp2_session,
1649        flags: u8,
1650        opaque_data: *const u8,
1651    ) -> ::std::os::raw::c_int;
1652}
1653unsafe extern "C" {
1654    #[doc = " @function\n\n Submits GOAWAY frame with the last stream ID |last_stream_id| and\n the error code |error_code|.\n\n The pre-defined error code is one of :enum:`nghttp2_error_code`.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n The |last_stream_id| is peer's stream ID or 0.  So if |session| is\n initialized as client, |last_stream_id| must be even or 0.  If\n |session| is initialized as server, |last_stream_id| must be odd or\n 0.\n\n The HTTP/2 specification says last_stream_id must not be increased\n from the value previously sent.  So the actual value sent as\n last_stream_id is the minimum value between the given\n |last_stream_id| and the last_stream_id previously sent to the\n peer.\n\n If the |opaque_data| is not ``NULL`` and |opaque_data_len| is not\n zero, those data will be sent as additional debug data.  The\n library makes a copy of the memory region pointed by |opaque_data|\n with the length |opaque_data_len|, so the caller does not need to\n keep this memory after the return of this function.  If the\n |opaque_data_len| is 0, the |opaque_data| could be ``NULL``.\n\n After successful transmission of GOAWAY, following things happen.\n All incoming streams having strictly more than |last_stream_id| are\n closed.  All incoming HEADERS which starts new stream are simply\n ignored.  After all active streams are handled, both\n `nghttp2_session_want_read()` and `nghttp2_session_want_write()`\n return 0 and the application can close session.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |opaque_data_len| is too large; the |last_stream_id| is\n     invalid."]
1655    pub fn nghttp2_submit_goaway(
1656        session: *mut nghttp2_session,
1657        flags: u8,
1658        last_stream_id: i32,
1659        error_code: u32,
1660        opaque_data: *const u8,
1661        opaque_data_len: usize,
1662    ) -> ::std::os::raw::c_int;
1663}
1664unsafe extern "C" {
1665    #[doc = " @function\n\n Returns the last stream ID of a stream for which\n :type:`nghttp2_on_frame_recv_callback` was invoked most recently.\n The returned value can be used as last_stream_id parameter for\n `nghttp2_submit_goaway()` and\n `nghttp2_session_terminate_session2()`.\n\n This function always succeeds."]
1666    pub fn nghttp2_session_get_last_proc_stream_id(session: *mut nghttp2_session) -> i32;
1667}
1668unsafe extern "C" {
1669    #[doc = " @function\n\n Returns nonzero if new request can be sent from local endpoint.\n\n This function return 0 if request is not allowed for this session.\n There are several reasons why request is not allowed.  Some of the\n reasons are: session is server; stream ID has been spent; GOAWAY\n has been sent or received.\n\n The application can call `nghttp2_submit_request2()` without\n consulting this function.  In that case,\n `nghttp2_submit_request2()` may return error.  Or, request is\n failed to sent, and :type:`nghttp2_on_stream_close_callback` is\n called."]
1670    pub fn nghttp2_session_check_request_allowed(
1671        session: *mut nghttp2_session,
1672    ) -> ::std::os::raw::c_int;
1673}
1674unsafe extern "C" {
1675    #[doc = " @function\n\n Returns nonzero if |session| is initialized as server side session."]
1676    pub fn nghttp2_session_check_server_session(
1677        session: *mut nghttp2_session,
1678    ) -> ::std::os::raw::c_int;
1679}
1680unsafe extern "C" {
1681    #[doc = " @function\n\n Submits WINDOW_UPDATE frame.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n The |stream_id| is the stream ID to send this WINDOW_UPDATE.  To\n send connection level WINDOW_UPDATE, specify 0 to |stream_id|.\n\n If the |window_size_increment| is positive, the WINDOW_UPDATE with\n that value as window_size_increment is queued.  If the\n |window_size_increment| is larger than the received bytes from the\n remote endpoint, the local window size is increased by that\n difference.  If the sole purpose is to increase the local window\n size, consider to use `nghttp2_session_set_local_window_size()`.\n\n If the |window_size_increment| is negative, the local window size\n is decreased by -|window_size_increment|.  If automatic\n WINDOW_UPDATE is enabled\n (`nghttp2_option_set_no_auto_window_update()`), and the library\n decided that the WINDOW_UPDATE should be submitted, then\n WINDOW_UPDATE is queued with the current received bytes count.  If\n the sole purpose is to decrease the local window size, consider to\n use `nghttp2_session_set_local_window_size()`.\n\n If the |window_size_increment| is 0, the function does nothing and\n returns 0.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_FLOW_CONTROL`\n     The local window size overflow or gets negative.\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1682    pub fn nghttp2_submit_window_update(
1683        session: *mut nghttp2_session,
1684        flags: u8,
1685        stream_id: i32,
1686        window_size_increment: i32,
1687    ) -> ::std::os::raw::c_int;
1688}
1689unsafe extern "C" {
1690    #[doc = " @function\n\n Set local window size (local endpoints's window size) to the given\n |window_size| for the given stream denoted by |stream_id|.  To\n change connection level window size, specify 0 to |stream_id|.  To\n increase window size, this function may submit WINDOW_UPDATE frame\n to transmission queue.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n This sounds similar to `nghttp2_submit_window_update()`, but there\n are 2 differences.  The first difference is that this function\n takes the absolute value of window size to set, rather than the\n delta.  To change the window size, this may be easier to use since\n the application just declares the intended window size, rather than\n calculating delta.  The second difference is that\n `nghttp2_submit_window_update()` affects the received bytes count\n which has not acked yet.  By the specification of\n `nghttp2_submit_window_update()`, to strictly increase the local\n window size, we have to submit delta including all received bytes\n count, which might not be desirable in some cases.  On the other\n hand, this function does not affect the received bytes count.  It\n just sets the local window size to the given value.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |stream_id| is negative.\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1691    pub fn nghttp2_session_set_local_window_size(
1692        session: *mut nghttp2_session,
1693        flags: u8,
1694        stream_id: i32,
1695        window_size: i32,
1696    ) -> ::std::os::raw::c_int;
1697}
1698unsafe extern "C" {
1699    #[doc = " @function\n\n Submits extension frame.\n\n Application can pass arbitrary frame flags and stream ID in |flags|\n and |stream_id| respectively.  The |payload| is opaque pointer, and\n it can be accessible though ``frame->ext.payload`` in\n :type:`nghttp2_pack_extension_callback2`.  The library will not own\n passed |payload| pointer.\n\n The application must set :type:`nghttp2_pack_extension_callback2`\n using `nghttp2_session_callbacks_set_pack_extension_callback2()`.\n\n The application should retain the memory pointed by |payload| until\n the transmission of extension frame is done (which is indicated by\n :type:`nghttp2_on_frame_send_callback`), or transmission fails\n (which is indicated by :type:`nghttp2_on_frame_not_send_callback`).\n If application does not touch this memory region after packing it\n into a wire format, application can free it inside\n :type:`nghttp2_pack_extension_callback2`.\n\n The standard HTTP/2 frame cannot be sent with this function, so\n |type| must be strictly grater than 0x9.  Otherwise, this function\n will fail with error code\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     If :type:`nghttp2_pack_extension_callback2` is not set.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     If  |type| specifies  standard  HTTP/2 frame  type.  The  frame\n     types  in the  rage [0x0,  0x9], both  inclusive, are  standard\n     HTTP/2 frame type, and cannot be sent using this function.\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory"]
1700    pub fn nghttp2_submit_extension(
1701        session: *mut nghttp2_session,
1702        type_: u8,
1703        flags: u8,
1704        stream_id: i32,
1705        payload: *mut ::std::os::raw::c_void,
1706    ) -> ::std::os::raw::c_int;
1707}
1708#[doc = " @struct\n\n The payload of ALTSVC frame.  ALTSVC frame is a non-critical\n extension to HTTP/2.  If this frame is received, and\n `nghttp2_option_set_user_recv_extension_type()` is not set, and\n `nghttp2_option_set_builtin_recv_extension_type()` is set for\n :enum:`nghttp2_frame_type.NGHTTP2_ALTSVC`,\n ``nghttp2_extension.payload`` will point to this struct.\n\n It has the following members:"]
1709#[repr(C)]
1710#[derive(Debug, Copy, Clone)]
1711pub struct nghttp2_ext_altsvc {
1712    #[doc = " The pointer to origin which this alternative service is\n associated with.  This is not necessarily NULL-terminated."]
1713    pub origin: *mut u8,
1714    #[doc = " The length of the |origin|."]
1715    pub origin_len: usize,
1716    #[doc = " The pointer to Alt-Svc field value contained in ALTSVC frame.\n This is not necessarily NULL-terminated."]
1717    pub field_value: *mut u8,
1718    #[doc = " The length of the |field_value|."]
1719    pub field_value_len: usize,
1720}
1721unsafe extern "C" {
1722    #[doc = " @function\n\n Submits ALTSVC frame.\n\n ALTSVC frame is a non-critical extension to HTTP/2, and defined in\n `RFC 7383 <https://tools.ietf.org/html/rfc7838#section-4>`_.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n The |origin| points to the origin this alternative service is\n associated with.  The |origin_len| is the length of the origin.  If\n |stream_id| is 0, the origin must be specified.  If |stream_id| is\n not zero, the origin must be empty (in other words, |origin_len|\n must be 0).\n\n The ALTSVC frame is only usable from server side.  If this function\n is invoked with client side session, this function returns\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     The function is called from client side session\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The sum of |origin_len| and |field_value_len| is larger than\n     16382; or |origin_len| is 0 while |stream_id| is 0; or\n     |origin_len| is not 0 while |stream_id| is not 0."]
1723    pub fn nghttp2_submit_altsvc(
1724        session: *mut nghttp2_session,
1725        flags: u8,
1726        stream_id: i32,
1727        origin: *const u8,
1728        origin_len: usize,
1729        field_value: *const u8,
1730        field_value_len: usize,
1731    ) -> ::std::os::raw::c_int;
1732}
1733#[doc = " @struct\n\n The single entry of an origin."]
1734#[repr(C)]
1735#[derive(Debug, Copy, Clone)]
1736pub struct nghttp2_origin_entry {
1737    #[doc = " The pointer to origin.  No validation is made against this field\n by the library.  This is not necessarily NULL-terminated."]
1738    pub origin: *mut u8,
1739    #[doc = " The length of the |origin|."]
1740    pub origin_len: usize,
1741}
1742#[doc = " @struct\n\n The payload of ORIGIN frame.  ORIGIN frame is a non-critical\n extension to HTTP/2 and defined by `RFC 8336\n <https://tools.ietf.org/html/rfc8336>`_.\n\n If this frame is received, and\n `nghttp2_option_set_user_recv_extension_type()` is not set, and\n `nghttp2_option_set_builtin_recv_extension_type()` is set for\n :enum:`nghttp2_frame_type.NGHTTP2_ORIGIN`,\n ``nghttp2_extension.payload`` will point to this struct.\n\n It has the following members:"]
1743#[repr(C)]
1744#[derive(Debug, Copy, Clone)]
1745pub struct nghttp2_ext_origin {
1746    #[doc = " The number of origins contained in |ov|."]
1747    pub nov: usize,
1748    #[doc = " The pointer to the array of origins contained in ORIGIN frame."]
1749    pub ov: *mut nghttp2_origin_entry,
1750}
1751unsafe extern "C" {
1752    #[doc = " @function\n\n Submits ORIGIN frame.\n\n ORIGIN frame is a non-critical extension to HTTP/2 and defined by\n `RFC 8336 <https://tools.ietf.org/html/rfc8336>`_.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n The |ov| points to the array of origins.  The |nov| specifies the\n number of origins included in |ov|.  This function creates copies\n of all elements in |ov|.\n\n The ORIGIN frame is only usable by a server.  If this function is\n invoked with client side session, this function returns\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`.\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     The function is called from client side session.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     There are too many origins, or an origin is too large to fit\n     into a default frame payload."]
1753    pub fn nghttp2_submit_origin(
1754        session: *mut nghttp2_session,
1755        flags: u8,
1756        ov: *const nghttp2_origin_entry,
1757        nov: usize,
1758    ) -> ::std::os::raw::c_int;
1759}
1760#[doc = " @struct\n\n The payload of PRIORITY_UPDATE frame.  PRIORITY_UPDATE frame is a\n non-critical extension to HTTP/2.  If this frame is received, and\n `nghttp2_option_set_user_recv_extension_type()` is not set, and\n `nghttp2_option_set_builtin_recv_extension_type()` is set for\n :enum:`nghttp2_frame_type.NGHTTP2_PRIORITY_UPDATE`,\n ``nghttp2_extension.payload`` will point to this struct.\n\n It has the following members:"]
1761#[repr(C)]
1762#[derive(Debug, Copy, Clone)]
1763pub struct nghttp2_ext_priority_update {
1764    #[doc = " The stream ID of the stream whose priority is updated."]
1765    pub stream_id: i32,
1766    #[doc = " The pointer to Priority field value.  It is not necessarily\n NULL-terminated."]
1767    pub field_value: *mut u8,
1768    #[doc = " The length of the :member:`field_value`."]
1769    pub field_value_len: usize,
1770}
1771unsafe extern "C" {
1772    #[doc = " @function\n\n Submits PRIORITY_UPDATE frame.\n\n PRIORITY_UPDATE frame is a non-critical extension to HTTP/2, and\n defined in :rfc:`9218#section-7.1`.\n\n The |flags| is currently ignored and should be\n :enum:`nghttp2_flag.NGHTTP2_FLAG_NONE`.\n\n The |stream_id| is the ID of stream which is prioritized.  The\n |field_value| points to the Priority field value.  The\n |field_value_len| is the length of the Priority field value.\n\n If this function is called by server,\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE` is returned.\n\n If\n :enum:`nghttp2_settings_id.NGHTTP2_SETTINGS_NO_RFC7540_PRIORITIES`\n of value of 0 is received by a remote endpoint (or it is omitted),\n this function does nothing and returns 0.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     The function is called from server side session\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     The |field_value_len| is larger than 16380; or |stream_id| is\n     0."]
1773    pub fn nghttp2_submit_priority_update(
1774        session: *mut nghttp2_session,
1775        flags: u8,
1776        stream_id: i32,
1777        field_value: *const u8,
1778        field_value_len: usize,
1779    ) -> ::std::os::raw::c_int;
1780}
1781unsafe extern "C" {
1782    #[doc = " @function\n\n Changes the priority of the existing stream denoted by |stream_id|.\n The new priority is |extpri|.  This function is meant to be used by\n server for :rfc:`9218` extensible prioritization scheme.\n\n If |session| is initialized as client, this function returns\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`.  For client, use\n `nghttp2_submit_priority_update()` instead.\n\n If :member:`extpri->urgency <nghttp2_extpri.urgency>` is out of\n bound, it is set to :macro:`NGHTTP2_EXTPRI_URGENCY_LOW`.\n\n If |ignore_client_signal| is nonzero, server starts to ignore\n client priority signals for this stream.\n\n If\n :enum:`nghttp2_settings_id.NGHTTP2_SETTINGS_NO_RFC7540_PRIORITIES`\n of value of 1 is not submitted via `nghttp2_submit_settings()`,\n this function does nothing and returns 0.\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     The |session| is initialized as client.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     |stream_id| is zero; or a stream denoted by |stream_id| is not\n     found."]
1783    pub fn nghttp2_session_change_extpri_stream_priority(
1784        session: *mut nghttp2_session,
1785        stream_id: i32,
1786        extpri: *const nghttp2_extpri,
1787        ignore_client_signal: ::std::os::raw::c_int,
1788    ) -> ::std::os::raw::c_int;
1789}
1790unsafe extern "C" {
1791    #[doc = " @function\n\n Stores the stream priority of the existing stream denoted by\n |stream_id| in the object pointed by |extpri|.  This function is\n meant to be used by server for :rfc:`9218` extensible\n prioritization scheme.\n\n If |session| is initialized as client, this function returns\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`.\n\n If\n :enum:`nghttp2_settings_id.NGHTTP2_SETTINGS_NO_RFC7540_PRIORITIES`\n of value of 1 is not submitted via `nghttp2_submit_settings()`,\n this function does nothing and returns 0.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     The |session| is initialized as client.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     |stream_id| is zero; or a stream denoted by |stream_id| is not\n     found."]
1792    pub fn nghttp2_session_get_extpri_stream_priority(
1793        session: *mut nghttp2_session,
1794        extpri: *mut nghttp2_extpri,
1795        stream_id: i32,
1796    ) -> ::std::os::raw::c_int;
1797}
1798unsafe extern "C" {
1799    #[doc = " @function\n\n Parses Priority header field value pointed by |value| of length\n |len|, and stores the result in the object pointed by |extpri|.\n Priority header field is defined in :rfc:`9218`.\n\n This function does not initialize the object pointed by |extpri|\n before storing the result.  It only assigns the values that the\n parser correctly extracted to fields.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_ARGUMENT`\n     Failed to parse the header field value."]
1800    pub fn nghttp2_extpri_parse_priority(
1801        extpri: *mut nghttp2_extpri,
1802        value: *const u8,
1803        len: usize,
1804    ) -> ::std::os::raw::c_int;
1805}
1806unsafe extern "C" {
1807    #[doc = " @function\n\n Compares ``lhs->name`` of length ``lhs->namelen`` bytes and\n ``rhs->name`` of length ``rhs->namelen`` bytes.  Returns negative\n integer if ``lhs->name`` is found to be less than ``rhs->name``; or\n returns positive integer if ``lhs->name`` is found to be greater\n than ``rhs->name``; or returns 0 otherwise."]
1808    pub fn nghttp2_nv_compare_name(
1809        lhs: *const nghttp2_nv,
1810        rhs: *const nghttp2_nv,
1811    ) -> ::std::os::raw::c_int;
1812}
1813unsafe extern "C" {
1814    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_select_alpn` instead.\n\n A helper function for dealing with ALPN in server side.  The |in|\n contains peer's protocol list in preferable order.  The format of\n |in| is length-prefixed and not null-terminated.  For example,\n ``h2`` and ``http/1.1`` stored in |in| like this::\n\n     in[0] = 2\n     in[1..2] = \"h2\"\n     in[3] = 8\n     in[4..11] = \"http/1.1\"\n     inlen = 12\n\n The selection algorithm is as follows:\n\n 1. If peer's list contains HTTP/2 protocol the library supports,\n    it is selected and returns 1. The following step is not taken.\n\n 2. If peer's list contains ``http/1.1``, this function selects\n    ``http/1.1`` and returns 0.  The following step is not taken.\n\n 3. This function selects nothing and returns -1 (So called\n    non-overlap case).  In this case, |out| and |outlen| are left\n    untouched.\n\n Selecting ``h2`` means that ``h2`` is written into |*out| and its\n length (which is 2) is assigned to |*outlen|.\n\n For ALPN, refer to https://tools.ietf.org/html/rfc7301\n\n To use this method you should do something like::\n\n     static int alpn_select_proto_cb(SSL* ssl,\n                                     const unsigned char **out,\n                                     unsigned char *outlen,\n                                     const unsigned char *in,\n                                     unsigned int inlen,\n                                     void *arg)\n     {\n         int rv;\n         rv = nghttp2_select_next_protocol((unsigned char**)out, outlen,\n                                           in, inlen);\n         if (rv == -1) {\n             return SSL_TLSEXT_ERR_NOACK;\n         }\n         if (rv == 1) {\n             ((MyType*)arg)->http2_selected = 1;\n         }\n         return SSL_TLSEXT_ERR_OK;\n     }\n     ...\n     SSL_CTX_set_alpn_select_cb(ssl_ctx, alpn_select_proto_cb, my_obj);\n"]
1815    pub fn nghttp2_select_next_protocol(
1816        out: *mut *mut ::std::os::raw::c_uchar,
1817        outlen: *mut ::std::os::raw::c_uchar,
1818        in_: *const ::std::os::raw::c_uchar,
1819        inlen: ::std::os::raw::c_uint,
1820    ) -> ::std::os::raw::c_int;
1821}
1822unsafe extern "C" {
1823    #[doc = " @function\n\n A helper function for dealing with ALPN in server side.  The |in|\n contains peer's protocol list in preferable order.  The format of\n |in| is length-prefixed and not null-terminated.  For example,\n ``h2`` and ``http/1.1`` stored in |in| like this::\n\n     in[0] = 2\n     in[1..2] = \"h2\"\n     in[3] = 8\n     in[4..11] = \"http/1.1\"\n     inlen = 12\n\n The selection algorithm is as follows:\n\n 1. If peer's list contains HTTP/2 protocol the library supports,\n    it is selected and returns 1. The following step is not taken.\n\n 2. If peer's list contains ``http/1.1``, this function selects\n    ``http/1.1`` and returns 0.  The following step is not taken.\n\n 3. This function selects nothing and returns -1 (So called\n    non-overlap case).  In this case, |out| and |outlen| are left\n    untouched.\n\n Selecting ``h2`` means that ``h2`` is written into |*out| and its\n length (which is 2) is assigned to |*outlen|.\n\n For ALPN, refer to https://tools.ietf.org/html/rfc7301\n\n To use this method you should do something like::\n\n     static int alpn_select_proto_cb(SSL* ssl,\n                                     const unsigned char **out,\n                                     unsigned char *outlen,\n                                     const unsigned char *in,\n                                     unsigned int inlen,\n                                     void *arg)\n     {\n         int rv;\n         rv = nghttp2_select_alpn(out, outlen, in, inlen);\n         if (rv == -1) {\n             return SSL_TLSEXT_ERR_NOACK;\n         }\n         if (rv == 1) {\n             ((MyType*)arg)->http2_selected = 1;\n         }\n         return SSL_TLSEXT_ERR_OK;\n     }\n     ...\n     SSL_CTX_set_alpn_select_cb(ssl_ctx, alpn_select_proto_cb, my_obj);\n"]
1824    pub fn nghttp2_select_alpn(
1825        out: *mut *const ::std::os::raw::c_uchar,
1826        outlen: *mut ::std::os::raw::c_uchar,
1827        in_: *const ::std::os::raw::c_uchar,
1828        inlen: ::std::os::raw::c_uint,
1829    ) -> ::std::os::raw::c_int;
1830}
1831unsafe extern "C" {
1832    #[doc = " @function\n\n Returns a pointer to a nghttp2_info struct with version information\n about the run-time library in use.  The |least_version| argument\n can be set to a 24 bit numerical value for the least accepted\n version number and if the condition is not met, this function will\n return a ``NULL``.  Pass in 0 to skip the version checking."]
1833    pub fn nghttp2_version(least_version: ::std::os::raw::c_int) -> *mut nghttp2_info;
1834}
1835unsafe extern "C" {
1836    #[doc = " @function\n\n Returns nonzero if the :type:`nghttp2_error` library error code\n |lib_error| is fatal."]
1837    pub fn nghttp2_is_fatal(lib_error_code: ::std::os::raw::c_int) -> ::std::os::raw::c_int;
1838}
1839unsafe extern "C" {
1840    #[doc = " @function\n\n Returns nonzero if HTTP header field name |name| of length |len| is\n valid according to http://tools.ietf.org/html/rfc7230#section-3.2\n\n Because this is a header field name in HTTP2, the upper cased alphabet\n is treated as error."]
1841    pub fn nghttp2_check_header_name(name: *const u8, len: usize) -> ::std::os::raw::c_int;
1842}
1843unsafe extern "C" {
1844    #[doc = " @function\n\n Returns nonzero if HTTP header field value |value| of length |len|\n is valid according to\n http://tools.ietf.org/html/rfc7230#section-3.2\n\n This function is considered obsolete, and application should\n consider to use `nghttp2_check_header_value_rfc9113()` instead."]
1845    pub fn nghttp2_check_header_value(value: *const u8, len: usize) -> ::std::os::raw::c_int;
1846}
1847unsafe extern "C" {
1848    #[doc = " @function\n\n Returns nonzero if HTTP header field value |value| of length |len|\n is valid according to\n http://tools.ietf.org/html/rfc7230#section-3.2, plus\n https://datatracker.ietf.org/doc/html/rfc9113#section-8.2.1"]
1849    pub fn nghttp2_check_header_value_rfc9113(
1850        value: *const u8,
1851        len: usize,
1852    ) -> ::std::os::raw::c_int;
1853}
1854unsafe extern "C" {
1855    #[doc = " @function\n\n Returns nonzero if the |value| which is supposed to be the value of\n the :method header field is valid according to\n https://datatracker.ietf.org/doc/html/rfc7231#section-4 and\n https://datatracker.ietf.org/doc/html/rfc7230#section-3.2.6"]
1856    pub fn nghttp2_check_method(value: *const u8, len: usize) -> ::std::os::raw::c_int;
1857}
1858unsafe extern "C" {
1859    #[doc = " @function\n\n Returns nonzero if the |value| which is supposed to be the value of\n the :path header field is valid according to\n https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.3\n\n |value| is valid if it merely consists of the allowed characters.\n In particular, it does not check whether |value| follows the syntax\n of path.  The allowed characters are all characters valid by\n `nghttp2_check_header_value` minus SPC and HT."]
1860    pub fn nghttp2_check_path(value: *const u8, len: usize) -> ::std::os::raw::c_int;
1861}
1862unsafe extern "C" {
1863    #[doc = " @function\n\n Returns nonzero if the |value| which is supposed to be the value of the\n :authority or host header field is valid according to\n https://tools.ietf.org/html/rfc3986#section-3.2\n\n Note that :authority and host field values are not authority.  They\n do not include userinfo in RFC 3986, see\n https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2, that\n is, it does not include '@'.  This function treats '@' as a valid\n character.\n\n |value| is valid if it merely consists of the allowed characters.\n In particular, it does not check whether |value| follows the syntax\n of authority."]
1864    pub fn nghttp2_check_authority(value: *const u8, len: usize) -> ::std::os::raw::c_int;
1865}
1866#[repr(C)]
1867#[derive(Debug, Copy, Clone)]
1868pub struct nghttp2_hd_deflater {
1869    _unused: [u8; 0],
1870}
1871unsafe extern "C" {
1872    #[doc = " @function\n\n Initializes |*deflater_ptr| for deflating name/values pairs.\n\n The |max_deflate_dynamic_table_size| is the upper bound of header\n table size the deflater will use.\n\n If this function fails, |*deflater_ptr| is left untouched.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1873    pub fn nghttp2_hd_deflate_new(
1874        deflater_ptr: *mut *mut nghttp2_hd_deflater,
1875        max_deflate_dynamic_table_size: usize,
1876    ) -> ::std::os::raw::c_int;
1877}
1878unsafe extern "C" {
1879    #[doc = " @function\n\n Like `nghttp2_hd_deflate_new()`, but with additional custom memory\n allocator specified in the |mem|.\n\n The |mem| can be ``NULL`` and the call is equivalent to\n `nghttp2_hd_deflate_new()`.\n\n This function does not take ownership |mem|.  The application is\n responsible for freeing |mem|.\n\n The library code does not refer to |mem| pointer after this\n function returns, so the application can safely free it."]
1880    pub fn nghttp2_hd_deflate_new2(
1881        deflater_ptr: *mut *mut nghttp2_hd_deflater,
1882        max_deflate_dynamic_table_size: usize,
1883        mem: *mut nghttp2_mem,
1884    ) -> ::std::os::raw::c_int;
1885}
1886unsafe extern "C" {
1887    #[doc = " @function\n\n Deallocates any resources allocated for |deflater|."]
1888    pub fn nghttp2_hd_deflate_del(deflater: *mut nghttp2_hd_deflater);
1889}
1890unsafe extern "C" {
1891    #[doc = " @function\n\n Changes header table size of the |deflater| to\n |settings_max_dynamic_table_size| bytes.  This may trigger eviction\n in the dynamic table.\n\n The |settings_max_dynamic_table_size| should be the value received\n in SETTINGS_HEADER_TABLE_SIZE.\n\n The deflater never uses more memory than\n ``max_deflate_dynamic_table_size`` bytes specified in\n `nghttp2_hd_deflate_new()`.  Therefore, if\n |settings_max_dynamic_table_size| >\n ``max_deflate_dynamic_table_size``, resulting maximum table size\n becomes ``max_deflate_dynamic_table_size``.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1892    pub fn nghttp2_hd_deflate_change_table_size(
1893        deflater: *mut nghttp2_hd_deflater,
1894        settings_max_dynamic_table_size: usize,
1895    ) -> ::std::os::raw::c_int;
1896}
1897unsafe extern "C" {
1898    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_hd_deflate_hd2()` instead.\n\n Deflates the |nva|, which has the |nvlen| name/value pairs, into\n the |buf| of length |buflen|.\n\n If |buf| is not large enough to store the deflated header block,\n this function fails with\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`.  The caller\n should use `nghttp2_hd_deflate_bound()` to know the upper bound of\n buffer size required to deflate given header name/value pairs.\n\n Once this function fails, subsequent call of this function always\n returns :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`.\n\n After this function returns, it is safe to delete the |nva|.\n\n This function returns the number of bytes written to |buf| if it\n succeeds, or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`\n     Deflation process has failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`\n     The provided |buflen| size is too small to hold the output."]
1899    pub fn nghttp2_hd_deflate_hd(
1900        deflater: *mut nghttp2_hd_deflater,
1901        buf: *mut u8,
1902        buflen: usize,
1903        nva: *const nghttp2_nv,
1904        nvlen: usize,
1905    ) -> isize;
1906}
1907unsafe extern "C" {
1908    #[doc = " @function\n\n Deflates the |nva|, which has the |nvlen| name/value pairs, into\n the |buf| of length |buflen|.\n\n If |buf| is not large enough to store the deflated header block,\n this function fails with\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`.  The caller\n should use `nghttp2_hd_deflate_bound()` to know the upper bound of\n buffer size required to deflate given header name/value pairs.\n\n Once this function fails, subsequent call of this function always\n returns :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`.\n\n After this function returns, it is safe to delete the |nva|.\n\n This function returns the number of bytes written to |buf| if it\n succeeds, or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`\n     Deflation process has failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`\n     The provided |buflen| size is too small to hold the output."]
1909    pub fn nghttp2_hd_deflate_hd2(
1910        deflater: *mut nghttp2_hd_deflater,
1911        buf: *mut u8,
1912        buflen: usize,
1913        nva: *const nghttp2_nv,
1914        nvlen: usize,
1915    ) -> nghttp2_ssize;
1916}
1917unsafe extern "C" {
1918    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_hd_deflate_hd_vec2()` instead.\n\n Deflates the |nva|, which has the |nvlen| name/value pairs, into\n the |veclen| size of buf vector |vec|.  The each size of buffer\n must be set in len field of :type:`nghttp2_vec`.  If and only if\n one chunk is filled up completely, next chunk will be used.  If\n |vec| is not large enough to store the deflated header block, this\n function fails with\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`.  The caller\n should use `nghttp2_hd_deflate_bound()` to know the upper bound of\n buffer size required to deflate given header name/value pairs.\n\n Once this function fails, subsequent call of this function always\n returns :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`.\n\n After this function returns, it is safe to delete the |nva|.\n\n This function returns the number of bytes written to |vec| if it\n succeeds, or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`\n     Deflation process has failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`\n     The provided |buflen| size is too small to hold the output."]
1919    pub fn nghttp2_hd_deflate_hd_vec(
1920        deflater: *mut nghttp2_hd_deflater,
1921        vec: *const nghttp2_vec,
1922        veclen: usize,
1923        nva: *const nghttp2_nv,
1924        nvlen: usize,
1925    ) -> isize;
1926}
1927unsafe extern "C" {
1928    #[doc = " @function\n\n Deflates the |nva|, which has the |nvlen| name/value pairs, into\n the |veclen| size of buf vector |vec|.  The each size of buffer\n must be set in len field of :type:`nghttp2_vec`.  If and only if\n one chunk is filled up completely, next chunk will be used.  If\n |vec| is not large enough to store the deflated header block, this\n function fails with\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`.  The caller\n should use `nghttp2_hd_deflate_bound()` to know the upper bound of\n buffer size required to deflate given header name/value pairs.\n\n Once this function fails, subsequent call of this function always\n returns :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`.\n\n After this function returns, it is safe to delete the |nva|.\n\n This function returns the number of bytes written to |vec| if it\n succeeds, or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`\n     Deflation process has failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_INSUFF_BUFSIZE`\n     The provided |buflen| size is too small to hold the output."]
1929    pub fn nghttp2_hd_deflate_hd_vec2(
1930        deflater: *mut nghttp2_hd_deflater,
1931        vec: *const nghttp2_vec,
1932        veclen: usize,
1933        nva: *const nghttp2_nv,
1934        nvlen: usize,
1935    ) -> nghttp2_ssize;
1936}
1937unsafe extern "C" {
1938    #[doc = " @function\n\n Returns an upper bound on the compressed size after deflation of\n |nva| of length |nvlen|."]
1939    pub fn nghttp2_hd_deflate_bound(
1940        deflater: *mut nghttp2_hd_deflater,
1941        nva: *const nghttp2_nv,
1942        nvlen: usize,
1943    ) -> usize;
1944}
1945unsafe extern "C" {
1946    #[doc = " @function\n\n Returns the number of entries that header table of |deflater|\n contains.  This is the sum of the number of static table and\n dynamic table, so the return value is at least 61."]
1947    pub fn nghttp2_hd_deflate_get_num_table_entries(deflater: *mut nghttp2_hd_deflater) -> usize;
1948}
1949unsafe extern "C" {
1950    #[doc = " @function\n\n Returns the table entry denoted by |idx| from header table of\n |deflater|.  The |idx| is 1-based, and idx=1 returns first entry of\n static table.  idx=62 returns first entry of dynamic table if it\n exists.  Specifying idx=0 is error, and this function returns NULL.\n If |idx| is strictly greater than the number of entries the tables\n contain, this function returns NULL."]
1951    pub fn nghttp2_hd_deflate_get_table_entry(
1952        deflater: *mut nghttp2_hd_deflater,
1953        idx: usize,
1954    ) -> *const nghttp2_nv;
1955}
1956unsafe extern "C" {
1957    #[doc = " @function\n\n Returns the used dynamic table size, including the overhead 32\n bytes per entry described in RFC 7541."]
1958    pub fn nghttp2_hd_deflate_get_dynamic_table_size(deflater: *mut nghttp2_hd_deflater) -> usize;
1959}
1960unsafe extern "C" {
1961    #[doc = " @function\n\n Returns the maximum dynamic table size."]
1962    pub fn nghttp2_hd_deflate_get_max_dynamic_table_size(
1963        deflater: *mut nghttp2_hd_deflater,
1964    ) -> usize;
1965}
1966#[repr(C)]
1967#[derive(Debug, Copy, Clone)]
1968pub struct nghttp2_hd_inflater {
1969    _unused: [u8; 0],
1970}
1971unsafe extern "C" {
1972    #[doc = " @function\n\n Initializes |*inflater_ptr| for inflating name/values pairs.\n\n If this function fails, |*inflater_ptr| is left untouched.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory."]
1973    pub fn nghttp2_hd_inflate_new(
1974        inflater_ptr: *mut *mut nghttp2_hd_inflater,
1975    ) -> ::std::os::raw::c_int;
1976}
1977unsafe extern "C" {
1978    #[doc = " @function\n\n Like `nghttp2_hd_inflate_new()`, but with additional custom memory\n allocator specified in the |mem|.\n\n The |mem| can be ``NULL`` and the call is equivalent to\n `nghttp2_hd_inflate_new()`.\n\n This function does not take ownership |mem|.  The application is\n responsible for freeing |mem|.\n\n The library code does not refer to |mem| pointer after this\n function returns, so the application can safely free it."]
1979    pub fn nghttp2_hd_inflate_new2(
1980        inflater_ptr: *mut *mut nghttp2_hd_inflater,
1981        mem: *mut nghttp2_mem,
1982    ) -> ::std::os::raw::c_int;
1983}
1984unsafe extern "C" {
1985    #[doc = " @function\n\n Deallocates any resources allocated for |inflater|."]
1986    pub fn nghttp2_hd_inflate_del(inflater: *mut nghttp2_hd_inflater);
1987}
1988unsafe extern "C" {
1989    #[doc = " @function\n\n Changes header table size in the |inflater|.  This may trigger\n eviction in the dynamic table.\n\n The |settings_max_dynamic_table_size| should be the value\n transmitted in SETTINGS_HEADER_TABLE_SIZE.\n\n This function must not be called while header block is being\n inflated.  In other words, this function must be called after\n initialization of |inflater|, but before calling\n `nghttp2_hd_inflate_hd3()`, or after\n `nghttp2_hd_inflate_end_headers()`.  Otherwise,\n `NGHTTP2_ERR_INVALID_STATE` was returned.\n\n This function returns 0 if it succeeds, or one of the following\n negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_INVALID_STATE`\n     The function is called while header block is being inflated.\n     Probably, application missed to call\n     `nghttp2_hd_inflate_end_headers()`."]
1990    pub fn nghttp2_hd_inflate_change_table_size(
1991        inflater: *mut nghttp2_hd_inflater,
1992        settings_max_dynamic_table_size: usize,
1993    ) -> ::std::os::raw::c_int;
1994}
1995#[doc = " No flag set."]
1996pub const NGHTTP2_HD_INFLATE_NONE: nghttp2_hd_inflate_flag = 0;
1997#[doc = " Indicates all headers were inflated."]
1998pub const NGHTTP2_HD_INFLATE_FINAL: nghttp2_hd_inflate_flag = 1;
1999#[doc = " Indicates a header was emitted."]
2000pub const NGHTTP2_HD_INFLATE_EMIT: nghttp2_hd_inflate_flag = 2;
2001#[doc = " @enum\n\n The flags for header inflation."]
2002pub type nghttp2_hd_inflate_flag = ::std::os::raw::c_uint;
2003unsafe extern "C" {
2004    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_hd_inflate_hd2()` instead.\n\n Inflates name/value block stored in |in| with length |inlen|.  This\n function performs decompression.  For each successful emission of\n header name/value pair,\n :enum:`nghttp2_hd_inflate_flag.NGHTTP2_HD_INFLATE_EMIT` is set in\n |*inflate_flags| and name/value pair is assigned to the |nv_out|\n and the function returns.  The caller must not free the members of\n |nv_out|.\n\n The |nv_out| may include pointers to the memory region in the |in|.\n The caller must retain the |in| while the |nv_out| is used.\n\n The application should call this function repeatedly until the\n ``(*inflate_flags) & NGHTTP2_HD_INFLATE_FINAL`` is nonzero and\n return value is non-negative.  This means the all input values are\n processed successfully.  Then the application must call\n `nghttp2_hd_inflate_end_headers()` to prepare for the next header\n block input.\n\n The caller can feed complete compressed header block.  It also can\n feed it in several chunks.  The caller must set |in_final| to\n nonzero if the given input is the last block of the compressed\n header.\n\n This function returns the number of bytes processed if it succeeds,\n or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`\n     Inflation process has failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_BUFFER_ERROR`\n     The header field name or value is too large.\n\n Example follows::\n\n     int inflate_header_block(nghttp2_hd_inflater *hd_inflater,\n                              uint8_t *in, size_t inlen, int final)\n     {\n         ssize_t rv;\n\n         for(;;) {\n             nghttp2_nv nv;\n             int inflate_flags = 0;\n\n             rv = nghttp2_hd_inflate_hd(hd_inflater, &nv, &inflate_flags,\n                                        in, inlen, final);\n\n             if(rv < 0) {\n                 fprintf(stderr, \"inflate failed with error code %zd\", rv);\n                 return -1;\n             }\n\n             in += rv;\n             inlen -= rv;\n\n             if(inflate_flags & NGHTTP2_HD_INFLATE_EMIT) {\n                 fwrite(nv.name, nv.namelen, 1, stderr);\n                 fprintf(stderr, \": \");\n                 fwrite(nv.value, nv.valuelen, 1, stderr);\n                 fprintf(stderr, \"\\n\");\n             }\n             if(inflate_flags & NGHTTP2_HD_INFLATE_FINAL) {\n                 nghttp2_hd_inflate_end_headers(hd_inflater);\n                 break;\n             }\n             if((inflate_flags & NGHTTP2_HD_INFLATE_EMIT) == 0 &&\n                inlen == 0) {\n                break;\n             }\n         }\n\n         return 0;\n     }\n"]
2005    pub fn nghttp2_hd_inflate_hd(
2006        inflater: *mut nghttp2_hd_inflater,
2007        nv_out: *mut nghttp2_nv,
2008        inflate_flags: *mut ::std::os::raw::c_int,
2009        in_: *mut u8,
2010        inlen: usize,
2011        in_final: ::std::os::raw::c_int,
2012    ) -> isize;
2013}
2014unsafe extern "C" {
2015    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  Use `nghttp2_hd_inflate_hd3()` instead.\n\n Inflates name/value block stored in |in| with length |inlen|.  This\n function performs decompression.  For each successful emission of\n header name/value pair,\n :enum:`nghttp2_hd_inflate_flag.NGHTTP2_HD_INFLATE_EMIT` is set in\n |*inflate_flags| and name/value pair is assigned to the |nv_out|\n and the function returns.  The caller must not free the members of\n |nv_out|.\n\n The |nv_out| may include pointers to the memory region in the |in|.\n The caller must retain the |in| while the |nv_out| is used.\n\n The application should call this function repeatedly until the\n ``(*inflate_flags) & NGHTTP2_HD_INFLATE_FINAL`` is nonzero and\n return value is non-negative.  If that happens, all given input\n data (|inlen| bytes) are processed successfully.  Then the\n application must call `nghttp2_hd_inflate_end_headers()` to prepare\n for the next header block input.\n\n In other words, if |in_final| is nonzero, and this function returns\n |inlen|, you can assert that\n :enum:`nghttp2_hd_inflate_final.NGHTTP2_HD_INFLATE_FINAL` is set in\n |*inflate_flags|.\n\n The caller can feed complete compressed header block.  It also can\n feed it in several chunks.  The caller must set |in_final| to\n nonzero if the given input is the last block of the compressed\n header.\n\n This function returns the number of bytes processed if it succeeds,\n or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`\n     Inflation process has failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_BUFFER_ERROR`\n     The header field name or value is too large.\n\n Example follows::\n\n     int inflate_header_block(nghttp2_hd_inflater *hd_inflater,\n                              uint8_t *in, size_t inlen, int final)\n     {\n         ssize_t rv;\n\n         for(;;) {\n             nghttp2_nv nv;\n             int inflate_flags = 0;\n\n             rv = nghttp2_hd_inflate_hd2(hd_inflater, &nv, &inflate_flags,\n                                         in, inlen, final);\n\n             if(rv < 0) {\n                 fprintf(stderr, \"inflate failed with error code %zd\", rv);\n                 return -1;\n             }\n\n             in += rv;\n             inlen -= rv;\n\n             if(inflate_flags & NGHTTP2_HD_INFLATE_EMIT) {\n                 fwrite(nv.name, nv.namelen, 1, stderr);\n                 fprintf(stderr, \": \");\n                 fwrite(nv.value, nv.valuelen, 1, stderr);\n                 fprintf(stderr, \"\\n\");\n             }\n             if(inflate_flags & NGHTTP2_HD_INFLATE_FINAL) {\n                 nghttp2_hd_inflate_end_headers(hd_inflater);\n                 break;\n             }\n             if((inflate_flags & NGHTTP2_HD_INFLATE_EMIT) == 0 &&\n                inlen == 0) {\n                break;\n             }\n         }\n\n         return 0;\n     }\n"]
2016    pub fn nghttp2_hd_inflate_hd2(
2017        inflater: *mut nghttp2_hd_inflater,
2018        nv_out: *mut nghttp2_nv,
2019        inflate_flags: *mut ::std::os::raw::c_int,
2020        in_: *const u8,
2021        inlen: usize,
2022        in_final: ::std::os::raw::c_int,
2023    ) -> isize;
2024}
2025unsafe extern "C" {
2026    #[doc = " @function\n\n Inflates name/value block stored in |in| with length |inlen|.  This\n function performs decompression.  For each successful emission of\n header name/value pair,\n :enum:`nghttp2_hd_inflate_flag.NGHTTP2_HD_INFLATE_EMIT` is set in\n |*inflate_flags| and name/value pair is assigned to the |nv_out|\n and the function returns.  The caller must not free the members of\n |nv_out|.\n\n The |nv_out| may include pointers to the memory region in the |in|.\n The caller must retain the |in| while the |nv_out| is used.\n\n The application should call this function repeatedly until the\n ``(*inflate_flags) & NGHTTP2_HD_INFLATE_FINAL`` is nonzero and\n return value is non-negative.  If that happens, all given input\n data (|inlen| bytes) are processed successfully.  Then the\n application must call `nghttp2_hd_inflate_end_headers()` to prepare\n for the next header block input.\n\n In other words, if |in_final| is nonzero, and this function returns\n |inlen|, you can assert that\n :enum:`nghttp2_hd_inflate_final.NGHTTP2_HD_INFLATE_FINAL` is set in\n |*inflate_flags|.\n\n The caller can feed complete compressed header block.  It also can\n feed it in several chunks.  The caller must set |in_final| to\n nonzero if the given input is the last block of the compressed\n header.\n\n This function returns the number of bytes processed if it succeeds,\n or one of the following negative error codes:\n\n :enum:`nghttp2_error.NGHTTP2_ERR_NOMEM`\n     Out of memory.\n :enum:`nghttp2_error.NGHTTP2_ERR_HEADER_COMP`\n     Inflation process has failed.\n :enum:`nghttp2_error.NGHTTP2_ERR_BUFFER_ERROR`\n     The header field name or value is too large.\n\n Example follows::\n\n     int inflate_header_block(nghttp2_hd_inflater *hd_inflater,\n                              uint8_t *in, size_t inlen, int final)\n     {\n         nghttp2_ssize rv;\n\n         for(;;) {\n             nghttp2_nv nv;\n             int inflate_flags = 0;\n\n             rv = nghttp2_hd_inflate_hd3(hd_inflater, &nv, &inflate_flags,\n                                         in, inlen, final);\n\n             if(rv < 0) {\n                 fprintf(stderr, \"inflate failed with error code %td\", rv);\n                 return -1;\n             }\n\n             in += rv;\n             inlen -= rv;\n\n             if(inflate_flags & NGHTTP2_HD_INFLATE_EMIT) {\n                 fwrite(nv.name, nv.namelen, 1, stderr);\n                 fprintf(stderr, \": \");\n                 fwrite(nv.value, nv.valuelen, 1, stderr);\n                 fprintf(stderr, \"\\n\");\n             }\n             if(inflate_flags & NGHTTP2_HD_INFLATE_FINAL) {\n                 nghttp2_hd_inflate_end_headers(hd_inflater);\n                 break;\n             }\n             if((inflate_flags & NGHTTP2_HD_INFLATE_EMIT) == 0 &&\n                inlen == 0) {\n                break;\n             }\n         }\n\n         return 0;\n     }\n"]
2027    pub fn nghttp2_hd_inflate_hd3(
2028        inflater: *mut nghttp2_hd_inflater,
2029        nv_out: *mut nghttp2_nv,
2030        inflate_flags: *mut ::std::os::raw::c_int,
2031        in_: *const u8,
2032        inlen: usize,
2033        in_final: ::std::os::raw::c_int,
2034    ) -> nghttp2_ssize;
2035}
2036unsafe extern "C" {
2037    #[doc = " @function\n\n Signals the end of decompression for one header block.\n\n This function returns 0 if it succeeds. Currently this function\n always succeeds."]
2038    pub fn nghttp2_hd_inflate_end_headers(
2039        inflater: *mut nghttp2_hd_inflater,
2040    ) -> ::std::os::raw::c_int;
2041}
2042unsafe extern "C" {
2043    #[doc = " @function\n\n Returns the number of entries that header table of |inflater|\n contains.  This is the sum of the number of static table and\n dynamic table, so the return value is at least 61."]
2044    pub fn nghttp2_hd_inflate_get_num_table_entries(inflater: *mut nghttp2_hd_inflater) -> usize;
2045}
2046unsafe extern "C" {
2047    #[doc = " @function\n\n Returns the table entry denoted by |idx| from header table of\n |inflater|.  The |idx| is 1-based, and idx=1 returns first entry of\n static table.  idx=62 returns first entry of dynamic table if it\n exists.  Specifying idx=0 is error, and this function returns NULL.\n If |idx| is strictly greater than the number of entries the tables\n contain, this function returns NULL."]
2048    pub fn nghttp2_hd_inflate_get_table_entry(
2049        inflater: *mut nghttp2_hd_inflater,
2050        idx: usize,
2051    ) -> *const nghttp2_nv;
2052}
2053unsafe extern "C" {
2054    #[doc = " @function\n\n Returns the used dynamic table size, including the overhead 32\n bytes per entry described in RFC 7541."]
2055    pub fn nghttp2_hd_inflate_get_dynamic_table_size(inflater: *mut nghttp2_hd_inflater) -> usize;
2056}
2057unsafe extern "C" {
2058    #[doc = " @function\n\n Returns the maximum dynamic table size."]
2059    pub fn nghttp2_hd_inflate_get_max_dynamic_table_size(
2060        inflater: *mut nghttp2_hd_inflater,
2061    ) -> usize;
2062}
2063#[repr(C)]
2064#[derive(Debug, Copy, Clone)]
2065pub struct nghttp2_stream {
2066    _unused: [u8; 0],
2067}
2068unsafe extern "C" {
2069    #[doc = " @function\n\n Returns pointer to :type:`nghttp2_stream` object denoted by\n |stream_id|.  If stream was not found, returns NULL.\n\n Returns imaginary root stream (see\n `nghttp2_session_get_root_stream()`) if 0 is given in |stream_id|.\n\n Unless |stream_id| == 0, the returned pointer is valid until next\n call of `nghttp2_session_send()`, `nghttp2_session_mem_send2()`,\n `nghttp2_session_recv()`, and `nghttp2_session_mem_recv2()`."]
2070    pub fn nghttp2_session_find_stream(
2071        session: *mut nghttp2_session,
2072        stream_id: i32,
2073    ) -> *mut nghttp2_stream;
2074}
2075#[doc = " idle state."]
2076pub const NGHTTP2_STREAM_STATE_IDLE: nghttp2_stream_proto_state = 1;
2077#[doc = " open state."]
2078pub const NGHTTP2_STREAM_STATE_OPEN: nghttp2_stream_proto_state = 2;
2079#[doc = " reserved (local) state."]
2080pub const NGHTTP2_STREAM_STATE_RESERVED_LOCAL: nghttp2_stream_proto_state = 3;
2081#[doc = " reserved (remote) state."]
2082pub const NGHTTP2_STREAM_STATE_RESERVED_REMOTE: nghttp2_stream_proto_state = 4;
2083#[doc = " half closed (local) state."]
2084pub const NGHTTP2_STREAM_STATE_HALF_CLOSED_LOCAL: nghttp2_stream_proto_state = 5;
2085#[doc = " half closed (remote) state."]
2086pub const NGHTTP2_STREAM_STATE_HALF_CLOSED_REMOTE: nghttp2_stream_proto_state = 6;
2087#[doc = " closed state."]
2088pub const NGHTTP2_STREAM_STATE_CLOSED: nghttp2_stream_proto_state = 7;
2089#[doc = " @enum\n\n State of stream as described in RFC 7540."]
2090pub type nghttp2_stream_proto_state = ::std::os::raw::c_uint;
2091unsafe extern "C" {
2092    #[doc = " @function\n\n Returns state of |stream|.  The root stream retrieved by\n `nghttp2_session_get_root_stream()` will have stream state\n :enum:`nghttp2_stream_proto_state.NGHTTP2_STREAM_STATE_IDLE`."]
2093    pub fn nghttp2_stream_get_state(stream: *mut nghttp2_stream) -> nghttp2_stream_proto_state;
2094}
2095unsafe extern "C" {
2096    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n Returns root of dependency tree, which is imaginary stream with\n stream ID 0.  The returned pointer is valid until |session| is\n freed by `nghttp2_session_del()`."]
2097    pub fn nghttp2_session_get_root_stream(session: *mut nghttp2_session) -> *mut nghttp2_stream;
2098}
2099unsafe extern "C" {
2100    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function always returns NULL."]
2101    pub fn nghttp2_stream_get_parent(stream: *mut nghttp2_stream) -> *mut nghttp2_stream;
2102}
2103unsafe extern "C" {
2104    pub fn nghttp2_stream_get_stream_id(stream: *mut nghttp2_stream) -> i32;
2105}
2106unsafe extern "C" {
2107    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function always returns NULL."]
2108    pub fn nghttp2_stream_get_next_sibling(stream: *mut nghttp2_stream) -> *mut nghttp2_stream;
2109}
2110unsafe extern "C" {
2111    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function always returns NULL."]
2112    pub fn nghttp2_stream_get_previous_sibling(stream: *mut nghttp2_stream) -> *mut nghttp2_stream;
2113}
2114unsafe extern "C" {
2115    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function always returns NULL."]
2116    pub fn nghttp2_stream_get_first_child(stream: *mut nghttp2_stream) -> *mut nghttp2_stream;
2117}
2118unsafe extern "C" {
2119    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function always returns :macro:`NGHTTP2_DEFAULT_WEIGHT`."]
2120    pub fn nghttp2_stream_get_weight(stream: *mut nghttp2_stream) -> i32;
2121}
2122unsafe extern "C" {
2123    #[doc = " @function\n\n .. warning::\n\n   Deprecated.  :rfc:`7540` priorities are deprecated by\n   :rfc:`9113`.  Consider migrating to :rfc:`9218` extensible\n   prioritization scheme.\n\n This function always returns 0."]
2124    pub fn nghttp2_stream_get_sum_dependency_weight(stream: *mut nghttp2_stream) -> i32;
2125}