walkero
/
nghttp2
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity

Define NGHTTP2_EXTERN macro to export function for Windows build

This commit is contained in:
Tatsuhiro Tsujikawa 2015-03-28 01:58:59 +09:00
parent fd8f8e2708
commit 966e3a1308
1 changed files with 230 additions and 174 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

404
lib/includes/nghttp2/nghttp2.h
View File

@ -25,6 +25,12 @@
#ifndef NGHTTP2_H #ifndef NGHTTP2_H
#define NGHTTP2_H #define NGHTTP2_H
/* Define WIN32 when build target is Win32 API (borrowed from
libcurl) */
#if (defined(_WIN32) || defined(__WIN32__))
#define WIN32
#endif
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
@ -35,6 +41,14 @@ extern "C" {
#include <nghttp2/nghttp2ver.h> #include <nghttp2/nghttp2ver.h>
#ifdef NGHTTP2_STATICLIB
#define NGHTTP2_EXTERN
#elif defined(WIN32)
#define NGHTTP2_EXTERN __declspec(dllexport)
#else /* !defined(WIN32) */
#define NGHTTP2_EXTERN
#endif /* !defined(WIN32) */
/** /**
* @macro * @macro
* *
@ -1620,7 +1634,8 @@ typedef struct nghttp2_session_callbacks nghttp2_session_callbacks;
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_callbacks_new(nghttp2_session_callbacks **callbacks_ptr); NGHTTP2_EXTERN int
nghttp2_session_callbacks_new(nghttp2_session_callbacks **callbacks_ptr);
/** /**
* @function * @function
@ -1628,7 +1643,8 @@ int nghttp2_session_callbacks_new(nghttp2_session_callbacks **callbacks_ptr);
* Frees any resources allocated for |callbacks|. If |callbacks| is * Frees any resources allocated for |callbacks|. If |callbacks| is
* ``NULL``, this function does nothing. * ``NULL``, this function does nothing.
*/ */
void nghttp2_session_callbacks_del(nghttp2_session_callbacks *callbacks); NGHTTP2_EXTERN void
nghttp2_session_callbacks_del(nghttp2_session_callbacks *callbacks);
/** /**
* @function * @function
@ -1638,7 +1654,7 @@ void nghttp2_session_callbacks_del(nghttp2_session_callbacks *callbacks);
* uses solely `nghttp2_session_mem_send()` to serialize data to * uses solely `nghttp2_session_mem_send()` to serialize data to
* transmit. * transmit.
*/ */
void nghttp2_session_callbacks_set_send_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_send_callback(
nghttp2_session_callbacks *cbs, nghttp2_send_callback send_callback); nghttp2_session_callbacks *cbs, nghttp2_send_callback send_callback);
/** /**
@ -1649,7 +1665,7 @@ void nghttp2_session_callbacks_set_send_callback(
* application uses solely `nghttp2_session_mem_recv()` to process * application uses solely `nghttp2_session_mem_recv()` to process
* received data. * received data.
*/ */
void nghttp2_session_callbacks_set_recv_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_recv_callback(
nghttp2_session_callbacks *cbs, nghttp2_recv_callback recv_callback); nghttp2_session_callbacks *cbs, nghttp2_recv_callback recv_callback);
/** /**
@ -1658,7 +1674,7 @@ void nghttp2_session_callbacks_set_recv_callback(
* Sets callback function invoked by `nghttp2_session_recv()` when a * Sets callback function invoked by `nghttp2_session_recv()` when a
* frame is received. * frame is received.
*/ */
void nghttp2_session_callbacks_set_on_frame_recv_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_frame_recv_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_frame_recv_callback on_frame_recv_callback); nghttp2_on_frame_recv_callback on_frame_recv_callback);
@ -1668,7 +1684,8 @@ void nghttp2_session_callbacks_set_on_frame_recv_callback(
* Sets callback function invoked by `nghttp2_session_recv()` when an * Sets callback function invoked by `nghttp2_session_recv()` when an
* invalid non-DATA frame is received. * invalid non-DATA frame is received.
*/ */
void nghttp2_session_callbacks_set_on_invalid_frame_recv_callback( NGHTTP2_EXTERN void
nghttp2_session_callbacks_set_on_invalid_frame_recv_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_invalid_frame_recv_callback on_invalid_frame_recv_callback); nghttp2_on_invalid_frame_recv_callback on_invalid_frame_recv_callback);
@ -1678,7 +1695,7 @@ void nghttp2_session_callbacks_set_on_invalid_frame_recv_callback(
* Sets callback function invoked when a chunk of data in DATA frame * Sets callback function invoked when a chunk of data in DATA frame
* is received. * is received.
*/ */
void nghttp2_session_callbacks_set_on_data_chunk_recv_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_data_chunk_recv_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_data_chunk_recv_callback on_data_chunk_recv_callback); nghttp2_on_data_chunk_recv_callback on_data_chunk_recv_callback);
@ -1687,7 +1704,7 @@ void nghttp2_session_callbacks_set_on_data_chunk_recv_callback(
* *
* Sets callback function invoked before a non-DATA frame is sent. * Sets callback function invoked before a non-DATA frame is sent.
*/ */
void nghttp2_session_callbacks_set_before_frame_send_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_before_frame_send_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_before_frame_send_callback before_frame_send_callback); nghttp2_before_frame_send_callback before_frame_send_callback);
@ -1696,7 +1713,7 @@ void nghttp2_session_callbacks_set_before_frame_send_callback(
* *
* Sets callback function invoked after a frame is sent. * Sets callback function invoked after a frame is sent.
*/ */
void nghttp2_session_callbacks_set_on_frame_send_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_frame_send_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_frame_send_callback on_frame_send_callback); nghttp2_on_frame_send_callback on_frame_send_callback);
@ -1706,7 +1723,7 @@ void nghttp2_session_callbacks_set_on_frame_send_callback(
* Sets callback function invoked when a non-DATA frame is not sent * Sets callback function invoked when a non-DATA frame is not sent
* because of an error. * because of an error.
*/ */
void nghttp2_session_callbacks_set_on_frame_not_send_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_frame_not_send_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_frame_not_send_callback on_frame_not_send_callback); nghttp2_on_frame_not_send_callback on_frame_not_send_callback);
@ -1715,7 +1732,7 @@ void nghttp2_session_callbacks_set_on_frame_not_send_callback(
* *
* Sets callback function invoked when the stream is closed. * Sets callback function invoked when the stream is closed.
*/ */
void nghttp2_session_callbacks_set_on_stream_close_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_stream_close_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_stream_close_callback on_stream_close_callback); nghttp2_on_stream_close_callback on_stream_close_callback);
@ -1725,7 +1742,7 @@ void nghttp2_session_callbacks_set_on_stream_close_callback(
* Sets callback function invoked when the reception of header block * Sets callback function invoked when the reception of header block
* in HEADERS or PUSH_PROMISE is started. * in HEADERS or PUSH_PROMISE is started.
*/ */
void nghttp2_session_callbacks_set_on_begin_headers_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_begin_headers_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_begin_headers_callback on_begin_headers_callback); nghttp2_on_begin_headers_callback on_begin_headers_callback);
@ -1735,7 +1752,7 @@ void nghttp2_session_callbacks_set_on_begin_headers_callback(
* Sets callback function invoked when a header name/value pair is * Sets callback function invoked when a header name/value pair is
* received. * received.
*/ */
void nghttp2_session_callbacks_set_on_header_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_header_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_header_callback on_header_callback); nghttp2_on_header_callback on_header_callback);
@ -1746,7 +1763,7 @@ void nghttp2_session_callbacks_set_on_header_callback(
* how many padding bytes are required for the transmission of the * how many padding bytes are required for the transmission of the
* given frame. * given frame.
*/ */
void nghttp2_session_callbacks_set_select_padding_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_select_padding_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_select_padding_callback select_padding_callback); nghttp2_select_padding_callback select_padding_callback);
@ -1756,7 +1773,8 @@ void nghttp2_session_callbacks_set_select_padding_callback(
* Sets callback function determine the length allowed in * Sets callback function determine the length allowed in
* :type:`nghttp2_data_source_read_callback`. * :type:`nghttp2_data_source_read_callback`.
*/ */
void nghttp2_session_callbacks_set_data_source_read_length_callback( NGHTTP2_EXTERN void
nghttp2_session_callbacks_set_data_source_read_length_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_data_source_read_length_callback data_source_read_length_callback); nghttp2_data_source_read_length_callback data_source_read_length_callback);
@ -1765,7 +1783,7 @@ void nghttp2_session_callbacks_set_data_source_read_length_callback(
* *
* Sets callback function invoked when a frame header is received. * Sets callback function invoked when a frame header is received.
*/ */
void nghttp2_session_callbacks_set_on_begin_frame_callback( NGHTTP2_EXTERN void nghttp2_session_callbacks_set_on_begin_frame_callback(
nghttp2_session_callbacks *cbs, nghttp2_session_callbacks *cbs,
nghttp2_on_begin_frame_callback on_begin_frame_callback); nghttp2_on_begin_frame_callback on_begin_frame_callback);
@ -1888,7 +1906,7 @@ typedef struct nghttp2_option nghttp2_option;
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_option_new(nghttp2_option **option_ptr); NGHTTP2_EXTERN int nghttp2_option_new(nghttp2_option **option_ptr);
/** /**
* @function * @function
@ -1896,7 +1914,7 @@ int nghttp2_option_new(nghttp2_option **option_ptr);
* Frees any resources allocated for |option|. If |option| is * Frees any resources allocated for |option|. If |option| is
* ``NULL``, this function does nothing. * ``NULL``, this function does nothing.
*/ */
void nghttp2_option_del(nghttp2_option *option); NGHTTP2_EXTERN void nghttp2_option_del(nghttp2_option *option);
/** /**
* @function * @function
@ -1908,7 +1926,8 @@ void nghttp2_option_del(nghttp2_option *option);
* data. Don't use `nghttp2_submit_window_update()` for this purpose. * data. Don't use `nghttp2_submit_window_update()` for this purpose.
* By default, this option is set to zero. * By default, this option is set to zero.
*/ */
void nghttp2_option_set_no_auto_window_update(nghttp2_option *option, int val); NGHTTP2_EXTERN void
nghttp2_option_set_no_auto_window_update(nghttp2_option *option, int val);
/** /**
* @function * @function
@ -1925,8 +1944,9 @@ void nghttp2_option_set_no_auto_window_update(nghttp2_option *option, int val);
* overwritten if the local endpoint receives * overwritten if the local endpoint receives
* SETTINGS_MAX_CONCURRENT_STREAMS from the remote endpoint. * SETTINGS_MAX_CONCURRENT_STREAMS from the remote endpoint.
*/ */
void nghttp2_option_set_peer_max_concurrent_streams(nghttp2_option *option, NGHTTP2_EXTERN void
uint32_t val); nghttp2_option_set_peer_max_concurrent_streams(nghttp2_option *option,
uint32_t val);
/** /**
* @function * @function
@ -1944,7 +1964,8 @@ void nghttp2_option_set_peer_max_concurrent_streams(nghttp2_option *option,
* one, `nghttp2_session_recv()` and `nghttp2_session_mem_recv()` will * one, `nghttp2_session_recv()` and `nghttp2_session_mem_recv()` will
* return error :enum:`NGHTTP2_ERR_BAD_PREFACE`, which is fatal error. * return error :enum:`NGHTTP2_ERR_BAD_PREFACE`, which is fatal error.
*/ */
void nghttp2_option_set_recv_client_preface(nghttp2_option *option, int val); NGHTTP2_EXTERN void
nghttp2_option_set_recv_client_preface(nghttp2_option *option, int val);
/** /**
* @function * @function
@ -1956,7 +1977,8 @@ void nghttp2_option_set_recv_client_preface(nghttp2_option *option, int val);
* who use nghttp2 library as non-HTTP use, give nonzero to |val| to * who use nghttp2 library as non-HTTP use, give nonzero to |val| to
* disable this enforcement. * disable this enforcement.
*/ */
void nghttp2_option_set_no_http_messaging(nghttp2_option *option, int val); NGHTTP2_EXTERN void nghttp2_option_set_no_http_messaging(nghttp2_option *option,
int val);
/** /**
* @function * @function
@ -1979,9 +2001,10 @@ void nghttp2_option_set_no_http_messaging(nghttp2_option *option, int val);
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_client_new(nghttp2_session **session_ptr, NGHTTP2_EXTERN int
const nghttp2_session_callbacks *callbacks, nghttp2_session_client_new(nghttp2_session **session_ptr,
void *user_data); const nghttp2_session_callbacks *callbacks,
void *user_data);
/** /**
* @function * @function
@ -2004,9 +2027,10 @@ int nghttp2_session_client_new(nghttp2_session **session_ptr,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_server_new(nghttp2_session **session_ptr, NGHTTP2_EXTERN int
const nghttp2_session_callbacks *callbacks, nghttp2_session_server_new(nghttp2_session **session_ptr,
void *user_data); const nghttp2_session_callbacks *callbacks,
void *user_data);
/** /**
* @function * @function
@ -2029,9 +2053,10 @@ int nghttp2_session_server_new(nghttp2_session **session_ptr,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_client_new2(nghttp2_session **session_ptr, NGHTTP2_EXTERN int
const nghttp2_session_callbacks *callbacks, nghttp2_session_client_new2(nghttp2_session **session_ptr,
void *user_data, const nghttp2_option *option); const nghttp2_session_callbacks *callbacks,
void *user_data, const nghttp2_option *option);
/** /**
* @function * @function
@ -2054,9 +2079,10 @@ int nghttp2_session_client_new2(nghttp2_session **session_ptr,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_server_new2(nghttp2_session **session_ptr, NGHTTP2_EXTERN int
const nghttp2_session_callbacks *callbacks, nghttp2_session_server_new2(nghttp2_session **session_ptr,
void *user_data, const nghttp2_option *option); const nghttp2_session_callbacks *callbacks,
void *user_data, const nghttp2_option *option);
/** /**
* @function * @function
@ -2079,10 +2105,9 @@ int nghttp2_session_server_new2(nghttp2_session **session_ptr,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_client_new3(nghttp2_session **session_ptr, NGHTTP2_EXTERN int nghttp2_session_client_new3(
const nghttp2_session_callbacks *callbacks, nghttp2_session **session_ptr, const nghttp2_session_callbacks *callbacks,
void *user_data, const nghttp2_option *option, void *user_data, const nghttp2_option *option, nghttp2_mem *mem);
nghttp2_mem *mem);
/** /**
* @function * @function
@ -2105,10 +2130,9 @@ int nghttp2_session_client_new3(nghttp2_session **session_ptr,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_server_new3(nghttp2_session **session_ptr, NGHTTP2_EXTERN int nghttp2_session_server_new3(
const nghttp2_session_callbacks *callbacks, nghttp2_session **session_ptr, const nghttp2_session_callbacks *callbacks,
void *user_data, const nghttp2_option *option, void *user_data, const nghttp2_option *option, nghttp2_mem *mem);
nghttp2_mem *mem);
/** /**
* @function * @function
@ -2116,7 +2140,7 @@ int nghttp2_session_server_new3(nghttp2_session **session_ptr,
* Frees any resources allocated for |session|. If |session| is * Frees any resources allocated for |session|. If |session| is
* ``NULL``, this function does nothing. * ``NULL``, this function does nothing.
*/ */
void nghttp2_session_del(nghttp2_session *session); NGHTTP2_EXTERN void nghttp2_session_del(nghttp2_session *session);
/** /**
* @function * @function
@ -2165,7 +2189,7 @@ void nghttp2_session_del(nghttp2_session *session);
* :enum:`NGHTTP2_ERR_CALLBACK_FAILURE` * :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`
* The callback function failed. * The callback function failed.
*/ */
int nghttp2_session_send(nghttp2_session *session); NGHTTP2_EXTERN int nghttp2_session_send(nghttp2_session *session);
/** /**
* @function * @function
@ -2197,8 +2221,8 @@ int nghttp2_session_send(nghttp2_session *session);
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
ssize_t nghttp2_session_mem_send(nghttp2_session *session, NGHTTP2_EXTERN ssize_t nghttp2_session_mem_send(nghttp2_session *session,
const uint8_t **data_ptr); const uint8_t **data_ptr);
/** /**
* @function * @function
@ -2263,7 +2287,7 @@ ssize_t nghttp2_session_mem_send(nghttp2_session *session,
* when |session| was configured as server and * when |session| was configured as server and
* `nghttp2_option_set_recv_client_preface()` is used. * `nghttp2_option_set_recv_client_preface()` is used.
*/ */
int nghttp2_session_recv(nghttp2_session *session); NGHTTP2_EXTERN int nghttp2_session_recv(nghttp2_session *session);
/** /**
* @function * @function
@ -2298,8 +2322,9 @@ int nghttp2_session_recv(nghttp2_session *session);
* when |session| was configured as server and * when |session| was configured as server and
* `nghttp2_option_set_recv_client_preface()` is used. * `nghttp2_option_set_recv_client_preface()` is used.
*/ */
ssize_t nghttp2_session_mem_recv(nghttp2_session *session, const uint8_t *in, NGHTTP2_EXTERN ssize_t nghttp2_session_mem_recv(nghttp2_session *session,
size_t inlen); const uint8_t *in,
size_t inlen);
/** /**
* @function * @function
@ -2315,7 +2340,8 @@ ssize_t nghttp2_session_mem_recv(nghttp2_session *session, const uint8_t *in,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_resume_data(nghttp2_session *session, int32_t stream_id); NGHTTP2_EXTERN int nghttp2_session_resume_data(nghttp2_session *session,
int32_t stream_id);
/** /**
* @function * @function
@ -2327,7 +2353,7 @@ int nghttp2_session_resume_data(nghttp2_session *session, int32_t stream_id);
* `nghttp2_session_want_write()` return 0, the application should * `nghttp2_session_want_write()` return 0, the application should
* drop the connection. * drop the connection.
*/ */
int nghttp2_session_want_read(nghttp2_session *session); NGHTTP2_EXTERN int nghttp2_session_want_read(nghttp2_session *session);
/** /**
* @function * @function
@ -2339,7 +2365,7 @@ int nghttp2_session_want_read(nghttp2_session *session);
* `nghttp2_session_want_write()` return 0, the application should * `nghttp2_session_want_write()` return 0, the application should
* drop the connection. * drop the connection.
*/ */
int nghttp2_session_want_write(nghttp2_session *session); NGHTTP2_EXTERN int nghttp2_session_want_write(nghttp2_session *session);
/** /**
* @function * @function
@ -2353,8 +2379,9 @@ int nghttp2_session_want_write(nghttp2_session *session);
* ``NULL``. If the stream does not exist, this function returns * ``NULL``. If the stream does not exist, this function returns
* ``NULL``. * ``NULL``.
*/ */
void *nghttp2_session_get_stream_user_data(nghttp2_session *session, NGHTTP2_EXTERN void *
int32_t stream_id); nghttp2_session_get_stream_user_data(nghttp2_session *session,
int32_t stream_id);
/** /**
* @function * @function
@ -2374,9 +2401,9 @@ void *nghttp2_session_get_stream_user_data(nghttp2_session *session,
* :enum:`NGHTTP2_ERR_INVALID_ARGUMENT` * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
* The stream does not exist * The stream does not exist
*/ */
int nghttp2_session_set_stream_user_data(nghttp2_session *session, NGHTTP2_EXTERN int
int32_t stream_id, nghttp2_session_set_stream_user_data(nghttp2_session *session,
void *stream_user_data); int32_t stream_id, void *stream_user_data);
/** /**
* @function * @function
@ -2384,7 +2411,8 @@ int nghttp2_session_set_stream_user_data(nghttp2_session *session,
* Returns the number of frames in the outbound queue. This does not * Returns the number of frames in the outbound queue. This does not
* include the deferred DATA frames. * include the deferred DATA frames.
*/ */
size_t nghttp2_session_get_outbound_queue_size(nghttp2_session *session); NGHTTP2_EXTERN size_t
nghttp2_session_get_outbound_queue_size(nghttp2_session *session);
/** /**
* @function * @function
@ -2400,9 +2428,8 @@ size_t nghttp2_session_get_outbound_queue_size(nghttp2_session *session);
* *
* This function returns -1 if it fails. * This function returns -1 if it fails.
*/ */
int32_t NGHTTP2_EXTERN int32_t nghttp2_session_get_stream_effective_recv_data_length(
nghttp2_session_get_stream_effective_recv_data_length(nghttp2_session *session, nghttp2_session *session, int32_t stream_id);
int32_t stream_id);
/** /**
* @function * @function
@ -2414,9 +2441,8 @@ nghttp2_session_get_stream_effective_recv_data_length(nghttp2_session *session,
* *
* This function returns -1 if it fails. * This function returns -1 if it fails.
*/ */
int32_t NGHTTP2_EXTERN int32_t nghttp2_session_get_stream_effective_local_window_size(
nghttp2_session_get_stream_effective_local_window_size(nghttp2_session *session, nghttp2_session *session, int32_t stream_id);
int32_t stream_id);
/** /**
* @function * @function
@ -2432,8 +2458,8 @@ nghttp2_session_get_stream_effective_local_window_size(nghttp2_session *session,
* *
* This function returns -1 if it fails. * This function returns -1 if it fails.
*/ */
int32_t NGHTTP2_EXTERN int32_t
nghttp2_session_get_effective_recv_data_length(nghttp2_session *session); nghttp2_session_get_effective_recv_data_length(nghttp2_session *session);
/** /**
* @function * @function
@ -2445,8 +2471,8 @@ nghttp2_session_get_effective_recv_data_length(nghttp2_session *session);
* *
* This function returns -1 if it fails. * This function returns -1 if it fails.
*/ */
int32_t NGHTTP2_EXTERN int32_t
nghttp2_session_get_effective_local_window_size(nghttp2_session *session); nghttp2_session_get_effective_local_window_size(nghttp2_session *session);
/** /**
* @function * @function
@ -2462,8 +2488,9 @@ nghttp2_session_get_effective_local_window_size(nghttp2_session *session);
* *
* This function returns -1 if it fails. * This function returns -1 if it fails.
*/ */
int32_t nghttp2_session_get_stream_remote_window_size(nghttp2_session *session, NGHTTP2_EXTERN int32_t
int32_t stream_id); nghttp2_session_get_stream_remote_window_size(nghttp2_session *session,
int32_t stream_id);
/** /**
* @function * @function
@ -2472,7 +2499,8 @@ int32_t nghttp2_session_get_stream_remote_window_size(nghttp2_session *session,
* *
* This function always succeeds. * This function always succeeds.
*/ */
int32_t nghttp2_session_get_remote_window_size(nghttp2_session *session); NGHTTP2_EXTERN int32_t
nghttp2_session_get_remote_window_size(nghttp2_session *session);
/** /**
* @function * @function
@ -2480,8 +2508,9 @@ int32_t nghttp2_session_get_remote_window_size(nghttp2_session *session);
* Returns 1 if local peer half closed the given stream |stream_id|. * Returns 1 if local peer half closed the given stream |stream_id|.
* Returns 0 if it did not. Returns -1 if no such stream exists. * Returns 0 if it did not. Returns -1 if no such stream exists.
*/ */
int nghttp2_session_get_stream_local_close(nghttp2_session *session, NGHTTP2_EXTERN int
int32_t stream_id); nghttp2_session_get_stream_local_close(nghttp2_session *session,
int32_t stream_id);
/** /**
* @function * @function
@ -2489,8 +2518,9 @@ int nghttp2_session_get_stream_local_close(nghttp2_session *session,
* Returns 1 if remote peer half closed the given stream |stream_id|. * Returns 1 if remote peer half closed the given stream |stream_id|.
* Returns 0 if it did not. Returns -1 if no such stream exists. * Returns 0 if it did not. Returns -1 if no such stream exists.
*/ */
int nghttp2_session_get_stream_remote_close(nghttp2_session *session, NGHTTP2_EXTERN int
int32_t stream_id); nghttp2_session_get_stream_remote_close(nghttp2_session *session,
int32_t stream_id);
/** /**
* @function * @function
@ -2518,8 +2548,8 @@ int nghttp2_session_get_stream_remote_close(nghttp2_session *session,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_session_terminate_session(nghttp2_session *session, NGHTTP2_EXTERN int nghttp2_session_terminate_session(nghttp2_session *session,
uint32_t error_code); uint32_t error_code);
/** /**
* @function * @function
@ -2547,9 +2577,9 @@ int nghttp2_session_terminate_session(nghttp2_session *session,
* :enum:`NGHTTP2_ERR_INVALID_ARGUMENT` * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
* The |last_stream_id| is invalid. * The |last_stream_id| is invalid.
*/ */
int nghttp2_session_terminate_session2(nghttp2_session *session, NGHTTP2_EXTERN int nghttp2_session_terminate_session2(nghttp2_session *session,
int32_t last_stream_id, int32_t last_stream_id,
uint32_t error_code); uint32_t error_code);
/** /**
* @function * @function
@ -2586,7 +2616,7 @@ int nghttp2_session_terminate_session2(nghttp2_session *session,
* :enum:`NGHTTP2_ERR_INVALID_STATE` * :enum:`NGHTTP2_ERR_INVALID_STATE`
* The |session| is initialized as client. * The |session| is initialized as client.
*/ */
int nghttp2_submit_shutdown_notice(nghttp2_session *session); NGHTTP2_EXTERN int nghttp2_submit_shutdown_notice(nghttp2_session *session);
/** /**
* @function * @function
@ -2595,8 +2625,9 @@ int nghttp2_submit_shutdown_notice(nghttp2_session *session);
* The |id| must be one of values defined in * The |id| must be one of values defined in
* :enum:`nghttp2_settings_id`. * :enum:`nghttp2_settings_id`.
*/ */
uint32_t nghttp2_session_get_remote_settings(nghttp2_session *session, NGHTTP2_EXTERN uint32_t
nghttp2_settings_id id); nghttp2_session_get_remote_settings(nghttp2_session *session,
nghttp2_settings_id id);
/** /**
* @function * @function
@ -2612,8 +2643,8 @@ uint32_t nghttp2_session_get_remote_settings(nghttp2_session *session,
* The |next_stream_id| is strictly less than the value * The |next_stream_id| is strictly less than the value
* `nghttp2_session_get_next_stream_id()` returns. * `nghttp2_session_get_next_stream_id()` returns.
*/ */
int nghttp2_session_set_next_stream_id(nghttp2_session *session, NGHTTP2_EXTERN int nghttp2_session_set_next_stream_id(nghttp2_session *session,
int32_t next_stream_id); int32_t next_stream_id);
/** /**
* @function * @function
@ -2622,7 +2653,8 @@ int nghttp2_session_set_next_stream_id(nghttp2_session *session,
* uint32_t. If we run out of stream ID for this session, this * uint32_t. If we run out of stream ID for this session, this
* function returns 1 << 31. * function returns 1 << 31.
*/ */
uint32_t nghttp2_session_get_next_stream_id(nghttp2_session *session); NGHTTP2_EXTERN uint32_t
nghttp2_session_get_next_stream_id(nghttp2_session *session);
/** /**
* @function * @function
@ -2643,8 +2675,8 @@ uint32_t nghttp2_session_get_next_stream_id(nghttp2_session *session);
* :enum:`NGHTTP2_ERR_INVALID_STATE` * :enum:`NGHTTP2_ERR_INVALID_STATE`
* Automatic WINDOW_UPDATE is not disabled. * Automatic WINDOW_UPDATE is not disabled.
*/ */
int nghttp2_session_consume(nghttp2_session *session, int32_t stream_id, NGHTTP2_EXTERN int nghttp2_session_consume(nghttp2_session *session,
size_t size); int32_t stream_id, size_t size);
/** /**
* @function * @function
@ -2682,9 +2714,10 @@ int nghttp2_session_consume(nghttp2_session *session, int32_t stream_id,
* :enum:`NGHTTP2_ERR_PROTO` * :enum:`NGHTTP2_ERR_PROTO`
* The stream ID 1 is already used or closed; or is not available. * The stream ID 1 is already used or closed; or is not available.
*/ */
int nghttp2_session_upgrade(nghttp2_session *session, NGHTTP2_EXTERN int nghttp2_session_upgrade(nghttp2_session *session,
const uint8_t *settings_payload, const uint8_t *settings_payload,
size_t settings_payloadlen, void *stream_user_data); size_t settings_payloadlen,
void *stream_user_data);
/** /**
* @function * @function
@ -2707,9 +2740,9 @@ int nghttp2_session_upgrade(nghttp2_session *session,
* :enum:`NGHTTP2_ERR_INSUFF_BUFSIZE` * :enum:`NGHTTP2_ERR_INSUFF_BUFSIZE`
* The provided |buflen| size is too small to hold the output. * The provided |buflen| size is too small to hold the output.
*/ */
ssize_t nghttp2_pack_settings_payload(uint8_t *buf, size_t buflen, NGHTTP2_EXTERN ssize_t
const nghttp2_settings_entry *iv, nghttp2_pack_settings_payload(uint8_t *buf, size_t buflen,
size_t niv); const nghttp2_settings_entry *iv, size_t niv);
/** /**
* @function * @function
@ -2717,7 +2750,7 @@ ssize_t nghttp2_pack_settings_payload(uint8_t *buf, size_t buflen,
* Returns string describing the |lib_error_code|. The * Returns string describing the |lib_error_code|. The
* |lib_error_code| must be one of the :enum:`nghttp2_error`. * |lib_error_code| must be one of the :enum:`nghttp2_error`.
*/ */
const char *nghttp2_strerror(int lib_error_code); NGHTTP2_EXTERN const char *nghttp2_strerror(int lib_error_code);
/** /**
* @function * @function
@ -2729,9 +2762,9 @@ const char *nghttp2_strerror(int lib_error_code);
* The |weight| must be in [:enum:`NGHTTP2_MIN_WEIGHT`, * The |weight| must be in [:enum:`NGHTTP2_MIN_WEIGHT`,
* :enum:`NGHTTP2_MAX_WEIGHT`], inclusive. * :enum:`NGHTTP2_MAX_WEIGHT`], inclusive.
*/ */
void nghttp2_priority_spec_init(nghttp2_priority_spec *pri_spec, NGHTTP2_EXTERN void nghttp2_priority_spec_init(nghttp2_priority_spec *pri_spec,
int32_t stream_id, int32_t weight, int32_t stream_id,
int exclusive); int32_t weight, int exclusive);
/** /**
* @function * @function
@ -2740,14 +2773,16 @@ void nghttp2_priority_spec_init(nghttp2_priority_spec *pri_spec,
* are: stream_id = 0, weight = :macro:`NGHTTP2_DEFAULT_WEIGHT` and * are: stream_id = 0, weight = :macro:`NGHTTP2_DEFAULT_WEIGHT` and
* exclusive = 0. * exclusive = 0.
*/ */
void nghttp2_priority_spec_default_init(nghttp2_priority_spec *pri_spec); NGHTTP2_EXTERN void
nghttp2_priority_spec_default_init(nghttp2_priority_spec *pri_spec);
/** /**
* @function * @function
* *
* Returns nonzero if the |pri_spec| is filled with default values. * Returns nonzero if the |pri_spec| is filled with default values.
*/ */
int nghttp2_priority_spec_check_default(const nghttp2_priority_spec *pri_spec); NGHTTP2_EXTERN int
nghttp2_priority_spec_check_default(const nghttp2_priority_spec *pri_spec);
/** /**
* @function * @function
@ -2809,11 +2844,12 @@ int nghttp2_priority_spec_check_default(const nghttp2_priority_spec *pri_spec);
* frame. * frame.
* *
*/ */
int32_t nghttp2_submit_request(nghttp2_session *session, NGHTTP2_EXTERN int32_t
const nghttp2_priority_spec *pri_spec, nghttp2_submit_request(nghttp2_session *session,
const nghttp2_nv *nva, size_t nvlen, const nghttp2_priority_spec *pri_spec,
const nghttp2_data_provider *data_prd, const nghttp2_nv *nva, size_t nvlen,
void *stream_user_data); const nghttp2_data_provider *data_prd,
void *stream_user_data);
/** /**
* @function * @function
@ -2864,9 +2900,10 @@ int32_t nghttp2_submit_request(nghttp2_session *session,
* program crash. It is generally considered to a programming error * program crash. It is generally considered to a programming error
* to commit response twice. * to commit response twice.
*/ */
int nghttp2_submit_response(nghttp2_session *session, int32_t stream_id, NGHTTP2_EXTERN int
const nghttp2_nv *nva, size_t nvlen, nghttp2_submit_response(nghttp2_session *session, int32_t stream_id,
const nghttp2_data_provider *data_prd); const nghttp2_nv *nva, size_t nvlen,
const nghttp2_data_provider *data_prd);
/** /**
* @function * @function
@ -2912,8 +2949,9 @@ int nghttp2_submit_response(nghttp2_session *session, int32_t stream_id,
* :enum:`NGHTTP2_ERR_INVALID_ARGUMENT` * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
* The |stream_id| is 0. * The |stream_id| is 0.
*/ */
int nghttp2_submit_trailer(nghttp2_session *session, int32_t stream_id, NGHTTP2_EXTERN int nghttp2_submit_trailer(nghttp2_session *session,
const nghttp2_nv *nva, size_t nvlen); int32_t stream_id,
const nghttp2_nv *nva, size_t nvlen);
/** /**
* @function * @function
@ -2987,11 +3025,12 @@ int nghttp2_submit_trailer(nghttp2_session *session, int32_t stream_id,
* frame. * frame.
* *
*/ */
int32_t nghttp2_submit_headers(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int32_t
int32_t stream_id, nghttp2_submit_headers(nghttp2_session *session, uint8_t flags,
const nghttp2_priority_spec *pri_spec, int32_t stream_id,
const nghttp2_nv *nva, size_t nvlen, const nghttp2_priority_spec *pri_spec,
void *stream_user_data); const nghttp2_nv *nva, size_t nvlen,
void *stream_user_data);
/** /**
* @function * @function
@ -3027,9 +3066,9 @@ int32_t nghttp2_submit_headers(nghttp2_session *session, uint8_t flags,
* course, all data except for last one must not have * course, all data except for last one must not have
* :enum:`NGHTTP2_FLAG_END_STREAM` flag set in |flags|. * :enum:`NGHTTP2_FLAG_END_STREAM` flag set in |flags|.
*/ */
int nghttp2_submit_data(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int nghttp2_submit_data(nghttp2_session *session, uint8_t flags,
int32_t stream_id, int32_t stream_id,
const nghttp2_data_provider *data_prd); const nghttp2_data_provider *data_prd);
/** /**
* @function * @function
@ -3060,9 +3099,10 @@ int nghttp2_submit_data(nghttp2_session *session, uint8_t flags,
* The |stream_id| is 0; or the |pri_spec| is NULL; or trying to * The |stream_id| is 0; or the |pri_spec| is NULL; or trying to
* depend on itself. * depend on itself.
*/ */
int nghttp2_submit_priority(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int
int32_t stream_id, nghttp2_submit_priority(nghttp2_session *session, uint8_t flags,
const nghttp2_priority_spec *pri_spec); int32_t stream_id,
const nghttp2_priority_spec *pri_spec);
/** /**
* @function * @function
@ -3083,8 +3123,9 @@ int nghttp2_submit_priority(nghttp2_session *session, uint8_t flags,
* :enum:`NGHTTP2_ERR_INVALID_ARGUMENT` * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
* The |stream_id| is 0. * The |stream_id| is 0.
*/ */
int nghttp2_submit_rst_stream(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int nghttp2_submit_rst_stream(nghttp2_session *session,
int32_t stream_id, uint32_t error_code); uint8_t flags, int32_t stream_id,
uint32_t error_code);
/** /**
* @function * @function
@ -3119,8 +3160,10 @@ int nghttp2_submit_rst_stream(nghttp2_session *session, uint8_t flags,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_submit_settings(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int nghttp2_submit_settings(nghttp2_session *session,
const nghttp2_settings_entry *iv, size_t niv); uint8_t flags,
const nghttp2_settings_entry *iv,
size_t niv);
/** /**
* @function * @function
@ -3179,10 +3222,10 @@ int nghttp2_submit_settings(nghttp2_session *session, uint8_t flags,
* frame. * frame.
* *
*/ */
int32_t nghttp2_submit_push_promise(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int32_t
int32_t stream_id, const nghttp2_nv *nva, nghttp2_submit_push_promise(nghttp2_session *session, uint8_t flags,
size_t nvlen, int32_t stream_id, const nghttp2_nv *nva,
void *promised_stream_user_data); size_t nvlen, void *promised_stream_user_data);
/** /**
* @function * @function
@ -3205,8 +3248,8 @@ int32_t nghttp2_submit_push_promise(nghttp2_session *session, uint8_t flags,
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_submit_ping(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int nghttp2_submit_ping(nghttp2_session *session, uint8_t flags,
const uint8_t *opaque_data); const uint8_t *opaque_data);
/** /**
* @function * @function
@ -3253,9 +3296,11 @@ int nghttp2_submit_ping(nghttp2_session *session, uint8_t flags,
* The |opaque_data_len| is too large; the |last_stream_id| is * The |opaque_data_len| is too large; the |last_stream_id| is
* invalid. * invalid.
*/ */
int nghttp2_submit_goaway(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int nghttp2_submit_goaway(nghttp2_session *session,
int32_t last_stream_id, uint32_t error_code, uint8_t flags, int32_t last_stream_id,
const uint8_t *opaque_data, size_t opaque_data_len); uint32_t error_code,
const uint8_t *opaque_data,
size_t opaque_data_len);
/** /**
* @function * @function
@ -3268,7 +3313,8 @@ int nghttp2_submit_goaway(nghttp2_session *session, uint8_t flags,
* *
* This function always succeeds. * This function always succeeds.
*/ */
int32_t nghttp2_session_get_last_proc_stream_id(nghttp2_session *session); NGHTTP2_EXTERN int32_t
nghttp2_session_get_last_proc_stream_id(nghttp2_session *session);
/** /**
* @function * @function
@ -3302,9 +3348,10 @@ int32_t nghttp2_session_get_last_proc_stream_id(nghttp2_session *session);
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_submit_window_update(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int nghttp2_submit_window_update(nghttp2_session *session,
int32_t stream_id, uint8_t flags,
int32_t window_size_increment); int32_t stream_id,
int32_t window_size_increment);
/** /**
* @function * @function
@ -3313,11 +3360,12 @@ int nghttp2_submit_window_update(nghttp2_session *session, uint8_t flags,
* parameters, but is deprecated and will be removed in a future * parameters, but is deprecated and will be removed in a future
* release. This function does nothing and just return 0. * release. This function does nothing and just return 0.
*/ */
int nghttp2_submit_altsvc(nghttp2_session *session, uint8_t flags, NGHTTP2_EXTERN int
int32_t stream_id, uint32_t max_age, uint16_t port, nghttp2_submit_altsvc(nghttp2_session *session, uint8_t flags,
const uint8_t *protocol_id, size_t protocol_id_len, int32_t stream_id, uint32_t max_age, uint16_t port,
const uint8_t *host, size_t host_len, const uint8_t *protocol_id, size_t protocol_id_len,
const uint8_t *origin, size_t origin_len); const uint8_t *host, size_t host_len,
const uint8_t *origin, size_t origin_len);
/** /**
* @function * @function
@ -3328,7 +3376,8 @@ int nghttp2_submit_altsvc(nghttp2_session *session, uint8_t flags,
* returns positive integer if ``lhs->name`` is found to be greater * returns positive integer if ``lhs->name`` is found to be greater
* than ``rhs->name``; or returns 0 otherwise. * than ``rhs->name``; or returns 0 otherwise.
*/ */
int nghttp2_nv_compare_name(const nghttp2_nv *lhs, const nghttp2_nv *rhs); NGHTTP2_EXTERN int nghttp2_nv_compare_name(const nghttp2_nv *lhs,
const nghttp2_nv *rhs);
/** /**
* @function * @function
@ -3387,8 +3436,10 @@ int nghttp2_nv_compare_name(const nghttp2_nv *lhs, const nghttp2_nv *rhs);
* SSL_CTX_set_next_proto_select_cb(ssl_ctx, select_next_proto_cb, my_obj); * SSL_CTX_set_next_proto_select_cb(ssl_ctx, select_next_proto_cb, my_obj);
* *
*/ */
int nghttp2_select_next_protocol(unsigned char **out, unsigned char *outlen, NGHTTP2_EXTERN int nghttp2_select_next_protocol(unsigned char **out,
const unsigned char *in, unsigned int inlen); unsigned char *outlen,
const unsigned char *in,
unsigned int inlen);
/** /**
* @function * @function
@ -3399,7 +3450,7 @@ int nghttp2_select_next_protocol(unsigned char **out, unsigned char *outlen,
* version number and if the condition is not met, this function will * version number and if the condition is not met, this function will
* return a ``NULL``. Pass in 0 to skip the version checking. * return a ``NULL``. Pass in 0 to skip the version checking.
*/ */
nghttp2_info *nghttp2_version(int least_version); NGHTTP2_EXTERN nghttp2_info *nghttp2_version(int least_version);
/** /**
* @function * @function
@ -3407,7 +3458,7 @@ nghttp2_info *nghttp2_version(int least_version);
* Returns nonzero if the :type:`nghttp2_error` library error code * Returns nonzero if the :type:`nghttp2_error` library error code
* |lib_error| is fatal. * |lib_error| is fatal.
*/ */
int nghttp2_is_fatal(int lib_error); NGHTTP2_EXTERN int nghttp2_is_fatal(int lib_error);
/** /**
* @function * @function
@ -3418,7 +3469,7 @@ int nghttp2_is_fatal(int lib_error);
* Because this is a header field name in HTTP2, the upper cased alphabet * Because this is a header field name in HTTP2, the upper cased alphabet
* is treated as error. * is treated as error.
*/ */
int nghttp2_check_header_name(const uint8_t *name, size_t len); NGHTTP2_EXTERN int nghttp2_check_header_name(const uint8_t *name, size_t len);
/** /**
* @function * @function
@ -3427,7 +3478,7 @@ int nghttp2_check_header_name(const uint8_t *name, size_t len);
* is valid according to * is valid according to
* http://tools.ietf.org/html/rfc7230#section-3.2 * http://tools.ietf.org/html/rfc7230#section-3.2
*/ */
int nghttp2_check_header_value(const uint8_t *value, size_t len); NGHTTP2_EXTERN int nghttp2_check_header_value(const uint8_t *value, size_t len);
/* HPACK API */ /* HPACK API */
@ -3456,8 +3507,8 @@ typedef struct nghttp2_hd_deflater nghttp2_hd_deflater;
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_hd_deflate_new(nghttp2_hd_deflater **deflater_ptr, NGHTTP2_EXTERN int nghttp2_hd_deflate_new(nghttp2_hd_deflater **deflater_ptr,
size_t deflate_hd_table_bufsize_max); size_t deflate_hd_table_bufsize_max);
/** /**
* @function * @function
@ -3474,16 +3525,16 @@ int nghttp2_hd_deflate_new(nghttp2_hd_deflater **deflater_ptr,
* The library code does not refer to |mem| pointer after this * The library code does not refer to |mem| pointer after this
* function returns, so the application can safely free it. * function returns, so the application can safely free it.
*/ */
int nghttp2_hd_deflate_new2(nghttp2_hd_deflater **deflater_ptr, NGHTTP2_EXTERN int nghttp2_hd_deflate_new2(nghttp2_hd_deflater **deflater_ptr,
size_t deflate_hd_table_bufsize_max, size_t deflate_hd_table_bufsize_max,
nghttp2_mem *mem); nghttp2_mem *mem);
/** /**
* @function * @function
* *
* Deallocates any resources allocated for |deflater|. * Deallocates any resources allocated for |deflater|.
*/ */
void nghttp2_hd_deflate_del(nghttp2_hd_deflater *deflater); NGHTTP2_EXTERN void nghttp2_hd_deflate_del(nghttp2_hd_deflater *deflater);
/** /**
* @function * @function
@ -3508,8 +3559,9 @@ void nghttp2_hd_deflate_del(nghttp2_hd_deflater *deflater);
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_hd_deflate_change_table_size(nghttp2_hd_deflater *deflater, NGHTTP2_EXTERN int
size_t settings_hd_table_bufsize_max); nghttp2_hd_deflate_change_table_size(nghttp2_hd_deflater *deflater,
size_t settings_hd_table_bufsize_max);
/** /**
* @function * @function
@ -3538,9 +3590,9 @@ int nghttp2_hd_deflate_change_table_size(nghttp2_hd_deflater *deflater,
* :enum:`NGHTTP2_ERR_INSUFF_BUFSIZE` * :enum:`NGHTTP2_ERR_INSUFF_BUFSIZE`
* The provided |buflen| size is too small to hold the output. * The provided |buflen| size is too small to hold the output.
*/ */
ssize_t nghttp2_hd_deflate_hd(nghttp2_hd_deflater *deflater, uint8_t *buf, NGHTTP2_EXTERN ssize_t
size_t buflen, const nghttp2_nv *nva, nghttp2_hd_deflate_hd(nghttp2_hd_deflater *deflater, uint8_t *buf,
size_t nvlen); size_t buflen, const nghttp2_nv *nva, size_t nvlen);
/** /**
* @function * @function
@ -3548,8 +3600,9 @@ ssize_t nghttp2_hd_deflate_hd(nghttp2_hd_deflater *deflater, uint8_t *buf,
* Returns an upper bound on the compressed size after deflation of * Returns an upper bound on the compressed size after deflation of
* |nva| of length |nvlen|. * |nva| of length |nvlen|.
*/ */
size_t nghttp2_hd_deflate_bound(nghttp2_hd_deflater *deflater, NGHTTP2_EXTERN size_t nghttp2_hd_deflate_bound(nghttp2_hd_deflater *deflater,
const nghttp2_nv *nva, size_t nvlen); const nghttp2_nv *nva,
size_t nvlen);
struct nghttp2_hd_inflater; struct nghttp2_hd_inflater;
@ -3573,7 +3626,7 @@ typedef struct nghttp2_hd_inflater nghttp2_hd_inflater;
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_hd_inflate_new(nghttp2_hd_inflater **inflater_ptr); NGHTTP2_EXTERN int nghttp2_hd_inflate_new(nghttp2_hd_inflater **inflater_ptr);
/** /**
* @function * @function
@ -3590,15 +3643,15 @@ int nghttp2_hd_inflate_new(nghttp2_hd_inflater **inflater_ptr);
* The library code does not refer to |mem| pointer after this * The library code does not refer to |mem| pointer after this
* function returns, so the application can safely free it. * function returns, so the application can safely free it.
*/ */
int nghttp2_hd_inflate_new2(nghttp2_hd_inflater **inflater_ptr, NGHTTP2_EXTERN int nghttp2_hd_inflate_new2(nghttp2_hd_inflater **inflater_ptr,
nghttp2_mem *mem); nghttp2_mem *mem);
/** /**
* @function * @function
* *
* Deallocates any resources allocated for |inflater|. * Deallocates any resources allocated for |inflater|.
*/ */
void nghttp2_hd_inflate_del(nghttp2_hd_inflater *inflater); NGHTTP2_EXTERN void nghttp2_hd_inflate_del(nghttp2_hd_inflater *inflater);
/** /**
* @function * @function
@ -3615,8 +3668,9 @@ void nghttp2_hd_inflate_del(nghttp2_hd_inflater *inflater);
* :enum:`NGHTTP2_ERR_NOMEM` * :enum:`NGHTTP2_ERR_NOMEM`
* Out of memory. * Out of memory.
*/ */
int nghttp2_hd_inflate_change_table_size(nghttp2_hd_inflater *inflater, NGHTTP2_EXTERN int
size_t settings_hd_table_bufsize_max); nghttp2_hd_inflate_change_table_size(nghttp2_hd_inflater *inflater,
size_t settings_hd_table_bufsize_max);
/** /**
* @enum * @enum
@ -3715,9 +3769,10 @@ typedef enum {
* } * }
* *
*/ */
ssize_t nghttp2_hd_inflate_hd(nghttp2_hd_inflater *inflater, nghttp2_nv *nv_out, NGHTTP2_EXTERN ssize_t nghttp2_hd_inflate_hd(nghttp2_hd_inflater *inflater,
int *inflate_flags, uint8_t *in, size_t inlen, nghttp2_nv *nv_out,
int in_final); int *inflate_flags, uint8_t *in,
size_t inlen, int in_final);
/** /**
* @function * @function
@ -3727,7 +3782,8 @@ ssize_t nghttp2_hd_inflate_hd(nghttp2_hd_inflater *inflater, nghttp2_nv *nv_out,
* This function returns 0 if it succeeds. Currently this function * This function returns 0 if it succeeds. Currently this function
* always succeeds. * always succeeds.
*/ */
int nghttp2_hd_inflate_end_headers(nghttp2_hd_inflater *inflater); NGHTTP2_EXTERN int
nghttp2_hd_inflate_end_headers(nghttp2_hd_inflater *inflater);
#ifdef __cplusplus #ifdef __cplusplus
} }