1#![allow(bad_style)]
2#![allow(rustdoc::bare_urls)]
3#[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}