From 253ec901761c8a5eb33e70ee00f4e0e5c663127d Mon Sep 17 00:00:00 2001 From: Tatsuhiro Tsujikawa Date: Tue, 5 Nov 2013 00:51:55 +0900 Subject: [PATCH] Update doc --- _sources/index.txt | 1 + apiref.html | 10 +- genindex.html | 10 +- index.html | 11 +- nghttp2.h.html | 10 +- nghttp2ver.h.html | 14 +- objects.inv | Bin 2045 -> 2045 bytes package_README.html | 10 +- released-versions/v0.2.0/_sources/apiref.txt | 1986 ++++ released-versions/v0.2.0/_sources/index.txt | 32 + .../v0.2.0/_sources/nghttp2.h.txt | 4 + .../v0.2.0/_sources/nghttp2ver.h.txt | 4 + .../v0.2.0/_sources/package_README.txt | 1 + .../v0.2.0/_static/ajax-loader.gif | Bin 0 -> 673 bytes released-versions/v0.2.0/_static/basic.css | 540 + .../v0.2.0/_static/comment-bright.png | Bin 0 -> 3500 bytes .../v0.2.0/_static/comment-close.png | Bin 0 -> 3578 bytes released-versions/v0.2.0/_static/comment.png | Bin 0 -> 3445 bytes released-versions/v0.2.0/_static/default.css | 256 + released-versions/v0.2.0/_static/default2.css | 15 + released-versions/v0.2.0/_static/doctools.js | 247 + .../v0.2.0/_static/down-pressed.png | Bin 0 -> 368 bytes released-versions/v0.2.0/_static/down.png | Bin 0 -> 363 bytes released-versions/v0.2.0/_static/file.png | Bin 0 -> 392 bytes released-versions/v0.2.0/_static/jquery.js | 9404 +++++++++++++++++ released-versions/v0.2.0/_static/minus.png | Bin 0 -> 199 bytes released-versions/v0.2.0/_static/plus.png | Bin 0 -> 199 bytes released-versions/v0.2.0/_static/pygments.css | 62 + .../v0.2.0/_static/searchtools.js | 560 + released-versions/v0.2.0/_static/sidebar.js | 151 + .../v0.2.0/_static/underscore.js | 1226 +++ .../v0.2.0/_static/up-pressed.png | Bin 0 -> 372 bytes released-versions/v0.2.0/_static/up.png | Bin 0 -> 363 bytes .../v0.2.0/_static/websupport.js | 808 ++ released-versions/v0.2.0/apiref.html | 2504 +++++ released-versions/v0.2.0/genindex.html | 1014 ++ released-versions/v0.2.0/index.html | 159 + released-versions/v0.2.0/nghttp2.h.html | 2404 +++++ released-versions/v0.2.0/nghttp2ver.h.html | 151 + released-versions/v0.2.0/objects.inv | Bin 0 -> 2041 bytes released-versions/v0.2.0/package_README.html | 870 ++ released-versions/v0.2.0/search.html | 104 + released-versions/v0.2.0/searchindex.js | 1 + search.html | 10 +- searchindex.js | 2 +- 45 files changed, 22543 insertions(+), 38 deletions(-) create mode 100644 released-versions/v0.2.0/_sources/apiref.txt create mode 100644 released-versions/v0.2.0/_sources/index.txt create mode 100644 released-versions/v0.2.0/_sources/nghttp2.h.txt create mode 100644 released-versions/v0.2.0/_sources/nghttp2ver.h.txt create mode 100644 released-versions/v0.2.0/_sources/package_README.txt create mode 100644 released-versions/v0.2.0/_static/ajax-loader.gif create mode 100644 released-versions/v0.2.0/_static/basic.css create mode 100644 released-versions/v0.2.0/_static/comment-bright.png create mode 100644 released-versions/v0.2.0/_static/comment-close.png create mode 100644 released-versions/v0.2.0/_static/comment.png create mode 100644 released-versions/v0.2.0/_static/default.css create mode 100644 released-versions/v0.2.0/_static/default2.css create mode 100644 released-versions/v0.2.0/_static/doctools.js create mode 100644 released-versions/v0.2.0/_static/down-pressed.png create mode 100644 released-versions/v0.2.0/_static/down.png create mode 100644 released-versions/v0.2.0/_static/file.png create mode 100644 released-versions/v0.2.0/_static/jquery.js create mode 100644 released-versions/v0.2.0/_static/minus.png create mode 100644 released-versions/v0.2.0/_static/plus.png create mode 100644 released-versions/v0.2.0/_static/pygments.css create mode 100644 released-versions/v0.2.0/_static/searchtools.js create mode 100644 released-versions/v0.2.0/_static/sidebar.js create mode 100644 released-versions/v0.2.0/_static/underscore.js create mode 100644 released-versions/v0.2.0/_static/up-pressed.png create mode 100644 released-versions/v0.2.0/_static/up.png create mode 100644 released-versions/v0.2.0/_static/websupport.js create mode 100644 released-versions/v0.2.0/apiref.html create mode 100644 released-versions/v0.2.0/genindex.html create mode 100644 released-versions/v0.2.0/index.html create mode 100644 released-versions/v0.2.0/nghttp2.h.html create mode 100644 released-versions/v0.2.0/nghttp2ver.h.html create mode 100644 released-versions/v0.2.0/objects.inv create mode 100644 released-versions/v0.2.0/package_README.html create mode 100644 released-versions/v0.2.0/search.html create mode 100644 released-versions/v0.2.0/searchindex.js diff --git a/_sources/index.txt b/_sources/index.txt index 91a9f790..1be7fa0a 100644 --- a/_sources/index.txt +++ b/_sources/index.txt @@ -22,6 +22,7 @@ Contents: Released Versions ================= +* `v0.2.0 `_ `(Download) `_ * `v0.1.0 `_ `(Download) `_ diff --git a/apiref.html b/apiref.html index 3c96e52e..491b2152 100644 --- a/apiref.html +++ b/apiref.html @@ -8,7 +8,7 @@ - API Reference — nghttp2 0.2.0-DEV documentation + API Reference — nghttp2 0.3.0-DEV documentation @@ -17,7 +17,7 @@ - + @@ -43,7 +43,7 @@
  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • @@ -2493,7 +2493,7 @@ the version checking.

  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • diff --git a/genindex.html b/genindex.html index cb76bc80..9e3553ac 100644 --- a/genindex.html +++ b/genindex.html @@ -10,7 +10,7 @@ - Index — nghttp2 0.2.0-DEV documentation + Index — nghttp2 0.3.0-DEV documentation @@ -19,7 +19,7 @@ - +
    @@ -37,7 +37,7 @@
  • index
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • @@ -1003,7 +1003,7 @@
  • index
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • diff --git a/index.html b/index.html index c2cd98cb..27c0b792 100644 --- a/index.html +++ b/index.html @@ -8,7 +8,7 @@ - nghttp2 - HTTP/2.0 C Library — nghttp2 0.2.0-DEV documentation + nghttp2 - HTTP/2.0 C Library — nghttp2 0.3.0-DEV documentation @@ -17,7 +17,7 @@ - + @@ -39,7 +39,7 @@
  • next |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • @@ -82,6 +82,7 @@ version 2.0.

    Released VersionsΒΆ

    @@ -148,7 +149,7 @@ version 2.0.

  • next |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • diff --git a/nghttp2.h.html b/nghttp2.h.html index 518b00d6..8ea02b3b 100644 --- a/nghttp2.h.html +++ b/nghttp2.h.html @@ -8,7 +8,7 @@ - nghttp2.h — nghttp2 0.2.0-DEV documentation + nghttp2.h — nghttp2 0.3.0-DEV documentation @@ -17,7 +17,7 @@ - + @@ -43,7 +43,7 @@
  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • @@ -2393,7 +2393,7 @@
  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • diff --git a/nghttp2ver.h.html b/nghttp2ver.h.html index 521dec24..e5cfce80 100644 --- a/nghttp2ver.h.html +++ b/nghttp2ver.h.html @@ -8,7 +8,7 @@ - nghttp2ver.h — nghttp2 0.2.0-DEV documentation + nghttp2ver.h — nghttp2 0.3.0-DEV documentation @@ -17,7 +17,7 @@ - + @@ -39,7 +39,7 @@
  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • @@ -81,7 +81,7 @@ * @macro * Version number of the nghttp2 library release */ -#define NGHTTP2_VERSION "0.2.0-DEV" +#define NGHTTP2_VERSION "0.3.0-DEV" /** * @macro @@ -89,7 +89,7 @@ * release. This is a 24 bit number with 8 bits for major number, 8 bits * for minor and 8 bits for patch. Version 1.2.3 becomes 0x010203. */ -#define NGHTTP2_VERSION_NUM 0x000200 +#define NGHTTP2_VERSION_NUM 0x000300 #endif /* NGHTTP2VER_H */ @@ -140,7 +140,7 @@
  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • diff --git a/objects.inv b/objects.inv index bc8f5d645606a5ad2e95f49f79538ded1d54a0a0..38b1d3acf3b7d366f39c01cbbfd0f64a8a24d184 100644 GIT binary patch delta 12 Tcmey%|CfJ)Eu-;9yZ!6{BPj&W delta 12 Tcmey%|CfJ)Eu+y!yZ!6{BP0aQ diff --git a/package_README.html b/package_README.html index 1bcb8921..b967e0e9 100644 --- a/package_README.html +++ b/package_README.html @@ -8,7 +8,7 @@ - nghttp2 - HTTP/2.0 C Library — nghttp2 0.2.0-DEV documentation + nghttp2 - HTTP/2.0 C Library — nghttp2 0.3.0-DEV documentation @@ -17,7 +17,7 @@ - + @@ -43,7 +43,7 @@
  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • @@ -859,7 +859,7 @@ corresponding header set was processed. The format is the same as
  • previous |
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • diff --git a/released-versions/v0.2.0/_sources/apiref.txt b/released-versions/v0.2.0/_sources/apiref.txt new file mode 100644 index 00000000..fcb68319 --- /dev/null +++ b/released-versions/v0.2.0/_sources/apiref.txt @@ -0,0 +1,1986 @@ +API Reference +============= + +Includes +-------- + +To use the public APIs, include ``nghttp2/nghttp2.h``:: + + #include + +The header files are also available online: :doc:`nghttp2.h` and +:doc:`nghttp2ver.h`. + +Remarks +------- + +Do not call `nghttp2_session_send`, `nghttp2_session_recv` or +`nghttp2_session_mem_recv` from the nghttp2 callback functions +directly or indirectly. It will lead to the crash. You can submit +requests or frames in the callbacks then call `nghttp2_session_send`, +`nghttp2_session_recv` or `nghttp2_session_mem_recv` outside of the +callbacks. + +Macros +------ +.. macro:: NGHTTP2_VERSION + + Version number of the nghttp2 library release + +.. macro:: NGHTTP2_VERSION_NUM + + Numerical representation of the version number of the nghttp2 library + release. This is a 24 bit number with 8 bits for major number, 8 bits + for minor and 8 bits for patch. Version 1.2.3 becomes 0x010203. + +.. macro:: NGHTTP2_PROTO_VERSION_ID + + + The protocol version identification of this library supports. + +.. macro:: NGHTTP2_PROTO_VERSION_ID_LEN + + + The length of :macro:`NGHTTP2_PROTO_VERSION_ID`. + +.. macro:: NGHTTP2_VERSION_AGE + + + The age of :type:`nghttp2_info` + +.. macro:: NGHTTP2_PRI_DEFAULT + + + The default priority value + +.. macro:: NGHTTP2_PRI_LOWEST + + + The lowest priority value + +.. macro:: NGHTTP2_MAX_WINDOW_SIZE + + + The maximum window size + +.. macro:: NGHTTP2_INITIAL_WINDOW_SIZE + + + The initial window size for stream level flow control. + +.. macro:: NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZE + + + The initial window size for connection level flow control. + +.. macro:: NGHTTP2_MAX_HEADER_TABLE_SIZE + + + The maximum header table size. + +.. macro:: NGHTTP2_CLIENT_CONNECTION_HEADER + + + The client connection header. + +.. macro:: NGHTTP2_CLIENT_CONNECTION_HEADER_LEN + + + The length of :macro:`NGHTTP2_CLIENT_CONNECTION_HEADER`. + +.. macro:: NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMS + + Default maximum concurrent streams. + + +Enums +----- +.. type:: nghttp2_error + + + Error codes used in this library. The code range is [-999, -500], + inclusive. The following values are defined: + + .. macro:: NGHTTP2_ERR_INVALID_ARGUMENT + + (``-501``) + Invalid argument passed. + .. macro:: NGHTTP2_ERR_UNSUPPORTED_VERSION + + (``-503``) + The specified protocol version is not supported. + .. macro:: NGHTTP2_ERR_WOULDBLOCK + + (``-504``) + Used as a return value from :type:`nghttp2_send_callback` and + :type:`nghttp2_recv_callback` to indicate that the operation + would block. + .. macro:: NGHTTP2_ERR_PROTO + + (``-505``) + General protocol error + .. macro:: NGHTTP2_ERR_INVALID_FRAME + + (``-506``) + The frame is invalid. + .. macro:: NGHTTP2_ERR_EOF + + (``-507``) + The peer performed a shutdown on the connection. + .. macro:: NGHTTP2_ERR_DEFERRED + + (``-508``) + Used as a return value from + :func:`nghttp2_data_source_read_callback` to indicate that data + transfer is postponed. See + :func:`nghttp2_data_source_read_callback` for details. + .. macro:: NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE + + (``-509``) + Stream ID has reached the maximum value. Therefore no stream ID + is available. + .. macro:: NGHTTP2_ERR_STREAM_CLOSED + + (``-510``) + The stream is already closed; or the stream ID is invalid. + .. macro:: NGHTTP2_ERR_STREAM_CLOSING + + (``-511``) + RST_STREAM has been added to the outbound queue. The stream is in + closing state. + .. macro:: NGHTTP2_ERR_STREAM_SHUT_WR + + (``-512``) + The transmission is not allowed for this stream (e.g., a frame + with END_STREAM flag set has already sent). + .. macro:: NGHTTP2_ERR_INVALID_STREAM_ID + + (``-513``) + The stream ID is invalid. + .. macro:: NGHTTP2_ERR_INVALID_STREAM_STATE + + (``-514``) + The state of the stream is not valid (e.g., DATA cannot be sent + to the stream if response HEADERS has not been sent). + .. macro:: NGHTTP2_ERR_DEFERRED_DATA_EXIST + + (``-515``) + Another DATA frame has already been deferred. + .. macro:: NGHTTP2_ERR_START_STREAM_NOT_ALLOWED + + (``-516``) + Starting new stream is not allowed. (e.g., GOAWAY has been sent + and/or received. + .. macro:: NGHTTP2_ERR_GOAWAY_ALREADY_SENT + + (``-517``) + GOAWAY has already been sent. + .. macro:: NGHTTP2_ERR_INVALID_HEADER_BLOCK + + (``-518``) + The received frame contains the invalid header block. (e.g., + There are duplicate header names; or the header names are not + encoded in US-ASCII character set and not lower cased; or the + header name is zero-length string; or the header value contains + multiple in-sequence NUL bytes). + .. macro:: NGHTTP2_ERR_INVALID_STATE + + (``-519``) + Indicates that the context is not suitable to perform the + requested operation. + .. macro:: NGHTTP2_ERR_GZIP + + (``-520``) + The gzip error. + .. macro:: NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE + + (``-521``) + The user callback function failed due to the temporal error. + .. macro:: NGHTTP2_ERR_FRAME_SIZE_ERROR + + (``-522``) + The length of the frame is invalid, either too large or too small. + .. macro:: NGHTTP2_ERR_HEADER_COMP + + (``-523``) + Header block inflate/deflate error. + .. macro:: NGHTTP2_ERR_FLOW_CONTROL + + (``-524``) + Flow control error + .. macro:: NGHTTP2_ERR_INSUFF_BUFSIZE + + (``-525``) + Insufficient buffer size given to function. + .. macro:: NGHTTP2_ERR_PAUSE + + (``-526``) + Callback was paused by the application + .. macro:: NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGS + + (``-527``) + There are too many in-flight SETTING frame and no more + transmission of SETTINGS is allowed. + .. macro:: NGHTTP2_ERR_PUSH_DISABLED + + (``-528``) + The server push is disabled. + .. macro:: NGHTTP2_ERR_FATAL + + (``-900``) + The errors < :macro:`NGHTTP2_ERR_FATAL` mean that the library is + under unexpected condition and cannot process any further data + reliably (e.g., out of memory). + .. macro:: NGHTTP2_ERR_NOMEM + + (``-901``) + Out of memory. This is a fatal error. + .. macro:: NGHTTP2_ERR_CALLBACK_FAILURE + + (``-902``) + The user callback function failed. This is a fatal error. + + +.. type:: nghttp2_frame_type + + The control frame types in HTTP/2.0. + + .. macro:: NGHTTP2_DATA + + (``0``) + The DATA frame. + .. macro:: NGHTTP2_HEADERS + + (``1``) + The HEADERS frame. + .. macro:: NGHTTP2_PRIORITY + + (``2``) + The PRIORITY frame. + .. macro:: NGHTTP2_RST_STREAM + + (``3``) + The RST_STREAM frame. + .. macro:: NGHTTP2_SETTINGS + + (``4``) + The SETTINGS frame. + .. macro:: NGHTTP2_PUSH_PROMISE + + (``5``) + The PUSH_PROMISE frame. + .. macro:: NGHTTP2_PING + + (``6``) + The PING frame. + .. macro:: NGHTTP2_GOAWAY + + (``7``) + The GOAWAY frame. + .. macro:: NGHTTP2_WINDOW_UPDATE + + (``9``) + The WINDOW_UPDATE frame. + + +.. type:: nghttp2_flag + + + The flags for HTTP/2.0 frames. This enum defines all flags for + frames, assuming that the same flag name has the same mask. + + .. macro:: NGHTTP2_FLAG_NONE + + (``0``) + No flag set. + .. macro:: NGHTTP2_FLAG_END_STREAM + + (``0x1``) + The END_STREAM flag. + .. macro:: NGHTTP2_FLAG_END_HEADERS + + (``0x4``) + The END_HEADERS flag. + .. macro:: NGHTTP2_FLAG_PRIORITY + + (``0x8``) + The PRIORITY flag. + .. macro:: NGHTTP2_FLAG_END_PUSH_PROMISE + + (``0x4``) + The END_PUSH_PROMISE flag. + .. macro:: NGHTTP2_FLAG_ACK + + (``0x1``) + The ACK flag. + + +.. type:: nghttp2_settings_id + + The SETTINGS ID. + + .. macro:: NGHTTP2_SETTINGS_HEADER_TABLE_SIZE + + (``1``) + SETTINGS_HEADER_TABLE_SIZE + .. macro:: NGHTTP2_SETTINGS_ENABLE_PUSH + + (``2``) + SETTINGS_ENABLE_PUSH + .. macro:: NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS + + (``4``) + SETTINGS_MAX_CONCURRENT_STREAMS + .. macro:: NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE + + (``7``) + SETTINGS_INITIAL_WINDOW_SIZE + .. macro:: NGHTTP2_SETTINGS_FLOW_CONTROL_OPTIONS + + (``10``) + SETTINGS_FLOW_CONTROL_OPTIONS + .. macro:: NGHTTP2_SETTINGS_MAX + + (``10``) + Maximum ID of :type:`nghttp2_settings_id`. + + +.. type:: nghttp2_error_code + + The status codes for the RST_STREAM and GOAWAY frames. + + .. macro:: NGHTTP2_NO_ERROR + + (``0``) + No errors. + .. macro:: NGHTTP2_PROTOCOL_ERROR + + (``1``) + PROTOCOL_ERROR + .. macro:: NGHTTP2_INTERNAL_ERROR + + (``2``) + INTERNAL_ERROR + .. macro:: NGHTTP2_FLOW_CONTROL_ERROR + + (``3``) + FLOW_CONTROL_ERROR + .. macro:: NGHTTP2_SETTINGS_TIMEOUT + + (``4``) + SETTINGS_TIMEOUT + .. macro:: NGHTTP2_STREAM_CLOSED + + (``5``) + STREAM_CLOSED + .. macro:: NGHTTP2_FRAME_SIZE_ERROR + + (``6``) + FRAME_SIZE_ERROR + .. macro:: NGHTTP2_REFUSED_STREAM + + (``7``) + REFUSED_STREAM + .. macro:: NGHTTP2_CANCEL + + (``8``) + CANCEL + .. macro:: NGHTTP2_COMPRESSION_ERROR + + (``9``) + COMPRESSION_ERROR + .. macro:: NGHTTP2_CONNECT_ERROR + + (``10``) + CONNECT_ERROR + .. macro:: NGHTTP2_ENHANCE_YOUR_CALM + + (``420``) + ENHANCE_YOUR_CALM + + +.. type:: nghttp2_headers_category + + + The category of HEADERS, which indicates the role of the frame. In + HTTP/2.0 spec, request, response, push response and other arbitrary + headers (e.g., trailers) are all called just HEADERS. To give the + application the role of incoming HEADERS frame, we define several + categories. + + .. macro:: NGHTTP2_HCAT_REQUEST + + (``0``) + The HEADERS frame is opening new stream, which is analogous to + SYN_STREAM in SPDY. + .. macro:: NGHTTP2_HCAT_RESPONSE + + (``1``) + The HEADERS frame is the first response headers, which is + analogous to SYN_REPLY in SPDY. + .. macro:: NGHTTP2_HCAT_PUSH_RESPONSE + + (``2``) + The HEADERS frame is the first headers sent against reserved + stream. + .. macro:: NGHTTP2_HCAT_HEADERS + + (``3``) + The HEADERS frame which does not apply for the above categories, + which is analogous to HEADERS in SPDY. + + +.. type:: nghttp2_opt + + + Configuration options for :type:`nghttp2_session`. + + .. macro:: NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE + + (``1``) + This option prevents the library from sending WINDOW_UPDATE for a + stream automatically. If this option is set, the application is + responsible for sending WINDOW_UPDATE using + `nghttp2_submit_window_update`. + .. macro:: NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE + + (``2``) + This option prevents the library from sending WINDOW_UPDATE for a + connection automatically. If this option is set, the application + is responsible for sending WINDOW_UPDATE with stream ID 0 using + `nghttp2_submit_window_update`. + .. macro:: NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS + + (``3``) + This option sets the SETTINGS_MAX_CONCURRENT_STREAMS value of + remote endpoint as if it is received in SETTINGS frame. Without + specifying this option, before the local endpoint receives + SETTINGS_MAX_CONCURRENT_STREAMS in SETTINGS frame from remote + endpoint, SETTINGS_MAX_CONCURRENT_STREAMS is unlimited. This may + cause problem if local endpoint submits lots of requests + initially and sending them at once to the remote peer may lead to + the rejection of some requests. Specifying this option to the + sensible value, say 100, may avoid this kind of issue. This value + will be overwritten if the local endpoint receives + SETTINGS_MAX_CONCURRENT_STREAMS from the remote endpoint. + + + +Types (structs, unions and typedefs) +------------------------------------ +.. type:: nghttp2_session + + + The primary structure to hold the resources needed for a HTTP/2.0 + session. The details of this structure are intentionally hidden + from the public API. + + + +.. type:: nghttp2_info + + + This struct is what `nghttp2_version()` returns. It holds + information about the particular nghttp2 version. + + .. member:: int age + + Age of this struct. This instance of nghttp2 sets it to + :macro:`NGHTTP2_VERSION_AGE` but a future version may bump it and + add more struct fields at the bottom + .. member:: int version_num + + the :macro:`NGHTTP2_VERSION_NUM` number (since age ==1) + .. member:: const char *version_str + + points to the :macro:`NGHTTP2_VERSION` string (since age ==1) + .. member:: const char *proto_str + + points to the :macro:`NGHTTP2_PROTO_VERSION_ID` string this + instance implements (since age ==1) + + +.. type:: nghttp2_nv + + + The name/value pair, which mainly used to represent header fields. + + .. member:: uint8_t *name + + The *name* byte string, which is not necessarily ``NULL`` + terminated. + .. member:: uint8_t *value + + The *value* byte string, which is not necessarily ``NULL`` + terminated. + .. member:: uint16_t namelen + + The length of the *name*. + .. member:: uint16_t valuelen + + The length of the *value*. + + +.. type:: nghttp2_frame_hd + + The frame header. + + .. member:: uint16_t length + + The length field of this frame, excluding frame header. + .. member:: uint8_t type + + The type of this frame. See `nghttp2_frame`. + .. member:: uint8_t flags + + The flags. + .. member:: int32_t stream_id + + The stream identifier (aka, stream ID) + + +.. type:: nghttp2_data_source + + + This union represents the some kind of data source passed to + :type:`nghttp2_data_source_read_callback`. + + .. member:: int fd + + The integer field, suitable for a file descriptor. + .. member:: void *ptr + + The pointer to an arbitrary object. + + +.. type:: typedef ssize_t (*nghttp2_data_source_read_callback) (nghttp2_session *session, int32_t stream_id, uint8_t *buf, size_t length, int *eof, nghttp2_data_source *source, void *user_data) + + + Callback function invoked when the library wants to read data from + the *source*. The read data is sent in the stream *stream_id*. The + implementation of this function must read at most *length* bytes of + data from *source* (or possibly other places) and store them in + *buf* and return number of data stored in *buf*. If EOF is reached, + set *\*eof* to 1. If the application wants to postpone DATA frames, + (e.g., asynchronous I/O, or reading data blocks for long time), it + is achieved by returning :macro:`NGHTTP2_ERR_DEFERRED` without + reading any data in this invocation. The library removes DATA + frame from the outgoing queue temporarily. To move back deferred + DATA frame to outgoing queue, call `nghttp2_session_resume_data()`. + In case of error, there are 2 choices. Returning + :macro:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will close the stream + by issuing RST_STREAM with :macro:`NGHTTP2_INTERNAL_ERROR`. + Returning :macro:`NGHTTP2_ERR_CALLBACK_FAILURE` will signal the + entire session failure. + +.. type:: nghttp2_data_provider + + + This struct represents the data source and the way to read a chunk + of data from it. + + .. member:: nghttp2_data_source source + + The data source. + .. member:: nghttp2_data_source_read_callback read_callback + + The callback function to read a chunk of data from the *source*. + + +.. type:: nghttp2_headers + + The HEADERS frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: int32_t pri + + The priority. + .. member:: nghttp2_nv *nva + + The name/value pairs. + .. member:: size_t nvlen + + The number of name/value pairs in *nva*. + + +.. type:: nghttp2_priority + + The PRIORITY frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: int32_t pri + + The priority. + + +.. type:: nghttp2_rst_stream + + The RST_STREAM frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: nghttp2_error_code error_code + + The error code. See :type:`nghttp2_error_code`. + + +.. type:: nghttp2_settings_entry + + The SETTINGS ID/Value pair. It has the following members: + + .. member:: int32_t settings_id + + The SETTINGS ID. See :type:`nghttp2_settings_id`. + .. member:: uint32_t value + + The value of this entry. + + +.. type:: nghttp2_settings + + The SETTINGS frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: size_t niv + + The number of SETTINGS ID/Value pairs in *iv*. + .. member:: nghttp2_settings_entry *iv + + The pointer to the array of SETTINGS ID/Value pair. + + +.. type:: nghttp2_push_promise + + The PUSH_PROMISE frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: int32_t promised_stream_id + + The promised stream ID + .. member:: nghttp2_nv *nva + + The name/value pairs. + .. member:: size_t nvlen + + The number of name/value pairs in *nva*. + + +.. type:: nghttp2_ping + + The PING frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: uint8_t opaque_data[8] + + The opaque data + + +.. type:: nghttp2_goaway + + The GOAWAY frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: int32_t last_stream_id + + The last stream stream ID. + .. member:: nghttp2_error_code error_code + + The error code. See :type:`nghttp2_error_code`. + .. member:: uint8_t *opaque_data + + The additional debug data + .. member:: size_t opaque_data_len + + The length of *opaque_data* member. + + +.. type:: nghttp2_window_update + + + The WINDOW_UPDATE frame. It has the following members: + + .. member:: nghttp2_frame_hd hd + + The frame header. + .. member:: int32_t window_size_increment + + The window size increment. + + +.. type:: nghttp2_frame + + + This union includes all frames to pass them to various function + calls as nghttp2_frame type. The DATA frame is intentionally + omitted from here. + + .. member:: nghttp2_frame_hd hd + + The frame header, which is convenient to inspect frame header. + .. member:: nghttp2_headers headers + + The HEADERS frame. + .. member:: nghttp2_priority priority + + The PRIORITY frame. + .. member:: nghttp2_rst_stream rst_stream + + The RST_STREAM frame. + .. member:: nghttp2_settings settings + + The SETTINGS frame. + .. member:: nghttp2_push_promise push_promise + + The PUSH_PROMISE frame. + .. member:: nghttp2_ping ping + + The PING frame. + .. member:: nghttp2_goaway goaway + + The GOAWAY frame. + .. member:: nghttp2_window_update window_update + + The WINDOW_UPDATE frame. + + +.. type:: typedef ssize_t (*nghttp2_send_callback) (nghttp2_session *session, const uint8_t *data, size_t length, int flags, void *user_data) + + + Callback function invoked when *session* wants to send data to the + remote peer. The implementation of this function must send at most + *length* bytes of data stored in *data*. The *flags* is currently + not used and always 0. It must return the number of bytes sent if + it succeeds. If it cannot send any single byte without blocking, + it must return :macro:`NGHTTP2_ERR_WOULDBLOCK`. For other errors, it + must return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. The *user_data* + pointer is the third argument passed in to the call to + `nghttp2_session_client_new()` or `nghttp2_session_server_new()`. + +.. type:: typedef ssize_t (*nghttp2_recv_callback) (nghttp2_session *session, uint8_t *buf, size_t length, int flags, void *user_data) + + + Callback function invoked when *session* wants to receive data from + the remote peer. The implementation of this function must read at + most *length* bytes of data and store it in *buf*. The *flags* is + currently not used and always 0. It must return the number of bytes + written in *buf* if it succeeds. If it cannot read any single byte + without blocking, it must return :macro:`NGHTTP2_ERR_WOULDBLOCK`. If + it gets EOF before it reads any single byte, it must return + :macro:`NGHTTP2_ERR_EOF`. For other errors, it must return + :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. Returning 0 is treated as + :macro:`NGHTTP2_ERR_WOULDBLOCK`. The *user_data* pointer is the + third argument passed in to the call to + `nghttp2_session_client_new()` or `nghttp2_session_server_new()`. + +.. type:: typedef int (*nghttp2_on_frame_recv_callback) (nghttp2_session *session, const nghttp2_frame *frame, void *user_data) + + + Callback function invoked by `nghttp2_session_recv()` when a + non-DATA frame is received. The *user_data* pointer is the third + argument passed in to the call to `nghttp2_session_client_new()` or + `nghttp2_session_server_new()`. + + If the application uses `nghttp2_session_mem_recv()`, it can return + :macro:`NGHTTP2_ERR_PAUSE` to make `nghttp2_session_mem_recv()` + return without processing further input bytes. The *frame* + parameter is retained until `nghttp2_session_continue()` is + called. The application must retain the input bytes which was used + to produce the *frame* parameter, because it may refer to the + memory region included in the input bytes. The application which + returns :macro:`NGHTTP2_ERR_PAUSE` must call + `nghttp2_session_continue()` before `nghttp2_session_mem_recv()`. + + The implementation of this function must return 0 if it + succeeds. It may return :macro:`NGHTTP2_ERR_PAUSE`. If the other + nonzero value is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_invalid_frame_recv_callback) (nghttp2_session *session, const nghttp2_frame *frame, nghttp2_error_code error_code, void *user_data) + + + Callback function invoked by `nghttp2_session_recv()` when an + invalid non-DATA frame is received. The *error_code* is one of the + :macro:`nghttp2_error_code` and indicates the error. When this + callback function is invoked, the library automatically submits + either RST_STREAM or GOAWAY frame. The *user_data* pointer is the + third argument passed in to the call to + `nghttp2_session_client_new()` or `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_data_chunk_recv_callback) (nghttp2_session *session, uint8_t flags, int32_t stream_id, const uint8_t *data, size_t len, void *user_data) + + + Callback function invoked when a chunk of data in DATA frame is + received. The *stream_id* is the stream ID this DATA frame belongs + to. The *flags* is the flags of DATA frame which this data chunk is + contained. ``(flags & NGHTTP2_FLAG_END_STREAM) != 0`` does not + necessarily mean this chunk of data is the last one in the + stream. You should use :type:`nghttp2_on_data_recv_callback` to + know all data frames are received. The *user_data* pointer is the + third argument passed in to the call to + `nghttp2_session_client_new()` or `nghttp2_session_server_new()`. + + If the application uses `nghttp2_session_mem_recv()`, it can return + :macro:`NGHTTP2_ERR_PAUSE` to make `nghttp2_session_mem_recv()` + return without processing further input bytes. The *frame* + parameter is retained until `nghttp2_session_continue()` is + called. The application must retain the input bytes which was used + to produce the *frame* parameter, because it may refer to the + memory region included in the input bytes. The application which + returns :macro:`NGHTTP2_ERR_PAUSE` must call + `nghttp2_session_continue()` before `nghttp2_session_mem_recv()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_data_recv_callback) (nghttp2_session *session, uint16_t length, uint8_t flags, int32_t stream_id, void *user_data) + + + Callback function invoked when DATA frame is received. The actual + data it contains are received by + :type:`nghttp2_on_data_chunk_recv_callback`. The *user_data* + pointer is the third argument passed in to the call to + `nghttp2_session_client_new()` or `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_before_frame_send_callback) (nghttp2_session *session, const nghttp2_frame *frame, void *user_data) + + + Callback function invoked before the non-DATA frame *frame* is + sent. This may be useful, for example, to know the stream ID of + HEADERS and PUSH_PROMISE frame (see also + `nghttp2_session_get_stream_user_data()`), which is not assigned + when it was queued. The *user_data* pointer is the third argument + passed in to the call to `nghttp2_session_client_new()` or + `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_frame_send_callback) (nghttp2_session *session, const nghttp2_frame *frame, void *user_data) + + + Callback function invoked after the non-DATA frame *frame* is sent. + The *user_data* pointer is the third argument passed in to the call + to `nghttp2_session_client_new()` or + `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_frame_not_send_callback) (nghttp2_session *session, const nghttp2_frame *frame, int lib_error_code, void *user_data) + + + Callback function invoked after the non-DATA frame *frame* is not + sent because of the error. The error is indicated by the + *lib_error_code*, which is one of the values defined in + :type:`nghttp2_error`. The *user_data* pointer is the third + argument passed in to the call to `nghttp2_session_client_new()` or + `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_data_send_callback) (nghttp2_session *session, uint16_t length, uint8_t flags, int32_t stream_id, void *user_data) + + + Callback function invoked after DATA frame is sent. The *user_data* + pointer is the third argument passed in to the call to + `nghttp2_session_client_new()` or `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_stream_close_callback) (nghttp2_session *session, int32_t stream_id, nghttp2_error_code error_code, void *user_data) + + + Callback function invoked when the stream *stream_id* is + closed. The reason of closure is indicated by the *error_code*. The + stream_user_data, which was specified in `nghttp2_submit_request()` + or `nghttp2_submit_headers()`, is still available in this + function. The *user_data* pointer is the third argument passed in + to the call to `nghttp2_session_client_new()` or + `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_request_recv_callback) (nghttp2_session *session, int32_t stream_id, void *user_data) + + + Callback function invoked when the request from the remote peer is + received. In other words, the frame with END_STREAM flag set is + received. In HTTP, this means HTTP request, including request + body, is fully received. The *user_data* pointer is the third + argument passed in to the call to `nghttp2_session_client_new()` or + `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_frame_recv_parse_error_callback) (nghttp2_session *session, nghttp2_frame_type type, const uint8_t *head, size_t headlen, const uint8_t *payload, size_t payloadlen, int lib_error_code, void *user_data) + + + Callback function invoked when the received control frame octets + could not be parsed correctly. The *type* indicates the type of + received non-DATA frame. The *head* is the pointer to the header of + the received frame. The *headlen* is the length of the + *head*. According to the spec, the *headlen* is always 8. In other + words, the *head* is the first 8 bytes of the received frame. The + *payload* is the pointer to the data portion of the received frame. + The *payloadlen* is the length of the *payload*. This is the data + after the length field. The *lib_error_code* is one of the error + code defined in :macro:`nghttp2_error` and indicates the error. The + *user_data* pointer is the third argument passed in to the call to + `nghttp2_session_client_new()` or `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: typedef int (*nghttp2_on_unknown_frame_recv_callback) (nghttp2_session *session, const uint8_t *head, size_t headlen, const uint8_t *payload, size_t payloadlen, void *user_data) + + + Callback function invoked when the received frame type is + unknown. The *head* is the pointer to the header of the received + frame. The *headlen* is the length of the *head*. According to the + spec, the *headlen* is always 8. In other words, the *head* is the + first 8 bytes of the received frame. The *payload* is the pointer + to the data portion of the received frame. The *payloadlen* is the + length of the *payload*. This is the data after the length + field. The *user_data* pointer is the third argument passed in to + the call to `nghttp2_session_client_new()` or + `nghttp2_session_server_new()`. + + The implementation of this function must return 0 if it + succeeds. If nonzero is returned, it is treated as fatal error and + `nghttp2_session_recv()` and `nghttp2_session_send()` functions + immediately return :macro:`NGHTTP2_ERR_CALLBACK_FAILURE`. + +.. type:: nghttp2_session_callbacks + + + Callback functions. + + .. member:: nghttp2_send_callback send_callback + + Callback function invoked when the *session* wants to send data + to the remote peer. + .. member:: nghttp2_recv_callback recv_callback + + Callback function invoked when the *session* wants to receive + data from the remote peer. + .. member:: nghttp2_on_frame_recv_callback on_frame_recv_callback + + Callback function invoked by `nghttp2_session_recv()` when a + non-DATA frame is received. + .. member:: nghttp2_on_invalid_frame_recv_callback on_invalid_frame_recv_callback + + Callback function invoked by `nghttp2_session_recv()` when an + invalid non-DATA frame is received. + .. member:: nghttp2_on_data_chunk_recv_callback on_data_chunk_recv_callback + + Callback function invoked when a chunk of data in DATA frame is + received. + .. member:: nghttp2_on_data_recv_callback on_data_recv_callback + + Callback function invoked when DATA frame is received. + .. member:: nghttp2_before_frame_send_callback before_frame_send_callback + + Callback function invoked before the non-DATA frame is sent. + .. member:: nghttp2_on_frame_send_callback on_frame_send_callback + + Callback function invoked after the non-DATA frame is sent. + .. member:: nghttp2_on_frame_not_send_callback on_frame_not_send_callback + + The callback function invoked when a non-DATA frame is not sent + because of an error. + .. member:: nghttp2_on_data_send_callback on_data_send_callback + + Callback function invoked after DATA frame is sent. + .. member:: nghttp2_on_stream_close_callback on_stream_close_callback + + Callback function invoked when the stream is closed. + .. member:: nghttp2_on_request_recv_callback on_request_recv_callback + + Callback function invoked when request from the remote peer is + received. + .. member:: nghttp2_on_frame_recv_parse_error_callback + + Callback function invoked when the received non-DATA frame octets + could not be parsed correctly. + .. member:: nghttp2_on_unknown_frame_recv_callback on_unknown_frame_recv_callback + + Callback function invoked when the received frame type is + unknown. + + +.. type:: nghttp2_gzip + + + The gzip stream to inflate data. The details of this structure are + intentionally hidden from the public API. + + + + +Functions +--------- +.. function:: int nghttp2_session_client_new(nghttp2_session **session_ptr, const nghttp2_session_callbacks *callbacks, void *user_data) + + + Initializes *\*session_ptr* for client use. The all members of + *callbacks* are copied to *\*session_ptr*. Therefore *\*session_ptr* + does not store *callbacks*. *user_data* is an arbitrary user + supplied data, which will be passed to the callback functions. + + The :member:`nghttp2_session_callbacks.send_callback` must be + specified. If the application code uses `nghttp2_session_recv()`, + the :member:`nghttp2_session_callbacks.recv_callback` must be + specified. The other members of *callbacks* can be ``NULL``. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_session_server_new(nghttp2_session **session_ptr, const nghttp2_session_callbacks *callbacks, void *user_data) + + + Initializes *\*session_ptr* for server use. The all members of + *callbacks* are copied to *\*session_ptr*. Therefore *\*session_ptr* + does not store *callbacks*. *user_data* is an arbitrary user + supplied data, which will be passed to the callback functions. + + The :member:`nghttp2_session_callbacks.send_callback` must be + specified. If the application code uses `nghttp2_session_recv()`, + the :member:`nghttp2_session_callbacks.recv_callback` must be + specified. The other members of *callbacks* can be ``NULL``. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: void nghttp2_session_del(nghttp2_session *session) + + + Frees any resources allocated for *session*. If *session* is + ``NULL``, this function does nothing. + +.. function:: int nghttp2_session_set_option(nghttp2_session *session, int optname, void *optval, size_t optlen) + + + Sets the configuration option for the *session*. The *optname* is + one of :type:`nghttp2_opt`. The *optval* is the pointer to the + option value and the *optlen* is the size of *\*optval*. The + required type of *optval* varies depending on the *optname*. See + below. + + The following *optname* are supported: + + :macro:`NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE` + The *optval* must be a pointer to ``int``. If the *\*optval* is + nonzero, the library will not send WINDOW_UPDATE for a stream + automatically. Therefore, the application is responsible for + sending WINDOW_UPDATE using + `nghttp2_submit_window_update`. This option defaults to 0. + + :macro:`NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE` + The *optval* must be a pointer to ``int``. If the *\*optval* is + nonzero, the library will not send WINDOW_UPDATE for connection + automatically. Therefore, the application is responsible for + sending WINDOW_UPDATE using + `nghttp2_submit_window_update`. This option defaults to 0. + + :macro:`NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS` + The *optval* must be a pointer to ``ssize_t``. It is an error + if *\*optval* is 0 or negative. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *optname* is not supported; or the *optval* and/or the + *optlen* are invalid. + +.. function:: int nghttp2_session_send(nghttp2_session *session) + + + Sends pending frames to the remote peer. + + This function retrieves the highest prioritized frame from the + outbound queue and sends it to the remote peer. It does this as + many as possible until the user callback + :member:`nghttp2_session_callbacks.send_callback` returns + :macro:`NGHTTP2_ERR_WOULDBLOCK` or the outbound queue becomes empty. + This function calls several callback functions which are passed + when initializing the *session*. Here is the simple time chart + which tells when each callback is invoked: + + 1. Get the next frame to send from outbound queue. + 2. Prepare transmission of the frame. + 3. If the control frame cannot be sent because some preconditions + are not met (e.g., request HEADERS cannot be sent after + GOAWAY), + :member:`nghttp2_session_callbacks.on_ctrl_not_send_callback` is + invoked. Abort the following steps. + 4. If the frame is request HEADERS, the stream is opened + here. + 5. :member:`nghttp2_session_callbacks.before_ctrl_send_callback` is + invoked. + 6. :member:`nghttp2_session_callbacks.send_callback` is invoked one + or more times to send the frame. + 7. If the frame is a control frame, + :member:`nghttp2_session_callbacks.on_ctrl_send_callback` is + invoked. + 8. If the frame is a DATA frame, + :member:`nghttp2_session_callbacks.on_data_send_callback` is + invoked. + 9. If the transmission of the frame triggers closure of the stream, + the stream is closed and + :member:`nghttp2_session_callbacks.on_stream_close_callback` is + invoked. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + :macro:`NGHTTP2_ERR_CALLBACK_FAILURE` + The callback function failed. + +.. function:: int nghttp2_session_recv(nghttp2_session *session) + + + Receives frames from the remote peer. + + This function receives as many frames as possible until the user + callback :member:`nghttp2_session_callbacks.recv_callback` returns + :macro:`NGHTTP2_ERR_WOULDBLOCK`. This function calls several + callback functions which are passed when initializing the + *session*. Here is the simple time chart which tells when each + callback is invoked: + + 1. :member:`nghttp2_session_callbacks.recv_callback` is invoked one + or more times to receive frame header. + 2. If the frame is DATA frame: + + 2.1. :member:`nghttp2_session_callbacks.recv_callback` is invoked + to receive DATA payload. For each chunk of data, + :member:`nghttp2_session_callbacks.on_data_chunk_recv_callback` + is invoked. + 2.2. If one DATA frame is completely received, + :member:`nghttp2_session_callbacks.on_data_recv_callback` is + invoked. If the frame is the final frame of the request, + :member:`nghttp2_session_callbacks.on_request_recv_callback` + is invoked. If the reception of the frame triggers the + closure of the stream, + :member:`nghttp2_session_callbacks.on_stream_close_callback` + is invoked. + + 3. If the frame is the control frame: + + 3.1. :member:`nghttp2_session_callbacks.recv_callback` is invoked + one or more times to receive whole frame. + 3.2. If the received frame is valid, + :member:`nghttp2_session_callbacks.on_ctrl_recv_callback` is + invoked. If the frame is the final frame of the request, + :member:`nghttp2_session_callbacks.on_request_recv_callback` + is invoked. If the reception of the frame triggers the + closure of the stream, + :member:`nghttp2_session_callbacks.on_stream_close_callback` + is invoked. + 3.3. If the received frame is unpacked but is interpreted as + invalid, + :member:`nghttp2_session_callbacks.on_invalid_ctrl_recv_callback` + is invoked. + 3.4. If the received frame could not be unpacked correctly, + :member:`nghttp2_session_callbacks.on_ctrl_recv_parse_error_callback` + is invoked. + 3.5. If the received frame type is unknown, + :member:`nghttp2_session_callbacks.on_unknown_ctrl_recv_callback` + is invoked. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_EOF` + The remote peer did shutdown on the connection. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + :macro:`NGHTTP2_ERR_CALLBACK_FAILURE` + The callback function failed. + +.. function:: ssize_t nghttp2_session_mem_recv(nghttp2_session *session, const uint8_t *in, size_t inlen) + + + Processes data *in* as an input from the remote endpoint. The + *inlen* indicates the number of bytes in the *in*. + + This function behaves like `nghttp2_session_recv()` except that it + does not use :member:`nghttp2_session_callbacks.recv_callback` to + receive data; the *in* is the only data for the invocation of this + function. If all bytes are processed, this function returns. The + other callbacks are called in the same way as they are in + `nghttp2_session_recv()`. + + In the current implementation, this function always tries to + processes all input data unless either an error occurs or + :macro:`NGHTTP2_ERR_PAUSE` is returned from + :member:`nghttp2_session_callbacks.on_frame_recv_callback` or + :member:`nghttp2_session_callbacks.on_data_chunk_recv_callback`. + If :macro:`NGHTTP2_ERR_PAUSE` is used, the return value includes the + number of bytes which was used to produce the data or frame for the + callback. + + This function returns the number of processed bytes, or one of the + following negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + :macro:`NGHTTP2_ERR_CALLBACK_FAILURE` + The callback function failed. + +.. function:: int nghttp2_session_continue(nghttp2_session *session) + + + Perform post-processing after `nghttp2_session_mem_recv()` was + paused by :macro:`NGHTTP2_ERR_PAUSE` from + :member:`nghttp2_session_callbacks.on_frame_recv_callback` or + :member:`nghttp2_session_callbacks.on_data_chunk_recv_callback`. + + This function frees resources associated with paused frames. It + may also call additional callbacks, such as + :member:`nghttp2_session_callbacks.on_stream_close_callback`. + + If this function succeeds, the application can call + `nghttp2_session_mem_recv()` again. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + :macro:`NGHTTP2_ERR_CALLBACK_FAILURE` + The callback function failed. + + +.. function:: int nghttp2_session_resume_data(nghttp2_session *session, int32_t stream_id) + + + Puts back previously deferred DATA frame in the stream *stream_id* + to the outbound queue. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The stream does not exist or no deferred data exist. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_session_want_read(nghttp2_session *session) + + + Returns nonzero value if *session* wants to receive data from the + remote peer. + + If both `nghttp2_session_want_read()` and + `nghttp2_session_want_write()` return 0, the application should + drop the connection. + +.. function:: int nghttp2_session_want_write(nghttp2_session *session) + + + Returns nonzero value if *session* wants to send data to the remote + peer. + + If both `nghttp2_session_want_read()` and + `nghttp2_session_want_write()` return 0, the application should + drop the connection. + +.. function:: void* nghttp2_session_get_stream_user_data(nghttp2_session *session, int32_t stream_id) + + + Returns stream_user_data for the stream *stream_id*. The + stream_user_data is provided by `nghttp2_submit_request()` or + `nghttp2_submit_syn_stream()`. If the stream is initiated by the + remote endpoint, stream_user_data is always ``NULL``. If the stream + is initiated by the local endpoint and ``NULL`` is given in + `nghttp2_submit_request()` or `nghttp2_submit_syn_stream()`, then + this function returns ``NULL``. If the stream does not exist, this + function returns ``NULL``. + +.. function:: size_t nghttp2_session_get_outbound_queue_size(nghttp2_session *session) + + + Returns the number of frames in the outbound queue. This does not + include the deferred DATA frames. + +.. function:: int32_t nghttp2_session_get_stream_effective_recv_data_length (nghttp2_session *session, int32_t stream_id) + + + Returns the number of DATA payload in bytes received without + WINDOW_UPDATE transmission for the stream *stream_id*. The local + (receive) window size can be adjusted by + `nghttp2_submit_window_update()`. This function takes into account + that and returns effective data length. In particular, if the + local window size is reduced by submitting negative + window_size_increment with `nghttp2_submit_window_update()`, this + function returns the number of bytes less than actually received. + + If flow control is disabled for that stream, this function returns + 0. + + This function returns -1 if it fails. + +.. function:: int32_t nghttp2_session_get_stream_effective_local_window_size (nghttp2_session *session, int32_t stream_id) + + + Returns the local (receive) window size for the stream + *stream_id*. The local window size can be adjusted by + `nghttp2_submit_window_update()`. This function takes into account + that and returns effective window size. + + This function returns -1 if it fails. + +.. function:: int32_t nghttp2_session_get_effective_recv_data_length (nghttp2_session *session) + + + Returns the number of DATA payload in bytes received without + WINDOW_UPDATE transmission for a connection. The local (receive) + window size can be adjusted by + `nghttp2_submit_window_update()`. This function takes into account + that and returns effective data length. In particular, if the local + window size is reduced by submitting negative window_size_increment + with `nghttp2_submit_window_update()`, this function returns the + number of bytes less than actually received. + + If flow control is disabled for a connection, this function returns + 0. + + This function returns -1 if it fails. + +.. function:: int32_t nghttp2_session_get_effective_local_window_size (nghttp2_session *session) + + + Returns the local (receive) window size for a connection. The local + window size can be adjusted by + `nghttp2_submit_window_update()`. This function takes into account + that and returns effective window size. + + This function returns -1 if it fails. + +.. function:: int nghttp2_session_fail_session(nghttp2_session *session, nghttp2_error_code error_code) + + + Submits GOAWAY frame with the given *error_code*. + + This function should be called when the connection should be + terminated after sending GOAWAY. If the remaining streams should be + processed after GOAWAY, use `nghttp2_submit_goaway()` instead. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_session_upgrade(nghttp2_session *session, const uint8_t *settings_payload, size_t settings_payloadlen, void *stream_user_data) + + + Performs post-process of HTTP Upgrade request. This function can be + called from both client and server, but the behavior is very + different in each other. + + If called from client side, the *settings_payload* must be the + value sent in ``HTTP2-Settings`` header field and must be decoded + by base64url decoder. The *settings_payloadlen* is the length of + *settings_payload*. The *settings_payload* is unpacked and its + setting values will be submitted using + `nghttp2_submit_settings()`. This means that the client application + code does not need to submit SETTINGS by itself. The stream with + stream ID=1 is opened and the *stream_user_data* is used for its + stream_user_data. The opened stream becomes half-closed (local) + state. + + If called from server side, the *settings_payload* must be the + value received in ``HTTP2-Settings`` header field and must be + decoded by base64url decoder. The *settings_payloadlen* is the + length of *settings_payload*. It is treated as if the SETTINGS + frame with that payload is received. Thus, callback functions for + the reception of SETTINGS frame will be invoked. The stream with + stream ID=1 is opened. The *stream_user_data* is ignored. The + opened stream becomes half-closed (remote). + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *settings_payload* is badly formed. + :macro:`NGHTTP2_ERR_PROTO` + The stream ID 1 is already used or closed; or is not available; + or the *settings_payload* does not include both + :macro:`NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS` and + :macro:`NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE`. + +.. function:: ssize_t nghttp2_pack_settings_payload(uint8_t *buf, size_t buflen, const nghttp2_settings_entry *iv, size_t niv) + + + Serializes the SETTINGS values *iv* in the *buf*. The size of the + *buf* is specified by *buflen*. The number of entries in the *iv* + array is given by *niv*. The required space in *buf* for the *niv* + entries is ``8*niv`` bytes and if the given buffer is too small, an + error is returned. This function is used mainly for creating a + SETTINGS payload to be sent with the ``HTTP2-Settings`` header + field in an HTTP Upgrade request. The data written in *buf* is NOT + base64url encoded and the application is responsible for encoding. + + This function returns the number of bytes written in *buf*, or one + of the following negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *iv* contains duplicate settings ID or invalid value. + + :macro:`NGHTTP2_ERR_INSUFF_BUFSIZE` + The provided *buflen* size is too small to hold the output. + +.. function:: const char* nghttp2_strerror(int lib_error_code) + + + Returns string describing the *lib_error_code*. The + *lib_error_code* must be one of the :macro:`nghttp2_error`. + +.. function:: int nghttp2_submit_request(nghttp2_session *session, int32_t pri, const char **nv, const nghttp2_data_provider *data_prd, void *stream_user_data) + + + Submits HEADERS frame and optionally one or more DATA frames. + + The *pri* is priority of this request. 0 is the highest priority + value and :macro:`NGHTTP2_PRI_LOWEST` is the lowest value. + + The *nv* contains the name/value pairs. For i >= 0, ``nv[2*i]`` + contains a pointer to the name string and ``nv[2*i+1]`` contains a + pointer to the value string. The one beyond last value must be + ``NULL``. That is, if the *nv* contains N name/value pairs, + ``nv[2*N]`` must be ``NULL``. + + HTTP/2.0 specification has requirement about header fields in the + request HEADERS. See the specification for more details. + + This function creates copies of all name/value pairs in *nv*. It + also lower-cases all names in *nv*. + + The string in *nv* must be NULL-terminated. Use + `nghttp2_submit_request2()` if name/value pairs are not + NULL-terminated strings. + + If *data_prd* is not ``NULL``, it provides data which will be sent + in subsequent DATA frames. In this case, a method that allows + request message bodies + (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9) must + be specified with ``:method`` key in *nv* (e.g. ``POST``). This + function does not take ownership of the *data_prd*. The function + copies the members of the *data_prd*. If *data_prd* is ``NULL``, + HEADERS have END_STREAM set. The *stream_user_data* is data + associated to the stream opened by this request and can be an + arbitrary pointer, which can be retrieved later by + `nghttp2_session_get_stream_user_data()`. + + Since the library reorders the frames and tries to send the highest + prioritized one first and the HTTP/2.0 specification requires the + stream ID must be strictly increasing, the stream ID of this + request cannot be known until it is about to sent. To know the + stream ID of the request, the application can use + :member:`nghttp2_session_callbacks.before_ctrl_send_callback`. This + callback is called just before the frame is sent. For HEADERS + frame, the argument frame has the stream ID assigned. Also since + the stream is already opened, + `nghttp2_session_get_stream_user_data()` can be used to get + *stream_user_data* to identify which HEADERS we are processing. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *pri* is invalid; or the *nv* includes empty name or + ``NULL`` value. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_request2(nghttp2_session *session, int32_t pri, const nghttp2_nv *nva, size_t nvlen, const nghttp2_data_provider *data_prd, void *stream_user_data) + + + Just like `nghttp2_submit_request()`, but this function takes the + *nva*, which is an array of ``nghttp2_nv`` with *nvlen* elements, + as name/value pairs. This function is useful if name/value pairs + are not NULL-terminated strings. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *pri* is invalid; or the *nva* includes empty name or + name which contains invalid characters. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_response(nghttp2_session *session, int32_t stream_id, const char **nv, const nghttp2_data_provider *data_prd) + + + Submits response HEADERS frame and optionally one or more DATA + frames against the stream *stream_id*. + + The *nv* contains the name/value pairs. For i >= 0, ``nv[2*i]`` + contains a pointer to the name string and ``nv[2*i+1]`` contains a + pointer to the value string. The one beyond last value must be + ``NULL``. That is, if the *nv* contains N name/value pairs, + ``nv[2*N]`` must be ``NULL``. + + HTTP/2.0 specification has requirement about header fields in the + response HEADERS. See the specification for more details. + + This function creates copies of all name/value pairs in *nv*. It + also lower-cases all names in *nv*. + + If *data_prd* is not ``NULL``, it provides data which will be sent + in subsequent DATA frames. This function does not take ownership + of the *data_prd*. The function copies the members of the + *data_prd*. If *data_prd* is ``NULL``, HEADERS will have + END_STREAM flag set. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *nv* includes empty name or ``NULL`` value. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_headers(nghttp2_session *session, uint8_t flags, int32_t stream_id, int32_t pri, const char **nv, void *stream_user_data) + + + Submits HEADERS frame. The *flags* is bitwise OR of the + following values: + + * :macro:`NGHTTP2_FLAG_END_STREAM` + * :macro:`NGHTTP2_FLAG_END_HEADERS` + * :macro:`NGHTTP2_FLAG_PRIORITY` + + If *flags* includes :macro:`NGHTTP2_FLAG_END_STREAM`, this frame has + END_STREAM flag set. The library does not support header + continuation and the HEADERS frame always has + :macro:`NGHTTP2_FLAG_END_HEADERS` flag set regardless of the *flags* + value. + + If the *stream_id* is -1, this frame is assumed as request (i.e., + request HEADERS frame which opens new stream). In this case, the + actual stream ID is assigned just before the frame is sent. For + response, specify stream ID in *stream_id*. + + The *pri* is priority of this request. + + The *nv* contains the name/value pairs. For i >= 0, ``nv[2*i]`` + contains a pointer to the name string and ``nv[2*i+1]`` contains a + pointer to the value string. The one beyond last value must be + ``NULL``. That is, if the *nv* contains N name/value pairs, + ``nv[2*N]`` must be ``NULL``. + + This function creates copies of all name/value pairs in *nv*. It + also lower-cases all names in *nv*. + + The *stream_user_data* is a pointer to an arbitrary data which is + associated to the stream this frame will open. Therefore it is only + used if this frame opens streams, in other words, it changes stream + state from idle or reserved to open. + + This function is low-level in a sense that the application code can + specify flags directly. For usual HTTP request, + `nghttp2_submit_request()` is useful. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *pri* is invalid; or the *nv* includes empty name or + ``NULL`` value. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_data(nghttp2_session *session, uint8_t flags, int32_t stream_id, const nghttp2_data_provider *data_prd) + + + Submits one or more DATA frames to the stream *stream_id*. The + data to be sent are provided by *data_prd*. If *flags* contains + :macro:`NGHTTP2_FLAG_END_STREAM`, the last DATA frame has END_STREAM + flag set. + + This function does not take ownership of the *data_prd*. The + function copies the members of the *data_prd*. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + :macro:`NGHTTP2_ERR_STREAM_CLOSED` + The stream is already closed or does not exist. + +.. function:: int nghttp2_submit_priority(nghttp2_session *session, uint8_t flags, int32_t stream_id, int32_t pri) + + + Submits PRIORITY frame to change the priority of stream *stream_id* + to the priority value *pri*. + + The *flags* is currently ignored and should be + :macro:`NGHTTP2_FLAG_NONE`. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *pri* is negative. + :macro:`NGHTTP2_ERR_STREAM_CLOSED` + The stream is already closed or does not exist. + +.. function:: int nghttp2_submit_rst_stream(nghttp2_session *session, uint8_t flags, int32_t stream_id, nghttp2_error_code error_code) + + + Submits RST_STREAM frame to cancel/reject the stream *stream_id* + with the error code *error_code*. + + The *flags* is currently ignored and should be + :macro:`NGHTTP2_FLAG_NONE`. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_settings(nghttp2_session *session, uint8_t flags, const nghttp2_settings_entry *iv, size_t niv) + + + Stores local settings and submits SETTINGS frame. The *iv* is the + pointer to the array of :type:`nghttp2_settings_entry`. The *niv* + indicates the number of :type:`nghttp2_settings_entry`. + + The *flags* is currently ignored and should be + :macro:`NGHTTP2_FLAG_NONE`. + + This function does not take ownership of the *iv*. This function + copies all the elements in the *iv*. + + While updating individual stream's local window size, if the window + size becomes strictly larger than NGHTTP2_MAX_WINDOW_SIZE, + RST_STREAM is issued against such a stream. + + SETTINGS with :macro:`NGHTTP2_FLAG_ACK` is automatically submitted + by the library and application could not send it at its will. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *iv* contains invalid value (e.g., attempting to re-enable + flow control). + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_push_promise(nghttp2_session *session, uint8_t flags, int32_t stream_id, const char **nv) + + + Submits PUSH_PROMISE frame. The *flags* is currently ignored and + the resulting PUSH_PROMISE frame always has + :macro:`NGHTTP2_FLAG_END_PUSH_PROMISE` flag set due to the lack of + header continuation support in the library. + + The *stream_id* must be client initiated stream ID. + + The *nv* contains the name/value pairs. For i >= 0, ``nv[2*i]`` + contains a pointer to the name string and ``nv[2*i+1]`` contains a + pointer to the value string. The one beyond last value must be + ``NULL``. That is, if the *nv* contains N name/value pairs, + ``nv[2*N]`` must be ``NULL``. + + This function creates copies of all name/value pairs in *nv*. It + also lower-cases all names in *nv*. + + Since the library reorders the frames and tries to send the highest + prioritized one first and the HTTP/2.0 specification requires the + stream ID must be strictly increasing, the promised stream ID + cannot be known until it is about to sent. To know the promised + stream ID, the application can use + :member:`nghttp2_session_callbacks.before_frame_send_callback`. This + callback is called just before the frame is sent. For PUSH_PROMISE + frame, the argument frame has the promised stream ID assigned. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *nv* includes empty name or ``NULL`` value. + :macro:`NGHTTP2_ERR_STREAM_CLOSED` + The stream is already closed or does not exist. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_ping(nghttp2_session *session, uint8_t flags, uint8_t *opaque_data) + + + Submits PING frame. You don't have to send PING back when you + received PING frame. The library automatically submits PING frame + in this case. + + The *flags* is currently ignored and should be + :macro:`NGHTTP2_FLAG_NONE`. + + If the *opaque_data* is non ``NULL``, then it should point to the 8 + bytes array of memory to specify opaque data to send with PING + frame. If the *opaque_data* is ``NULL``, zero-cleared 8 bytes will + be sent as opaque data. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_goaway(nghttp2_session *session, uint8_t flags, nghttp2_error_code error_code, uint8_t *opaque_data, size_t opaque_data_len) + + + Submits GOAWAY frame with the error code *error_code*. + + The *flags* is currently ignored and should be + :macro:`NGHTTP2_FLAG_NONE`. + + If the *opaque_data* is not ``NULL`` and *opaque_data_len* is not + zero, those data will be sent as additional debug data. The + library makes a copy of the memory region pointed by *opaque_data* + with the length *opaque_data_len*, so the caller does not need to + keep this memory after the return of this function. If the + *opaque_data_len* is 0, the *opaque_data* could be ``NULL``. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_window_update(nghttp2_session *session, uint8_t flags, int32_t stream_id, int32_t window_size_increment) + + + Submits WINDOW_UPDATE frame. + + The *flags* is currently ignored and should be + :macro:`NGHTTP2_FLAG_NONE`. + + If the *window_size_increment* is positive, the WINDOW_UPDATE with + that value as window_size_increment is queued. If the + *window_size_increment* is larger than the received bytes from the + remote endpoint, the local window size is increased by that + difference. + + If the *window_size_increment* is negative, the local window size + is decreased by -*window_size_increment*. If + :macro:`NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE` (or + :macro:`NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE` if *stream_id* + is 0) is not set and the library decided that the WINDOW_UPDATE + should be submitted, then WINDOW_UPDATE is queued with the current + received bytes count. + + If the *window_size_increment* is 0, the function does nothing and + returns 0. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_FLOW_CONTROL` + The local window size overflow or gets negative. + :macro:`NGHTTP2_ERR_STREAM_CLOSED` + The stream is already closed or does not exist. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: int nghttp2_nv_compare_name(const nghttp2_nv *lhs, const nghttp2_nv *rhs) + + + Compares lhs->name with lhs->namelen bytes and rhs->name with + rhs->namelen bytes. Returns negative integer if lhs->name is found + to be less than rhs->name; or returns positive integer if lhs->name + is found to be greater than rhs->name; or returns 0 otherwise. + +.. function:: int nghttp2_select_next_protocol(unsigned char **out, unsigned char *outlen, const unsigned char *in, unsigned int inlen) + + + A helper function for dealing with NPN in client side. The *in* + contains server's protocol in preferable order. The format of *in* + is length-prefixed and not null-terminated. For example, + ``HTTP-draft-04/2.0`` and ``http/1.1`` stored in *in* like this:: + + in[0] = 17 + in[1..17] = "HTTP-draft-04/2.0" + in[18] = 8 + in[19..26] = "http/1.1" + inlen = 27 + + The selection algorithm is as follows: + + 1. If server's list contains ``HTTP-draft-04/2.0``, it is selected + and returns 1. The following step is not taken. + + 2. If server's list contains ``http/1.1``, this function selects + ``http/1.1`` and returns 0. The following step is not taken. + + 3. This function selects nothing and returns -1. (So called + non-overlap case). In this case, *out* and *outlen* are left + untouched. + + Selecting ``HTTP-draft-04/2.0`` means that ``HTTP-draft-04/2.0`` is + written into *\*out* and its length (which is 17) is + assigned to *\*outlen*. + + See http://technotes.googlecode.com/git/nextprotoneg.html for more + details about NPN. + + To use this method you should do something like:: + + static int select_next_proto_cb(SSL* ssl, + unsigned char **out, + unsigned char *outlen, + const unsigned char *in, + unsigned int inlen, + void *arg) + { + int rv; + rv = nghttp2_select_next_protocol(out, outlen, in, inlen); + if(rv == 1) { + ((MyType*)arg)->http2_selected = 1; + } + return SSL_TLSEXT_ERR_OK; + } + ... + SSL_CTX_set_next_proto_select_cb(ssl_ctx, select_next_proto_cb, my_obj); + + Note that the HTTP/2.0 spec does use ALPN instead of NPN. This + function is provided for transitional period before ALPN is got + implemented in major SSL/TLS libraries. + + +.. function:: int nghttp2_gzip_inflate_new(nghttp2_gzip **inflater_ptr) + + + A helper function to set up a per request gzip stream to inflate data. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_GZIP` + The initialization of gzip stream failed. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. function:: void nghttp2_gzip_inflate_del(nghttp2_gzip *inflater) + + + Frees the inflate stream. The *inflater* may be ``NULL``. + +.. function:: int nghttp2_gzip_inflate(nghttp2_gzip *inflater, uint8_t *out, size_t *outlen_ptr, const uint8_t *in, size_t *inlen_ptr) + + + Inflates data in *in* with the length *\*inlen_ptr* and stores the + inflated data to *out* which has allocated size at least + *\*outlen_ptr*. On return, *\*outlen_ptr* is updated to represent + the number of data written in *out*. Similarly, *\*inlen_ptr* is + updated to represent the number of input bytes processed. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_GZIP` + The inflation of gzip stream failed. + + The example follows:: + + void on_data_chunk_recv_callback(nghttp2_session *session, + uint8_t flags, + int32_t stream_id, + const uint8_t *data, size_t len, + void *user_data) + { + ... + req = nghttp2_session_get_stream_user_data(session, stream_id); + nghttp2_gzip *inflater = req->inflater; + while(len > 0) { + uint8_t out[MAX_OUTLEN]; + size_t outlen = MAX_OUTLEN; + size_t tlen = len; + int rv; + rv = nghttp2_gzip_inflate(inflater, out, &outlen, data, &tlen); + if(rv != 0) { + nghttp2_submit_rst_stream(session, stream_id, + NGHTTP2_INTERNAL_ERROR); + break; + } + ... Do stuff ... + data += tlen; + len -= tlen; + } + .... + } + +.. function:: nghttp2_info *nghttp2_version(int least_version) + + + Returns a pointer to a nghttp2_info struct with version information about + the run-time library in use. The *least_version* argument can be set to a + 24 bit numerical value for the least accepted version number and if the + condition is not met, this function will return a NULL. Pass in 0 to skip + the version checking. + + diff --git a/released-versions/v0.2.0/_sources/index.txt b/released-versions/v0.2.0/_sources/index.txt new file mode 100644 index 00000000..91a9f790 --- /dev/null +++ b/released-versions/v0.2.0/_sources/index.txt @@ -0,0 +1,32 @@ +.. nghttp2 documentation master file, created by + sphinx-quickstart on Sun Mar 11 22:57:49 2012. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +nghttp2 - HTTP/2.0 C Library +============================ + +This is an experimental implementation of Hypertext Transfer Protocol +version 2.0. + +Contents: + +.. toctree:: + :maxdepth: 2 + + package_README + apiref + nghttp2.h + nghttp2ver.h + +Released Versions +================= + +* `v0.1.0 `_ `(Download) `_ + + +Resources +--------- + +* http://tools.ietf.org/html/draft-ietf-httpbis-http2-07 +* http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-04 diff --git a/released-versions/v0.2.0/_sources/nghttp2.h.txt b/released-versions/v0.2.0/_sources/nghttp2.h.txt new file mode 100644 index 00000000..86284f2e --- /dev/null +++ b/released-versions/v0.2.0/_sources/nghttp2.h.txt @@ -0,0 +1,4 @@ +nghttp2.h +========= + +.. literalinclude:: ../lib/includes/nghttp2/nghttp2.h diff --git a/released-versions/v0.2.0/_sources/nghttp2ver.h.txt b/released-versions/v0.2.0/_sources/nghttp2ver.h.txt new file mode 100644 index 00000000..d0cdbcbb --- /dev/null +++ b/released-versions/v0.2.0/_sources/nghttp2ver.h.txt @@ -0,0 +1,4 @@ +nghttp2ver.h +============ + +.. literalinclude:: ../lib/includes/nghttp2/nghttp2ver.h diff --git a/released-versions/v0.2.0/_sources/package_README.txt b/released-versions/v0.2.0/_sources/package_README.txt new file mode 100644 index 00000000..72a33558 --- /dev/null +++ b/released-versions/v0.2.0/_sources/package_README.txt @@ -0,0 +1 @@ +.. include:: ../README.rst diff --git a/released-versions/v0.2.0/_static/ajax-loader.gif b/released-versions/v0.2.0/_static/ajax-loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..61faf8cab23993bd3e1560bff0668bd628642330 GIT binary patch literal 673 zcmZ?wbhEHb6krfw_{6~Q|Nno%(3)e{?)x>&1u}A`t?OF7Z|1gRivOgXi&7IyQd1Pl zGfOfQ60;I3a`F>X^fL3(@);C=vM_KlFfb_o=k{|A33hf2a5d61U}gjg=>Rd%XaNQW zW@Cw{|b%Y*pl8F?4B9 zlo4Fz*0kZGJabY|>}Okf0}CCg{u4`zEPY^pV?j2@h+|igy0+Kz6p;@SpM4s6)XEMg z#3Y4GX>Hjlml5ftdH$4x0JGdn8~MX(U~_^d!Hi)=HU{V%g+mi8#UGbE-*ao8f#h+S z2a0-5+vc7MU$e-NhmBjLIC1v|)9+Im8x1yacJ7{^tLX(ZhYi^rpmXm0`@ku9b53aN zEXH@Y3JaztblgpxbJt{AtE1ad1Ca>{v$rwwvK(>{m~Gf_=-Ro7Fk{#;i~+{{>QtvI yb2P8Zac~?~=sRA>$6{!(^3;ZP0TPFR(G_-UDU(8Jl0?(IXu$~#4A!880|o%~Al1tN literal 0 HcmV?d00001 diff --git a/released-versions/v0.2.0/_static/basic.css b/released-versions/v0.2.0/_static/basic.css new file mode 100644 index 00000000..43e8bafa --- /dev/null +++ b/released-versions/v0.2.0/_static/basic.css @@ -0,0 +1,540 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox input[type="text"] { + width: 170px; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + width: 30px; +} + +img { + border: 0; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable dl, table.indextable dd { + margin-top: 0; + margin-bottom: 0; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- general body styles --------------------------------------------------- */ + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.field-list ul { + padding-left: 1em; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px 7px 0 7px; + background-color: #ffe; + width: 40%; + float: right; +} + +p.sidebar-title { + font-weight: bold; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px 7px 0 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +div.admonition dl { + margin-bottom: 0; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + border: 0; + border-collapse: collapse; +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.field-list td, table.field-list th { + border: 0 !important; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +dl { + margin-bottom: 15px; +} + +dd p { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dt:target, .highlighted { + background-color: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.refcount { + color: #060; +} + +.optional { + font-size: 1.3em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + margin-left: 0.5em; +} + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; +} + +tt.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +tt.descclassname { + background-color: transparent; +} + +tt.xref, a tt { + background-color: transparent; + font-weight: bold; +} + +h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/released-versions/v0.2.0/_static/comment-bright.png b/released-versions/v0.2.0/_static/comment-bright.png new file mode 100644 index 0000000000000000000000000000000000000000..551517b8c83b76f734ff791f847829a760ad1903 GIT binary patch literal 3500 zcmV;d4O8-oP)Oz@Z0f2-7z;ux~O9+4z06=<WDR*FRcSTFz- zW=q650N5=6FiBTtNC2?60Km==3$g$R3;-}uh=nNt1bYBr$Ri_o0EC$U6h`t_Jn<{8 z5a%iY0C<_QJh>z}MS)ugEpZ1|S1ukX&Pf+56gFW3VVXcL!g-k)GJ!M?;PcD?0HBc- z5#WRK{dmp}uFlRjj{U%*%WZ25jX z{P*?XzTzZ-GF^d31o+^>%=Ap99M6&ogks$0k4OBs3;+Bb(;~!4V!2o<6ys46agIcq zjPo+3B8fthDa9qy|77CdEc*jK-!%ZRYCZvbku9iQV*~a}ClFY4z~c7+0P?$U!PF=S z1Au6Q;m>#f??3%Vpd|o+W=WE9003S@Bra6Svp>fO002awfhw>;8}z{#EWidF!3EsG z3;bXU&9EIRU@z1_9W=mEXoiz;4lcq~xDGvV5BgyU zp1~-*fe8db$Osc*A=-!mVv1NJjtCc-h4>-CNCXm#Bp}I%6j35eku^v$Qi@a{RY)E3 zJ#qp$hg?Rwkvqr$GJ^buyhkyVfwECO)C{#lxu`c9ghrwZ&}4KmnvWKso6vH!8a<3Q zq36)6Xb;+tK10Vaz~~qUGsJ8#F2=(`u{bOVlVi)VBCHIn#u~6ztOL7=^<&SmcLWlF zMZgI*1b0FpVIDz9SWH+>*hr`#93(Um+6gxa1B6k+CnA%mOSC4s5&6UzVlpv@SV$}* z))J2sFA#f(L&P^E5{W}HC%KRUNwK6<(h|}}(r!{C=`5+6G)NjFlgZj-YqAG9lq?`C z$c5yc>d>VnA`E_*3F2Qp##d8RZb=H01_mm@+|Cqnc9PsG(F5HIG_C zt)aG3uTh7n6Et<2In9F>NlT@zqLtGcXcuVrX|L#Xx)I%#9!{6gSJKPrN9dR61N3(c z4Tcqi$B1Vr8Jidf7-t!G7_XR2rWwr)$3XQ?}=hpK0&Z&W{| zep&sA23f;Q!%st`QJ}G3cbou<7-yIK2z4nfCCCtN2-XOGSWo##{8Q{ATurxr~;I`ytDs%xbip}RzP zziy}Qn4Z2~fSycmr`~zJ=lUFdFa1>gZThG6M+{g7vkW8#+YHVaJjFF}Z#*3@$J_By zLtVo_L#1JrVVB{Ak-5=4qt!-@Mh}c>#$4kh<88)m#-k<%CLtzEP3leVno>={htGUuD;o7bD)w_sX$S}eAxwzy?UvgBH(S?;#HZiQMoS*2K2 zT3xe7t(~nU*1N5{rxB;QPLocnp4Ml>u<^FZwyC!nu;thW+pe~4wtZn|Vi#w(#jeBd zlf9FDx_yoPJqHbk*$%56S{;6Kv~mM9!g3B(KJ}#RZ#@)!hR|78Dq|Iq-afF%KE1Brn_fm;Im z_u$xr8UFki1L{Ox>G0o)(&RAZ;=|I=wN2l97;cLaHH6leTB-XXa*h%dBOEvi`+x zi?=Txl?TadvyiL>SuF~-LZ;|cS}4~l2eM~nS7yJ>iOM;atDY;(?aZ^v+mJV$@1Ote z62cPUlD4IWOIIx&SmwQ~YB{nzae3Pc;}r!fhE@iwJh+OsDs9zItL;~pu715HdQEGA zUct(O!LkCy1<%NCg+}G`0PgpNm-?d@-hMgNe6^V+j6x$b<6@S<$+<4_1hi}Ti zncS4LsjI}fWY1>OX6feMEuLErma3QLmkw?X+1j)X-&VBk_4Y;EFPF_I+q;9dL%E~B zJh;4Nr^(LEJ3myURP{Rblsw%57T)g973R8o)DE9*xN#~;4_o$q%o z4K@u`jhx2fBXC4{U8Qn{*%*B$Ge=nny$HAYq{=vy|sI0 z_vss+H_qMky?OB#|JK!>IX&II^LlUh#rO5!7TtbwC;iULyV-Xq?ybB}ykGP{?LpZ? z-G|jbTmIbG@7#ZCz;~eY(cDM(28Dyq{*m>M4?_iynUBkc4TkHUI6gT!;y-fz>HMcd z&t%Ugo)`Y2{>!cx7B7DI)$7;J(U{Spm-3gBzioV_{p!H$8L!*M!p0uH$#^p{Ui4P` z?ZJ24cOCDe-w#jZd?0@)|7iKK^;6KN`;!@ylm7$*nDhK&GcDTy000JJOGiWi{{a60 z|De66lK=n!32;bRa{vGf6951U69E94oEQKA00(qQO+^RV2niQ93PPz|JOBU!-bqA3 zR5;6pl1pe^WfX zkSdl!omi0~*ntl;2q{jA^;J@WT8O!=A(Gck8fa>hn{#u{`Tyg)!KXI6l>4dj==iVKK6+%4zaRizy(5eryC3d2 z+5Y_D$4}k5v2=Siw{=O)SWY2HJwR3xX1*M*9G^XQ*TCNXF$Vj(kbMJXK0DaS_Sa^1 z?CEa!cFWDhcwxy%a?i@DN|G6-M#uuWU>lss@I>;$xmQ|`u3f;MQ|pYuHxxvMeq4TW;>|7Z2*AsqT=`-1O~nTm6O&pNEK?^cf9CX= zkq5|qAoE7un3V z^yy=@%6zqN^x`#qW+;e7j>th{6GV}sf*}g7{(R#T)yg-AZh0C&U;WA`AL$qz8()5^ zGFi2`g&L7!c?x+A2oOaG0c*Bg&YZt8cJ{jq_W{uTdA-<;`@iP$$=$H?gYIYc_q^*$ z#k(Key`d40R3?+GmgK8hHJcwiQ~r4By@w9*PuzR>x3#(F?YW_W5pPc(t(@-Y{psOt zz2!UE_5S)bLF)Oz@Z0f2-7z;ux~O9+4z06=<WDR*FRcSTFz- zW=q650N5=6FiBTtNC2?60Km==3$g$R3;-}uh=nNt1bYBr$Ri_o0EC$U6h`t_Jn<{8 z5a%iY0C<_QJh>z}MS)ugEpZ1|S1ukX&Pf+56gFW3VVXcL!g-k)GJ!M?;PcD?0HBc- z5#WRK{dmp}uFlRjj{U%*%WZ25jX z{P*?XzTzZ-GF^d31o+^>%=Ap99M6&ogks$0k4OBs3;+Bb(;~!4V!2o<6ys46agIcq zjPo+3B8fthDa9qy|77CdEc*jK-!%ZRYCZvbku9iQV*~a}ClFY4z~c7+0P?$U!PF=S z1Au6Q;m>#f??3%Vpd|o+W=WE9003S@Bra6Svp>fO002awfhw>;8}z{#EWidF!3EsG z3;bXU&9EIRU@z1_9W=mEXoiz;4lcq~xDGvV5BgyU zp1~-*fe8db$Osc*A=-!mVv1NJjtCc-h4>-CNCXm#Bp}I%6j35eku^v$Qi@a{RY)E3 zJ#qp$hg?Rwkvqr$GJ^buyhkyVfwECO)C{#lxu`c9ghrwZ&}4KmnvWKso6vH!8a<3Q zq36)6Xb;+tK10Vaz~~qUGsJ8#F2=(`u{bOVlVi)VBCHIn#u~6ztOL7=^<&SmcLWlF zMZgI*1b0FpVIDz9SWH+>*hr`#93(Um+6gxa1B6k+CnA%mOSC4s5&6UzVlpv@SV$}* z))J2sFA#f(L&P^E5{W}HC%KRUNwK6<(h|}}(r!{C=`5+6G)NjFlgZj-YqAG9lq?`C z$c5yc>d>VnA`E_*3F2Qp##d8RZb=H01_mm@+|Cqnc9PsG(F5HIG_C zt)aG3uTh7n6Et<2In9F>NlT@zqLtGcXcuVrX|L#Xx)I%#9!{6gSJKPrN9dR61N3(c z4Tcqi$B1Vr8Jidf7-t!G7_XR2rWwr)$3XQ?}=hpK0&Z&W{| zep&sA23f;Q!%st`QJ}G3cbou<7-yIK2z4nfCCCtN2-XOGSWo##{8Q{ATurxr~;I`ytDs%xbip}RzP zziy}Qn4Z2~fSycmr`~zJ=lUFdFa1>gZThG6M+{g7vkW8#+YHVaJjFF}Z#*3@$J_By zLtVo_L#1JrVVB{Ak-5=4qt!-@Mh}c>#$4kh<88)m#-k<%CLtzEP3leVno>={htGUuD;o7bD)w_sX$S}eAxwzy?UvgBH(S?;#HZiQMoS*2K2 zT3xe7t(~nU*1N5{rxB;QPLocnp4Ml>u<^FZwyC!nu;thW+pe~4wtZn|Vi#w(#jeBd zlf9FDx_yoPJqHbk*$%56S{;6Kv~mM9!g3B(KJ}#RZ#@)!hR|78Dq|Iq-afF%KE1Brn_fm;Im z_u$xr8UFki1L{Ox>G0o)(&RAZ;=|I=wN2l97;cLaHH6leTB-XXa*h%dBOEvi`+x zi?=Txl?TadvyiL>SuF~-LZ;|cS}4~l2eM~nS7yJ>iOM;atDY;(?aZ^v+mJV$@1Ote z62cPUlD4IWOIIx&SmwQ~YB{nzae3Pc;}r!fhE@iwJh+OsDs9zItL;~pu715HdQEGA zUct(O!LkCy1<%NCg+}G`0PgpNm-?d@-hMgNe6^V+j6x$b<6@S<$+<4_1hi}Ti zncS4LsjI}fWY1>OX6feMEuLErma3QLmkw?X+1j)X-&VBk_4Y;EFPF_I+q;9dL%E~B zJh;4Nr^(LEJ3myURP{Rblsw%57T)g973R8o)DE9*xN#~;4_o$q%o z4K@u`jhx2fBXC4{U8Qn{*%*B$Ge=nny$HAYq{=vy|sI0 z_vss+H_qMky?OB#|JK!>IX&II^LlUh#rO5!7TtbwC;iULyV-Xq?ybB}ykGP{?LpZ? z-G|jbTmIbG@7#ZCz;~eY(cDM(28Dyq{*m>M4?_iynUBkc4TkHUI6gT!;y-fz>HMcd z&t%Ugo)`Y2{>!cx7B7DI)$7;J(U{Spm-3gBzioV_{p!H$8L!*M!p0uH$#^p{Ui4P` z?ZJ24cOCDe-w#jZd?0@)|7iKK^;6KN`;!@ylm7$*nDhK&GcDTy000JJOGiWi{{a60 z|De66lK=n!32;bRa{vGf6951U69E94oEQKA00(qQO+^RV2oe()A>y0J-2easEJ;K` zR5;6Jl3z%jbr{D#&+mQTbB>-f&3W<<%ayjKi&ZjBc2N<@)`~{dMXWB0(ajbV85_gJ zf(EU`iek}4Bt%55ix|sVMm1u8KvB#hnmU~_r<Ogd(A5vg_omvd-#L!=(BMVklxVqhdT zofSj`QA^|)G*lu58>#vhvA)%0Or&dIsb%b)st*LV8`ANnOipDbh%_*c7`d6# z21*z~Xd?ovgf>zq(o0?Et~9ti+pljZC~#_KvJhA>u91WRaq|uqBBKP6V0?p-NL59w zrK0w($_m#SDPQ!Z$nhd^JO|f+7k5xca94d2OLJ&sSxlB7F%NtrF@@O7WWlkHSDtor zzD?u;b&KN$*MnHx;JDy9P~G<{4}9__s&MATBV4R+MuA8TjlZ3ye&qZMCUe8ihBnHI zhMSu zSERHwrmBb$SWVr+)Yk2k^FgTMR6mP;@FY2{}BeV|SUo=mNk<-XSOHNErw>s{^rR-bu$@aN7= zj~-qXcS2!BA*(Q**BOOl{FggkyHdCJi_Fy>?_K+G+DYwIn8`29DYPg&s4$}7D`fv? zuyJ2sMfJX(I^yrf6u!(~9anf(AqAk&ke}uL0SIb-H!SaDQvd(}07*qoM6N<$g1Ha7 A2LJ#7 literal 0 HcmV?d00001 diff --git a/released-versions/v0.2.0/_static/comment.png b/released-versions/v0.2.0/_static/comment.png new file mode 100644 index 0000000000000000000000000000000000000000..92feb52b8824c6b0f59b658b1196c61de9162a95 GIT binary patch literal 3445 zcmV-*4T|!KP)Oz@Z0f2-7z;ux~O9+4z06=<WDR*FRcSTFz- zW=q650N5=6FiBTtNC2?60Km==3$g$R3;-}uh=nNt1bYBr$Ri_o0EC$U6h`t_Jn<{8 z5a%iY0C<_QJh>z}MS)ugEpZ1|S1ukX&Pf+56gFW3VVXcL!g-k)GJ!M?;PcD?0HBc- z5#WRK{dmp}uFlRjj{U%*%WZ25jX z{P*?XzTzZ-GF^d31o+^>%=Ap99M6&ogks$0k4OBs3;+Bb(;~!4V!2o<6ys46agIcq zjPo+3B8fthDa9qy|77CdEc*jK-!%ZRYCZvbku9iQV*~a}ClFY4z~c7+0P?$U!PF=S z1Au6Q;m>#f??3%Vpd|o+W=WE9003S@Bra6Svp>fO002awfhw>;8}z{#EWidF!3EsG z3;bXU&9EIRU@z1_9W=mEXoiz;4lcq~xDGvV5BgyU zp1~-*fe8db$Osc*A=-!mVv1NJjtCc-h4>-CNCXm#Bp}I%6j35eku^v$Qi@a{RY)E3 zJ#qp$hg?Rwkvqr$GJ^buyhkyVfwECO)C{#lxu`c9ghrwZ&}4KmnvWKso6vH!8a<3Q zq36)6Xb;+tK10Vaz~~qUGsJ8#F2=(`u{bOVlVi)VBCHIn#u~6ztOL7=^<&SmcLWlF zMZgI*1b0FpVIDz9SWH+>*hr`#93(Um+6gxa1B6k+CnA%mOSC4s5&6UzVlpv@SV$}* z))J2sFA#f(L&P^E5{W}HC%KRUNwK6<(h|}}(r!{C=`5+6G)NjFlgZj-YqAG9lq?`C z$c5yc>d>VnA`E_*3F2Qp##d8RZb=H01_mm@+|Cqnc9PsG(F5HIG_C zt)aG3uTh7n6Et<2In9F>NlT@zqLtGcXcuVrX|L#Xx)I%#9!{6gSJKPrN9dR61N3(c z4Tcqi$B1Vr8Jidf7-t!G7_XR2rWwr)$3XQ?}=hpK0&Z&W{| zep&sA23f;Q!%st`QJ}G3cbou<7-yIK2z4nfCCCtN2-XOGSWo##{8Q{ATurxr~;I`ytDs%xbip}RzP zziy}Qn4Z2~fSycmr`~zJ=lUFdFa1>gZThG6M+{g7vkW8#+YHVaJjFF}Z#*3@$J_By zLtVo_L#1JrVVB{Ak-5=4qt!-@Mh}c>#$4kh<88)m#-k<%CLtzEP3leVno>={htGUuD;o7bD)w_sX$S}eAxwzy?UvgBH(S?;#HZiQMoS*2K2 zT3xe7t(~nU*1N5{rxB;QPLocnp4Ml>u<^FZwyC!nu;thW+pe~4wtZn|Vi#w(#jeBd zlf9FDx_yoPJqHbk*$%56S{;6Kv~mM9!g3B(KJ}#RZ#@)!hR|78Dq|Iq-afF%KE1Brn_fm;Im z_u$xr8UFki1L{Ox>G0o)(&RAZ;=|I=wN2l97;cLaHH6leTB-XXa*h%dBOEvi`+x zi?=Txl?TadvyiL>SuF~-LZ;|cS}4~l2eM~nS7yJ>iOM;atDY;(?aZ^v+mJV$@1Ote z62cPUlD4IWOIIx&SmwQ~YB{nzae3Pc;}r!fhE@iwJh+OsDs9zItL;~pu715HdQEGA zUct(O!LkCy1<%NCg+}G`0PgpNm-?d@-hMgNe6^V+j6x$b<6@S<$+<4_1hi}Ti zncS4LsjI}fWY1>OX6feMEuLErma3QLmkw?X+1j)X-&VBk_4Y;EFPF_I+q;9dL%E~B zJh;4Nr^(LEJ3myURP{Rblsw%57T)g973R8o)DE9*xN#~;4_o$q%o z4K@u`jhx2fBXC4{U8Qn{*%*B$Ge=nny$HAYq{=vy|sI0 z_vss+H_qMky?OB#|JK!>IX&II^LlUh#rO5!7TtbwC;iULyV-Xq?ybB}ykGP{?LpZ? z-G|jbTmIbG@7#ZCz;~eY(cDM(28Dyq{*m>M4?_iynUBkc4TkHUI6gT!;y-fz>HMcd z&t%Ugo)`Y2{>!cx7B7DI)$7;J(U{Spm-3gBzioV_{p!H$8L!*M!p0uH$#^p{Ui4P` z?ZJ24cOCDe-w#jZd?0@)|7iKK^;6KN`;!@ylm7$*nDhK&GcDTy000JJOGiWi{{a60 z|De66lK=n!32;bRa{vGf6951U69E94oEQKA00(qQO+^RV2nzr)JMUJvzW@LNr%6OX zR5;6Zk;`k`RTRfR-*ac2G}PGmXsUu>6ce?Lsn$m^3Q`48f|TwQ+_-Qh=t8Ra7nE)y zf@08(pjZ@22^EVjG*%30TJRMkBUC$WqZ73uoiv&J=APqX;!v%AH}`Vx`999MVjXwy z{f1-vh8P<=plv&cZ>p5jjX~Vt&W0e)wpw1RFRuRdDkwlKb01tp5 zP=trFN0gH^|L4jJkB{6sCV;Q!ewpg-D&4cza%GQ*b>R*=34#dW;ek`FEiB(vnw+U# zpOX5UMJBhIN&;D1!yQoIAySC!9zqJmmfoJqmQp}p&h*HTfMh~u9rKic2oz3sNM^#F zBIq*MRLbsMt%y{EHj8}LeqUUvoxf0=kqji62>ne+U`d#%J)abyK&Y`=eD%oA!36<)baZyK zXJh5im6umkS|_CSGXips$nI)oBHXojzBzyY_M5K*uvb0_9viuBVyV%5VtJ*Am1ag# zczbv4B?u8j68iOz<+)nDu^oWnL+$_G{PZOCcOGQ?!1VCefves~rfpaEZs-PdVYMiV z98ElaJ2}7f;htSXFY#Zv?__sQeckE^HV{ItO=)2hMQs=(_ Xn!ZpXD%P(H00000NkvXXu0mjf= 0 && !jQuery(node.parentNode).hasClass(className)) { + var span = document.createElement("span"); + span.className = className; + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this); + }); + } + } + return this.each(function() { + highlight(this); + }); +}; + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated == 'undefined') + return string; + return (typeof translated == 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated == 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('

    ' + _('Hide Search Matches') + '

    ') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) == 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this == '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); diff --git a/released-versions/v0.2.0/_static/down-pressed.png b/released-versions/v0.2.0/_static/down-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..6f7ad782782e4f8e39b0c6e15c7344700cdd2527 GIT binary patch literal 368 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|*pj^6U4S$Y z{B+)352QE?JR*yM+OLB!qm#z$3ZNi+iKnkC`z>}Z23@f-Ava~9&<9T!#}JFtXD=!G zGdl{fK6ro2OGiOl+hKvH6i=D3%%Y^j`yIkRn!8O>@bG)IQR0{Kf+mxNd=_WScA8u_ z3;8(7x2){m9`nt+U(Nab&1G)!{`SPVpDX$w8McLTzAJ39wprG3p4XLq$06M`%}2Yk zRPPsbES*dnYm1wkGL;iioAUB*Or2kz6(-M_r_#Me-`{mj$Z%( literal 0 HcmV?d00001 diff --git a/released-versions/v0.2.0/_static/down.png b/released-versions/v0.2.0/_static/down.png new file mode 100644 index 0000000000000000000000000000000000000000..3003a88770de3977d47a2ba69893436a2860f9e7 GIT binary patch literal 363 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|*pj^6U4S$Y z{B+)352QE?JR*yM+OLB!qm#z$3ZNi+iKnkC`z>}xaV3tUZ$qnrLa#kt978NlpS`ru z&)HFc^}^>{UOEce+71h5nn>6&w6A!ieNbu1wh)UGh{8~et^#oZ1# z>T7oM=FZ~xXWnTo{qnXm$ZLOlqGswI_m2{XwVK)IJmBjW{J3-B3x@C=M{ShWt#fYS9M?R;8K$~YwlIqwf>VA7q=YKcwf2DS4Zj5inDKXXB1zl=(YO3ST6~rDq)&z z*o>z)=hxrfG-cDBW0G$!?6{M<$@{_4{m1o%Ub!naEtn|@^frU1tDnm{r-UW|!^@B8 literal 0 HcmV?d00001 diff --git a/released-versions/v0.2.0/_static/file.png b/released-versions/v0.2.0/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..d18082e397e7e54f20721af768c4c2983258f1b4 GIT binary patch literal 392 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`Y)RhkE)4%caKYZ?lYt_f1s;*b z3=G`DAk4@xYmNj^kiEpy*OmP$HyOL$D9)yc9|lc|nKf<9@eUiWd>3GuTC!a5vdfWYEazjncPj5ZQX%+1 zt8B*4=d)!cdDz4wr^#OMYfqGz$1LDFF>|#>*O?AGil(WEs?wLLy{Gj2J_@opDm%`dlax3yA*@*N$G&*ukFv>P8+2CBWO(qz zD0k1@kN>hhb1_6`&wrCswzINE(evt-5C1B^STi2@PmdKI;Vst0PQB6!2kdN literal 0 HcmV?d00001 diff --git a/released-versions/v0.2.0/_static/jquery.js b/released-versions/v0.2.0/_static/jquery.js new file mode 100644 index 00000000..12581195 --- /dev/null +++ b/released-versions/v0.2.0/_static/jquery.js @@ -0,0 +1,9404 @@ +/*! + * jQuery JavaScript Library v1.7.2 + * http://jquery.com/ + * + * Copyright 2011, John Resig + * Dual licensed under the MIT or GPL Version 2 licenses. + * http://jquery.org/license + * + * Includes Sizzle.js + * http://sizzlejs.com/ + * Copyright 2011, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * + * Date: Thu Aug 1 23:20:30 BRT 2013 + */ +(function( window, undefined ) { + +// Use the correct document accordingly with window argument (sandbox) +var document = window.document, + navigator = window.navigator, + location = window.location; +var jQuery = (function() { + +// Define a local copy of jQuery +var jQuery = function( selector, context ) { + // The jQuery object is actually just the init constructor 'enhanced' + return new jQuery.fn.init( selector, context, rootjQuery ); + }, + + // Map over jQuery in case of overwrite + _jQuery = window.jQuery, + + // Map over the $ in case of overwrite + _$ = window.$, + + // A central reference to the root jQuery(document) + rootjQuery, + + // A simple way to check for HTML strings or ID strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + quickExpr = /^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/, + + // Check if a string has a non-whitespace character in it + rnotwhite = /\S/, + + // Used for trimming whitespace + trimLeft = /^\s+/, + trimRight = /\s+$/, + + // Match a standalone tag + rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>)?$/, + + // JSON RegExp + rvalidchars = /^[\],:{}\s]*$/, + rvalidescape = /\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, + rvalidtokens = /"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, + rvalidbraces = /(?:^|:|,)(?:\s*\[)+/g, + + // Useragent RegExp + rwebkit = /(webkit)[ \/]([\w.]+)/, + ropera = /(opera)(?:.*version)?[ \/]([\w.]+)/, + rmsie = /(msie) ([\w.]+)/, + rmozilla = /(mozilla)(?:.*? rv:([\w.]+))?/, + + // Matches dashed string for camelizing + rdashAlpha = /-([a-z]|[0-9])/ig, + rmsPrefix = /^-ms-/, + + // Used by jQuery.camelCase as callback to replace() + fcamelCase = function( all, letter ) { + return ( letter + "" ).toUpperCase(); + }, + + // Keep a UserAgent string for use with jQuery.browser + userAgent = navigator.userAgent, + + // For matching the engine and version of the browser + browserMatch, + + // The deferred used on DOM ready + readyList, + + // The ready event handler + DOMContentLoaded, + + // Save a reference to some core methods + toString = Object.prototype.toString, + hasOwn = Object.prototype.hasOwnProperty, + push = Array.prototype.push, + slice = Array.prototype.slice, + trim = String.prototype.trim, + indexOf = Array.prototype.indexOf, + + // [[Class]] -> type pairs + class2type = {}; + +jQuery.fn = jQuery.prototype = { + constructor: jQuery, + init: function( selector, context, rootjQuery ) { + var match, elem, ret, doc; + + // Handle $(""), $(null), or $(undefined) + if ( !selector ) { + return this; + } + + // Handle $(DOMElement) + if ( selector.nodeType ) { + this.context = this[0] = selector; + this.length = 1; + return this; + } + + // The body element only exists once, optimize finding it + if ( selector === "body" && !context && document.body ) { + this.context = document; + this[0] = document.body; + this.selector = selector; + this.length = 1; + return this; + } + + // Handle HTML strings + if ( typeof selector === "string" ) { + // Are we dealing with HTML string or an ID? + if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = quickExpr.exec( selector ); + } + + // Verify a match, and that no context was specified for #id + if ( match && (match[1] || !context) ) { + + // HANDLE: $(html) -> $(array) + if ( match[1] ) { + context = context instanceof jQuery ? context[0] : context; + doc = ( context ? context.ownerDocument || context : document ); + + // If a single string is passed in and it's a single tag + // just do a createElement and skip the rest + ret = rsingleTag.exec( selector ); + + if ( ret ) { + if ( jQuery.isPlainObject( context ) ) { + selector = [ document.createElement( ret[1] ) ]; + jQuery.fn.attr.call( selector, context, true ); + + } else { + selector = [ doc.createElement( ret[1] ) ]; + } + + } else { + ret = jQuery.buildFragment( [ match[1] ], [ doc ] ); + selector = ( ret.cacheable ? jQuery.clone(ret.fragment) : ret.fragment ).childNodes; + } + + return jQuery.merge( this, selector ); + + // HANDLE: $("#id") + } else { + elem = document.getElementById( match[2] ); + + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE and Opera return items + // by name instead of ID + if ( elem.id !== match[2] ) { + return rootjQuery.find( selector ); + } + + // Otherwise, we inject the element directly into the jQuery object + this.length = 1; + this[0] = elem; + } + + this.context = document; + this.selector = selector; + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || rootjQuery ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( jQuery.isFunction( selector ) ) { + return rootjQuery.ready( selector ); + } + + if ( selector.selector !== undefined ) { + this.selector = selector.selector; + this.context = selector.context; + } + + return jQuery.makeArray( selector, this ); + }, + + // Start with an empty selector + selector: "", + + // The current version of jQuery being used + jquery: "1.7.2", + + // The default length of a jQuery object is 0 + length: 0, + + // The number of elements contained in the matched element set + size: function() { + return this.length; + }, + + toArray: function() { + return slice.call( this, 0 ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + return num == null ? + + // Return a 'clean' array + this.toArray() : + + // Return just the object + ( num < 0 ? this[ this.length + num ] : this[ num ] ); + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems, name, selector ) { + // Build a new jQuery matched element set + var ret = this.constructor(); + + if ( jQuery.isArray( elems ) ) { + push.apply( ret, elems ); + + } else { + jQuery.merge( ret, elems ); + } + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + ret.context = this.context; + + if ( name === "find" ) { + ret.selector = this.selector + ( this.selector ? " " : "" ) + selector; + } else if ( name ) { + ret.selector = this.selector + "." + name + "(" + selector + ")"; + } + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + // (You can seed the arguments with an array of args, but this is + // only used internally.) + each: function( callback, args ) { + return jQuery.each( this, callback, args ); + }, + + ready: function( fn ) { + // Attach the listeners + jQuery.bindReady(); + + // Add the callback + readyList.add( fn ); + + return this; + }, + + eq: function( i ) { + i = +i; + return i === -1 ? + this.slice( i ) : + this.slice( i, i + 1 ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ), + "slice", slice.call(arguments).join(",") ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map(this, function( elem, i ) { + return callback.call( elem, i, elem ); + })); + }, + + end: function() { + return this.prevObject || this.constructor(null); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: [].sort, + splice: [].splice +}; + +// Give the init function the jQuery prototype for later instantiation +jQuery.fn.init.prototype = jQuery.fn; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[0] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + target = arguments[1] || {}; + // skip the boolean and the target + i = 2; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !jQuery.isFunction(target) ) { + target = {}; + } + + // extend jQuery itself if only one argument is passed + if ( length === i ) { + target = this; + --i; + } + + for ( ; i < length; i++ ) { + // Only deal with non-null/undefined values + if ( (options = arguments[ i ]) != null ) { + // Extend the base object + for ( name in options ) { + src = target[ name ]; + copy = options[ name ]; + + // Prevent never-ending loop + if ( target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { + if ( copyIsArray ) { + copyIsArray = false; + clone = src && jQuery.isArray(src) ? src : []; + + } else { + clone = src && jQuery.isPlainObject(src) ? src : {}; + } + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend({ + noConflict: function( deep ) { + if ( window.$ === jQuery ) { + window.$ = _$; + } + + if ( deep && window.jQuery === jQuery ) { + window.jQuery = _jQuery; + } + + return jQuery; + }, + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Hold (or release) the ready event + holdReady: function( hold ) { + if ( hold ) { + jQuery.readyWait++; + } else { + jQuery.ready( true ); + } + }, + + // Handle when the DOM is ready + ready: function( wait ) { + // Either a released hold or an DOMready/load event and not yet ready + if ( (wait === true && !--jQuery.readyWait) || (wait !== true && !jQuery.isReady) ) { + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( !document.body ) { + return setTimeout( jQuery.ready, 1 ); + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.fireWith( document, [ jQuery ] ); + + // Trigger any bound ready events + if ( jQuery.fn.trigger ) { + jQuery( document ).trigger( "ready" ).off( "ready" ); + } + } + }, + + bindReady: function() { + if ( readyList ) { + return; + } + + readyList = jQuery.Callbacks( "once memory" ); + + // Catch cases where $(document).ready() is called after the + // browser event has already occurred. + if ( document.readyState === "complete" ) { + // Handle it asynchronously to allow scripts the opportunity to delay ready + return setTimeout( jQuery.ready, 1 ); + } + + // Mozilla, Opera and webkit nightlies currently support this event + if ( document.addEventListener ) { + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", jQuery.ready, false ); + + // If IE event model is used + } else if ( document.attachEvent ) { + // ensure firing before onload, + // maybe late but safe also for iframes + document.attachEvent( "onreadystatechange", DOMContentLoaded ); + + // A fallback to window.onload, that will always work + window.attachEvent( "onload", jQuery.ready ); + + // If IE and not a frame + // continually check to see if the document is ready + var toplevel = false; + + try { + toplevel = window.frameElement == null; + } catch(e) {} + + if ( document.documentElement.doScroll && toplevel ) { + doScrollCheck(); + } + } + }, + + // See test/unit/core.js for details concerning isFunction. + // Since version 1.3, DOM methods and functions like alert + // aren't supported. They return false on IE (#2968). + isFunction: function( obj ) { + return jQuery.type(obj) === "function"; + }, + + isArray: Array.isArray || function( obj ) { + return jQuery.type(obj) === "array"; + }, + + isWindow: function( obj ) { + return obj != null && obj == obj.window; + }, + + isNumeric: function( obj ) { + return !isNaN( parseFloat(obj) ) && isFinite( obj ); + }, + + type: function( obj ) { + return obj == null ? + String( obj ) : + class2type[ toString.call(obj) ] || "object"; + }, + + isPlainObject: function( obj ) { + // Must be an Object. + // Because of IE, we also have to check the presence of the constructor property. + // Make sure that DOM nodes and window objects don't pass through, as well + if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { + return false; + } + + try { + // Not own constructor property must be Object + if ( obj.constructor && + !hasOwn.call(obj, "constructor") && + !hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { + return false; + } + } catch ( e ) { + // IE8,9 Will throw exceptions on certain host objects #9897 + return false; + } + + // Own properties are enumerated firstly, so to speed up, + // if last one is own, then all properties are own. + + var key; + for ( key in obj ) {} + + return key === undefined || hasOwn.call( obj, key ); + }, + + isEmptyObject: function( obj ) { + for ( var name in obj ) { + return false; + } + return true; + }, + + error: function( msg ) { + throw new Error( msg ); + }, + + parseJSON: function( data ) { + if ( typeof data !== "string" || !data ) { + return null; + } + + // Make sure leading/trailing whitespace is removed (IE can't handle it) + data = jQuery.trim( data ); + + // Attempt to parse using the native JSON parser first + if ( window.JSON && window.JSON.parse ) { + return window.JSON.parse( data ); + } + + // Make sure the incoming data is actual JSON + // Logic borrowed from http://json.org/json2.js + if ( rvalidchars.test( data.replace( rvalidescape, "@" ) + .replace( rvalidtokens, "]" ) + .replace( rvalidbraces, "")) ) { + + return ( new Function( "return " + data ) )(); + + } + jQuery.error( "Invalid JSON: " + data ); + }, + + // Cross-browser xml parsing + parseXML: function( data ) { + if ( typeof data !== "string" || !data ) { + return null; + } + var xml, tmp; + try { + if ( window.DOMParser ) { // Standard + tmp = new DOMParser(); + xml = tmp.parseFromString( data , "text/xml" ); + } else { // IE + xml = new ActiveXObject( "Microsoft.XMLDOM" ); + xml.async = "false"; + xml.loadXML( data ); + } + } catch( e ) { + xml = undefined; + } + if ( !xml || !xml.documentElement || xml.getElementsByTagName( "parsererror" ).length ) { + jQuery.error( "Invalid XML: " + data ); + } + return xml; + }, + + noop: function() {}, + + // Evaluates a script in a global context + // Workarounds based on findings by Jim Driscoll + // http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context + globalEval: function( data ) { + if ( data && rnotwhite.test( data ) ) { + // We use execScript on Internet Explorer + // We use an anonymous function so that context is window + // rather than jQuery in Firefox + ( window.execScript || function( data ) { + window[ "eval" ].call( window, data ); + } )( data ); + } + }, + + // Convert dashed to camelCase; used by the css and data modules + // Microsoft forgot to hump their vendor prefix (#9572) + camelCase: function( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); + }, + + nodeName: function( elem, name ) { + return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase(); + }, + + // args is for internal usage only + each: function( object, callback, args ) { + var name, i = 0, + length = object.length, + isObj = length === undefined || jQuery.isFunction( object ); + + if ( args ) { + if ( isObj ) { + for ( name in object ) { + if ( callback.apply( object[ name ], args ) === false ) { + break; + } + } + } else { + for ( ; i < length; ) { + if ( callback.apply( object[ i++ ], args ) === false ) { + break; + } + } + } + + // A special, fast, case for the most common use of each + } else { + if ( isObj ) { + for ( name in object ) { + if ( callback.call( object[ name ], name, object[ name ] ) === false ) { + break; + } + } + } else { + for ( ; i < length; ) { + if ( callback.call( object[ i ], i, object[ i++ ] ) === false ) { + break; + } + } + } + } + + return object; + }, + + // Use native String.trim function wherever possible + trim: trim ? + function( text ) { + return text == null ? + "" : + trim.call( text ); + } : + + // Otherwise use our own trimming functionality + function( text ) { + return text == null ? + "" : + text.toString().replace( trimLeft, "" ).replace( trimRight, "" ); + }, + + // results is for internal usage only + makeArray: function( array, results ) { + var ret = results || []; + + if ( array != null ) { + // The window, strings (and functions) also have 'length' + // Tweaked logic slightly to handle Blackberry 4.7 RegExp issues #6930 + var type = jQuery.type( array ); + + if ( array.length == null || type === "string" || type === "function" || type === "regexp" || jQuery.isWindow( array ) ) { + push.call( ret, array ); + } else { + jQuery.merge( ret, array ); + } + } + + return ret; + }, + + inArray: function( elem, array, i ) { + var len; + + if ( array ) { + if ( indexOf ) { + return indexOf.call( array, elem, i ); + } + + len = array.length; + i = i ? i < 0 ? Math.max( 0, len + i ) : i : 0; + + for ( ; i < len; i++ ) { + // Skip accessing in sparse arrays + if ( i in array && array[ i ] === elem ) { + return i; + } + } + } + + return -1; + }, + + merge: function( first, second ) { + var i = first.length, + j = 0; + + if ( typeof second.length === "number" ) { + for ( var l = second.length; j < l; j++ ) { + first[ i++ ] = second[ j ]; + } + + } else { + while ( second[j] !== undefined ) { + first[ i++ ] = second[ j++ ]; + } + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, inv ) { + var ret = [], retVal; + inv = !!inv; + + // Go through the array, only saving the items + // that pass the validator function + for ( var i = 0, length = elems.length; i < length; i++ ) { + retVal = !!callback( elems[ i ], i ); + if ( inv !== retVal ) { + ret.push( elems[ i ] ); + } + } + + return ret; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var value, key, ret = [], + i = 0, + length = elems.length, + // jquery objects are treated as arrays + isArray = elems instanceof jQuery || length !== undefined && typeof length === "number" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ; + + // Go through the array, translating each of the items to their + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret[ ret.length ] = value; + } + } + + // Go through every key on the object, + } else { + for ( key in elems ) { + value = callback( elems[ key ], key, arg ); + + if ( value != null ) { + ret[ ret.length ] = value; + } + } + } + + // Flatten any nested arrays + return ret.concat.apply( [], ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // Bind a function to a context, optionally partially applying any + // arguments. + proxy: function( fn, context ) { + if ( typeof context === "string" ) { + var tmp = fn[ context ]; + context = fn; + fn = tmp; + } + + // Quick check to determine if target is callable, in the spec + // this throws a TypeError, but we will just return undefined. + if ( !jQuery.isFunction( fn ) ) { + return undefined; + } + + // Simulated bind + var args = slice.call( arguments, 2 ), + proxy = function() { + return fn.apply( context, args.concat( slice.call( arguments ) ) ); + }; + + // Set the guid of unique handler to the same of original handler, so it can be removed + proxy.guid = fn.guid = fn.guid || proxy.guid || jQuery.guid++; + + return proxy; + }, + + // Mutifunctional method to get and set values to a collection + // The value/s can optionally be executed if it's a function + access: function( elems, fn, key, value, chainable, emptyGet, pass ) { + var exec, + bulk = key == null, + i = 0, + length = elems.length; + + // Sets many values + if ( key && typeof key === "object" ) { + for ( i in key ) { + jQuery.access( elems, fn, i, key[i], 1, emptyGet, value ); + } + chainable = 1; + + // Sets one value + } else if ( value !== undefined ) { + // Optionally, function values get executed if exec is true + exec = pass === undefined && jQuery.isFunction( value ); + + if ( bulk ) { + // Bulk operations only iterate when executing function values + if ( exec ) { + exec = fn; + fn = function( elem, key, value ) { + return exec.call( jQuery( elem ), value ); + }; + + // Otherwise they run against the entire set + } else { + fn.call( elems, value ); + fn = null; + } + } + + if ( fn ) { + for (; i < length; i++ ) { + fn( elems[i], key, exec ? value.call( elems[i], i, fn( elems[i], key ) ) : value, pass ); + } + } + + chainable = 1; + } + + return chainable ? + elems : + + // Gets + bulk ? + fn.call( elems ) : + length ? fn( elems[0], key ) : emptyGet; + }, + + now: function() { + return ( new Date() ).getTime(); + }, + + // Use of jQuery.browser is frowned upon. + // More details: http://docs.jquery.com/Utilities/jQuery.browser + uaMatch: function( ua ) { + ua = ua.toLowerCase(); + + var match = rwebkit.exec( ua ) || + ropera.exec( ua ) || + rmsie.exec( ua ) || + ua.indexOf("compatible") < 0 && rmozilla.exec( ua ) || + []; + + return { browser: match[1] || "", version: match[2] || "0" }; + }, + + sub: function() { + function jQuerySub( selector, context ) { + return new jQuerySub.fn.init( selector, context ); + } + jQuery.extend( true, jQuerySub, this ); + jQuerySub.superclass = this; + jQuerySub.fn = jQuerySub.prototype = this(); + jQuerySub.fn.constructor = jQuerySub; + jQuerySub.sub = this.sub; + jQuerySub.fn.init = function init( selector, context ) { + if ( context && context instanceof jQuery && !(context instanceof jQuerySub) ) { + context = jQuerySub( context ); + } + + return jQuery.fn.init.call( this, selector, context, rootjQuerySub ); + }; + jQuerySub.fn.init.prototype = jQuerySub.fn; + var rootjQuerySub = jQuerySub(document); + return jQuerySub; + }, + + browser: {} +}); + +// Populate the class2type map +jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +}); + +browserMatch = jQuery.uaMatch( userAgent ); +if ( browserMatch.browser ) { + jQuery.browser[ browserMatch.browser ] = true; + jQuery.browser.version = browserMatch.version; +} + +// Deprecated, use jQuery.browser.webkit instead +if ( jQuery.browser.webkit ) { + jQuery.browser.safari = true; +} + +// IE doesn't match non-breaking spaces with \s +if ( rnotwhite.test( "\xA0" ) ) { + trimLeft = /^[\s\xA0]+/; + trimRight = /[\s\xA0]+$/; +} + +// All jQuery objects should point back to these +rootjQuery = jQuery(document); + +// Cleanup functions for the document ready method +if ( document.addEventListener ) { + DOMContentLoaded = function() { + document.removeEventListener( "DOMContentLoaded", DOMContentLoaded, false ); + jQuery.ready(); + }; + +} else if ( document.attachEvent ) { + DOMContentLoaded = function() { + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( document.readyState === "complete" ) { + document.detachEvent( "onreadystatechange", DOMContentLoaded ); + jQuery.ready(); + } + }; +} + +// The DOM ready check for Internet Explorer +function doScrollCheck() { + if ( jQuery.isReady ) { + return; + } + + try { + // If IE is used, use the trick by Diego Perini + // http://javascript.nwbox.com/IEContentLoaded/ + document.documentElement.doScroll("left"); + } catch(e) { + setTimeout( doScrollCheck, 1 ); + return; + } + + // and execute any waiting functions + jQuery.ready(); +} + +return jQuery; + +})(); + + +// String to Object flags format cache +var flagsCache = {}; + +// Convert String-formatted flags into Object-formatted ones and store in cache +function createFlags( flags ) { + var object = flagsCache[ flags ] = {}, + i, length; + flags = flags.split( /\s+/ ); + for ( i = 0, length = flags.length; i < length; i++ ) { + object[ flags[i] ] = true; + } + return object; +} + +/* + * Create a callback list using the following parameters: + * + * flags: an optional list of space-separated flags that will change how + * the callback list behaves + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible flags: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( flags ) { + + // Convert flags from String-formatted to Object-formatted + // (we check in cache first) + flags = flags ? ( flagsCache[ flags ] || createFlags( flags ) ) : {}; + + var // Actual callback list + list = [], + // Stack of fire calls for repeatable lists + stack = [], + // Last fire value (for non-forgettable lists) + memory, + // Flag to know if list was already fired + fired, + // Flag to know if list is currently firing + firing, + // First callback to fire (used internally by add and fireWith) + firingStart, + // End of the loop when firing + firingLength, + // Index of currently firing callback (modified by remove if needed) + firingIndex, + // Add one or several callbacks to the list + add = function( args ) { + var i, + length, + elem, + type, + actual; + for ( i = 0, length = args.length; i < length; i++ ) { + elem = args[ i ]; + type = jQuery.type( elem ); + if ( type === "array" ) { + // Inspect recursively + add( elem ); + } else if ( type === "function" ) { + // Add if not in unique mode and callback is not in + if ( !flags.unique || !self.has( elem ) ) { + list.push( elem ); + } + } + } + }, + // Fire callbacks + fire = function( context, args ) { + args = args || []; + memory = !flags.memory || [ context, args ]; + fired = true; + firing = true; + firingIndex = firingStart || 0; + firingStart = 0; + firingLength = list.length; + for ( ; list && firingIndex < firingLength; firingIndex++ ) { + if ( list[ firingIndex ].apply( context, args ) === false && flags.stopOnFalse ) { + memory = true; // Mark as halted + break; + } + } + firing = false; + if ( list ) { + if ( !flags.once ) { + if ( stack && stack.length ) { + memory = stack.shift(); + self.fireWith( memory[ 0 ], memory[ 1 ] ); + } + } else if ( memory === true ) { + self.disable(); + } else { + list = []; + } + } + }, + // Actual Callbacks object + self = { + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + var length = list.length; + add( arguments ); + // Do we need to add the callbacks to the + // current firing batch? + if ( firing ) { + firingLength = list.length; + // With memory, if we're not firing then + // we should call right away, unless previous + // firing was halted (stopOnFalse) + } else if ( memory && memory !== true ) { + firingStart = length; + fire( memory[ 0 ], memory[ 1 ] ); + } + } + return this; + }, + // Remove a callback from the list + remove: function() { + if ( list ) { + var args = arguments, + argIndex = 0, + argLength = args.length; + for ( ; argIndex < argLength ; argIndex++ ) { + for ( var i = 0; i < list.length; i++ ) { + if ( args[ argIndex ] === list[ i ] ) { + // Handle firingIndex and firingLength + if ( firing ) { + if ( i <= firingLength ) { + firingLength--; + if ( i <= firingIndex ) { + firingIndex--; + } + } + } + // Remove the element + list.splice( i--, 1 ); + // If we have some unicity property then + // we only need to do this once + if ( flags.unique ) { + break; + } + } + } + } + } + return this; + }, + // Control if a given callback is in the list + has: function( fn ) { + if ( list ) { + var i = 0, + length = list.length; + for ( ; i < length; i++ ) { + if ( fn === list[ i ] ) { + return true; + } + } + } + return false; + }, + // Remove all callbacks from the list + empty: function() { + list = []; + return this; + }, + // Have the list do nothing anymore + disable: function() { + list = stack = memory = undefined; + return this; + }, + // Is it disabled? + disabled: function() { + return !list; + }, + // Lock the list in its current state + lock: function() { + stack = undefined; + if ( !memory || memory === true ) { + self.disable(); + } + return this; + }, + // Is it locked? + locked: function() { + return !stack; + }, + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( stack ) { + if ( firing ) { + if ( !flags.once ) { + stack.push( [ context, args ] ); + } + } else if ( !( flags.once && memory ) ) { + fire( context, args ); + } + } + return this; + }, + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + + + +var // Static reference to slice + sliceDeferred = [].slice; + +jQuery.extend({ + + Deferred: function( func ) { + var doneList = jQuery.Callbacks( "once memory" ), + failList = jQuery.Callbacks( "once memory" ), + progressList = jQuery.Callbacks( "memory" ), + state = "pending", + lists = { + resolve: doneList, + reject: failList, + notify: progressList + }, + promise = { + done: doneList.add, + fail: failList.add, + progress: progressList.add, + + state: function() { + return state; + }, + + // Deprecated + isResolved: doneList.fired, + isRejected: failList.fired, + + then: function( doneCallbacks, failCallbacks, progressCallbacks ) { + deferred.done( doneCallbacks ).fail( failCallbacks ).progress( progressCallbacks ); + return this; + }, + always: function() { + deferred.done.apply( deferred, arguments ).fail.apply( deferred, arguments ); + return this; + }, + pipe: function( fnDone, fnFail, fnProgress ) { + return jQuery.Deferred(function( newDefer ) { + jQuery.each( { + done: [ fnDone, "resolve" ], + fail: [ fnFail, "reject" ], + progress: [ fnProgress, "notify" ] + }, function( handler, data ) { + var fn = data[ 0 ], + action = data[ 1 ], + returned; + if ( jQuery.isFunction( fn ) ) { + deferred[ handler ](function() { + returned = fn.apply( this, arguments ); + if ( returned && jQuery.isFunction( returned.promise ) ) { + returned.promise().then( newDefer.resolve, newDefer.reject, newDefer.notify ); + } else { + newDefer[ action + "With" ]( this === deferred ? newDefer : this, [ returned ] ); + } + }); + } else { + deferred[ handler ]( newDefer[ action ] ); + } + }); + }).promise(); + }, + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + if ( obj == null ) { + obj = promise; + } else { + for ( var key in promise ) { + obj[ key ] = promise[ key ]; + } + } + return obj; + } + }, + deferred = promise.promise({}), + key; + + for ( key in lists ) { + deferred[ key ] = lists[ key ].fire; + deferred[ key + "With" ] = lists[ key ].fireWith; + } + + // Handle state + deferred.done( function() { + state = "resolved"; + }, failList.disable, progressList.lock ).fail( function() { + state = "rejected"; + }, doneList.disable, progressList.lock ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( firstParam ) { + var args = sliceDeferred.call( arguments, 0 ), + i = 0, + length = args.length, + pValues = new Array( length ), + count = length, + pCount = length, + deferred = length <= 1 && firstParam && jQuery.isFunction( firstParam.promise ) ? + firstParam : + jQuery.Deferred(), + promise = deferred.promise(); + function resolveFunc( i ) { + return function( value ) { + args[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments, 0 ) : value; + if ( !( --count ) ) { + deferred.resolveWith( deferred, args ); + } + }; + } + function progressFunc( i ) { + return function( value ) { + pValues[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments, 0 ) : value; + deferred.notifyWith( promise, pValues ); + }; + } + if ( length > 1 ) { + for ( ; i < length; i++ ) { + if ( args[ i ] && args[ i ].promise && jQuery.isFunction( args[ i ].promise ) ) { + args[ i ].promise().then( resolveFunc(i), deferred.reject, progressFunc(i) ); + } else { + --count; + } + } + if ( !count ) { + deferred.resolveWith( deferred, args ); + } + } else if ( deferred !== firstParam ) { + deferred.resolveWith( deferred, length ? [ firstParam ] : [] ); + } + return promise; + } +}); + + + + +jQuery.support = (function() { + + var support, + all, + a, + select, + opt, + input, + fragment, + tds, + events, + eventName, + i, + isSupported, + div = document.createElement( "div" ), + documentElement = document.documentElement; + + // Preliminary tests + div.setAttribute("className", "t"); + div.innerHTML = "
    a"; + + all = div.getElementsByTagName( "*" ); + a = div.getElementsByTagName( "a" )[ 0 ]; + + // Can't get basic test support + if ( !all || !all.length || !a ) { + return {}; + } + + // First batch of supports tests + select = document.createElement( "select" ); + opt = select.appendChild( document.createElement("option") ); + input = div.getElementsByTagName( "input" )[ 0 ]; + + support = { + // IE strips leading whitespace when .innerHTML is used + leadingWhitespace: ( div.firstChild.nodeType === 3 ), + + // Make sure that tbody elements aren't automatically inserted + // IE will insert them into empty tables + tbody: !div.getElementsByTagName("tbody").length, + + // Make sure that link elements get serialized correctly by innerHTML + // This requires a wrapper element in IE + htmlSerialize: !!div.getElementsByTagName("link").length, + + // Get the style information from getAttribute + // (IE uses .cssText instead) + style: /top/.test( a.getAttribute("style") ), + + // Make sure that URLs aren't manipulated + // (IE normalizes it by default) + hrefNormalized: ( a.getAttribute("href") === "/a" ), + + // Make sure that element opacity exists + // (IE uses filter instead) + // Use a regex to work around a WebKit issue. See #5145 + opacity: /^0.55/.test( a.style.opacity ), + + // Verify style float existence + // (IE uses styleFloat instead of cssFloat) + cssFloat: !!a.style.cssFloat, + + // Make sure that if no value is specified for a checkbox + // that it defaults to "on". + // (WebKit defaults to "" instead) + checkOn: ( input.value === "on" ), + + // Make sure that a selected-by-default option has a working selected property. + // (WebKit defaults to false instead of true, IE too, if it's in an optgroup) + optSelected: opt.selected, + + // Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7) + getSetAttribute: div.className !== "t", + + // Tests for enctype support on a form(#6743) + enctype: !!document.createElement("form").enctype, + + // Makes sure cloning an html5 element does not cause problems + // Where outerHTML is undefined, this still works + html5Clone: document.createElement("nav").cloneNode( true ).outerHTML !== "<:nav>", + + // Will be defined later + submitBubbles: true, + changeBubbles: true, + focusinBubbles: false, + deleteExpando: true, + noCloneEvent: true, + inlineBlockNeedsLayout: false, + shrinkWrapBlocks: false, + reliableMarginRight: true, + pixelMargin: true + }; + + // jQuery.boxModel DEPRECATED in 1.3, use jQuery.support.boxModel instead + jQuery.boxModel = support.boxModel = (document.compatMode === "CSS1Compat"); + + // Make sure checked status is properly cloned + input.checked = true; + support.noCloneChecked = input.cloneNode( true ).checked; + + // Make sure that the options inside disabled selects aren't marked as disabled + // (WebKit marks them as disabled) + select.disabled = true; + support.optDisabled = !opt.disabled; + + // Test to see if it's possible to delete an expando from an element + // Fails in Internet Explorer + try { + delete div.test; + } catch( e ) { + support.deleteExpando = false; + } + + if ( !div.addEventListener && div.attachEvent && div.fireEvent ) { + div.attachEvent( "onclick", function() { + // Cloning a node shouldn't copy over any + // bound event handlers (IE does this) + support.noCloneEvent = false; + }); + div.cloneNode( true ).fireEvent( "onclick" ); + } + + // Check if a radio maintains its value + // after being appended to the DOM + input = document.createElement("input"); + input.value = "t"; + input.setAttribute("type", "radio"); + support.radioValue = input.value === "t"; + + input.setAttribute("checked", "checked"); + + // #11217 - WebKit loses check when the name is after the checked attribute + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + fragment = document.createDocumentFragment(); + fragment.appendChild( div.lastChild ); + + // WebKit doesn't clone checked state correctly in fragments + support.checkClone = fragment.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Check if a disconnected checkbox will retain its checked + // value of true after appended to the DOM (IE6/7) + support.appendChecked = input.checked; + + fragment.removeChild( input ); + fragment.appendChild( div ); + + // Technique from Juriy Zaytsev + // http://perfectionkills.com/detecting-event-support-without-browser-sniffing/ + // We only care about the case where non-standard event systems + // are used, namely in IE. Short-circuiting here helps us to + // avoid an eval call (in setAttribute) which can cause CSP + // to go haywire. See: https://developer.mozilla.org/en/Security/CSP + if ( div.attachEvent ) { + for ( i in { + submit: 1, + change: 1, + focusin: 1 + }) { + eventName = "on" + i; + isSupported = ( eventName in div ); + if ( !isSupported ) { + div.setAttribute( eventName, "return;" ); + isSupported = ( typeof div[ eventName ] === "function" ); + } + support[ i + "Bubbles" ] = isSupported; + } + } + + fragment.removeChild( div ); + + // Null elements to avoid leaks in IE + fragment = select = opt = div = input = null; + + // Run tests that need a body at doc ready + jQuery(function() { + var container, outer, inner, table, td, offsetSupport, + marginDiv, conMarginTop, style, html, positionTopLeftWidthHeight, + paddingMarginBorderVisibility, paddingMarginBorder, + body = document.getElementsByTagName("body")[0]; + + if ( !body ) { + // Return for frameset docs that don't have a body + return; + } + + conMarginTop = 1; + paddingMarginBorder = "padding:0;margin:0;border:"; + positionTopLeftWidthHeight = "position:absolute;top:0;left:0;width:1px;height:1px;"; + paddingMarginBorderVisibility = paddingMarginBorder + "0;visibility:hidden;"; + style = "style='" + positionTopLeftWidthHeight + paddingMarginBorder + "5px solid #000;"; + html = "
    " + + "" + + "
    "; + + container = document.createElement("div"); + container.style.cssText = paddingMarginBorderVisibility + "width:0;height:0;position:static;top:0;margin-top:" + conMarginTop + "px"; + body.insertBefore( container, body.firstChild ); + + // Construct the test element + div = document.createElement("div"); + container.appendChild( div ); + + // Check if table cells still have offsetWidth/Height when they are set + // to display:none and there are still other visible table cells in a + // table row; if so, offsetWidth/Height are not reliable for use when + // determining if an element has been hidden directly using + // display:none (it is still safe to use offsets if a parent element is + // hidden; don safety goggles and see bug #4512 for more information). + // (only IE 8 fails this test) + div.innerHTML = "
    t
    "; + tds = div.getElementsByTagName( "td" ); + isSupported = ( tds[ 0 ].offsetHeight === 0 ); + + tds[ 0 ].style.display = ""; + tds[ 1 ].style.display = "none"; + + // Check if empty table cells still have offsetWidth/Height + // (IE <= 8 fail this test) + support.reliableHiddenOffsets = isSupported && ( tds[ 0 ].offsetHeight === 0 ); + + // Check if div with explicit width and no margin-right incorrectly + // gets computed margin-right based on width of container. For more + // info see bug #3333 + // Fails in WebKit before Feb 2011 nightlies + // WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right + if ( window.getComputedStyle ) { + div.innerHTML = ""; + marginDiv = document.createElement( "div" ); + marginDiv.style.width = "0"; + marginDiv.style.marginRight = "0"; + div.style.width = "2px"; + div.appendChild( marginDiv ); + support.reliableMarginRight = + ( parseInt( ( window.getComputedStyle( marginDiv, null ) || { marginRight: 0 } ).marginRight, 10 ) || 0 ) === 0; + } + + if ( typeof div.style.zoom !== "undefined" ) { + // Check if natively block-level elements act like inline-block + // elements when setting their display to 'inline' and giving + // them layout + // (IE < 8 does this) + div.innerHTML = ""; + div.style.width = div.style.padding = "1px"; + div.style.border = 0; + div.style.overflow = "hidden"; + div.style.display = "inline"; + div.style.zoom = 1; + support.inlineBlockNeedsLayout = ( div.offsetWidth === 3 ); + + // Check if elements with layout shrink-wrap their children + // (IE 6 does this) + div.style.display = "block"; + div.style.overflow = "visible"; + div.innerHTML = "
    "; + support.shrinkWrapBlocks = ( div.offsetWidth !== 3 ); + } + + div.style.cssText = positionTopLeftWidthHeight + paddingMarginBorderVisibility; + div.innerHTML = html; + + outer = div.firstChild; + inner = outer.firstChild; + td = outer.nextSibling.firstChild.firstChild; + + offsetSupport = { + doesNotAddBorder: ( inner.offsetTop !== 5 ), + doesAddBorderForTableAndCells: ( td.offsetTop === 5 ) + }; + + inner.style.position = "fixed"; + inner.style.top = "20px"; + + // safari subtracts parent border width here which is 5px + offsetSupport.fixedPosition = ( inner.offsetTop === 20 || inner.offsetTop === 15 ); + inner.style.position = inner.style.top = ""; + + outer.style.overflow = "hidden"; + outer.style.position = "relative"; + + offsetSupport.subtractsBorderForOverflowNotVisible = ( inner.offsetTop === -5 ); + offsetSupport.doesNotIncludeMarginInBodyOffset = ( body.offsetTop !== conMarginTop ); + + if ( window.getComputedStyle ) { + div.style.marginTop = "1%"; + support.pixelMargin = ( window.getComputedStyle( div, null ) || { marginTop: 0 } ).marginTop !== "1%"; + } + + if ( typeof container.style.zoom !== "undefined" ) { + container.style.zoom = 1; + } + + body.removeChild( container ); + marginDiv = div = container = null; + + jQuery.extend( support, offsetSupport ); + }); + + return support; +})(); + + + + +var rbrace = /^(?:\{.*\}|\[.*\])$/, + rmultiDash = /([A-Z])/g; + +jQuery.extend({ + cache: {}, + + // Please use with caution + uuid: 0, + + // Unique for each copy of jQuery on the page + // Non-digits removed to match rinlinejQuery + expando: "jQuery" + ( jQuery.fn.jquery + Math.random() ).replace( /\D/g, "" ), + + // The following elements throw uncatchable exceptions if you + // attempt to add expando properties to them. + noData: { + "embed": true, + // Ban all objects except for Flash (which handle expandos) + "object": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000", + "applet": true + }, + + hasData: function( elem ) { + elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; + return !!elem && !isEmptyDataObject( elem ); + }, + + data: function( elem, name, data, pvt /* Internal Use Only */ ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var privateCache, thisCache, ret, + internalKey = jQuery.expando, + getByName = typeof name === "string", + + // We have to handle DOM nodes and JS objects differently because IE6-7 + // can't GC object references properly across the DOM-JS boundary + isNode = elem.nodeType, + + // Only DOM nodes need the global jQuery cache; JS object data is + // attached directly to the object so GC can occur automatically + cache = isNode ? jQuery.cache : elem, + + // Only defining an ID for JS objects if its cache already exists allows + // the code to shortcut on the same path as a DOM node with no cache + id = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey, + isEvents = name === "events"; + + // Avoid doing any more work than we need to when trying to get data on an + // object that has no data at all + if ( (!id || !cache[id] || (!isEvents && !pvt && !cache[id].data)) && getByName && data === undefined ) { + return; + } + + if ( !id ) { + // Only DOM nodes need a new unique ID for each element since their data + // ends up in the global cache + if ( isNode ) { + elem[ internalKey ] = id = ++jQuery.uuid; + } else { + id = internalKey; + } + } + + if ( !cache[ id ] ) { + cache[ id ] = {}; + + // Avoids exposing jQuery metadata on plain JS objects when the object + // is serialized using JSON.stringify + if ( !isNode ) { + cache[ id ].toJSON = jQuery.noop; + } + } + + // An object can be passed to jQuery.data instead of a key/value pair; this gets + // shallow copied over onto the existing cache + if ( typeof name === "object" || typeof name === "function" ) { + if ( pvt ) { + cache[ id ] = jQuery.extend( cache[ id ], name ); + } else { + cache[ id ].data = jQuery.extend( cache[ id ].data, name ); + } + } + + privateCache = thisCache = cache[ id ]; + + // jQuery data() is stored in a separate object inside the object's internal data + // cache in order to avoid key collisions between internal data and user-defined + // data. + if ( !pvt ) { + if ( !thisCache.data ) { + thisCache.data = {}; + } + + thisCache = thisCache.data; + } + + if ( data !== undefined ) { + thisCache[ jQuery.camelCase( name ) ] = data; + } + + // Users should not attempt to inspect the internal events object using jQuery.data, + // it is undocumented and subject to change. But does anyone listen? No. + if ( isEvents && !thisCache[ name ] ) { + return privateCache.events; + } + + // Check for both converted-to-camel and non-converted data property names + // If a data property was specified + if ( getByName ) { + + // First Try to find as-is property data + ret = thisCache[ name ]; + + // Test for null|undefined property data + if ( ret == null ) { + + // Try to find the camelCased property + ret = thisCache[ jQuery.camelCase( name ) ]; + } + } else { + ret = thisCache; + } + + return ret; + }, + + removeData: function( elem, name, pvt /* Internal Use Only */ ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var thisCache, i, l, + + // Reference to internal data cache key + internalKey = jQuery.expando, + + isNode = elem.nodeType, + + // See jQuery.data for more information + cache = isNode ? jQuery.cache : elem, + + // See jQuery.data for more information + id = isNode ? elem[ internalKey ] : internalKey; + + // If there is already no cache entry for this object, there is no + // purpose in continuing + if ( !cache[ id ] ) { + return; + } + + if ( name ) { + + thisCache = pvt ? cache[ id ] : cache[ id ].data; + + if ( thisCache ) { + + // Support array or space separated string names for data keys + if ( !jQuery.isArray( name ) ) { + + // try the string as a key before any manipulation + if ( name in thisCache ) { + name = [ name ]; + } else { + + // split the camel cased version by spaces unless a key with the spaces exists + name = jQuery.camelCase( name ); + if ( name in thisCache ) { + name = [ name ]; + } else { + name = name.split( " " ); + } + } + } + + for ( i = 0, l = name.length; i < l; i++ ) { + delete thisCache[ name[i] ]; + } + + // If there is no data left in the cache, we want to continue + // and let the cache object itself get destroyed + if ( !( pvt ? isEmptyDataObject : jQuery.isEmptyObject )( thisCache ) ) { + return; + } + } + } + + // See jQuery.data for more information + if ( !pvt ) { + delete cache[ id ].data; + + // Don't destroy the parent cache unless the internal data object + // had been the only thing left in it + if ( !isEmptyDataObject(cache[ id ]) ) { + return; + } + } + + // Browsers that fail expando deletion also refuse to delete expandos on + // the window, but it will allow it on all other JS objects; other browsers + // don't care + // Ensure that `cache` is not a window object #10080 + if ( jQuery.support.deleteExpando || !cache.setInterval ) { + delete cache[ id ]; + } else { + cache[ id ] = null; + } + + // We destroyed the cache and need to eliminate the expando on the node to avoid + // false lookups in the cache for entries that no longer exist + if ( isNode ) { + // IE does not allow us to delete expando properties from nodes, + // nor does it have a removeAttribute function on Document nodes; + // we must handle all of these cases + if ( jQuery.support.deleteExpando ) { + delete elem[ internalKey ]; + } else if ( elem.removeAttribute ) { + elem.removeAttribute( internalKey ); + } else { + elem[ internalKey ] = null; + } + } + }, + + // For internal use only. + _data: function( elem, name, data ) { + return jQuery.data( elem, name, data, true ); + }, + + // A method for determining if a DOM node can handle the data expando + acceptData: function( elem ) { + if ( elem.nodeName ) { + var match = jQuery.noData[ elem.nodeName.toLowerCase() ]; + + if ( match ) { + return !(match === true || elem.getAttribute("classid") !== match); + } + } + + return true; + } +}); + +jQuery.fn.extend({ + data: function( key, value ) { + var parts, part, attr, name, l, + elem = this[0], + i = 0, + data = null; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = jQuery.data( elem ); + + if ( elem.nodeType === 1 && !jQuery._data( elem, "parsedAttrs" ) ) { + attr = elem.attributes; + for ( l = attr.length; i < l; i++ ) { + name = attr[i].name; + + if ( name.indexOf( "data-" ) === 0 ) { + name = jQuery.camelCase( name.substring(5) ); + + dataAttr( elem, name, data[ name ] ); + } + } + jQuery._data( elem, "parsedAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each(function() { + jQuery.data( this, key ); + }); + } + + parts = key.split( ".", 2 ); + parts[1] = parts[1] ? "." + parts[1] : ""; + part = parts[1] + "!"; + + return jQuery.access( this, function( value ) { + + if ( value === undefined ) { + data = this.triggerHandler( "getData" + part, [ parts[0] ] ); + + // Try to fetch any internally stored data first + if ( data === undefined && elem ) { + data = jQuery.data( elem, key ); + data = dataAttr( elem, key, data ); + } + + return data === undefined && parts[1] ? + this.data( parts[0] ) : + data; + } + + parts[1] = value; + this.each(function() { + var self = jQuery( this ); + + self.triggerHandler( "setData" + part, parts ); + jQuery.data( this, key, value ); + self.triggerHandler( "changeData" + part, parts ); + }); + }, null, value, arguments.length > 1, null, false ); + }, + + removeData: function( key ) { + return this.each(function() { + jQuery.removeData( this, key ); + }); + } +}); + +function dataAttr( elem, key, data ) { + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + + var name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase(); + + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = data === "true" ? true : + data === "false" ? false : + data === "null" ? null : + jQuery.isNumeric( data ) ? +data : + rbrace.test( data ) ? jQuery.parseJSON( data ) : + data; + } catch( e ) {} + + // Make sure we set the data so it isn't changed later + jQuery.data( elem, key, data ); + + } else { + data = undefined; + } + } + + return data; +} + +// checks a cache object for emptiness +function isEmptyDataObject( obj ) { + for ( var name in obj ) { + + // if the public data object is empty, the private is still empty + if ( name === "data" && jQuery.isEmptyObject( obj[name] ) ) { + continue; + } + if ( name !== "toJSON" ) { + return false; + } + } + + return true; +} + + + + +function handleQueueMarkDefer( elem, type, src ) { + var deferDataKey = type + "defer", + queueDataKey = type + "queue", + markDataKey = type + "mark", + defer = jQuery._data( elem, deferDataKey ); + if ( defer && + ( src === "queue" || !jQuery._data(elem, queueDataKey) ) && + ( src === "mark" || !jQuery._data(elem, markDataKey) ) ) { + // Give room for hard-coded callbacks to fire first + // and eventually mark/queue something else on the element + setTimeout( function() { + if ( !jQuery._data( elem, queueDataKey ) && + !jQuery._data( elem, markDataKey ) ) { + jQuery.removeData( elem, deferDataKey, true ); + defer.fire(); + } + }, 0 ); + } +} + +jQuery.extend({ + + _mark: function( elem, type ) { + if ( elem ) { + type = ( type || "fx" ) + "mark"; + jQuery._data( elem, type, (jQuery._data( elem, type ) || 0) + 1 ); + } + }, + + _unmark: function( force, elem, type ) { + if ( force !== true ) { + type = elem; + elem = force; + force = false; + } + if ( elem ) { + type = type || "fx"; + var key = type + "mark", + count = force ? 0 : ( (jQuery._data( elem, key ) || 1) - 1 ); + if ( count ) { + jQuery._data( elem, key, count ); + } else { + jQuery.removeData( elem, key, true ); + handleQueueMarkDefer( elem, type, "mark" ); + } + } + }, + + queue: function( elem, type, data ) { + var q; + if ( elem ) { + type = ( type || "fx" ) + "queue"; + q = jQuery._data( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !q || jQuery.isArray(data) ) { + q = jQuery._data( elem, type, jQuery.makeArray(data) ); + } else { + q.push( data ); + } + } + return q || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + fn = queue.shift(), + hooks = {}; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + } + + if ( fn ) { + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + jQuery._data( elem, type + ".run", hooks ); + fn.call( elem, function() { + jQuery.dequeue( elem, type ); + }, hooks ); + } + + if ( !queue.length ) { + jQuery.removeData( elem, type + "queue " + type + ".run", true ); + handleQueueMarkDefer( elem, type, "queue" ); + } + } +}); + +jQuery.fn.extend({ + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[0], type ); + } + + return data === undefined ? + this : + this.each(function() { + var queue = jQuery.queue( this, type, data ); + + if ( type === "fx" && queue[0] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + }); + }, + dequeue: function( type ) { + return this.each(function() { + jQuery.dequeue( this, type ); + }); + }, + // Based off of the plugin by Clint Helfers, with permission. + // http://blindsignals.com/index.php/2009/07/jquery-delay/ + delay: function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = setTimeout( next, time ); + hooks.stop = function() { + clearTimeout( timeout ); + }; + }); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, object ) { + if ( typeof type !== "string" ) { + object = type; + type = undefined; + } + type = type || "fx"; + var defer = jQuery.Deferred(), + elements = this, + i = elements.length, + count = 1, + deferDataKey = type + "defer", + queueDataKey = type + "queue", + markDataKey = type + "mark", + tmp; + function resolve() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + } + while( i-- ) { + if (( tmp = jQuery.data( elements[ i ], deferDataKey, undefined, true ) || + ( jQuery.data( elements[ i ], queueDataKey, undefined, true ) || + jQuery.data( elements[ i ], markDataKey, undefined, true ) ) && + jQuery.data( elements[ i ], deferDataKey, jQuery.Callbacks( "once memory" ), true ) )) { + count++; + tmp.add( resolve ); + } + } + resolve(); + return defer.promise( object ); + } +}); + + + + +var rclass = /[\n\t\r]/g, + rspace = /\s+/, + rreturn = /\r/g, + rtype = /^(?:button|input)$/i, + rfocusable = /^(?:button|input|object|select|textarea)$/i, + rclickable = /^a(?:rea)?$/i, + rboolean = /^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i, + getSetAttribute = jQuery.support.getSetAttribute, + nodeHook, boolHook, fixSpecified; + +jQuery.fn.extend({ + attr: function( name, value ) { + return jQuery.access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each(function() { + jQuery.removeAttr( this, name ); + }); + }, + + prop: function( name, value ) { + return jQuery.access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + name = jQuery.propFix[ name ] || name; + return this.each(function() { + // try/catch handles cases where IE balks (such as removing a property on window) + try { + this[ name ] = undefined; + delete this[ name ]; + } catch( e ) {} + }); + }, + + addClass: function( value ) { + var classNames, i, l, elem, + setClass, c, cl; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( j ) { + jQuery( this ).addClass( value.call(this, j, this.className) ); + }); + } + + if ( value && typeof value === "string" ) { + classNames = value.split( rspace ); + + for ( i = 0, l = this.length; i < l; i++ ) { + elem = this[ i ]; + + if ( elem.nodeType === 1 ) { + if ( !elem.className && classNames.length === 1 ) { + elem.className = value; + + } else { + setClass = " " + elem.className + " "; + + for ( c = 0, cl = classNames.length; c < cl; c++ ) { + if ( !~setClass.indexOf( " " + classNames[ c ] + " " ) ) { + setClass += classNames[ c ] + " "; + } + } + elem.className = jQuery.trim( setClass ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classNames, i, l, elem, className, c, cl; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( j ) { + jQuery( this ).removeClass( value.call(this, j, this.className) ); + }); + } + + if ( (value && typeof value === "string") || value === undefined ) { + classNames = ( value || "" ).split( rspace ); + + for ( i = 0, l = this.length; i < l; i++ ) { + elem = this[ i ]; + + if ( elem.nodeType === 1 && elem.className ) { + if ( value ) { + className = (" " + elem.className + " ").replace( rclass, " " ); + for ( c = 0, cl = classNames.length; c < cl; c++ ) { + className = className.replace(" " + classNames[ c ] + " ", " "); + } + elem.className = jQuery.trim( className ); + + } else { + elem.className = ""; + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isBool = typeof stateVal === "boolean"; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( i ) { + jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal ); + }); + } + + return this.each(function() { + if ( type === "string" ) { + // toggle individual class names + var className, + i = 0, + self = jQuery( this ), + state = stateVal, + classNames = value.split( rspace ); + + while ( (className = classNames[ i++ ]) ) { + // check each className given, space seperated list + state = isBool ? state : !self.hasClass( className ); + self[ state ? "addClass" : "removeClass" ]( className ); + } + + } else if ( type === "undefined" || type === "boolean" ) { + if ( this.className ) { + // store className if set + jQuery._data( this, "__className__", this.className ); + } + + // toggle whole className + this.className = this.className || value === false ? "" : jQuery._data( this, "__className__" ) || ""; + } + }); + }, + + hasClass: function( selector ) { + var className = " " + selector + " ", + i = 0, + l = this.length; + for ( ; i < l; i++ ) { + if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) > -1 ) { + return true; + } + } + + return false; + }, + + val: function( value ) { + var hooks, ret, isFunction, + elem = this[0]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) { + return ret; + } + + ret = elem.value; + + return typeof ret === "string" ? + // handle most common string cases + ret.replace(rreturn, "") : + // handle cases where value is null/undef or number + ret == null ? "" : ret; + } + + return; + } + + isFunction = jQuery.isFunction( value ); + + return this.each(function( i ) { + var self = jQuery(this), val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( isFunction ) { + val = value.call( this, i, self.val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + } else if ( typeof val === "number" ) { + val += ""; + } else if ( jQuery.isArray( val ) ) { + val = jQuery.map(val, function ( value ) { + return value == null ? "" : value + ""; + }); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + }); + } +}); + +jQuery.extend({ + valHooks: { + option: { + get: function( elem ) { + // attributes.value is undefined in Blackberry 4.7 but + // uses .value. See #6932 + var val = elem.attributes.value; + return !val || val.specified ? elem.value : elem.text; + } + }, + select: { + get: function( elem ) { + var value, i, max, option, + index = elem.selectedIndex, + values = [], + options = elem.options, + one = elem.type === "select-one"; + + // Nothing was selected + if ( index < 0 ) { + return null; + } + + // Loop through all the selected options + i = one ? index : 0; + max = one ? index + 1 : options.length; + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Don't return options that are disabled or in a disabled optgroup + if ( option.selected && (jQuery.support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null) && + (!option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" )) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + // Fixes Bug #2551 -- select.val() broken in IE after form.reset() + if ( one && !values.length && options.length ) { + return jQuery( options[ index ] ).val(); + } + + return values; + }, + + set: function( elem, value ) { + var values = jQuery.makeArray( value ); + + jQuery(elem).find("option").each(function() { + this.selected = jQuery.inArray( jQuery(this).val(), values ) >= 0; + }); + + if ( !values.length ) { + elem.selectedIndex = -1; + } + return values; + } + } + }, + + attrFn: { + val: true, + css: true, + html: true, + text: true, + data: true, + width: true, + height: true, + offset: true + }, + + attr: function( elem, name, value, pass ) { + var ret, hooks, notxml, + nType = elem.nodeType; + + // don't get/set attributes on text, comment and attribute nodes + if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( pass && name in jQuery.attrFn ) { + return jQuery( elem )[ name ]( value ); + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); + + // All attributes are lowercase + // Grab necessary hook if one is defined + if ( notxml ) { + name = name.toLowerCase(); + hooks = jQuery.attrHooks[ name ] || ( rboolean.test( name ) ? boolHook : nodeHook ); + } + + if ( value !== undefined ) { + + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + + } else if ( hooks && "set" in hooks && notxml && (ret = hooks.set( elem, value, name )) !== undefined ) { + return ret; + + } else { + elem.setAttribute( name, "" + value ); + return value; + } + + } else if ( hooks && "get" in hooks && notxml && (ret = hooks.get( elem, name )) !== null ) { + return ret; + + } else { + + ret = elem.getAttribute( name ); + + // Non-existent attributes return null, we normalize to undefined + return ret === null ? + undefined : + ret; + } + }, + + removeAttr: function( elem, value ) { + var propName, attrNames, name, l, isBool, + i = 0; + + if ( value && elem.nodeType === 1 ) { + attrNames = value.toLowerCase().split( rspace ); + l = attrNames.length; + + for ( ; i < l; i++ ) { + name = attrNames[ i ]; + + if ( name ) { + propName = jQuery.propFix[ name ] || name; + isBool = rboolean.test( name ); + + // See #9699 for explanation of this approach (setting first, then removal) + // Do not do this for boolean attributes (see #10870) + if ( !isBool ) { + jQuery.attr( elem, name, "" ); + } + elem.removeAttribute( getSetAttribute ? name : propName ); + + // Set corresponding property to false for boolean attributes + if ( isBool && propName in elem ) { + elem[ propName ] = false; + } + } + } + } + }, + + attrHooks: { + type: { + set: function( elem, value ) { + // We can't allow the type property to be changed (since it causes problems in IE) + if ( rtype.test( elem.nodeName ) && elem.parentNode ) { + jQuery.error( "type property can't be changed" ); + } else if ( !jQuery.support.radioValue && value === "radio" && jQuery.nodeName(elem, "input") ) { + // Setting the type on a radio button after the value resets the value in IE6-9 + // Reset value to it's default in case type is set after value + // This is for element creation + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + }, + // Use the value property for back compat + // Use the nodeHook for button elements in IE6/7 (#1954) + value: { + get: function( elem, name ) { + if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { + return nodeHook.get( elem, name ); + } + return name in elem ? + elem.value : + null; + }, + set: function( elem, value, name ) { + if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { + return nodeHook.set( elem, value, name ); + } + // Does not return so that setAttribute is also used + elem.value = value; + } + } + }, + + propFix: { + tabindex: "tabIndex", + readonly: "readOnly", + "for": "htmlFor", + "class": "className", + maxlength: "maxLength", + cellspacing: "cellSpacing", + cellpadding: "cellPadding", + rowspan: "rowSpan", + colspan: "colSpan", + usemap: "useMap", + frameborder: "frameBorder", + contenteditable: "contentEditable" + }, + + prop: function( elem, name, value ) { + var ret, hooks, notxml, + nType = elem.nodeType; + + // don't get/set properties on text, comment and attribute nodes + if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); + + if ( notxml ) { + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) { + return ret; + + } else { + return ( elem[ name ] = value ); + } + + } else { + if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) { + return ret; + + } else { + return elem[ name ]; + } + } + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + // elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set + // http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + var attributeNode = elem.getAttributeNode("tabindex"); + + return attributeNode && attributeNode.specified ? + parseInt( attributeNode.value, 10 ) : + rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ? + 0 : + undefined; + } + } + } +}); + +// Add the tabIndex propHook to attrHooks for back-compat (different case is intentional) +jQuery.attrHooks.tabindex = jQuery.propHooks.tabIndex; + +// Hook for boolean attributes +boolHook = { + get: function( elem, name ) { + // Align boolean attributes with corresponding properties + // Fall back to attribute presence where some booleans are not supported + var attrNode, + property = jQuery.prop( elem, name ); + return property === true || typeof property !== "boolean" && ( attrNode = elem.getAttributeNode(name) ) && attrNode.nodeValue !== false ? + name.toLowerCase() : + undefined; + }, + set: function( elem, value, name ) { + var propName; + if ( value === false ) { + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + // value is true since we know at this point it's type boolean and not false + // Set boolean attributes to the same name and set the DOM property + propName = jQuery.propFix[ name ] || name; + if ( propName in elem ) { + // Only set the IDL specifically if it already exists on the element + elem[ propName ] = true; + } + + elem.setAttribute( name, name.toLowerCase() ); + } + return name; + } +}; + +// IE6/7 do not support getting/setting some attributes with get/setAttribute +if ( !getSetAttribute ) { + + fixSpecified = { + name: true, + id: true, + coords: true + }; + + // Use this for any attribute in IE6/7 + // This fixes almost every IE6/7 issue + nodeHook = jQuery.valHooks.button = { + get: function( elem, name ) { + var ret; + ret = elem.getAttributeNode( name ); + return ret && ( fixSpecified[ name ] ? ret.nodeValue !== "" : ret.specified ) ? + ret.nodeValue : + undefined; + }, + set: function( elem, value, name ) { + // Set the existing or create a new attribute node + var ret = elem.getAttributeNode( name ); + if ( !ret ) { + ret = document.createAttribute( name ); + elem.setAttributeNode( ret ); + } + return ( ret.nodeValue = value + "" ); + } + }; + + // Apply the nodeHook to tabindex + jQuery.attrHooks.tabindex.set = nodeHook.set; + + // Set width and height to auto instead of 0 on empty string( Bug #8150 ) + // This is for removals + jQuery.each([ "width", "height" ], function( i, name ) { + jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { + set: function( elem, value ) { + if ( value === "" ) { + elem.setAttribute( name, "auto" ); + return value; + } + } + }); + }); + + // Set contenteditable to false on removals(#10429) + // Setting to empty string throws an error as an invalid value + jQuery.attrHooks.contenteditable = { + get: nodeHook.get, + set: function( elem, value, name ) { + if ( value === "" ) { + value = "false"; + } + nodeHook.set( elem, value, name ); + } + }; +} + + +// Some attributes require a special call on IE +if ( !jQuery.support.hrefNormalized ) { + jQuery.each([ "href", "src", "width", "height" ], function( i, name ) { + jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { + get: function( elem ) { + var ret = elem.getAttribute( name, 2 ); + return ret === null ? undefined : ret; + } + }); + }); +} + +if ( !jQuery.support.style ) { + jQuery.attrHooks.style = { + get: function( elem ) { + // Return undefined in the case of empty string + // Normalize to lowercase since IE uppercases css property names + return elem.style.cssText.toLowerCase() || undefined; + }, + set: function( elem, value ) { + return ( elem.style.cssText = "" + value ); + } + }; +} + +// Safari mis-reports the default selected property of an option +// Accessing the parent's selectedIndex property fixes it +if ( !jQuery.support.optSelected ) { + jQuery.propHooks.selected = jQuery.extend( jQuery.propHooks.selected, { + get: function( elem ) { + var parent = elem.parentNode; + + if ( parent ) { + parent.selectedIndex; + + // Make sure that it also works with optgroups, see #5701 + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + return null; + } + }); +} + +// IE6/7 call enctype encoding +if ( !jQuery.support.enctype ) { + jQuery.propFix.enctype = "encoding"; +} + +// Radios and checkboxes getter/setter +if ( !jQuery.support.checkOn ) { + jQuery.each([ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + get: function( elem ) { + // Handle the case where in Webkit "" is returned instead of "on" if a value isn't specified + return elem.getAttribute("value") === null ? "on" : elem.value; + } + }; + }); +} +jQuery.each([ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = jQuery.extend( jQuery.valHooks[ this ], { + set: function( elem, value ) { + if ( jQuery.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0 ); + } + } + }); +}); + + + + +var rformElems = /^(?:textarea|input|select)$/i, + rtypenamespace = /^([^\.]*)?(?:\.(.+))?$/, + rhoverHack = /(?:^|\s)hover(\.\S+)?\b/, + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|contextmenu)|click/, + rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + rquickIs = /^(\w*)(?:#([\w\-]+))?(?:\.([\w\-]+))?$/, + quickParse = function( selector ) { + var quick = rquickIs.exec( selector ); + if ( quick ) { + // 0 1 2 3 + // [ _, tag, id, class ] + quick[1] = ( quick[1] || "" ).toLowerCase(); + quick[3] = quick[3] && new RegExp( "(?:^|\\s)" + quick[3] + "(?:\\s|$)" ); + } + return quick; + }, + quickIs = function( elem, m ) { + var attrs = elem.attributes || {}; + return ( + (!m[1] || elem.nodeName.toLowerCase() === m[1]) && + (!m[2] || (attrs.id || {}).value === m[2]) && + (!m[3] || m[3].test( (attrs[ "class" ] || {}).value )) + ); + }, + hoverHack = function( events ) { + return jQuery.event.special.hover ? events : events.replace( rhoverHack, "mouseenter$1 mouseleave$1" ); + }; + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + add: function( elem, types, handler, data, selector ) { + + var elemData, eventHandle, events, + t, tns, type, namespaces, handleObj, + handleObjIn, quick, handlers, special; + + // Don't attach events to noData or text/comment nodes (allow plain objects tho) + if ( elem.nodeType === 3 || elem.nodeType === 8 || !types || !handler || !(elemData = jQuery._data( elem )) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + events = elemData.events; + if ( !events ) { + elemData.events = events = {}; + } + eventHandle = elemData.handle; + if ( !eventHandle ) { + elemData.handle = eventHandle = function( e ) { + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && (!e || jQuery.event.triggered !== e.type) ? + jQuery.event.dispatch.apply( eventHandle.elem, arguments ) : + undefined; + }; + // Add elem as a property of the handle fn to prevent a memory leak with IE non-native events + eventHandle.elem = elem; + } + + // Handle multiple events separated by a space + // jQuery(...).bind("mouseover mouseout", fn); + types = jQuery.trim( hoverHack(types) ).split( " " ); + for ( t = 0; t < types.length; t++ ) { + + tns = rtypenamespace.exec( types[t] ) || []; + type = tns[1]; + namespaces = ( tns[2] || "" ).split( "." ).sort(); + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend({ + type: type, + origType: tns[1], + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + quick: selector && quickParse( selector ), + namespace: namespaces.join(".") + }, handleObjIn ); + + // Init the event handler queue if we're the first + handlers = events[ type ]; + if ( !handlers ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener/attachEvent if the special events handler returns false + if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + // Bind the global event handler to the element + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle, false ); + + } else if ( elem.attachEvent ) { + elem.attachEvent( "on" + type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + // Nullify elem to prevent memory leaks in IE + elem = null; + }, + + global: {}, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var elemData = jQuery.hasData( elem ) && jQuery._data( elem ), + t, tns, type, origType, namespaces, origCount, + j, events, special, handle, eventType, handleObj; + + if ( !elemData || !(events = elemData.events) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = jQuery.trim( hoverHack( types || "" ) ).split(" "); + for ( t = 0; t < types.length; t++ ) { + tns = rtypenamespace.exec( types[t] ) || []; + type = origType = tns[1]; + namespaces = tns[2]; + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector? special.delegateType : special.bindType ) || type; + eventType = events[ type ] || []; + origCount = eventType.length; + namespaces = namespaces ? new RegExp("(^|\\.)" + namespaces.split(".").sort().join("\\.(?:.*\\.)?") + "(\\.|$)") : null; + + // Remove matching events + for ( j = 0; j < eventType.length; j++ ) { + handleObj = eventType[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !namespaces || namespaces.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) { + eventType.splice( j--, 1 ); + + if ( handleObj.selector ) { + eventType.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( eventType.length === 0 && origCount !== eventType.length ) { + if ( !special.teardown || special.teardown.call( elem, namespaces ) === false ) { + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + handle = elemData.handle; + if ( handle ) { + handle.elem = null; + } + + // removeData also checks for emptiness and clears the expando if empty + // so use it instead of delete + jQuery.removeData( elem, [ "events", "handle" ], true ); + } + }, + + // Events that are safe to short-circuit if no handlers are attached. + // Native DOM events should not be added, they may have inline handlers. + customEvent: { + "getData": true, + "setData": true, + "changeData": true + }, + + trigger: function( event, data, elem, onlyHandlers ) { + // Don't do events on text and comment nodes + if ( elem && (elem.nodeType === 3 || elem.nodeType === 8) ) { + return; + } + + // Event object or event type + var type = event.type || event, + namespaces = [], + cache, exclusive, i, cur, old, ontype, special, handle, eventPath, bubbleType; + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "!" ) >= 0 ) { + // Exclusive events trigger only for the exact event (no namespaces) + type = type.slice(0, -1); + exclusive = true; + } + + if ( type.indexOf( "." ) >= 0 ) { + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split("."); + type = namespaces.shift(); + namespaces.sort(); + } + + if ( (!elem || jQuery.event.customEvent[ type ]) && !jQuery.event.global[ type ] ) { + // No jQuery handlers for this event type, and it can't have inline handlers + return; + } + + // Caller can pass in an Event, Object, or just an event type string + event = typeof event === "object" ? + // jQuery.Event object + event[ jQuery.expando ] ? event : + // Object literal + new jQuery.Event( type, event ) : + // Just the event type (string) + new jQuery.Event( type ); + + event.type = type; + event.isTrigger = true; + event.exclusive = exclusive; + event.namespace = namespaces.join( "." ); + event.namespace_re = event.namespace? new RegExp("(^|\\.)" + namespaces.join("\\.(?:.*\\.)?") + "(\\.|$)") : null; + ontype = type.indexOf( ":" ) < 0 ? "on" + type : ""; + + // Handle a global trigger + if ( !elem ) { + + // TODO: Stop taunting the data cache; remove global events and always attach to document + cache = jQuery.cache; + for ( i in cache ) { + if ( cache[ i ].events && cache[ i ].events[ type ] ) { + jQuery.event.trigger( event, data, cache[ i ].handle.elem, true ); + } + } + return; + } + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data != null ? jQuery.makeArray( data ) : []; + data.unshift( event ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + eventPath = [[ elem, special.bindType || type ]]; + if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + cur = rfocusMorph.test( bubbleType + type ) ? elem : elem.parentNode; + old = null; + for ( ; cur; cur = cur.parentNode ) { + eventPath.push([ cur, bubbleType ]); + old = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( old && old === elem.ownerDocument ) { + eventPath.push([ old.defaultView || old.parentWindow || window, bubbleType ]); + } + } + + // Fire handlers on the event path + for ( i = 0; i < eventPath.length && !event.isPropagationStopped(); i++ ) { + + cur = eventPath[i][0]; + event.type = eventPath[i][1]; + + handle = ( jQuery._data( cur, "events" ) || {} )[ event.type ] && jQuery._data( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + // Note that this is a bare JS function and not a jQuery handler + handle = ontype && cur[ ontype ]; + if ( handle && jQuery.acceptData( cur ) && handle.apply( cur, data ) === false ) { + event.preventDefault(); + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( (!special._default || special._default.apply( elem.ownerDocument, data ) === false) && + !(type === "click" && jQuery.nodeName( elem, "a" )) && jQuery.acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name name as the event. + // Can't use an .isFunction() check here because IE6/7 fails that test. + // Don't do default actions on window, that's where global variables be (#6170) + // IE<9 dies on focus/blur to hidden element (#1486) + if ( ontype && elem[ type ] && ((type !== "focus" && type !== "blur") || event.target.offsetWidth !== 0) && !jQuery.isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + old = elem[ ontype ]; + + if ( old ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + elem[ type ](); + jQuery.event.triggered = undefined; + + if ( old ) { + elem[ ontype ] = old; + } + } + } + } + + return event.result; + }, + + dispatch: function( event ) { + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( event || window.event ); + + var handlers = ( (jQuery._data( this, "events" ) || {} )[ event.type ] || []), + delegateCount = handlers.delegateCount, + args = [].slice.call( arguments, 0 ), + run_all = !event.exclusive && !event.namespace, + special = jQuery.event.special[ event.type ] || {}, + handlerQueue = [], + i, j, cur, jqcur, ret, selMatch, matched, matches, handleObj, sel, related; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[0] = event; + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers that should run if there are delegated events + // Avoid non-left-click bubbling in Firefox (#3861) + if ( delegateCount && !(event.button && event.type === "click") ) { + + // Pregenerate a single jQuery object for reuse with .is() + jqcur = jQuery(this); + jqcur.context = this.ownerDocument || this; + + for ( cur = event.target; cur != this; cur = cur.parentNode || this ) { + + // Don't process events on disabled elements (#6911, #8165) + if ( cur.disabled !== true ) { + selMatch = {}; + matches = []; + jqcur[0] = cur; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + sel = handleObj.selector; + + if ( selMatch[ sel ] === undefined ) { + selMatch[ sel ] = ( + handleObj.quick ? quickIs( cur, handleObj.quick ) : jqcur.is( sel ) + ); + } + if ( selMatch[ sel ] ) { + matches.push( handleObj ); + } + } + if ( matches.length ) { + handlerQueue.push({ elem: cur, matches: matches }); + } + } + } + } + + // Add the remaining (directly-bound) handlers + if ( handlers.length > delegateCount ) { + handlerQueue.push({ elem: this, matches: handlers.slice( delegateCount ) }); + } + + // Run delegates first; they may want to stop propagation beneath us + for ( i = 0; i < handlerQueue.length && !event.isPropagationStopped(); i++ ) { + matched = handlerQueue[ i ]; + event.currentTarget = matched.elem; + + for ( j = 0; j < matched.matches.length && !event.isImmediatePropagationStopped(); j++ ) { + handleObj = matched.matches[ j ]; + + // Triggered event must either 1) be non-exclusive and have no namespace, or + // 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace). + if ( run_all || (!event.namespace && !handleObj.namespace) || event.namespace_re && event.namespace_re.test( handleObj.namespace ) ) { + + event.data = handleObj.data; + event.handleObj = handleObj; + + ret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler ) + .apply( matched.elem, args ); + + if ( ret !== undefined ) { + event.result = ret; + if ( ret === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + // Includes some event props shared by KeyEvent and MouseEvent + // *** attrChange attrName relatedNode srcElement are not normalized, non-W3C, deprecated, will be removed in 1.8 *** + props: "attrChange attrName relatedNode srcElement altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "), + + fixHooks: {}, + + keyHooks: { + props: "char charCode key keyCode".split(" "), + filter: function( event, original ) { + + // Add which for key events + if ( event.which == null ) { + event.which = original.charCode != null ? original.charCode : original.keyCode; + } + + return event; + } + }, + + mouseHooks: { + props: "button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "), + filter: function( event, original ) { + var eventDoc, doc, body, + button = original.button, + fromElement = original.fromElement; + + // Calculate pageX/Y if missing and clientX/Y available + if ( event.pageX == null && original.clientX != null ) { + eventDoc = event.target.ownerDocument || document; + doc = eventDoc.documentElement; + body = eventDoc.body; + + event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 ); + event.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 ) - ( doc && doc.clientTop || body && body.clientTop || 0 ); + } + + // Add relatedTarget, if necessary + if ( !event.relatedTarget && fromElement ) { + event.relatedTarget = fromElement === event.target ? original.toElement : fromElement; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + // Note: button is not normalized, so don't use it + if ( !event.which && button !== undefined ) { + event.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) ); + } + + return event; + } + }, + + fix: function( event ) { + if ( event[ jQuery.expando ] ) { + return event; + } + + // Create a writable copy of the event object and normalize some properties + var i, prop, + originalEvent = event, + fixHook = jQuery.event.fixHooks[ event.type ] || {}, + copy = fixHook.props ? this.props.concat( fixHook.props ) : this.props; + + event = jQuery.Event( originalEvent ); + + for ( i = copy.length; i; ) { + prop = copy[ --i ]; + event[ prop ] = originalEvent[ prop ]; + } + + // Fix target property, if necessary (#1925, IE 6/7/8 & Safari2) + if ( !event.target ) { + event.target = originalEvent.srcElement || document; + } + + // Target should not be a text node (#504, Safari) + if ( event.target.nodeType === 3 ) { + event.target = event.target.parentNode; + } + + // For mouse/key events; add metaKey if it's not there (#3368, IE6/7/8) + if ( event.metaKey === undefined ) { + event.metaKey = event.ctrlKey; + } + + return fixHook.filter? fixHook.filter( event, originalEvent ) : event; + }, + + special: { + ready: { + // Make sure the ready event is setup + setup: jQuery.bindReady + }, + + load: { + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + + focus: { + delegateType: "focusin" + }, + blur: { + delegateType: "focusout" + }, + + beforeunload: { + setup: function( data, namespaces, eventHandle ) { + // We only want to do this special case on windows + if ( jQuery.isWindow( this ) ) { + this.onbeforeunload = eventHandle; + } + }, + + teardown: function( namespaces, eventHandle ) { + if ( this.onbeforeunload === eventHandle ) { + this.onbeforeunload = null; + } + } + } + }, + + simulate: function( type, elem, event, bubble ) { + // Piggyback on a donor event to simulate a different one. + // Fake originalEvent to avoid donor's stopPropagation, but if the + // simulated event prevents default then we do the same on the donor. + var e = jQuery.extend( + new jQuery.Event(), + event, + { type: type, + isSimulated: true, + originalEvent: {} + } + ); + if ( bubble ) { + jQuery.event.trigger( e, null, elem ); + } else { + jQuery.event.dispatch.call( elem, e ); + } + if ( e.isDefaultPrevented() ) { + event.preventDefault(); + } + } +}; + +// Some plugins are using, but it's undocumented/deprecated and will be removed. +// The 1.7 special event interface should provide all the hooks needed now. +jQuery.event.handle = jQuery.event.dispatch; + +jQuery.removeEvent = document.removeEventListener ? + function( elem, type, handle ) { + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle, false ); + } + } : + function( elem, type, handle ) { + if ( elem.detachEvent ) { + elem.detachEvent( "on" + type, handle ); + } + }; + +jQuery.Event = function( src, props ) { + // Allow instantiation without the 'new' keyword + if ( !(this instanceof jQuery.Event) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = ( src.defaultPrevented || src.returnValue === false || + src.getPreventDefault && src.getPreventDefault() ) ? returnTrue : returnFalse; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || jQuery.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +function returnFalse() { + return false; +} +function returnTrue() { + return true; +} + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + preventDefault: function() { + this.isDefaultPrevented = returnTrue; + + var e = this.originalEvent; + if ( !e ) { + return; + } + + // if preventDefault exists run it on the original event + if ( e.preventDefault ) { + e.preventDefault(); + + // otherwise set the returnValue property of the original event to false (IE) + } else { + e.returnValue = false; + } + }, + stopPropagation: function() { + this.isPropagationStopped = returnTrue; + + var e = this.originalEvent; + if ( !e ) { + return; + } + // if stopPropagation exists run it on the original event + if ( e.stopPropagation ) { + e.stopPropagation(); + } + // otherwise set the cancelBubble property of the original event to true (IE) + e.cancelBubble = true; + }, + stopImmediatePropagation: function() { + this.isImmediatePropagationStopped = returnTrue; + this.stopPropagation(); + }, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse +}; + +// Create mouseenter/leave events using mouseover/out and event-time checks +jQuery.each({ + mouseenter: "mouseover", + mouseleave: "mouseout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var target = this, + related = event.relatedTarget, + handleObj = event.handleObj, + selector = handleObj.selector, + ret; + + // For mousenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || (related !== target && !jQuery.contains( target, related )) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +}); + +// IE submit delegation +if ( !jQuery.support.submitBubbles ) { + + jQuery.event.special.submit = { + setup: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Lazy-add a submit handler when a descendant form may potentially be submitted + jQuery.event.add( this, "click._submit keypress._submit", function( e ) { + // Node name check avoids a VML-related crash in IE (#9807) + var elem = e.target, + form = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.form : undefined; + if ( form && !form._submit_attached ) { + jQuery.event.add( form, "submit._submit", function( event ) { + event._submit_bubble = true; + }); + form._submit_attached = true; + } + }); + // return undefined since we don't need an event listener + }, + + postDispatch: function( event ) { + // If form was submitted by the user, bubble the event up the tree + if ( event._submit_bubble ) { + delete event._submit_bubble; + if ( this.parentNode && !event.isTrigger ) { + jQuery.event.simulate( "submit", this.parentNode, event, true ); + } + } + }, + + teardown: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Remove delegated handlers; cleanData eventually reaps submit handlers attached above + jQuery.event.remove( this, "._submit" ); + } + }; +} + +// IE change delegation and checkbox/radio fix +if ( !jQuery.support.changeBubbles ) { + + jQuery.event.special.change = { + + setup: function() { + + if ( rformElems.test( this.nodeName ) ) { + // IE doesn't fire change on a check/radio until blur; trigger it on click + // after a propertychange. Eat the blur-change in special.change.handle. + // This still fires onchange a second time for check/radio after blur. + if ( this.type === "checkbox" || this.type === "radio" ) { + jQuery.event.add( this, "propertychange._change", function( event ) { + if ( event.originalEvent.propertyName === "checked" ) { + this._just_changed = true; + } + }); + jQuery.event.add( this, "click._change", function( event ) { + if ( this._just_changed && !event.isTrigger ) { + this._just_changed = false; + jQuery.event.simulate( "change", this, event, true ); + } + }); + } + return false; + } + // Delegated event; lazy-add a change handler on descendant inputs + jQuery.event.add( this, "beforeactivate._change", function( e ) { + var elem = e.target; + + if ( rformElems.test( elem.nodeName ) && !elem._change_attached ) { + jQuery.event.add( elem, "change._change", function( event ) { + if ( this.parentNode && !event.isSimulated && !event.isTrigger ) { + jQuery.event.simulate( "change", this.parentNode, event, true ); + } + }); + elem._change_attached = true; + } + }); + }, + + handle: function( event ) { + var elem = event.target; + + // Swallow native change events from checkbox/radio, we already triggered them above + if ( this !== elem || event.isSimulated || event.isTrigger || (elem.type !== "radio" && elem.type !== "checkbox") ) { + return event.handleObj.handler.apply( this, arguments ); + } + }, + + teardown: function() { + jQuery.event.remove( this, "._change" ); + + return rformElems.test( this.nodeName ); + } + }; +} + +// Create "bubbling" focus and blur events +if ( !jQuery.support.focusinBubbles ) { + jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler while someone wants focusin/focusout + var attaches = 0, + handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + if ( attaches++ === 0 ) { + document.addEventListener( orig, handler, true ); + } + }, + teardown: function() { + if ( --attaches === 0 ) { + document.removeEventListener( orig, handler, true ); + } + } + }; + }); +} + +jQuery.fn.extend({ + + on: function( types, selector, data, fn, /*INTERNAL*/ one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { // && selector != null + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + this.on( type, selector, data, types[ type ], one ); + } + return this; + } + + if ( data == null && fn == null ) { + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return this; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return this.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + }); + }, + one: function( types, selector, data, fn ) { + return this.on( types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + if ( types && types.preventDefault && types.handleObj ) { + // ( event ) dispatched jQuery.Event + var handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + // ( types-object [, selector] ) + for ( var type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each(function() { + jQuery.event.remove( this, types, fn, selector ); + }); + }, + + bind: function( types, data, fn ) { + return this.on( types, null, data, fn ); + }, + unbind: function( types, fn ) { + return this.off( types, null, fn ); + }, + + live: function( types, data, fn ) { + jQuery( this.context ).on( types, this.selector, data, fn ); + return this; + }, + die: function( types, fn ) { + jQuery( this.context ).off( types, this.selector || "**", fn ); + return this; + }, + + delegate: function( selector, types, data, fn ) { + return this.on( types, selector, data, fn ); + }, + undelegate: function( selector, types, fn ) { + // ( namespace ) or ( selector, types [, fn] ) + return arguments.length == 1? this.off( selector, "**" ) : this.off( types, selector, fn ); + }, + + trigger: function( type, data ) { + return this.each(function() { + jQuery.event.trigger( type, data, this ); + }); + }, + triggerHandler: function( type, data ) { + if ( this[0] ) { + return jQuery.event.trigger( type, data, this[0], true ); + } + }, + + toggle: function( fn ) { + // Save reference to arguments for access in closure + var args = arguments, + guid = fn.guid || jQuery.guid++, + i = 0, + toggler = function( event ) { + // Figure out which function to execute + var lastToggle = ( jQuery._data( this, "lastToggle" + fn.guid ) || 0 ) % i; + jQuery._data( this, "lastToggle" + fn.guid, lastToggle + 1 ); + + // Make sure that clicks stop + event.preventDefault(); + + // and execute the function + return args[ lastToggle ].apply( this, arguments ) || false; + }; + + // link all the functions, so any of them can unbind this click handler + toggler.guid = guid; + while ( i < args.length ) { + args[ i++ ].guid = guid; + } + + return this.click( toggler ); + }, + + hover: function( fnOver, fnOut ) { + return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); + } +}); + +jQuery.each( ("blur focus focusin focusout load resize scroll unload click dblclick " + + "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + + "change select submit keydown keypress keyup error contextmenu").split(" "), function( i, name ) { + + // Handle event binding + jQuery.fn[ name ] = function( data, fn ) { + if ( fn == null ) { + fn = data; + data = null; + } + + return arguments.length > 0 ? + this.on( name, null, data, fn ) : + this.trigger( name ); + }; + + if ( jQuery.attrFn ) { + jQuery.attrFn[ name ] = true; + } + + if ( rkeyEvent.test( name ) ) { + jQuery.event.fixHooks[ name ] = jQuery.event.keyHooks; + } + + if ( rmouseEvent.test( name ) ) { + jQuery.event.fixHooks[ name ] = jQuery.event.mouseHooks; + } +}); + + + +/*! + * Sizzle CSS Selector Engine + * Copyright 2011, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * More information: http://sizzlejs.com/ + */ +(function(){ + +var chunker = /((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^\[\]]*\]|['"][^'"]*['"]|[^\[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, + expando = "sizcache" + (Math.random() + '').replace('.', ''), + done = 0, + toString = Object.prototype.toString, + hasDuplicate = false, + baseHasDuplicate = true, + rBackslash = /\\/g, + rReturn = /\r\n/g, + rNonWord = /\W/; + +// Here we check if the JavaScript engine is using some sort of +// optimization where it does not always call our comparision +// function. If that is the case, discard the hasDuplicate value. +// Thus far that includes Google Chrome. +[0, 0].sort(function() { + baseHasDuplicate = false; + return 0; +}); + +var Sizzle = function( selector, context, results, seed ) { + results = results || []; + context = context || document; + + var origContext = context; + + if ( context.nodeType !== 1 && context.nodeType !== 9 ) { + return []; + } + + if ( !selector || typeof selector !== "string" ) { + return results; + } + + var m, set, checkSet, extra, ret, cur, pop, i, + prune = true, + contextXML = Sizzle.isXML( context ), + parts = [], + soFar = selector; + + // Reset the position of the chunker regexp (start from head) + do { + chunker.exec( "" ); + m = chunker.exec( soFar ); + + if ( m ) { + soFar = m[3]; + + parts.push( m[1] ); + + if ( m[2] ) { + extra = m[3]; + break; + } + } + } while ( m ); + + if ( parts.length > 1 && origPOS.exec( selector ) ) { + + if ( parts.length === 2 && Expr.relative[ parts[0] ] ) { + set = posProcess( parts[0] + parts[1], context, seed ); + + } else { + set = Expr.relative[ parts[0] ] ? + [ context ] : + Sizzle( parts.shift(), context ); + + while ( parts.length ) { + selector = parts.shift(); + + if ( Expr.relative[ selector ] ) { + selector += parts.shift(); + } + + set = posProcess( selector, set, seed ); + } + } + + } else { + // Take a shortcut and set the context if the root selector is an ID + // (but not if it'll be faster if the inner selector is an ID) + if ( !seed && parts.length > 1 && context.nodeType === 9 && !contextXML && + Expr.match.ID.test(parts[0]) && !Expr.match.ID.test(parts[parts.length - 1]) ) { + + ret = Sizzle.find( parts.shift(), context, contextXML ); + context = ret.expr ? + Sizzle.filter( ret.expr, ret.set )[0] : + ret.set[0]; + } + + if ( context ) { + ret = seed ? + { expr: parts.pop(), set: makeArray(seed) } : + Sizzle.find( parts.pop(), parts.length === 1 && (parts[0] === "~" || parts[0] === "+") && context.parentNode ? context.parentNode : context, contextXML ); + + set = ret.expr ? + Sizzle.filter( ret.expr, ret.set ) : + ret.set; + + if ( parts.length > 0 ) { + checkSet = makeArray( set ); + + } else { + prune = false; + } + + while ( parts.length ) { + cur = parts.pop(); + pop = cur; + + if ( !Expr.relative[ cur ] ) { + cur = ""; + } else { + pop = parts.pop(); + } + + if ( pop == null ) { + pop = context; + } + + Expr.relative[ cur ]( checkSet, pop, contextXML ); + } + + } else { + checkSet = parts = []; + } + } + + if ( !checkSet ) { + checkSet = set; + } + + if ( !checkSet ) { + Sizzle.error( cur || selector ); + } + + if ( toString.call(checkSet) === "[object Array]" ) { + if ( !prune ) { + results.push.apply( results, checkSet ); + + } else if ( context && context.nodeType === 1 ) { + for ( i = 0; checkSet[i] != null; i++ ) { + if ( checkSet[i] && (checkSet[i] === true || checkSet[i].nodeType === 1 && Sizzle.contains(context, checkSet[i])) ) { + results.push( set[i] ); + } + } + + } else { + for ( i = 0; checkSet[i] != null; i++ ) { + if ( checkSet[i] && checkSet[i].nodeType === 1 ) { + results.push( set[i] ); + } + } + } + + } else { + makeArray( checkSet, results ); + } + + if ( extra ) { + Sizzle( extra, origContext, results, seed ); + Sizzle.uniqueSort( results ); + } + + return results; +}; + +Sizzle.uniqueSort = function( results ) { + if ( sortOrder ) { + hasDuplicate = baseHasDuplicate; + results.sort( sortOrder ); + + if ( hasDuplicate ) { + for ( var i = 1; i < results.length; i++ ) { + if ( results[i] === results[ i - 1 ] ) { + results.splice( i--, 1 ); + } + } + } + } + + return results; +}; + +Sizzle.matches = function( expr, set ) { + return Sizzle( expr, null, null, set ); +}; + +Sizzle.matchesSelector = function( node, expr ) { + return Sizzle( expr, null, null, [node] ).length > 0; +}; + +Sizzle.find = function( expr, context, isXML ) { + var set, i, len, match, type, left; + + if ( !expr ) { + return []; + } + + for ( i = 0, len = Expr.order.length; i < len; i++ ) { + type = Expr.order[i]; + + if ( (match = Expr.leftMatch[ type ].exec( expr )) ) { + left = match[1]; + match.splice( 1, 1 ); + + if ( left.substr( left.length - 1 ) !== "\\" ) { + match[1] = (match[1] || "").replace( rBackslash, "" ); + set = Expr.find[ type ]( match, context, isXML ); + + if ( set != null ) { + expr = expr.replace( Expr.match[ type ], "" ); + break; + } + } + } + } + + if ( !set ) { + set = typeof context.getElementsByTagName !== "undefined" ? + context.getElementsByTagName( "*" ) : + []; + } + + return { set: set, expr: expr }; +}; + +Sizzle.filter = function( expr, set, inplace, not ) { + var match, anyFound, + type, found, item, filter, left, + i, pass, + old = expr, + result = [], + curLoop = set, + isXMLFilter = set && set[0] && Sizzle.isXML( set[0] ); + + while ( expr && set.length ) { + for ( type in Expr.filter ) { + if ( (match = Expr.leftMatch[ type ].exec( expr )) != null && match[2] ) { + filter = Expr.filter[ type ]; + left = match[1]; + + anyFound = false; + + match.splice(1,1); + + if ( left.substr( left.length - 1 ) === "\\" ) { + continue; + } + + if ( curLoop === result ) { + result = []; + } + + if ( Expr.preFilter[ type ] ) { + match = Expr.preFilter[ type ]( match, curLoop, inplace, result, not, isXMLFilter ); + + if ( !match ) { + anyFound = found = true; + + } else if ( match === true ) { + continue; + } + } + + if ( match ) { + for ( i = 0; (item = curLoop[i]) != null; i++ ) { + if ( item ) { + found = filter( item, match, i, curLoop ); + pass = not ^ found; + + if ( inplace && found != null ) { + if ( pass ) { + anyFound = true; + + } else { + curLoop[i] = false; + } + + } else if ( pass ) { + result.push( item ); + anyFound = true; + } + } + } + } + + if ( found !== undefined ) { + if ( !inplace ) { + curLoop = result; + } + + expr = expr.replace( Expr.match[ type ], "" ); + + if ( !anyFound ) { + return []; + } + + break; + } + } + } + + // Improper expression + if ( expr === old ) { + if ( anyFound == null ) { + Sizzle.error( expr ); + + } else { + break; + } + } + + old = expr; + } + + return curLoop; +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Utility function for retreiving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +var getText = Sizzle.getText = function( elem ) { + var i, node, + nodeType = elem.nodeType, + ret = ""; + + if ( nodeType ) { + if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + // Use textContent || innerText for elements + if ( typeof elem.textContent === 'string' ) { + return elem.textContent; + } else if ( typeof elem.innerText === 'string' ) { + // Replace IE's carriage returns + return elem.innerText.replace( rReturn, '' ); + } else { + // Traverse it's children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + } else { + + // If no nodeType, this is expected to be an array + for ( i = 0; (node = elem[i]); i++ ) { + // Do not traverse comment nodes + if ( node.nodeType !== 8 ) { + ret += getText( node ); + } + } + } + return ret; +}; + +var Expr = Sizzle.selectors = { + order: [ "ID", "NAME", "TAG" ], + + match: { + ID: /#((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, + CLASS: /\.((?:[\w\u00c0-\uFFFF\-]|\\.)+)/, + NAME: /\[name=['"]*((?:[\w\u00c0-\uFFFF\-]|\\.)+)['"]*\]/, + ATTR: /\[\s*((?:[\w\u00c0-\uFFFF\-]|\\.)+)\s*(?:(\S?=)\s*(?:(['"])(.*?)\3|(#?(?:[\w\u00c0-\uFFFF\-]|\\.)*)|)|)\s*\]/, + TAG: /^((?:[\w\u00c0-\uFFFF\*\-]|\\.)+)/, + CHILD: /:(only|nth|last|first)-child(?:\(\s*(even|odd|(?:[+\-]?\d+|(?:[+\-]?\d*)?n\s*(?:[+\-]\s*\d+)?))\s*\))?/, + POS: /:(nth|eq|gt|lt|first|last|even|odd)(?:\((\d*)\))?(?=[^\-]|$)/, + PSEUDO: /:((?:[\w\u00c0-\uFFFF\-]|\\.)+)(?:\((['"]?)((?:\([^\)]+\)|[^\(\)]*)+)\2\))?/ + }, + + leftMatch: {}, + + attrMap: { + "class": "className", + "for": "htmlFor" + }, + + attrHandle: { + href: function( elem ) { + return elem.getAttribute( "href" ); + }, + type: function( elem ) { + return elem.getAttribute( "type" ); + } + }, + + relative: { + "+": function(checkSet, part){ + var isPartStr = typeof part === "string", + isTag = isPartStr && !rNonWord.test( part ), + isPartStrNotTag = isPartStr && !isTag; + + if ( isTag ) { + part = part.toLowerCase(); + } + + for ( var i = 0, l = checkSet.length, elem; i < l; i++ ) { + if ( (elem = checkSet[i]) ) { + while ( (elem = elem.previousSibling) && elem.nodeType !== 1 ) {} + + checkSet[i] = isPartStrNotTag || elem && elem.nodeName.toLowerCase() === part ? + elem || false : + elem === part; + } + } + + if ( isPartStrNotTag ) { + Sizzle.filter( part, checkSet, true ); + } + }, + + ">": function( checkSet, part ) { + var elem, + isPartStr = typeof part === "string", + i = 0, + l = checkSet.length; + + if ( isPartStr && !rNonWord.test( part ) ) { + part = part.toLowerCase(); + + for ( ; i < l; i++ ) { + elem = checkSet[i]; + + if ( elem ) { + var parent = elem.parentNode; + checkSet[i] = parent.nodeName.toLowerCase() === part ? parent : false; + } + } + + } else { + for ( ; i < l; i++ ) { + elem = checkSet[i]; + + if ( elem ) { + checkSet[i] = isPartStr ? + elem.parentNode : + elem.parentNode === part; + } + } + + if ( isPartStr ) { + Sizzle.filter( part, checkSet, true ); + } + } + }, + + "": function(checkSet, part, isXML){ + var nodeCheck, + doneName = done++, + checkFn = dirCheck; + + if ( typeof part === "string" && !rNonWord.test( part ) ) { + part = part.toLowerCase(); + nodeCheck = part; + checkFn = dirNodeCheck; + } + + checkFn( "parentNode", part, doneName, checkSet, nodeCheck, isXML ); + }, + + "~": function( checkSet, part, isXML ) { + var nodeCheck, + doneName = done++, + checkFn = dirCheck; + + if ( typeof part === "string" && !rNonWord.test( part ) ) { + part = part.toLowerCase(); + nodeCheck = part; + checkFn = dirNodeCheck; + } + + checkFn( "previousSibling", part, doneName, checkSet, nodeCheck, isXML ); + } + }, + + find: { + ID: function( match, context, isXML ) { + if ( typeof context.getElementById !== "undefined" && !isXML ) { + var m = context.getElementById(match[1]); + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + return m && m.parentNode ? [m] : []; + } + }, + + NAME: function( match, context ) { + if ( typeof context.getElementsByName !== "undefined" ) { + var ret = [], + results = context.getElementsByName( match[1] ); + + for ( var i = 0, l = results.length; i < l; i++ ) { + if ( results[i].getAttribute("name") === match[1] ) { + ret.push( results[i] ); + } + } + + return ret.length === 0 ? null : ret; + } + }, + + TAG: function( match, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( match[1] ); + } + } + }, + preFilter: { + CLASS: function( match, curLoop, inplace, result, not, isXML ) { + match = " " + match[1].replace( rBackslash, "" ) + " "; + + if ( isXML ) { + return match; + } + + for ( var i = 0, elem; (elem = curLoop[i]) != null; i++ ) { + if ( elem ) { + if ( not ^ (elem.className && (" " + elem.className + " ").replace(/[\t\n\r]/g, " ").indexOf(match) >= 0) ) { + if ( !inplace ) { + result.push( elem ); + } + + } else if ( inplace ) { + curLoop[i] = false; + } + } + } + + return false; + }, + + ID: function( match ) { + return match[1].replace( rBackslash, "" ); + }, + + TAG: function( match, curLoop ) { + return match[1].replace( rBackslash, "" ).toLowerCase(); + }, + + CHILD: function( match ) { + if ( match[1] === "nth" ) { + if ( !match[2] ) { + Sizzle.error( match[0] ); + } + + match[2] = match[2].replace(/^\+|\s*/g, ''); + + // parse equations like 'even', 'odd', '5', '2n', '3n+2', '4n-1', '-n+6' + var test = /(-?)(\d*)(?:n([+\-]?\d*))?/.exec( + match[2] === "even" && "2n" || match[2] === "odd" && "2n+1" || + !/\D/.test( match[2] ) && "0n+" + match[2] || match[2]); + + // calculate the numbers (first)n+(last) including if they are negative + match[2] = (test[1] + (test[2] || 1)) - 0; + match[3] = test[3] - 0; + } + else if ( match[2] ) { + Sizzle.error( match[0] ); + } + + // TODO: Move to normal caching system + match[0] = done++; + + return match; + }, + + ATTR: function( match, curLoop, inplace, result, not, isXML ) { + var name = match[1] = match[1].replace( rBackslash, "" ); + + if ( !isXML && Expr.attrMap[name] ) { + match[1] = Expr.attrMap[name]; + } + + // Handle if an un-quoted value was used + match[4] = ( match[4] || match[5] || "" ).replace( rBackslash, "" ); + + if ( match[2] === "~=" ) { + match[4] = " " + match[4] + " "; + } + + return match; + }, + + PSEUDO: function( match, curLoop, inplace, result, not ) { + if ( match[1] === "not" ) { + // If we're dealing with a complex expression, or a simple one + if ( ( chunker.exec(match[3]) || "" ).length > 1 || /^\w/.test(match[3]) ) { + match[3] = Sizzle(match[3], null, null, curLoop); + + } else { + var ret = Sizzle.filter(match[3], curLoop, inplace, true ^ not); + + if ( !inplace ) { + result.push.apply( result, ret ); + } + + return false; + } + + } else if ( Expr.match.POS.test( match[0] ) || Expr.match.CHILD.test( match[0] ) ) { + return true; + } + + return match; + }, + + POS: function( match ) { + match.unshift( true ); + + return match; + } + }, + + filters: { + enabled: function( elem ) { + return elem.disabled === false && elem.type !== "hidden"; + }, + + disabled: function( elem ) { + return elem.disabled === true; + }, + + checked: function( elem ) { + return elem.checked === true; + }, + + selected: function( elem ) { + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + parent: function( elem ) { + return !!elem.firstChild; + }, + + empty: function( elem ) { + return !elem.firstChild; + }, + + has: function( elem, i, match ) { + return !!Sizzle( match[3], elem ).length; + }, + + header: function( elem ) { + return (/h\d/i).test( elem.nodeName ); + }, + + text: function( elem ) { + var attr = elem.getAttribute( "type" ), type = elem.type; + // IE6 and 7 will map elem.type to 'text' for new HTML5 types (search, etc) + // use getAttribute instead to test this case + return elem.nodeName.toLowerCase() === "input" && "text" === type && ( attr === type || attr === null ); + }, + + radio: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "radio" === elem.type; + }, + + checkbox: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "checkbox" === elem.type; + }, + + file: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "file" === elem.type; + }, + + password: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "password" === elem.type; + }, + + submit: function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && "submit" === elem.type; + }, + + image: function( elem ) { + return elem.nodeName.toLowerCase() === "input" && "image" === elem.type; + }, + + reset: function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && "reset" === elem.type; + }, + + button: function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && "button" === elem.type || name === "button"; + }, + + input: function( elem ) { + return (/input|select|textarea|button/i).test( elem.nodeName ); + }, + + focus: function( elem ) { + return elem === elem.ownerDocument.activeElement; + } + }, + setFilters: { + first: function( elem, i ) { + return i === 0; + }, + + last: function( elem, i, match, array ) { + return i === array.length - 1; + }, + + even: function( elem, i ) { + return i % 2 === 0; + }, + + odd: function( elem, i ) { + return i % 2 === 1; + }, + + lt: function( elem, i, match ) { + return i < match[3] - 0; + }, + + gt: function( elem, i, match ) { + return i > match[3] - 0; + }, + + nth: function( elem, i, match ) { + return match[3] - 0 === i; + }, + + eq: function( elem, i, match ) { + return match[3] - 0 === i; + } + }, + filter: { + PSEUDO: function( elem, match, i, array ) { + var name = match[1], + filter = Expr.filters[ name ]; + + if ( filter ) { + return filter( elem, i, match, array ); + + } else if ( name === "contains" ) { + return (elem.textContent || elem.innerText || getText([ elem ]) || "").indexOf(match[3]) >= 0; + + } else if ( name === "not" ) { + var not = match[3]; + + for ( var j = 0, l = not.length; j < l; j++ ) { + if ( not[j] === elem ) { + return false; + } + } + + return true; + + } else { + Sizzle.error( name ); + } + }, + + CHILD: function( elem, match ) { + var first, last, + doneName, parent, cache, + count, diff, + type = match[1], + node = elem; + + switch ( type ) { + case "only": + case "first": + while ( (node = node.previousSibling) ) { + if ( node.nodeType === 1 ) { + return false; + } + } + + if ( type === "first" ) { + return true; + } + + node = elem; + + /* falls through */ + case "last": + while ( (node = node.nextSibling) ) { + if ( node.nodeType === 1 ) { + return false; + } + } + + return true; + + case "nth": + first = match[2]; + last = match[3]; + + if ( first === 1 && last === 0 ) { + return true; + } + + doneName = match[0]; + parent = elem.parentNode; + + if ( parent && (parent[ expando ] !== doneName || !elem.nodeIndex) ) { + count = 0; + + for ( node = parent.firstChild; node; node = node.nextSibling ) { + if ( node.nodeType === 1 ) { + node.nodeIndex = ++count; + } + } + + parent[ expando ] = doneName; + } + + diff = elem.nodeIndex - last; + + if ( first === 0 ) { + return diff === 0; + + } else { + return ( diff % first === 0 && diff / first >= 0 ); + } + } + }, + + ID: function( elem, match ) { + return elem.nodeType === 1 && elem.getAttribute("id") === match; + }, + + TAG: function( elem, match ) { + return (match === "*" && elem.nodeType === 1) || !!elem.nodeName && elem.nodeName.toLowerCase() === match; + }, + + CLASS: function( elem, match ) { + return (" " + (elem.className || elem.getAttribute("class")) + " ") + .indexOf( match ) > -1; + }, + + ATTR: function( elem, match ) { + var name = match[1], + result = Sizzle.attr ? + Sizzle.attr( elem, name ) : + Expr.attrHandle[ name ] ? + Expr.attrHandle[ name ]( elem ) : + elem[ name ] != null ? + elem[ name ] : + elem.getAttribute( name ), + value = result + "", + type = match[2], + check = match[4]; + + return result == null ? + type === "!=" : + !type && Sizzle.attr ? + result != null : + type === "=" ? + value === check : + type === "*=" ? + value.indexOf(check) >= 0 : + type === "~=" ? + (" " + value + " ").indexOf(check) >= 0 : + !check ? + value && result !== false : + type === "!=" ? + value !== check : + type === "^=" ? + value.indexOf(check) === 0 : + type === "$=" ? + value.substr(value.length - check.length) === check : + type === "|=" ? + value === check || value.substr(0, check.length + 1) === check + "-" : + false; + }, + + POS: function( elem, match, i, array ) { + var name = match[2], + filter = Expr.setFilters[ name ]; + + if ( filter ) { + return filter( elem, i, match, array ); + } + } + } +}; + +var origPOS = Expr.match.POS, + fescape = function(all, num){ + return "\\" + (num - 0 + 1); + }; + +for ( var type in Expr.match ) { + Expr.match[ type ] = new RegExp( Expr.match[ type ].source + (/(?![^\[]*\])(?![^\(]*\))/.source) ); + Expr.leftMatch[ type ] = new RegExp( /(^(?:.|\r|\n)*?)/.source + Expr.match[ type ].source.replace(/\\(\d+)/g, fescape) ); +} +// Expose origPOS +// "global" as in regardless of relation to brackets/parens +Expr.match.globalPOS = origPOS; + +var makeArray = function( array, results ) { + array = Array.prototype.slice.call( array, 0 ); + + if ( results ) { + results.push.apply( results, array ); + return results; + } + + return array; +}; + +// Perform a simple check to determine if the browser is capable of +// converting a NodeList to an array using builtin methods. +// Also verifies that the returned array holds DOM nodes +// (which is not the case in the Blackberry browser) +try { + Array.prototype.slice.call( document.documentElement.childNodes, 0 )[0].nodeType; + +// Provide a fallback method if it does not work +} catch( e ) { + makeArray = function( array, results ) { + var i = 0, + ret = results || []; + + if ( toString.call(array) === "[object Array]" ) { + Array.prototype.push.apply( ret, array ); + + } else { + if ( typeof array.length === "number" ) { + for ( var l = array.length; i < l; i++ ) { + ret.push( array[i] ); + } + + } else { + for ( ; array[i]; i++ ) { + ret.push( array[i] ); + } + } + } + + return ret; + }; +} + +var sortOrder, siblingCheck; + +if ( document.documentElement.compareDocumentPosition ) { + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + if ( !a.compareDocumentPosition || !b.compareDocumentPosition ) { + return a.compareDocumentPosition ? -1 : 1; + } + + return a.compareDocumentPosition(b) & 4 ? -1 : 1; + }; + +} else { + sortOrder = function( a, b ) { + // The nodes are identical, we can exit early + if ( a === b ) { + hasDuplicate = true; + return 0; + + // Fallback to using sourceIndex (in IE) if it's available on both nodes + } else if ( a.sourceIndex && b.sourceIndex ) { + return a.sourceIndex - b.sourceIndex; + } + + var al, bl, + ap = [], + bp = [], + aup = a.parentNode, + bup = b.parentNode, + cur = aup; + + // If the nodes are siblings (or identical) we can do a quick check + if ( aup === bup ) { + return siblingCheck( a, b ); + + // If no parents were found then the nodes are disconnected + } else if ( !aup ) { + return -1; + + } else if ( !bup ) { + return 1; + } + + // Otherwise they're somewhere else in the tree so we need + // to build up a full list of the parentNodes for comparison + while ( cur ) { + ap.unshift( cur ); + cur = cur.parentNode; + } + + cur = bup; + + while ( cur ) { + bp.unshift( cur ); + cur = cur.parentNode; + } + + al = ap.length; + bl = bp.length; + + // Start walking down the tree looking for a discrepancy + for ( var i = 0; i < al && i < bl; i++ ) { + if ( ap[i] !== bp[i] ) { + return siblingCheck( ap[i], bp[i] ); + } + } + + // We ended someplace up the tree so do a sibling check + return i === al ? + siblingCheck( a, bp[i], -1 ) : + siblingCheck( ap[i], b, 1 ); + }; + + siblingCheck = function( a, b, ret ) { + if ( a === b ) { + return ret; + } + + var cur = a.nextSibling; + + while ( cur ) { + if ( cur === b ) { + return -1; + } + + cur = cur.nextSibling; + } + + return 1; + }; +} + +// Check to see if the browser returns elements by name when +// querying by getElementById (and provide a workaround) +(function(){ + // We're going to inject a fake input element with a specified name + var form = document.createElement("div"), + id = "script" + (new Date()).getTime(), + root = document.documentElement; + + form.innerHTML = ""; + + // Inject it into the root element, check its status, and remove it quickly + root.insertBefore( form, root.firstChild ); + + // The workaround has to do additional checks after a getElementById + // Which slows things down for other browsers (hence the branching) + if ( document.getElementById( id ) ) { + Expr.find.ID = function( match, context, isXML ) { + if ( typeof context.getElementById !== "undefined" && !isXML ) { + var m = context.getElementById(match[1]); + + return m ? + m.id === match[1] || typeof m.getAttributeNode !== "undefined" && m.getAttributeNode("id").nodeValue === match[1] ? + [m] : + undefined : + []; + } + }; + + Expr.filter.ID = function( elem, match ) { + var node = typeof elem.getAttributeNode !== "undefined" && elem.getAttributeNode("id"); + + return elem.nodeType === 1 && node && node.nodeValue === match; + }; + } + + root.removeChild( form ); + + // release memory in IE + root = form = null; +})(); + +(function(){ + // Check to see if the browser returns only elements + // when doing getElementsByTagName("*") + + // Create a fake element + var div = document.createElement("div"); + div.appendChild( document.createComment("") ); + + // Make sure no comments are found + if ( div.getElementsByTagName("*").length > 0 ) { + Expr.find.TAG = function( match, context ) { + var results = context.getElementsByTagName( match[1] ); + + // Filter out possible comments + if ( match[1] === "*" ) { + var tmp = []; + + for ( var i = 0; results[i]; i++ ) { + if ( results[i].nodeType === 1 ) { + tmp.push( results[i] ); + } + } + + results = tmp; + } + + return results; + }; + } + + // Check to see if an attribute returns normalized href attributes + div.innerHTML = ""; + + if ( div.firstChild && typeof div.firstChild.getAttribute !== "undefined" && + div.firstChild.getAttribute("href") !== "#" ) { + + Expr.attrHandle.href = function( elem ) { + return elem.getAttribute( "href", 2 ); + }; + } + + // release memory in IE + div = null; +})(); + +if ( document.querySelectorAll ) { + (function(){ + var oldSizzle = Sizzle, + div = document.createElement("div"), + id = "__sizzle__"; + + div.innerHTML = "

    "; + + // Safari can't handle uppercase or unicode characters when + // in quirks mode. + if ( div.querySelectorAll && div.querySelectorAll(".TEST").length === 0 ) { + return; + } + + Sizzle = function( query, context, extra, seed ) { + context = context || document; + + // Only use querySelectorAll on non-XML documents + // (ID selectors don't work in non-HTML documents) + if ( !seed && !Sizzle.isXML(context) ) { + // See if we find a selector to speed up + var match = /^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec( query ); + + if ( match && (context.nodeType === 1 || context.nodeType === 9) ) { + // Speed-up: Sizzle("TAG") + if ( match[1] ) { + return makeArray( context.getElementsByTagName( query ), extra ); + + // Speed-up: Sizzle(".CLASS") + } else if ( match[2] && Expr.find.CLASS && context.getElementsByClassName ) { + return makeArray( context.getElementsByClassName( match[2] ), extra ); + } + } + + if ( context.nodeType === 9 ) { + // Speed-up: Sizzle("body") + // The body element only exists once, optimize finding it + if ( query === "body" && context.body ) { + return makeArray( [ context.body ], extra ); + + // Speed-up: Sizzle("#ID") + } else if ( match && match[3] ) { + var elem = context.getElementById( match[3] ); + + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE and Opera return items + // by name instead of ID + if ( elem.id === match[3] ) { + return makeArray( [ elem ], extra ); + } + + } else { + return makeArray( [], extra ); + } + } + + try { + return makeArray( context.querySelectorAll(query), extra ); + } catch(qsaError) {} + + // qSA works strangely on Element-rooted queries + // We can work around this by specifying an extra ID on the root + // and working up from there (Thanks to Andrew Dupont for the technique) + // IE 8 doesn't work on object elements + } else if ( context.nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { + var oldContext = context, + old = context.getAttribute( "id" ), + nid = old || id, + hasParent = context.parentNode, + relativeHierarchySelector = /^\s*[+~]/.test( query ); + + if ( !old ) { + context.setAttribute( "id", nid ); + } else { + nid = nid.replace( /'/g, "\\$&" ); + } + if ( relativeHierarchySelector && hasParent ) { + context = context.parentNode; + } + + try { + if ( !relativeHierarchySelector || hasParent ) { + return makeArray( context.querySelectorAll( "[id='" + nid + "'] " + query ), extra ); + } + + } catch(pseudoError) { + } finally { + if ( !old ) { + oldContext.removeAttribute( "id" ); + } + } + } + } + + return oldSizzle(query, context, extra, seed); + }; + + for ( var prop in oldSizzle ) { + Sizzle[ prop ] = oldSizzle[ prop ]; + } + + // release memory in IE + div = null; + })(); +} + +(function(){ + var html = document.documentElement, + matches = html.matchesSelector || html.mozMatchesSelector || html.webkitMatchesSelector || html.msMatchesSelector; + + if ( matches ) { + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9 fails this) + var disconnectedMatch = !matches.call( document.createElement( "div" ), "div" ), + pseudoWorks = false; + + try { + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( document.documentElement, "[test!='']:sizzle" ); + + } catch( pseudoError ) { + pseudoWorks = true; + } + + Sizzle.matchesSelector = function( node, expr ) { + // Make sure that attribute selectors are quoted + expr = expr.replace(/\=\s*([^'"\]]*)\s*\]/g, "='$1']"); + + if ( !Sizzle.isXML( node ) ) { + try { + if ( pseudoWorks || !Expr.match.PSEUDO.test( expr ) && !/!=/.test( expr ) ) { + var ret = matches.call( node, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || !disconnectedMatch || + // As well, disconnected nodes are said to be in a document + // fragment in IE 9, so check for that + node.document && node.document.nodeType !== 11 ) { + return ret; + } + } + } catch(e) {} + } + + return Sizzle(expr, null, null, [node]).length > 0; + }; + } +})(); + +(function(){ + var div = document.createElement("div"); + + div.innerHTML = "
    "; + + // Opera can't find a second classname (in 9.6) + // Also, make sure that getElementsByClassName actually exists + if ( !div.getElementsByClassName || div.getElementsByClassName("e").length === 0 ) { + return; + } + + // Safari caches class attributes, doesn't catch changes (in 3.2) + div.lastChild.className = "e"; + + if ( div.getElementsByClassName("e").length === 1 ) { + return; + } + + Expr.order.splice(1, 0, "CLASS"); + Expr.find.CLASS = function( match, context, isXML ) { + if ( typeof context.getElementsByClassName !== "undefined" && !isXML ) { + return context.getElementsByClassName(match[1]); + } + }; + + // release memory in IE + div = null; +})(); + +function dirNodeCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { + for ( var i = 0, l = checkSet.length; i < l; i++ ) { + var elem = checkSet[i]; + + if ( elem ) { + var match = false; + + elem = elem[dir]; + + while ( elem ) { + if ( elem[ expando ] === doneName ) { + match = checkSet[elem.sizset]; + break; + } + + if ( elem.nodeType === 1 && !isXML ){ + elem[ expando ] = doneName; + elem.sizset = i; + } + + if ( elem.nodeName.toLowerCase() === cur ) { + match = elem; + break; + } + + elem = elem[dir]; + } + + checkSet[i] = match; + } + } +} + +function dirCheck( dir, cur, doneName, checkSet, nodeCheck, isXML ) { + for ( var i = 0, l = checkSet.length; i < l; i++ ) { + var elem = checkSet[i]; + + if ( elem ) { + var match = false; + + elem = elem[dir]; + + while ( elem ) { + if ( elem[ expando ] === doneName ) { + match = checkSet[elem.sizset]; + break; + } + + if ( elem.nodeType === 1 ) { + if ( !isXML ) { + elem[ expando ] = doneName; + elem.sizset = i; + } + + if ( typeof cur !== "string" ) { + if ( elem === cur ) { + match = true; + break; + } + + } else if ( Sizzle.filter( cur, [elem] ).length > 0 ) { + match = elem; + break; + } + } + + elem = elem[dir]; + } + + checkSet[i] = match; + } + } +} + +if ( document.documentElement.contains ) { + Sizzle.contains = function( a, b ) { + return a !== b && (a.contains ? a.contains(b) : true); + }; + +} else if ( document.documentElement.compareDocumentPosition ) { + Sizzle.contains = function( a, b ) { + return !!(a.compareDocumentPosition(b) & 16); + }; + +} else { + Sizzle.contains = function() { + return false; + }; +} + +Sizzle.isXML = function( elem ) { + // documentElement is verified for cases where it doesn't yet exist + // (such as loading iframes in IE - #4833) + var documentElement = (elem ? elem.ownerDocument || elem : 0).documentElement; + + return documentElement ? documentElement.nodeName !== "HTML" : false; +}; + +var posProcess = function( selector, context, seed ) { + var match, + tmpSet = [], + later = "", + root = context.nodeType ? [context] : context; + + // Position selectors must be done after the filter + // And so must :not(positional) so we move all PSEUDOs to the end + while ( (match = Expr.match.PSEUDO.exec( selector )) ) { + later += match[0]; + selector = selector.replace( Expr.match.PSEUDO, "" ); + } + + selector = Expr.relative[selector] ? selector + "*" : selector; + + for ( var i = 0, l = root.length; i < l; i++ ) { + Sizzle( selector, root[i], tmpSet, seed ); + } + + return Sizzle.filter( later, tmpSet ); +}; + +// EXPOSE +// Override sizzle attribute retrieval +Sizzle.attr = jQuery.attr; +Sizzle.selectors.attrMap = {}; +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; +jQuery.expr[":"] = jQuery.expr.filters; +jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; + + +})(); + + +var runtil = /Until$/, + rparentsprev = /^(?:parents|prevUntil|prevAll)/, + // Note: This RegExp should be improved, or likely pulled from Sizzle + rmultiselector = /,/, + isSimple = /^.[^:#\[\.,]*$/, + slice = Array.prototype.slice, + POS = jQuery.expr.match.globalPOS, + // methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend({ + find: function( selector ) { + var self = this, + i, l; + + if ( typeof selector !== "string" ) { + return jQuery( selector ).filter(function() { + for ( i = 0, l = self.length; i < l; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + }); + } + + var ret = this.pushStack( "", "find", selector ), + length, n, r; + + for ( i = 0, l = this.length; i < l; i++ ) { + length = ret.length; + jQuery.find( selector, this[i], ret ); + + if ( i > 0 ) { + // Make sure that the results are unique + for ( n = length; n < ret.length; n++ ) { + for ( r = 0; r < length; r++ ) { + if ( ret[r] === ret[n] ) { + ret.splice(n--, 1); + break; + } + } + } + } + } + + return ret; + }, + + has: function( target ) { + var targets = jQuery( target ); + return this.filter(function() { + for ( var i = 0, l = targets.length; i < l; i++ ) { + if ( jQuery.contains( this, targets[i] ) ) { + return true; + } + } + }); + }, + + not: function( selector ) { + return this.pushStack( winnow(this, selector, false), "not", selector); + }, + + filter: function( selector ) { + return this.pushStack( winnow(this, selector, true), "filter", selector ); + }, + + is: function( selector ) { + return !!selector && ( + typeof selector === "string" ? + // If this is a positional selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + POS.test( selector ) ? + jQuery( selector, this.context ).index( this[0] ) >= 0 : + jQuery.filter( selector, this ).length > 0 : + this.filter( selector ).length > 0 ); + }, + + closest: function( selectors, context ) { + var ret = [], i, l, cur = this[0]; + + // Array (deprecated as of jQuery 1.7) + if ( jQuery.isArray( selectors ) ) { + var level = 1; + + while ( cur && cur.ownerDocument && cur !== context ) { + for ( i = 0; i < selectors.length; i++ ) { + + if ( jQuery( cur ).is( selectors[ i ] ) ) { + ret.push({ selector: selectors[ i ], elem: cur, level: level }); + } + } + + cur = cur.parentNode; + level++; + } + + return ret; + } + + // String + var pos = POS.test( selectors ) || typeof selectors !== "string" ? + jQuery( selectors, context || this.context ) : + 0; + + for ( i = 0, l = this.length; i < l; i++ ) { + cur = this[i]; + + while ( cur ) { + if ( pos ? pos.index(cur) > -1 : jQuery.find.matchesSelector(cur, selectors) ) { + ret.push( cur ); + break; + + } else { + cur = cur.parentNode; + if ( !cur || !cur.ownerDocument || cur === context || cur.nodeType === 11 ) { + break; + } + } + } + } + + ret = ret.length > 1 ? jQuery.unique( ret ) : ret; + + return this.pushStack( ret, "closest", selectors ); + }, + + // Determine the position of an element within + // the matched set of elements + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[0] && this[0].parentNode ) ? this.prevAll().length : -1; + } + + // index in selector + if ( typeof elem === "string" ) { + return jQuery.inArray( this[0], jQuery( elem ) ); + } + + // Locate the position of the desired element + return jQuery.inArray( + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[0] : elem, this ); + }, + + add: function( selector, context ) { + var set = typeof selector === "string" ? + jQuery( selector, context ) : + jQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ), + all = jQuery.merge( this.get(), set ); + + return this.pushStack( isDisconnected( set[0] ) || isDisconnected( all[0] ) ? + all : + jQuery.unique( all ) ); + }, + + andSelf: function() { + return this.add( this.prevObject ); + } +}); + +// A painfully simple check to see if an element is disconnected +// from a document (should be improved, where feasible). +function isDisconnected( node ) { + return !node || !node.parentNode || node.parentNode.nodeType === 11; +} + +jQuery.each({ + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return jQuery.dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, i, until ) { + return jQuery.dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return jQuery.nth( elem, 2, "nextSibling" ); + }, + prev: function( elem ) { + return jQuery.nth( elem, 2, "previousSibling" ); + }, + nextAll: function( elem ) { + return jQuery.dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return jQuery.dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, i, until ) { + return jQuery.dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, i, until ) { + return jQuery.dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return jQuery.sibling( elem.firstChild ); + }, + contents: function( elem ) { + return jQuery.nodeName( elem, "iframe" ) ? + elem.contentDocument || elem.contentWindow.document : + jQuery.makeArray( elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var ret = jQuery.map( this, fn, until ); + + if ( !runtil.test( name ) ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + ret = jQuery.filter( selector, ret ); + } + + ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; + + if ( (this.length > 1 || rmultiselector.test( selector )) && rparentsprev.test( name ) ) { + ret = ret.reverse(); + } + + return this.pushStack( ret, name, slice.call( arguments ).join(",") ); + }; +}); + +jQuery.extend({ + filter: function( expr, elems, not ) { + if ( not ) { + expr = ":not(" + expr + ")"; + } + + return elems.length === 1 ? + jQuery.find.matchesSelector(elems[0], expr) ? [ elems[0] ] : [] : + jQuery.find.matches(expr, elems); + }, + + dir: function( elem, dir, until ) { + var matched = [], + cur = elem[ dir ]; + + while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { + if ( cur.nodeType === 1 ) { + matched.push( cur ); + } + cur = cur[dir]; + } + return matched; + }, + + nth: function( cur, result, dir, elem ) { + result = result || 1; + var num = 0; + + for ( ; cur; cur = cur[dir] ) { + if ( cur.nodeType === 1 && ++num === result ) { + break; + } + } + + return cur; + }, + + sibling: function( n, elem ) { + var r = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + r.push( n ); + } + } + + return r; + } +}); + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, keep ) { + + // Can't pass null or undefined to indexOf in Firefox 4 + // Set to 0 to skip string check + qualifier = qualifier || 0; + + if ( jQuery.isFunction( qualifier ) ) { + return jQuery.grep(elements, function( elem, i ) { + var retVal = !!qualifier.call( elem, i, elem ); + return retVal === keep; + }); + + } else if ( qualifier.nodeType ) { + return jQuery.grep(elements, function( elem, i ) { + return ( elem === qualifier ) === keep; + }); + + } else if ( typeof qualifier === "string" ) { + var filtered = jQuery.grep(elements, function( elem ) { + return elem.nodeType === 1; + }); + + if ( isSimple.test( qualifier ) ) { + return jQuery.filter(qualifier, filtered, !keep); + } else { + qualifier = jQuery.filter( qualifier, filtered ); + } + } + + return jQuery.grep(elements, function( elem, i ) { + return ( jQuery.inArray( elem, qualifier ) >= 0 ) === keep; + }); +} + + + + +function createSafeFragment( document ) { + var list = nodeNames.split( "|" ), + safeFrag = document.createDocumentFragment(); + + if ( safeFrag.createElement ) { + while ( list.length ) { + safeFrag.createElement( + list.pop() + ); + } + } + return safeFrag; +} + +var nodeNames = "abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|" + + "header|hgroup|mark|meter|nav|output|progress|section|summary|time|video", + rinlinejQuery = / jQuery\d+="(?:\d+|null)"/g, + rleadingWhitespace = /^\s+/, + rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig, + rtagName = /<([\w:]+)/, + rtbody = /]", "i"), + // checked="checked" or checked + rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i, + rscriptType = /\/(java|ecma)script/i, + rcleanScript = /^\s*", "" ], + legend: [ 1, "
    ", "
    " ], + thead: [ 1, "", "
    " ], + tr: [ 2, "", "
    " ], + td: [ 3, "", "
    " ], + col: [ 2, "", "
    " ], + area: [ 1, "", "" ], + _default: [ 0, "", "" ] + }, + safeFragment = createSafeFragment( document ); + +wrapMap.optgroup = wrapMap.option; +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// IE can't serialize and + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + +
    +

    API ReferenceΒΆ

    +
    +

    IncludesΒΆ

    +

    To use the public APIs, include nghttp2/nghttp2.h:

    +
    #include <nghttp2/nghttp2.h>
+
    +
    +

    The header files are also available online: nghttp2.h and +nghttp2ver.h.

    +
    +
    +

    RemarksΒΆ

    +

    Do not call nghttp2_session_send(), nghttp2_session_recv() or +nghttp2_session_mem_recv() from the nghttp2 callback functions +directly or indirectly. It will lead to the crash. You can submit +requests or frames in the callbacks then call nghttp2_session_send(), +nghttp2_session_recv() or nghttp2_session_mem_recv() outside of the +callbacks.

    +
    +
    +

    MacrosΒΆ

    +
    +
    +NGHTTP2_VERSIONΒΆ
    +

    Version number of the nghttp2 library release

    +
    + +
    +
    +NGHTTP2_VERSION_NUMΒΆ
    +

    Numerical representation of the version number of the nghttp2 library +release. This is a 24 bit number with 8 bits for major number, 8 bits +for minor and 8 bits for patch. Version 1.2.3 becomes 0x010203.

    +
    + +
    +
    +NGHTTP2_PROTO_VERSION_IDΒΆ
    +

    The protocol version identification of this library supports.

    +
    + +
    +
    +NGHTTP2_PROTO_VERSION_ID_LENΒΆ
    +

    The length of NGHTTP2_PROTO_VERSION_ID.

    +
    + +
    +
    +NGHTTP2_VERSION_AGEΒΆ
    +

    The age of nghttp2_info

    +
    + +
    +
    +NGHTTP2_PRI_DEFAULTΒΆ
    +

    The default priority value

    +
    + +
    +
    +NGHTTP2_PRI_LOWESTΒΆ
    +

    The lowest priority value

    +
    + +
    +
    +NGHTTP2_MAX_WINDOW_SIZEΒΆ
    +

    The maximum window size

    +
    + +
    +
    +NGHTTP2_INITIAL_WINDOW_SIZEΒΆ
    +

    The initial window size for stream level flow control.

    +
    + +
    +
    +NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZEΒΆ
    +

    The initial window size for connection level flow control.

    +
    + +
    +
    +NGHTTP2_MAX_HEADER_TABLE_SIZEΒΆ
    +

    The maximum header table size.

    +
    + +
    +
    +NGHTTP2_CLIENT_CONNECTION_HEADERΒΆ
    +

    The client connection header.

    +
    + +
    +
    +NGHTTP2_CLIENT_CONNECTION_HEADER_LENΒΆ
    +

    The length of NGHTTP2_CLIENT_CONNECTION_HEADER.

    +
    + +
    +
    +NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMSΒΆ
    +

    Default maximum concurrent streams.

    +
    + +
    +
    +

    EnumsΒΆ

    +
    +
    +nghttp2_errorΒΆ
    +

    Error codes used in this library. The code range is [-999, -500], +inclusive. The following values are defined:

    +
    +
    +NGHTTP2_ERR_INVALID_ARGUMENTΒΆ
    +

    (-501) +Invalid argument passed.

    +
    + +
    +
    +NGHTTP2_ERR_UNSUPPORTED_VERSIONΒΆ
    +

    (-503) +The specified protocol version is not supported.

    +
    + +
    +
    +NGHTTP2_ERR_WOULDBLOCKΒΆ
    +

    (-504) +Used as a return value from nghttp2_send_callback and +nghttp2_recv_callback to indicate that the operation +would block.

    +
    + +
    +
    +NGHTTP2_ERR_PROTOΒΆ
    +

    (-505) +General protocol error

    +
    + +
    +
    +NGHTTP2_ERR_INVALID_FRAMEΒΆ
    +

    (-506) +The frame is invalid.

    +
    + +
    +
    +NGHTTP2_ERR_EOFΒΆ
    +

    (-507) +The peer performed a shutdown on the connection.

    +
    + +
    +
    +NGHTTP2_ERR_DEFERREDΒΆ
    +

    (-508) +Used as a return value from +nghttp2_data_source_read_callback() to indicate that data +transfer is postponed. See +nghttp2_data_source_read_callback() for details.

    +
    + +
    +
    +NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLEΒΆ
    +

    (-509) +Stream ID has reached the maximum value. Therefore no stream ID +is available.

    +
    + +
    +
    +NGHTTP2_ERR_STREAM_CLOSEDΒΆ
    +

    (-510) +The stream is already closed; or the stream ID is invalid.

    +
    + +
    +
    +NGHTTP2_ERR_STREAM_CLOSINGΒΆ
    +

    (-511) +RST_STREAM has been added to the outbound queue. The stream is in +closing state.

    +
    + +
    +
    +NGHTTP2_ERR_STREAM_SHUT_WRΒΆ
    +

    (-512) +The transmission is not allowed for this stream (e.g., a frame +with END_STREAM flag set has already sent).

    +
    + +
    +
    +NGHTTP2_ERR_INVALID_STREAM_IDΒΆ
    +

    (-513) +The stream ID is invalid.

    +
    + +
    +
    +NGHTTP2_ERR_INVALID_STREAM_STATEΒΆ
    +

    (-514) +The state of the stream is not valid (e.g., DATA cannot be sent +to the stream if response HEADERS has not been sent).

    +
    + +
    +
    +NGHTTP2_ERR_DEFERRED_DATA_EXISTΒΆ
    +

    (-515) +Another DATA frame has already been deferred.

    +
    + +
    +
    +NGHTTP2_ERR_START_STREAM_NOT_ALLOWEDΒΆ
    +

    (-516) +Starting new stream is not allowed. (e.g., GOAWAY has been sent +and/or received.

    +
    + +
    +
    +NGHTTP2_ERR_GOAWAY_ALREADY_SENTΒΆ
    +

    (-517) +GOAWAY has already been sent.

    +
    + +
    +
    +NGHTTP2_ERR_INVALID_HEADER_BLOCKΒΆ
    +

    (-518) +The received frame contains the invalid header block. (e.g., +There are duplicate header names; or the header names are not +encoded in US-ASCII character set and not lower cased; or the +header name is zero-length string; or the header value contains +multiple in-sequence NUL bytes).

    +
    + +
    +
    +NGHTTP2_ERR_INVALID_STATEΒΆ
    +

    (-519) +Indicates that the context is not suitable to perform the +requested operation.

    +
    + +
    +
    +NGHTTP2_ERR_GZIPΒΆ
    +

    (-520) +The gzip error.

    +
    + +
    +
    +NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILUREΒΆ
    +

    (-521) +The user callback function failed due to the temporal error.

    +
    + +
    +
    +NGHTTP2_ERR_FRAME_SIZE_ERRORΒΆ
    +

    (-522) +The length of the frame is invalid, either too large or too small.

    +
    + +
    +
    +NGHTTP2_ERR_HEADER_COMPΒΆ
    +

    (-523) +Header block inflate/deflate error.

    +
    + +
    +
    +NGHTTP2_ERR_FLOW_CONTROLΒΆ
    +

    (-524) +Flow control error

    +
    + +
    +
    +NGHTTP2_ERR_INSUFF_BUFSIZEΒΆ
    +

    (-525) +Insufficient buffer size given to function.

    +
    + +
    +
    +NGHTTP2_ERR_PAUSEΒΆ
    +

    (-526) +Callback was paused by the application

    +
    + +
    +
    +NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGSΒΆ
    +

    (-527) +There are too many in-flight SETTING frame and no more +transmission of SETTINGS is allowed.

    +
    + +
    +
    +NGHTTP2_ERR_PUSH_DISABLEDΒΆ
    +

    (-528) +The server push is disabled.

    +
    + +
    +
    +NGHTTP2_ERR_FATALΒΆ
    +

    (-900) +The errors < NGHTTP2_ERR_FATAL mean that the library is +under unexpected condition and cannot process any further data +reliably (e.g., out of memory).

    +
    + +
    +
    +NGHTTP2_ERR_NOMEMΒΆ
    +

    (-901) +Out of memory. This is a fatal error.

    +
    + +
    +
    +NGHTTP2_ERR_CALLBACK_FAILUREΒΆ
    +

    (-902) +The user callback function failed. This is a fatal error.

    +
    + +
    + +
    +
    +nghttp2_frame_typeΒΆ
    +

    The control frame types in HTTP/2.0.

    +
    +
    +NGHTTP2_DATAΒΆ
    +

    (0) +The DATA frame.

    +
    + +
    +
    +NGHTTP2_HEADERSΒΆ
    +

    (1) +The HEADERS frame.

    +
    + +
    +
    +NGHTTP2_PRIORITYΒΆ
    +

    (2) +The PRIORITY frame.

    +
    + +
    +
    +NGHTTP2_RST_STREAMΒΆ
    +

    (3) +The RST_STREAM frame.

    +
    + +
    +
    +NGHTTP2_SETTINGSΒΆ
    +

    (4) +The SETTINGS frame.

    +
    + +
    +
    +NGHTTP2_PUSH_PROMISEΒΆ
    +

    (5) +The PUSH_PROMISE frame.

    +
    + +
    +
    +NGHTTP2_PINGΒΆ
    +

    (6) +The PING frame.

    +
    + +
    +
    +NGHTTP2_GOAWAYΒΆ
    +

    (7) +The GOAWAY frame.

    +
    + +
    +
    +NGHTTP2_WINDOW_UPDATEΒΆ
    +

    (9) +The WINDOW_UPDATE frame.

    +
    + +
    + +
    +
    +nghttp2_flagΒΆ
    +

    The flags for HTTP/2.0 frames. This enum defines all flags for +frames, assuming that the same flag name has the same mask.

    +
    +
    +NGHTTP2_FLAG_NONEΒΆ
    +

    (0) +No flag set.

    +
    + +
    +
    +NGHTTP2_FLAG_END_STREAMΒΆ
    +

    (0x1) +The END_STREAM flag.

    +
    + +
    +
    +NGHTTP2_FLAG_END_HEADERSΒΆ
    +

    (0x4) +The END_HEADERS flag.

    +
    + +
    +
    +NGHTTP2_FLAG_PRIORITYΒΆ
    +

    (0x8) +The PRIORITY flag.

    +
    + +
    +
    +NGHTTP2_FLAG_END_PUSH_PROMISEΒΆ
    +

    (0x4) +The END_PUSH_PROMISE flag.

    +
    + +
    +
    +NGHTTP2_FLAG_ACKΒΆ
    +

    (0x1) +The ACK flag.

    +
    + +
    + +
    +
    +nghttp2_settings_idΒΆ
    +

    The SETTINGS ID.

    +
    +
    +NGHTTP2_SETTINGS_HEADER_TABLE_SIZEΒΆ
    +

    (1) +SETTINGS_HEADER_TABLE_SIZE

    +
    + +
    +
    +NGHTTP2_SETTINGS_ENABLE_PUSHΒΆ
    +

    (2) +SETTINGS_ENABLE_PUSH

    +
    + +
    +
    +NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMSΒΆ
    +

    (4) +SETTINGS_MAX_CONCURRENT_STREAMS

    +
    + +
    +
    +NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZEΒΆ
    +

    (7) +SETTINGS_INITIAL_WINDOW_SIZE

    +
    + +
    +
    +NGHTTP2_SETTINGS_FLOW_CONTROL_OPTIONSΒΆ
    +

    (10) +SETTINGS_FLOW_CONTROL_OPTIONS

    +
    + +
    +
    +NGHTTP2_SETTINGS_MAXΒΆ
    +

    (10) +Maximum ID of nghttp2_settings_id.

    +
    + +
    + +
    +
    +nghttp2_error_codeΒΆ
    +

    The status codes for the RST_STREAM and GOAWAY frames.

    +
    +
    +NGHTTP2_NO_ERRORΒΆ
    +

    (0) +No errors.

    +
    + +
    +
    +NGHTTP2_PROTOCOL_ERRORΒΆ
    +

    (1) +PROTOCOL_ERROR

    +
    + +
    +
    +NGHTTP2_INTERNAL_ERRORΒΆ
    +

    (2) +INTERNAL_ERROR

    +
    + +
    +
    +NGHTTP2_FLOW_CONTROL_ERRORΒΆ
    +

    (3) +FLOW_CONTROL_ERROR

    +
    + +
    +
    +NGHTTP2_SETTINGS_TIMEOUTΒΆ
    +

    (4) +SETTINGS_TIMEOUT

    +
    + +
    +
    +NGHTTP2_STREAM_CLOSEDΒΆ
    +

    (5) +STREAM_CLOSED

    +
    + +
    +
    +NGHTTP2_FRAME_SIZE_ERRORΒΆ
    +

    (6) +FRAME_SIZE_ERROR

    +
    + +
    +
    +NGHTTP2_REFUSED_STREAMΒΆ
    +

    (7) +REFUSED_STREAM

    +
    + +
    +
    +NGHTTP2_CANCELΒΆ
    +

    (8) +CANCEL

    +
    + +
    +
    +NGHTTP2_COMPRESSION_ERRORΒΆ
    +

    (9) +COMPRESSION_ERROR

    +
    + +
    +
    +NGHTTP2_CONNECT_ERRORΒΆ
    +

    (10) +CONNECT_ERROR

    +
    + +
    +
    +NGHTTP2_ENHANCE_YOUR_CALMΒΆ
    +

    (420) +ENHANCE_YOUR_CALM

    +
    + +
    + +
    +
    +nghttp2_headers_categoryΒΆ
    +

    The category of HEADERS, which indicates the role of the frame. In +HTTP/2.0 spec, request, response, push response and other arbitrary +headers (e.g., trailers) are all called just HEADERS. To give the +application the role of incoming HEADERS frame, we define several +categories.

    +
    +
    +NGHTTP2_HCAT_REQUESTΒΆ
    +

    (0) +The HEADERS frame is opening new stream, which is analogous to +SYN_STREAM in SPDY.

    +
    + +
    +
    +NGHTTP2_HCAT_RESPONSEΒΆ
    +

    (1) +The HEADERS frame is the first response headers, which is +analogous to SYN_REPLY in SPDY.

    +
    + +
    +
    +NGHTTP2_HCAT_PUSH_RESPONSEΒΆ
    +

    (2) +The HEADERS frame is the first headers sent against reserved +stream.

    +
    + +
    +
    +NGHTTP2_HCAT_HEADERSΒΆ
    +

    (3) +The HEADERS frame which does not apply for the above categories, +which is analogous to HEADERS in SPDY.

    +
    + +
    + +
    +
    +nghttp2_optΒΆ
    +

    Configuration options for nghttp2_session.

    +
    +
    +NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATEΒΆ
    +

    (1) +This option prevents the library from sending WINDOW_UPDATE for a +stream automatically. If this option is set, the application is +responsible for sending WINDOW_UPDATE using +nghttp2_submit_window_update().

    +
    + +
    +
    +NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATEΒΆ
    +

    (2) +This option prevents the library from sending WINDOW_UPDATE for a +connection automatically. If this option is set, the application +is responsible for sending WINDOW_UPDATE with stream ID 0 using +nghttp2_submit_window_update().

    +
    + +
    +
    +NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMSΒΆ
    +

    (3) +This option sets the SETTINGS_MAX_CONCURRENT_STREAMS value of +remote endpoint as if it is received in SETTINGS frame. Without +specifying this option, before the local endpoint receives +SETTINGS_MAX_CONCURRENT_STREAMS in SETTINGS frame from remote +endpoint, SETTINGS_MAX_CONCURRENT_STREAMS is unlimited. This may +cause problem if local endpoint submits lots of requests +initially and sending them at once to the remote peer may lead to +the rejection of some requests. Specifying this option to the +sensible value, say 100, may avoid this kind of issue. This value +will be overwritten if the local endpoint receives +SETTINGS_MAX_CONCURRENT_STREAMS from the remote endpoint.

    +
    + +
    + +
    +
    +

    Types (structs, unions and typedefs)ΒΆ

    +
    +
    +nghttp2_sessionΒΆ
    +

    The primary structure to hold the resources needed for a HTTP/2.0 +session. The details of this structure are intentionally hidden +from the public API.

    +
    + +
    +
    +nghttp2_infoΒΆ
    +

    This struct is what nghttp2_version() returns. It holds +information about the particular nghttp2 version.

    +
    +
    +int ageΒΆ
    +

    Age of this struct. This instance of nghttp2 sets it to +NGHTTP2_VERSION_AGE but a future version may bump it and +add more struct fields at the bottom

    +
    + +
    +
    +int version_numΒΆ
    +

    the NGHTTP2_VERSION_NUM number (since age ==1)

    +
    + +
    +
    +const char *version_strΒΆ
    +

    points to the NGHTTP2_VERSION string (since age ==1)

    +
    + +
    +
    +const char *proto_strΒΆ
    +

    points to the NGHTTP2_PROTO_VERSION_ID string this +instance implements (since age ==1)

    +
    + +
    + +
    +
    +nghttp2_nvΒΆ
    +

    The name/value pair, which mainly used to represent header fields.

    +
    +
    +uint8_t *nameΒΆ
    +

    The name byte string, which is not necessarily NULL +terminated.

    +
    + +
    +
    +uint8_t *valueΒΆ
    +

    The value byte string, which is not necessarily NULL +terminated.

    +
    + +
    +
    +uint16_t namelenΒΆ
    +

    The length of the name.

    +
    + +
    +
    +uint16_t valuelenΒΆ
    +

    The length of the value.

    +
    + +
    + +
    +
    +nghttp2_frame_hdΒΆ
    +

    The frame header.

    +
    +
    +uint16_t lengthΒΆ
    +

    The length field of this frame, excluding frame header.

    +
    + +
    +
    +uint8_t typeΒΆ
    +

    The type of this frame. See nghttp2_frame().

    +
    + +
    +
    +uint8_t flagsΒΆ
    +

    The flags.

    +
    + +
    +
    +int32_t stream_idΒΆ
    +

    The stream identifier (aka, stream ID)

    +
    + +
    + +
    +
    +nghttp2_data_sourceΒΆ
    +

    This union represents the some kind of data source passed to +nghttp2_data_source_read_callback.

    +
    +
    +int fdΒΆ
    +

    The integer field, suitable for a file descriptor.

    +
    + +
    +
    +void *ptrΒΆ
    +

    The pointer to an arbitrary object.

    +
    + +
    + +
    +
    +typedef ssize_t (*nghttp2_data_source_read_callback)(nghttp2_session *session, int32_t stream_id, uint8_t *buf, size_t length, int *eof, nghttp2_data_source *source, void *user_data)ΒΆ
    +

    Callback function invoked when the library wants to read data from +the source. The read data is sent in the stream stream_id. The +implementation of this function must read at most length bytes of +data from source (or possibly other places) and store them in +buf and return number of data stored in buf. If EOF is reached, +set *eof to 1. If the application wants to postpone DATA frames, +(e.g., asynchronous I/O, or reading data blocks for long time), it +is achieved by returning NGHTTP2_ERR_DEFERRED without +reading any data in this invocation. The library removes DATA +frame from the outgoing queue temporarily. To move back deferred +DATA frame to outgoing queue, call nghttp2_session_resume_data(). +In case of error, there are 2 choices. Returning +NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE will close the stream +by issuing RST_STREAM with NGHTTP2_INTERNAL_ERROR. +Returning NGHTTP2_ERR_CALLBACK_FAILURE will signal the +entire session failure.

    +
    + +
    +
    +nghttp2_data_providerΒΆ
    +

    This struct represents the data source and the way to read a chunk +of data from it.

    +
    +
    +nghttp2_data_source sourceΒΆ
    +

    The data source.

    +
    + +
    +
    +nghttp2_data_source_read_callback read_callbackΒΆ
    +

    The callback function to read a chunk of data from the source.

    +
    + +
    + +
    +
    +nghttp2_headersΒΆ
    +

    The HEADERS frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +int32_t priΒΆ
    +

    The priority.

    +
    + +
    +
    +nghttp2_nv *nvaΒΆ
    +

    The name/value pairs.

    +
    + +
    +
    +size_t nvlenΒΆ
    +

    The number of name/value pairs in nva.

    +
    + +
    + +
    +
    +nghttp2_priorityΒΆ
    +

    The PRIORITY frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +int32_t priΒΆ
    +

    The priority.

    +
    + +
    + +
    +
    +nghttp2_rst_streamΒΆ
    +

    The RST_STREAM frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +nghttp2_error_code error_codeΒΆ
    +

    The error code. See nghttp2_error_code.

    +
    + +
    + +
    +
    +nghttp2_settings_entryΒΆ
    +

    The SETTINGS ID/Value pair. It has the following members:

    +
    +
    +int32_t settings_idΒΆ
    +

    The SETTINGS ID. See nghttp2_settings_id.

    +
    + +
    +
    +uint32_t valueΒΆ
    +

    The value of this entry.

    +
    + +
    + +
    +
    +nghttp2_settingsΒΆ
    +

    The SETTINGS frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +size_t nivΒΆ
    +

    The number of SETTINGS ID/Value pairs in iv.

    +
    + +
    +
    +nghttp2_settings_entry *ivΒΆ
    +

    The pointer to the array of SETTINGS ID/Value pair.

    +
    + +
    + +
    +
    +nghttp2_push_promiseΒΆ
    +

    The PUSH_PROMISE frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +int32_t promised_stream_idΒΆ
    +

    The promised stream ID

    +
    + +
    +
    +nghttp2_nv *nvaΒΆ
    +

    The name/value pairs.

    +
    + +
    +
    +size_t nvlenΒΆ
    +

    The number of name/value pairs in nva.

    +
    + +
    + +
    +
    +nghttp2_pingΒΆ
    +

    The PING frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +uint8_t opaque_data[8]
    +

    The opaque data

    +
    + +
    + +
    +
    +nghttp2_goawayΒΆ
    +

    The GOAWAY frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +int32_t last_stream_idΒΆ
    +

    The last stream stream ID.

    +
    + +
    +
    +nghttp2_error_code error_codeΒΆ
    +

    The error code. See nghttp2_error_code.

    +
    + +
    +
    +uint8_t *opaque_dataΒΆ
    +

    The additional debug data

    +
    + +
    +
    +size_t opaque_data_lenΒΆ
    +

    The length of opaque_data member.

    +
    + +
    + +
    +
    +nghttp2_window_updateΒΆ
    +

    The WINDOW_UPDATE frame. It has the following members:

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header.

    +
    + +
    +
    +int32_t window_size_incrementΒΆ
    +

    The window size increment.

    +
    + +
    + +
    +
    +nghttp2_frameΒΆ
    +

    This union includes all frames to pass them to various function +calls as nghttp2_frame type. The DATA frame is intentionally +omitted from here.

    +
    +
    +nghttp2_frame_hd hdΒΆ
    +

    The frame header, which is convenient to inspect frame header.

    +
    + +
    +
    +nghttp2_headers headersΒΆ
    +

    The HEADERS frame.

    +
    + +
    +
    +nghttp2_priority priorityΒΆ
    +

    The PRIORITY frame.

    +
    + +
    +
    +nghttp2_rst_stream rst_streamΒΆ
    +

    The RST_STREAM frame.

    +
    + +
    +
    +nghttp2_settings settingsΒΆ
    +

    The SETTINGS frame.

    +
    + +
    +
    +nghttp2_push_promise push_promiseΒΆ
    +

    The PUSH_PROMISE frame.

    +
    + +
    +
    +nghttp2_ping pingΒΆ
    +

    The PING frame.

    +
    + +
    +
    +nghttp2_goaway goawayΒΆ
    +

    The GOAWAY frame.

    +
    + +
    +
    +nghttp2_window_update window_updateΒΆ
    +

    The WINDOW_UPDATE frame.

    +
    + +
    + +
    +
    +typedef ssize_t (*nghttp2_send_callback)(nghttp2_session *session, const uint8_t *data, size_t length, int flags, void *user_data)ΒΆ
    +

    Callback function invoked when session wants to send data to the +remote peer. The implementation of this function must send at most +length bytes of data stored in data. The flags is currently +not used and always 0. It must return the number of bytes sent if +it succeeds. If it cannot send any single byte without blocking, +it must return NGHTTP2_ERR_WOULDBLOCK. For other errors, it +must return NGHTTP2_ERR_CALLBACK_FAILURE. The user_data +pointer is the third argument passed in to the call to +nghttp2_session_client_new() or nghttp2_session_server_new().

    +
    + +
    +
    +typedef ssize_t (*nghttp2_recv_callback)(nghttp2_session *session, uint8_t *buf, size_t length, int flags, void *user_data)ΒΆ
    +

    Callback function invoked when session wants to receive data from +the remote peer. The implementation of this function must read at +most length bytes of data and store it in buf. The flags is +currently not used and always 0. It must return the number of bytes +written in buf if it succeeds. If it cannot read any single byte +without blocking, it must return NGHTTP2_ERR_WOULDBLOCK. If +it gets EOF before it reads any single byte, it must return +NGHTTP2_ERR_EOF. For other errors, it must return +NGHTTP2_ERR_CALLBACK_FAILURE. Returning 0 is treated as +NGHTTP2_ERR_WOULDBLOCK. The user_data pointer is the +third argument passed in to the call to +nghttp2_session_client_new() or nghttp2_session_server_new().

    +
    + +
    +
    +typedef int (*nghttp2_on_frame_recv_callback)(nghttp2_session *session, const nghttp2_frame *frame, void *user_data)ΒΆ
    +

    Callback function invoked by nghttp2_session_recv() when a +non-DATA frame is received. The user_data pointer is the third +argument passed in to the call to nghttp2_session_client_new() or +nghttp2_session_server_new().

    +

    If the application uses nghttp2_session_mem_recv(), it can return +NGHTTP2_ERR_PAUSE to make nghttp2_session_mem_recv() +return without processing further input bytes. The frame +parameter is retained until nghttp2_session_continue() is +called. The application must retain the input bytes which was used +to produce the frame parameter, because it may refer to the +memory region included in the input bytes. The application which +returns NGHTTP2_ERR_PAUSE must call +nghttp2_session_continue() before nghttp2_session_mem_recv().

    +

    The implementation of this function must return 0 if it +succeeds. It may return NGHTTP2_ERR_PAUSE. If the other +nonzero value is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_invalid_frame_recv_callback)(nghttp2_session *session, const nghttp2_frame *frame, nghttp2_error_code error_code, void *user_data)ΒΆ
    +

    Callback function invoked by nghttp2_session_recv() when an +invalid non-DATA frame is received. The error_code is one of the +nghttp2_error_code and indicates the error. When this +callback function is invoked, the library automatically submits +either RST_STREAM or GOAWAY frame. The user_data pointer is the +third argument passed in to the call to +nghttp2_session_client_new() or nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_data_chunk_recv_callback)(nghttp2_session *session, uint8_t flags, int32_t stream_id, const uint8_t *data, size_t len, void *user_data)ΒΆ
    +

    Callback function invoked when a chunk of data in DATA frame is +received. The stream_id is the stream ID this DATA frame belongs +to. The flags is the flags of DATA frame which this data chunk is +contained. (flags & NGHTTP2_FLAG_END_STREAM) != 0 does not +necessarily mean this chunk of data is the last one in the +stream. You should use nghttp2_on_data_recv_callback to +know all data frames are received. The user_data pointer is the +third argument passed in to the call to +nghttp2_session_client_new() or nghttp2_session_server_new().

    +

    If the application uses nghttp2_session_mem_recv(), it can return +NGHTTP2_ERR_PAUSE to make nghttp2_session_mem_recv() +return without processing further input bytes. The frame +parameter is retained until nghttp2_session_continue() is +called. The application must retain the input bytes which was used +to produce the frame parameter, because it may refer to the +memory region included in the input bytes. The application which +returns NGHTTP2_ERR_PAUSE must call +nghttp2_session_continue() before nghttp2_session_mem_recv().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_data_recv_callback)(nghttp2_session *session, uint16_t length, uint8_t flags, int32_t stream_id, void *user_data)ΒΆ
    +

    Callback function invoked when DATA frame is received. The actual +data it contains are received by +nghttp2_on_data_chunk_recv_callback. The user_data +pointer is the third argument passed in to the call to +nghttp2_session_client_new() or nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_before_frame_send_callback)(nghttp2_session *session, const nghttp2_frame *frame, void *user_data)ΒΆ
    +

    Callback function invoked before the non-DATA frame frame is +sent. This may be useful, for example, to know the stream ID of +HEADERS and PUSH_PROMISE frame (see also +nghttp2_session_get_stream_user_data()), which is not assigned +when it was queued. The user_data pointer is the third argument +passed in to the call to nghttp2_session_client_new() or +nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_frame_send_callback)(nghttp2_session *session, const nghttp2_frame *frame, void *user_data)ΒΆ
    +

    Callback function invoked after the non-DATA frame frame is sent. +The user_data pointer is the third argument passed in to the call +to nghttp2_session_client_new() or +nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_frame_not_send_callback)(nghttp2_session *session, const nghttp2_frame *frame, int lib_error_code, void *user_data)ΒΆ
    +

    Callback function invoked after the non-DATA frame frame is not +sent because of the error. The error is indicated by the +lib_error_code, which is one of the values defined in +nghttp2_error. The user_data pointer is the third +argument passed in to the call to nghttp2_session_client_new() or +nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_data_send_callback)(nghttp2_session *session, uint16_t length, uint8_t flags, int32_t stream_id, void *user_data)ΒΆ
    +

    Callback function invoked after DATA frame is sent. The user_data +pointer is the third argument passed in to the call to +nghttp2_session_client_new() or nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_stream_close_callback)(nghttp2_session *session, int32_t stream_id, nghttp2_error_code error_code, void *user_data)ΒΆ
    +

    Callback function invoked when the stream stream_id is +closed. The reason of closure is indicated by the error_code. The +stream_user_data, which was specified in nghttp2_submit_request() +or nghttp2_submit_headers(), is still available in this +function. The user_data pointer is the third argument passed in +to the call to nghttp2_session_client_new() or +nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_request_recv_callback)(nghttp2_session *session, int32_t stream_id, void *user_data)ΒΆ
    +

    Callback function invoked when the request from the remote peer is +received. In other words, the frame with END_STREAM flag set is +received. In HTTP, this means HTTP request, including request +body, is fully received. The user_data pointer is the third +argument passed in to the call to nghttp2_session_client_new() or +nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_frame_recv_parse_error_callback)(nghttp2_session *session, nghttp2_frame_type type, const uint8_t *head, size_t headlen, const uint8_t *payload, size_t payloadlen, int lib_error_code, void *user_data)ΒΆ
    +

    Callback function invoked when the received control frame octets +could not be parsed correctly. The type indicates the type of +received non-DATA frame. The head is the pointer to the header of +the received frame. The headlen is the length of the +head. According to the spec, the headlen is always 8. In other +words, the head is the first 8 bytes of the received frame. The +payload is the pointer to the data portion of the received frame. +The payloadlen is the length of the payload. This is the data +after the length field. The lib_error_code is one of the error +code defined in nghttp2_error and indicates the error. The +user_data pointer is the third argument passed in to the call to +nghttp2_session_client_new() or nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +typedef int (*nghttp2_on_unknown_frame_recv_callback)(nghttp2_session *session, const uint8_t *head, size_t headlen, const uint8_t *payload, size_t payloadlen, void *user_data)ΒΆ
    +

    Callback function invoked when the received frame type is +unknown. The head is the pointer to the header of the received +frame. The headlen is the length of the head. According to the +spec, the headlen is always 8. In other words, the head is the +first 8 bytes of the received frame. The payload is the pointer +to the data portion of the received frame. The payloadlen is the +length of the payload. This is the data after the length +field. The user_data pointer is the third argument passed in to +the call to nghttp2_session_client_new() or +nghttp2_session_server_new().

    +

    The implementation of this function must return 0 if it +succeeds. If nonzero is returned, it is treated as fatal error and +nghttp2_session_recv() and nghttp2_session_send() functions +immediately return NGHTTP2_ERR_CALLBACK_FAILURE.

    +
    + +
    +
    +nghttp2_session_callbacksΒΆ
    +

    Callback functions.

    +
    +
    +nghttp2_send_callback send_callbackΒΆ
    +

    Callback function invoked when the session wants to send data +to the remote peer.

    +
    + +
    +
    +nghttp2_recv_callback recv_callbackΒΆ
    +

    Callback function invoked when the session wants to receive +data from the remote peer.

    +
    + +
    +
    +nghttp2_on_frame_recv_callback on_frame_recv_callbackΒΆ
    +

    Callback function invoked by nghttp2_session_recv() when a +non-DATA frame is received.

    +
    + +
    +
    +nghttp2_on_invalid_frame_recv_callback on_invalid_frame_recv_callbackΒΆ
    +

    Callback function invoked by nghttp2_session_recv() when an +invalid non-DATA frame is received.

    +
    + +
    +
    +nghttp2_on_data_chunk_recv_callback on_data_chunk_recv_callbackΒΆ
    +

    Callback function invoked when a chunk of data in DATA frame is +received.

    +
    + +
    +
    +nghttp2_on_data_recv_callback on_data_recv_callbackΒΆ
    +

    Callback function invoked when DATA frame is received.

    +
    + +
    +
    +nghttp2_before_frame_send_callback before_frame_send_callbackΒΆ
    +

    Callback function invoked before the non-DATA frame is sent.

    +
    + +
    +
    +nghttp2_on_frame_send_callback on_frame_send_callbackΒΆ
    +

    Callback function invoked after the non-DATA frame is sent.

    +
    + +
    +
    +nghttp2_on_frame_not_send_callback on_frame_not_send_callbackΒΆ
    +

    The callback function invoked when a non-DATA frame is not sent +because of an error.

    +
    + +
    +
    +nghttp2_on_data_send_callback on_data_send_callbackΒΆ
    +

    Callback function invoked after DATA frame is sent.

    +
    + +
    +
    +nghttp2_on_stream_close_callback on_stream_close_callbackΒΆ
    +

    Callback function invoked when the stream is closed.

    +
    + +
    +
    +nghttp2_on_request_recv_callback on_request_recv_callbackΒΆ
    +

    Callback function invoked when request from the remote peer is +received.

    +
    + +
    +
    +nghttp2_on_frame_recv_parse_error_callbackΒΆ
    +

    Callback function invoked when the received non-DATA frame octets +could not be parsed correctly.

    +
    + +
    +
    +nghttp2_on_unknown_frame_recv_callback on_unknown_frame_recv_callbackΒΆ
    +

    Callback function invoked when the received frame type is +unknown.

    +
    + +
    + +
    +
    +nghttp2_gzipΒΆ
    +

    The gzip stream to inflate data. The details of this structure are +intentionally hidden from the public API.

    +
    + +
    +
    +

    FunctionsΒΆ

    +
    +
    +int nghttp2_session_client_new(nghttp2_session **session_ptr, const nghttp2_session_callbacks *callbacks, void *user_data)ΒΆ
    +

    Initializes *session_ptr for client use. The all members of +callbacks are copied to *session_ptr. Therefore *session_ptr +does not store callbacks. user_data is an arbitrary user +supplied data, which will be passed to the callback functions.

    +

    The nghttp2_session_callbacks.send_callback must be +specified. If the application code uses nghttp2_session_recv(), +the nghttp2_session_callbacks.recv_callback must be +specified. The other members of callbacks can be NULL.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_session_server_new(nghttp2_session **session_ptr, const nghttp2_session_callbacks *callbacks, void *user_data)ΒΆ
    +

    Initializes *session_ptr for server use. The all members of +callbacks are copied to *session_ptr. Therefore *session_ptr +does not store callbacks. user_data is an arbitrary user +supplied data, which will be passed to the callback functions.

    +

    The nghttp2_session_callbacks.send_callback must be +specified. If the application code uses nghttp2_session_recv(), +the nghttp2_session_callbacks.recv_callback must be +specified. The other members of callbacks can be NULL.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +void nghttp2_session_del(nghttp2_session *session)ΒΆ
    +

    Frees any resources allocated for session. If session is +NULL, this function does nothing.

    +
    + +
    +
    +int nghttp2_session_set_option(nghttp2_session *session, int optname, void *optval, size_t optlen)ΒΆ
    +

    Sets the configuration option for the session. The optname is +one of nghttp2_opt. The optval is the pointer to the +option value and the optlen is the size of *optval. The +required type of optval varies depending on the optname. See +below.

    +

    The following optname are supported:

    +
    +
    NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE
    +
    The optval must be a pointer to int. If the *optval is +nonzero, the library will not send WINDOW_UPDATE for a stream +automatically. Therefore, the application is responsible for +sending WINDOW_UPDATE using +nghttp2_submit_window_update(). This option defaults to 0.
    +
    NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE
    +
    The optval must be a pointer to int. If the *optval is +nonzero, the library will not send WINDOW_UPDATE for connection +automatically. Therefore, the application is responsible for +sending WINDOW_UPDATE using +nghttp2_submit_window_update(). This option defaults to 0.
    +
    NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS
    +
    The optval must be a pointer to ssize_t. It is an error +if *optval is 0 or negative.
    +
    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The optname is not supported; or the optval and/or the +optlen are invalid.
    +
    +
    + +
    +
    +int nghttp2_session_send(nghttp2_session *session)ΒΆ
    +

    Sends pending frames to the remote peer.

    +

    This function retrieves the highest prioritized frame from the +outbound queue and sends it to the remote peer. It does this as +many as possible until the user callback +nghttp2_session_callbacks.send_callback returns +NGHTTP2_ERR_WOULDBLOCK or the outbound queue becomes empty. +This function calls several callback functions which are passed +when initializing the session. Here is the simple time chart +which tells when each callback is invoked:

    +
      +
    1. Get the next frame to send from outbound queue.
      2. +
    2. Prepare transmission of the frame.
      3. +
    3. If the control frame cannot be sent because some preconditions +are not met (e.g., request HEADERS cannot be sent after +GOAWAY), +nghttp2_session_callbacks.on_ctrl_not_send_callback is +invoked. Abort the following steps.
      4. +
    4. If the frame is request HEADERS, the stream is opened +here.
      5. +
    5. nghttp2_session_callbacks.before_ctrl_send_callback is +invoked.
      6. +
    6. nghttp2_session_callbacks.send_callback is invoked one +or more times to send the frame.
      7. +
    7. If the frame is a control frame, +nghttp2_session_callbacks.on_ctrl_send_callback is +invoked.
      8. +
    8. If the frame is a DATA frame, +nghttp2_session_callbacks.on_data_send_callback is +invoked.
      9. +
    9. If the transmission of the frame triggers closure of the stream, +the stream is closed and +nghttp2_session_callbacks.on_stream_close_callback is +invoked.
      10. +
    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    NGHTTP2_ERR_CALLBACK_FAILURE
    +
    The callback function failed.
    +
    +
    + +
    +
    +int nghttp2_session_recv(nghttp2_session *session)ΒΆ
    +

    Receives frames from the remote peer.

    +

    This function receives as many frames as possible until the user +callback nghttp2_session_callbacks.recv_callback returns +NGHTTP2_ERR_WOULDBLOCK. This function calls several +callback functions which are passed when initializing the +session. Here is the simple time chart which tells when each +callback is invoked:

    +
      +
    1. nghttp2_session_callbacks.recv_callback is invoked one +or more times to receive frame header.
      2. +
    2. If the frame is DATA frame:
      3. +
    +
    +
    +
    2.1. nghttp2_session_callbacks.recv_callback is invoked
    +
    to receive DATA payload. For each chunk of data, +nghttp2_session_callbacks.on_data_chunk_recv_callback +is invoked.
    +
    2.2. If one DATA frame is completely received,
    +
    nghttp2_session_callbacks.on_data_recv_callback is +invoked. If the frame is the final frame of the request, +nghttp2_session_callbacks.on_request_recv_callback +is invoked. If the reception of the frame triggers the +closure of the stream, +nghttp2_session_callbacks.on_stream_close_callback +is invoked.
    +
    +
    +
      +
    1. If the frame is the control frame:
      2. +
    +
    +
    +
    3.1. nghttp2_session_callbacks.recv_callback is invoked
    +
    one or more times to receive whole frame.
    +
    3.2. If the received frame is valid,
    +
    nghttp2_session_callbacks.on_ctrl_recv_callback is +invoked. If the frame is the final frame of the request, +nghttp2_session_callbacks.on_request_recv_callback +is invoked. If the reception of the frame triggers the +closure of the stream, +nghttp2_session_callbacks.on_stream_close_callback +is invoked.
    +
    3.3. If the received frame is unpacked but is interpreted as
    +
    invalid, +nghttp2_session_callbacks.on_invalid_ctrl_recv_callback +is invoked.
    +
    3.4. If the received frame could not be unpacked correctly,
    +
    nghttp2_session_callbacks.on_ctrl_recv_parse_error_callback +is invoked.
    +
    3.5. If the received frame type is unknown,
    +
    nghttp2_session_callbacks.on_unknown_ctrl_recv_callback +is invoked.
    +
    +
    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_EOF
    +
    The remote peer did shutdown on the connection.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    NGHTTP2_ERR_CALLBACK_FAILURE
    +
    The callback function failed.
    +
    +
    + +
    +
    +ssize_t nghttp2_session_mem_recv(nghttp2_session *session, const uint8_t *in, size_t inlen)ΒΆ
    +

    Processes data in as an input from the remote endpoint. The +inlen indicates the number of bytes in the in.

    +

    This function behaves like nghttp2_session_recv() except that it +does not use nghttp2_session_callbacks.recv_callback to +receive data; the in is the only data for the invocation of this +function. If all bytes are processed, this function returns. The +other callbacks are called in the same way as they are in +nghttp2_session_recv().

    +

    In the current implementation, this function always tries to +processes all input data unless either an error occurs or +NGHTTP2_ERR_PAUSE is returned from +nghttp2_session_callbacks.on_frame_recv_callback or +nghttp2_session_callbacks.on_data_chunk_recv_callback. +If NGHTTP2_ERR_PAUSE is used, the return value includes the +number of bytes which was used to produce the data or frame for the +callback.

    +

    This function returns the number of processed bytes, or one of the +following negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    NGHTTP2_ERR_CALLBACK_FAILURE
    +
    The callback function failed.
    +
    +
    + +
    +
    +int nghttp2_session_continue(nghttp2_session *session)ΒΆ
    +

    Perform post-processing after nghttp2_session_mem_recv() was +paused by NGHTTP2_ERR_PAUSE from +nghttp2_session_callbacks.on_frame_recv_callback or +nghttp2_session_callbacks.on_data_chunk_recv_callback.

    +

    This function frees resources associated with paused frames. It +may also call additional callbacks, such as +nghttp2_session_callbacks.on_stream_close_callback.

    +

    If this function succeeds, the application can call +nghttp2_session_mem_recv() again.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    NGHTTP2_ERR_CALLBACK_FAILURE
    +
    The callback function failed.
    +
    +
    + +
    +
    +int nghttp2_session_resume_data(nghttp2_session *session, int32_t stream_id)ΒΆ
    +

    Puts back previously deferred DATA frame in the stream stream_id +to the outbound queue.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The stream does not exist or no deferred data exist.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_session_want_read(nghttp2_session *session)ΒΆ
    +

    Returns nonzero value if session wants to receive data from the +remote peer.

    +

    If both nghttp2_session_want_read() and +nghttp2_session_want_write() return 0, the application should +drop the connection.

    +
    + +
    +
    +int nghttp2_session_want_write(nghttp2_session *session)ΒΆ
    +

    Returns nonzero value if session wants to send data to the remote +peer.

    +

    If both nghttp2_session_want_read() and +nghttp2_session_want_write() return 0, the application should +drop the connection.

    +
    + +
    +
    +void* nghttp2_session_get_stream_user_data(nghttp2_session *session, int32_t stream_id)ΒΆ
    +

    Returns stream_user_data for the stream stream_id. The +stream_user_data is provided by nghttp2_submit_request() or +nghttp2_submit_syn_stream(). If the stream is initiated by the +remote endpoint, stream_user_data is always NULL. If the stream +is initiated by the local endpoint and NULL is given in +nghttp2_submit_request() or nghttp2_submit_syn_stream(), then +this function returns NULL. If the stream does not exist, this +function returns NULL.

    +
    + +
    +
    +size_t nghttp2_session_get_outbound_queue_size(nghttp2_session *session)ΒΆ
    +

    Returns the number of frames in the outbound queue. This does not +include the deferred DATA frames.

    +
    + +
    +
    +int32_t nghttp2_session_get_stream_effective_recv_data_length(nghttp2_session *session, int32_t stream_id)ΒΆ
    +

    Returns the number of DATA payload in bytes received without +WINDOW_UPDATE transmission for the stream stream_id. The local +(receive) window size can be adjusted by +nghttp2_submit_window_update(). This function takes into account +that and returns effective data length. In particular, if the +local window size is reduced by submitting negative +window_size_increment with nghttp2_submit_window_update(), this +function returns the number of bytes less than actually received.

    +

    If flow control is disabled for that stream, this function returns +0.

    +

    This function returns -1 if it fails.

    +
    + +
    +
    +int32_t nghttp2_session_get_stream_effective_local_window_size(nghttp2_session *session, int32_t stream_id)ΒΆ
    +

    Returns the local (receive) window size for the stream +stream_id. The local window size can be adjusted by +nghttp2_submit_window_update(). This function takes into account +that and returns effective window size.

    +

    This function returns -1 if it fails.

    +
    + +
    +
    +int32_t nghttp2_session_get_effective_recv_data_length(nghttp2_session *session)ΒΆ
    +

    Returns the number of DATA payload in bytes received without +WINDOW_UPDATE transmission for a connection. The local (receive) +window size can be adjusted by +nghttp2_submit_window_update(). This function takes into account +that and returns effective data length. In particular, if the local +window size is reduced by submitting negative window_size_increment +with nghttp2_submit_window_update(), this function returns the +number of bytes less than actually received.

    +

    If flow control is disabled for a connection, this function returns +0.

    +

    This function returns -1 if it fails.

    +
    + +
    +
    +int32_t nghttp2_session_get_effective_local_window_size(nghttp2_session *session)ΒΆ
    +

    Returns the local (receive) window size for a connection. The local +window size can be adjusted by +nghttp2_submit_window_update(). This function takes into account +that and returns effective window size.

    +

    This function returns -1 if it fails.

    +
    + +
    +
    +int nghttp2_session_fail_session(nghttp2_session *session, nghttp2_error_code error_code)ΒΆ
    +

    Submits GOAWAY frame with the given error_code.

    +

    This function should be called when the connection should be +terminated after sending GOAWAY. If the remaining streams should be +processed after GOAWAY, use nghttp2_submit_goaway() instead.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_session_upgrade(nghttp2_session *session, const uint8_t *settings_payload, size_t settings_payloadlen, void *stream_user_data)ΒΆ
    +

    Performs post-process of HTTP Upgrade request. This function can be +called from both client and server, but the behavior is very +different in each other.

    +

    If called from client side, the settings_payload must be the +value sent in HTTP2-Settings header field and must be decoded +by base64url decoder. The settings_payloadlen is the length of +settings_payload. The settings_payload is unpacked and its +setting values will be submitted using +nghttp2_submit_settings(). This means that the client application +code does not need to submit SETTINGS by itself. The stream with +stream ID=1 is opened and the stream_user_data is used for its +stream_user_data. The opened stream becomes half-closed (local) +state.

    +

    If called from server side, the settings_payload must be the +value received in HTTP2-Settings header field and must be +decoded by base64url decoder. The settings_payloadlen is the +length of settings_payload. It is treated as if the SETTINGS +frame with that payload is received. Thus, callback functions for +the reception of SETTINGS frame will be invoked. The stream with +stream ID=1 is opened. The stream_user_data is ignored. The +opened stream becomes half-closed (remote).

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The settings_payload is badly formed.
    +
    NGHTTP2_ERR_PROTO
    +
    The stream ID 1 is already used or closed; or is not available; +or the settings_payload does not include both +NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS and +NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE.
    +
    +
    + +
    +
    +ssize_t nghttp2_pack_settings_payload(uint8_t *buf, size_t buflen, const nghttp2_settings_entry *iv, size_t niv)ΒΆ
    +

    Serializes the SETTINGS values iv in the buf. The size of the +buf is specified by buflen. The number of entries in the iv +array is given by niv. The required space in buf for the niv +entries is 8*niv bytes and if the given buffer is too small, an +error is returned. This function is used mainly for creating a +SETTINGS payload to be sent with the HTTP2-Settings header +field in an HTTP Upgrade request. The data written in buf is NOT +base64url encoded and the application is responsible for encoding.

    +

    This function returns the number of bytes written in buf, or one +of the following negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The iv contains duplicate settings ID or invalid value.
    +
    NGHTTP2_ERR_INSUFF_BUFSIZE
    +
    The provided buflen size is too small to hold the output.
    +
    +
    + +
    +
    +const char* nghttp2_strerror(int lib_error_code)ΒΆ
    +

    Returns string describing the lib_error_code. The +lib_error_code must be one of the nghttp2_error.

    +
    + +
    +
    +int nghttp2_submit_request(nghttp2_session *session, int32_t pri, const char **nv, const nghttp2_data_provider *data_prd, void *stream_user_data)ΒΆ
    +

    Submits HEADERS frame and optionally one or more DATA frames.

    +

    The pri is priority of this request. 0 is the highest priority +value and NGHTTP2_PRI_LOWEST is the lowest value.

    +

    The nv contains the name/value pairs. For i >= 0, nv[2*i] +contains a pointer to the name string and nv[2*i+1] contains a +pointer to the value string. The one beyond last value must be +NULL. That is, if the nv contains N name/value pairs, +nv[2*N] must be NULL.

    +

    HTTP/2.0 specification has requirement about header fields in the +request HEADERS. See the specification for more details.

    +

    This function creates copies of all name/value pairs in nv. It +also lower-cases all names in nv.

    +

    The string in nv must be NULL-terminated. Use +nghttp2_submit_request2() if name/value pairs are not +NULL-terminated strings.

    +

    If data_prd is not NULL, it provides data which will be sent +in subsequent DATA frames. In this case, a method that allows +request message bodies +(http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9) must +be specified with :method key in nv (e.g. POST). This +function does not take ownership of the data_prd. The function +copies the members of the data_prd. If data_prd is NULL, +HEADERS have END_STREAM set. The stream_user_data is data +associated to the stream opened by this request and can be an +arbitrary pointer, which can be retrieved later by +nghttp2_session_get_stream_user_data().

    +

    Since the library reorders the frames and tries to send the highest +prioritized one first and the HTTP/2.0 specification requires the +stream ID must be strictly increasing, the stream ID of this +request cannot be known until it is about to sent. To know the +stream ID of the request, the application can use +nghttp2_session_callbacks.before_ctrl_send_callback. This +callback is called just before the frame is sent. For HEADERS +frame, the argument frame has the stream ID assigned. Also since +the stream is already opened, +nghttp2_session_get_stream_user_data() can be used to get +stream_user_data to identify which HEADERS we are processing.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The pri is invalid; or the nv includes empty name or +NULL value.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_request2(nghttp2_session *session, int32_t pri, const nghttp2_nv *nva, size_t nvlen, const nghttp2_data_provider *data_prd, void *stream_user_data)ΒΆ
    +

    Just like nghttp2_submit_request(), but this function takes the +nva, which is an array of nghttp2_nv with nvlen elements, +as name/value pairs. This function is useful if name/value pairs +are not NULL-terminated strings.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The pri is invalid; or the nva includes empty name or +name which contains invalid characters.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_response(nghttp2_session *session, int32_t stream_id, const char **nv, const nghttp2_data_provider *data_prd)ΒΆ
    +

    Submits response HEADERS frame and optionally one or more DATA +frames against the stream stream_id.

    +

    The nv contains the name/value pairs. For i >= 0, nv[2*i] +contains a pointer to the name string and nv[2*i+1] contains a +pointer to the value string. The one beyond last value must be +NULL. That is, if the nv contains N name/value pairs, +nv[2*N] must be NULL.

    +

    HTTP/2.0 specification has requirement about header fields in the +response HEADERS. See the specification for more details.

    +

    This function creates copies of all name/value pairs in nv. It +also lower-cases all names in nv.

    +

    If data_prd is not NULL, it provides data which will be sent +in subsequent DATA frames. This function does not take ownership +of the data_prd. The function copies the members of the +data_prd. If data_prd is NULL, HEADERS will have +END_STREAM flag set.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The nv includes empty name or NULL value.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_headers(nghttp2_session *session, uint8_t flags, int32_t stream_id, int32_t pri, const char **nv, void *stream_user_data)ΒΆ
    +

    Submits HEADERS frame. The flags is bitwise OR of the +following values:

    + +

    If flags includes NGHTTP2_FLAG_END_STREAM, this frame has +END_STREAM flag set. The library does not support header +continuation and the HEADERS frame always has +NGHTTP2_FLAG_END_HEADERS flag set regardless of the flags +value.

    +

    If the stream_id is -1, this frame is assumed as request (i.e., +request HEADERS frame which opens new stream). In this case, the +actual stream ID is assigned just before the frame is sent. For +response, specify stream ID in stream_id.

    +

    The pri is priority of this request.

    +

    The nv contains the name/value pairs. For i >= 0, nv[2*i] +contains a pointer to the name string and nv[2*i+1] contains a +pointer to the value string. The one beyond last value must be +NULL. That is, if the nv contains N name/value pairs, +nv[2*N] must be NULL.

    +

    This function creates copies of all name/value pairs in nv. It +also lower-cases all names in nv.

    +

    The stream_user_data is a pointer to an arbitrary data which is +associated to the stream this frame will open. Therefore it is only +used if this frame opens streams, in other words, it changes stream +state from idle or reserved to open.

    +

    This function is low-level in a sense that the application code can +specify flags directly. For usual HTTP request, +nghttp2_submit_request() is useful.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The pri is invalid; or the nv includes empty name or +NULL value.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_data(nghttp2_session *session, uint8_t flags, int32_t stream_id, const nghttp2_data_provider *data_prd)ΒΆ
    +

    Submits one or more DATA frames to the stream stream_id. The +data to be sent are provided by data_prd. If flags contains +NGHTTP2_FLAG_END_STREAM, the last DATA frame has END_STREAM +flag set.

    +

    This function does not take ownership of the data_prd. The +function copies the members of the data_prd.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    NGHTTP2_ERR_STREAM_CLOSED
    +
    The stream is already closed or does not exist.
    +
    +
    + +
    +
    +int nghttp2_submit_priority(nghttp2_session *session, uint8_t flags, int32_t stream_id, int32_t pri)ΒΆ
    +

    Submits PRIORITY frame to change the priority of stream stream_id +to the priority value pri.

    +

    The flags is currently ignored and should be +NGHTTP2_FLAG_NONE.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The pri is negative.
    +
    NGHTTP2_ERR_STREAM_CLOSED
    +
    The stream is already closed or does not exist.
    +
    +
    + +
    +
    +int nghttp2_submit_rst_stream(nghttp2_session *session, uint8_t flags, int32_t stream_id, nghttp2_error_code error_code)ΒΆ
    +

    Submits RST_STREAM frame to cancel/reject the stream stream_id +with the error code error_code.

    +

    The flags is currently ignored and should be +NGHTTP2_FLAG_NONE.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_settings(nghttp2_session *session, uint8_t flags, const nghttp2_settings_entry *iv, size_t niv)ΒΆ
    +

    Stores local settings and submits SETTINGS frame. The iv is the +pointer to the array of nghttp2_settings_entry. The niv +indicates the number of nghttp2_settings_entry.

    +

    The flags is currently ignored and should be +NGHTTP2_FLAG_NONE.

    +

    This function does not take ownership of the iv. This function +copies all the elements in the iv.

    +

    While updating individual stream’s local window size, if the window +size becomes strictly larger than NGHTTP2_MAX_WINDOW_SIZE, +RST_STREAM is issued against such a stream.

    +

    SETTINGS with NGHTTP2_FLAG_ACK is automatically submitted +by the library and application could not send it at its will.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The iv contains invalid value (e.g., attempting to re-enable +flow control).
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_push_promise(nghttp2_session *session, uint8_t flags, int32_t stream_id, const char **nv)ΒΆ
    +

    Submits PUSH_PROMISE frame. The flags is currently ignored and +the resulting PUSH_PROMISE frame always has +NGHTTP2_FLAG_END_PUSH_PROMISE flag set due to the lack of +header continuation support in the library.

    +

    The stream_id must be client initiated stream ID.

    +

    The nv contains the name/value pairs. For i >= 0, nv[2*i] +contains a pointer to the name string and nv[2*i+1] contains a +pointer to the value string. The one beyond last value must be +NULL. That is, if the nv contains N name/value pairs, +nv[2*N] must be NULL.

    +

    This function creates copies of all name/value pairs in nv. It +also lower-cases all names in nv.

    +

    Since the library reorders the frames and tries to send the highest +prioritized one first and the HTTP/2.0 specification requires the +stream ID must be strictly increasing, the promised stream ID +cannot be known until it is about to sent. To know the promised +stream ID, the application can use +nghttp2_session_callbacks.before_frame_send_callback. This +callback is called just before the frame is sent. For PUSH_PROMISE +frame, the argument frame has the promised stream ID assigned.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_INVALID_ARGUMENT
    +
    The nv includes empty name or NULL value.
    +
    NGHTTP2_ERR_STREAM_CLOSED
    +
    The stream is already closed or does not exist.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_ping(nghttp2_session *session, uint8_t flags, uint8_t *opaque_data)ΒΆ
    +

    Submits PING frame. You don’t have to send PING back when you +received PING frame. The library automatically submits PING frame +in this case.

    +

    The flags is currently ignored and should be +NGHTTP2_FLAG_NONE.

    +

    If the opaque_data is non NULL, then it should point to the 8 +bytes array of memory to specify opaque data to send with PING +frame. If the opaque_data is NULL, zero-cleared 8 bytes will +be sent as opaque data.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_goaway(nghttp2_session *session, uint8_t flags, nghttp2_error_code error_code, uint8_t *opaque_data, size_t opaque_data_len)ΒΆ
    +

    Submits GOAWAY frame with the error code error_code.

    +

    The flags is currently ignored and should be +NGHTTP2_FLAG_NONE.

    +

    If the opaque_data is not NULL and opaque_data_len is not +zero, those data will be sent as additional debug data. The +library makes a copy of the memory region pointed by opaque_data +with the length opaque_data_len, so the caller does not need to +keep this memory after the return of this function. If the +opaque_data_len is 0, the opaque_data could be NULL.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_submit_window_update(nghttp2_session *session, uint8_t flags, int32_t stream_id, int32_t window_size_increment)ΒΆ
    +

    Submits WINDOW_UPDATE frame.

    +

    The flags is currently ignored and should be +NGHTTP2_FLAG_NONE.

    +

    If the window_size_increment is positive, the WINDOW_UPDATE with +that value as window_size_increment is queued. If the +window_size_increment is larger than the received bytes from the +remote endpoint, the local window size is increased by that +difference.

    +

    If the window_size_increment is negative, the local window size +is decreased by -window_size_increment. If +NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE (or +NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE if stream_id +is 0) is not set and the library decided that the WINDOW_UPDATE +should be submitted, then WINDOW_UPDATE is queued with the current +received bytes count.

    +

    If the window_size_increment is 0, the function does nothing and +returns 0.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_FLOW_CONTROL
    +
    The local window size overflow or gets negative.
    +
    NGHTTP2_ERR_STREAM_CLOSED
    +
    The stream is already closed or does not exist.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +int nghttp2_nv_compare_name(const nghttp2_nv *lhs, const nghttp2_nv *rhs)ΒΆ
    +

    Compares lhs->name with lhs->namelen bytes and rhs->name with +rhs->namelen bytes. Returns negative integer if lhs->name is found +to be less than rhs->name; or returns positive integer if lhs->name +is found to be greater than rhs->name; or returns 0 otherwise.

    +
    + +
    +
    +int nghttp2_select_next_protocol(unsigned char **out, unsigned char *outlen, const unsigned char *in, unsigned int inlen)ΒΆ
    +

    A helper function for dealing with NPN in client side. The in +contains server’s protocol in preferable order. The format of in +is length-prefixed and not null-terminated. For example, +HTTP-draft-04/2.0 and http/1.1 stored in in like this:

    +
    in[0] = 17
+in[1..17] = "HTTP-draft-04/2.0"
+in[18] = 8
+in[19..26] = "http/1.1"
+inlen = 27
+
    +
    +

    The selection algorithm is as follows:

    +
      +
    1. If server’s list contains HTTP-draft-04/2.0, it is selected +and returns 1. The following step is not taken.
      2. +
    2. If server’s list contains http/1.1, this function selects +http/1.1 and returns 0. The following step is not taken.
      3. +
    3. This function selects nothing and returns -1. (So called +non-overlap case). In this case, out and outlen are left +untouched.
      4. +
    +

    Selecting HTTP-draft-04/2.0 means that HTTP-draft-04/2.0 is +written into *out and its length (which is 17) is +assigned to *outlen.

    +

    See http://technotes.googlecode.com/git/nextprotoneg.html for more +details about NPN.

    +

    To use this method you should do something like:

    +
    static int select_next_proto_cb(SSL* ssl,
+                                unsigned char **out,
+                                unsigned char *outlen,
+                                const unsigned char *in,
+                                unsigned int inlen,
+                                void *arg)
+{
+    int rv;
+    rv = nghttp2_select_next_protocol(out, outlen, in, inlen);
+    if(rv == 1) {
+        ((MyType*)arg)->http2_selected = 1;
+    }
+    return SSL_TLSEXT_ERR_OK;
+}
+...
+SSL_CTX_set_next_proto_select_cb(ssl_ctx, select_next_proto_cb, my_obj);
+
    +
    +

    Note that the HTTP/2.0 spec does use ALPN instead of NPN. This +function is provided for transitional period before ALPN is got +implemented in major SSL/TLS libraries.

    +
    + +
    +
    +int nghttp2_gzip_inflate_new(nghttp2_gzip **inflater_ptr)ΒΆ
    +

    A helper function to set up a per request gzip stream to inflate data.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_GZIP
    +
    The initialization of gzip stream failed.
    +
    NGHTTP2_ERR_NOMEM
    +
    Out of memory.
    +
    +
    + +
    +
    +void nghttp2_gzip_inflate_del(nghttp2_gzip *inflater)ΒΆ
    +

    Frees the inflate stream. The inflater may be NULL.

    +
    + +
    +
    +int nghttp2_gzip_inflate(nghttp2_gzip *inflater, uint8_t *out, size_t *outlen_ptr, const uint8_t *in, size_t *inlen_ptr)ΒΆ
    +

    Inflates data in in with the length *inlen_ptr and stores the +inflated data to out which has allocated size at least +*outlen_ptr. On return, *outlen_ptr is updated to represent +the number of data written in out. Similarly, *inlen_ptr is +updated to represent the number of input bytes processed.

    +

    This function returns 0 if it succeeds, or one of the following +negative error codes:

    +
    +
    NGHTTP2_ERR_GZIP
    +
    The inflation of gzip stream failed.
    +
    +

    The example follows:

    +
    void on_data_chunk_recv_callback(nghttp2_session *session,
+                                 uint8_t flags,
+                                 int32_t stream_id,
+                                 const uint8_t *data, size_t len,
+                                 void *user_data)
+{
+    ...
+    req = nghttp2_session_get_stream_user_data(session, stream_id);
+    nghttp2_gzip *inflater = req->inflater;
+    while(len > 0) {
+        uint8_t out[MAX_OUTLEN];
+        size_t outlen = MAX_OUTLEN;
+        size_t tlen = len;
+        int rv;
+        rv = nghttp2_gzip_inflate(inflater, out, &outlen, data, &tlen);
+        if(rv != 0) {
+            nghttp2_submit_rst_stream(session, stream_id,
+                                      NGHTTP2_INTERNAL_ERROR);
+            break;
+        }
+        ... Do stuff ...
+        data += tlen;
+        len -= tlen;
+    }
+    ....
+}
+
    +
    +
    + +
    +
    +nghttp2_info *nghttp2_version(int least_version)ΒΆ
    +

    Returns a pointer to a nghttp2_info struct with version information about +the run-time library in use. The least_version argument can be set to a +24 bit numerical value for the least accepted version number and if the +condition is not met, this function will return a NULL. Pass in 0 to skip +the version checking.

    +
    + +
    +
    + + +
    +
    +
    +
    +

    Menu

    + +

    Table Of Contents

    + + +

    Previous topic

    +

    nghttp2 - HTTP/2.0 C Library

    +

    Next topic

    +

    nghttp2.h

    +

    This Page

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2012, 2013, Tatsuhiro Tsujikawa. + Created using Sphinx 1.1.3. +
    + + \ No newline at end of file diff --git a/released-versions/v0.2.0/genindex.html b/released-versions/v0.2.0/genindex.html new file mode 100644 index 00000000..56d92912 --- /dev/null +++ b/released-versions/v0.2.0/genindex.html @@ -0,0 +1,1014 @@ + + + + + + + + + + + + Index — nghttp2 0.2.0 documentation + + + + + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + + +

    Index

    + +
    + N + +
    +

    N

    + + + +
    + +
    nghttp2_before_frame_send_callback (C type) +
    + + +
    NGHTTP2_CANCEL (C macro) +
    + + +
    NGHTTP2_CLIENT_CONNECTION_HEADER (C macro) +
    + + +
    NGHTTP2_CLIENT_CONNECTION_HEADER_LEN (C macro) +
    + + +
    NGHTTP2_COMPRESSION_ERROR (C macro) +
    + + +
    NGHTTP2_CONNECT_ERROR (C macro) +
    + + +
    NGHTTP2_DATA (C macro) +
    + + +
    nghttp2_data_provider (C type) +
    + + +
    nghttp2_data_provider.read_callback (C member) +
    + + +
    nghttp2_data_provider.source (C member) +
    + + +
    nghttp2_data_source (C type) +
    + + +
    nghttp2_data_source.fd (C member) +
    + + +
    nghttp2_data_source.ptr (C member) +
    + + +
    nghttp2_data_source_read_callback (C type) +
    + + +
    NGHTTP2_ENHANCE_YOUR_CALM (C macro) +
    + + +
    NGHTTP2_ERR_CALLBACK_FAILURE (C macro) +
    + + +
    NGHTTP2_ERR_DEFERRED (C macro) +
    + + +
    NGHTTP2_ERR_DEFERRED_DATA_EXIST (C macro) +
    + + +
    NGHTTP2_ERR_EOF (C macro) +
    + + +
    NGHTTP2_ERR_FATAL (C macro) +
    + + +
    NGHTTP2_ERR_FLOW_CONTROL (C macro) +
    + + +
    NGHTTP2_ERR_FRAME_SIZE_ERROR (C macro) +
    + + +
    NGHTTP2_ERR_GOAWAY_ALREADY_SENT (C macro) +
    + + +
    NGHTTP2_ERR_GZIP (C macro) +
    + + +
    NGHTTP2_ERR_HEADER_COMP (C macro) +
    + + +
    NGHTTP2_ERR_INSUFF_BUFSIZE (C macro) +
    + + +
    NGHTTP2_ERR_INVALID_ARGUMENT (C macro) +
    + + +
    NGHTTP2_ERR_INVALID_FRAME (C macro) +
    + + +
    NGHTTP2_ERR_INVALID_HEADER_BLOCK (C macro) +
    + + +
    NGHTTP2_ERR_INVALID_STATE (C macro) +
    + + +
    NGHTTP2_ERR_INVALID_STREAM_ID (C macro) +
    + + +
    NGHTTP2_ERR_INVALID_STREAM_STATE (C macro) +
    + + +
    NGHTTP2_ERR_NOMEM (C macro) +
    + + +
    NGHTTP2_ERR_PAUSE (C macro) +
    + + +
    NGHTTP2_ERR_PROTO (C macro) +
    + + +
    NGHTTP2_ERR_PUSH_DISABLED (C macro) +
    + + +
    NGHTTP2_ERR_START_STREAM_NOT_ALLOWED (C macro) +
    + + +
    NGHTTP2_ERR_STREAM_CLOSED (C macro) +
    + + +
    NGHTTP2_ERR_STREAM_CLOSING (C macro) +
    + + +
    NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE (C macro) +
    + + +
    NGHTTP2_ERR_STREAM_SHUT_WR (C macro) +
    + + +
    NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE (C macro) +
    + + +
    NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGS (C macro) +
    + + +
    NGHTTP2_ERR_UNSUPPORTED_VERSION (C macro) +
    + + +
    NGHTTP2_ERR_WOULDBLOCK (C macro) +
    + + +
    nghttp2_error (C type) +
    + + +
    nghttp2_error_code (C type) +
    + + +
    nghttp2_flag (C type) +
    + + +
    NGHTTP2_FLAG_ACK (C macro) +
    + + +
    NGHTTP2_FLAG_END_HEADERS (C macro) +
    + + +
    NGHTTP2_FLAG_END_PUSH_PROMISE (C macro) +
    + + +
    NGHTTP2_FLAG_END_STREAM (C macro) +
    + + +
    NGHTTP2_FLAG_NONE (C macro) +
    + + +
    NGHTTP2_FLAG_PRIORITY (C macro) +
    + + +
    NGHTTP2_FLOW_CONTROL_ERROR (C macro) +
    + + +
    nghttp2_frame (C type) +
    + + +
    nghttp2_frame.goaway (C member) +
    + + +
    nghttp2_frame.hd (C member) +
    + + +
    nghttp2_frame.headers (C member) +
    + + +
    nghttp2_frame.ping (C member) +
    + + +
    nghttp2_frame.priority (C member) +
    + + +
    nghttp2_frame.push_promise (C member) +
    + + +
    nghttp2_frame.rst_stream (C member) +
    + + +
    nghttp2_frame.settings (C member) +
    + + +
    nghttp2_frame.window_update (C member) +
    + + +
    nghttp2_frame_hd (C type) +
    + + +
    nghttp2_frame_hd.flags (C member) +
    + + +
    nghttp2_frame_hd.length (C member) +
    + + +
    nghttp2_frame_hd.stream_id (C member) +
    + + +
    nghttp2_frame_hd.type (C member) +
    + + +
    NGHTTP2_FRAME_SIZE_ERROR (C macro) +
    + + +
    nghttp2_frame_type (C type) +
    + + +
    NGHTTP2_GOAWAY (C macro) +
    + + +
    nghttp2_goaway (C type) +
    + + +
    nghttp2_goaway.error_code (C member) +
    + + +
    nghttp2_goaway.hd (C member) +
    + + +
    nghttp2_goaway.last_stream_id (C member) +
    + + +
    nghttp2_goaway.opaque_data (C member) +
    + + +
    nghttp2_goaway.opaque_data_len (C member) +
    + + +
    nghttp2_gzip (C type) +
    + + +
    nghttp2_gzip_inflate (C function) +
    + + +
    nghttp2_gzip_inflate_del (C function) +
    + + +
    nghttp2_gzip_inflate_new (C function) +
    + + +
    NGHTTP2_HCAT_HEADERS (C macro) +
    + + +
    NGHTTP2_HCAT_PUSH_RESPONSE (C macro) +
    + + +
    NGHTTP2_HCAT_REQUEST (C macro) +
    + + +
    NGHTTP2_HCAT_RESPONSE (C macro) +
    + + +
    NGHTTP2_HEADERS (C macro) +
    + + +
    nghttp2_headers (C type) +
    + + +
    nghttp2_headers.hd (C member) +
    + + +
    nghttp2_headers.nva (C member) +
    + + +
    nghttp2_headers.nvlen (C member) +
    + + +
    nghttp2_headers.pri (C member) +
    + + +
    nghttp2_headers_category (C type) +
    + + +
    nghttp2_info (C type) +
    + + +
    nghttp2_info.age (C member) +
    + + +
    nghttp2_info.proto_str (C member) +
    + + +
    nghttp2_info.version_num (C member) +
    + + +
    nghttp2_info.version_str (C member) +
    + + +
    NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZE (C macro) +
    + + +
    NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMS (C macro) +
    + + +
    NGHTTP2_INITIAL_WINDOW_SIZE (C macro) +
    + + +
    NGHTTP2_INTERNAL_ERROR (C macro) +
    + + +
    NGHTTP2_MAX_HEADER_TABLE_SIZE (C macro) +
    + + +
    NGHTTP2_MAX_WINDOW_SIZE (C macro) +
    + + +
    NGHTTP2_NO_ERROR (C macro) +
    + + +
    nghttp2_nv (C type) +
    + + +
    nghttp2_nv.name (C member) +
    + + +
    nghttp2_nv.namelen (C member) +
    + + +
    nghttp2_nv.value (C member) +
    + + +
    nghttp2_nv.valuelen (C member) +
    + + +
    nghttp2_nv_compare_name (C function) +
    + + +
    nghttp2_on_data_chunk_recv_callback (C type) +
    + + +
    nghttp2_on_data_recv_callback (C type) +
    + +
    + +
    nghttp2_on_data_send_callback (C type) +
    + + +
    nghttp2_on_frame_not_send_callback (C type) +
    + + +
    nghttp2_on_frame_recv_callback (C type) +
    + + +
    nghttp2_on_frame_recv_parse_error_callback (C type) +
    + + +
    nghttp2_on_frame_send_callback (C type) +
    + + +
    nghttp2_on_invalid_frame_recv_callback (C type) +
    + + +
    nghttp2_on_request_recv_callback (C type) +
    + + +
    nghttp2_on_stream_close_callback (C type) +
    + + +
    nghttp2_on_unknown_frame_recv_callback (C type) +
    + + +
    nghttp2_opt (C type) +
    + + +
    NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE (C macro) +
    + + +
    NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE (C macro) +
    + + +
    NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS (C macro) +
    + + +
    nghttp2_pack_settings_payload (C function) +
    + + +
    NGHTTP2_PING (C macro) +
    + + +
    nghttp2_ping (C type) +
    + + +
    nghttp2_ping.hd (C member) +
    + + +
    NGHTTP2_PRI_DEFAULT (C macro) +
    + + +
    NGHTTP2_PRI_LOWEST (C macro) +
    + + +
    NGHTTP2_PRIORITY (C macro) +
    + + +
    nghttp2_priority (C type) +
    + + +
    nghttp2_priority.hd (C member) +
    + + +
    nghttp2_priority.pri (C member) +
    + + +
    NGHTTP2_PROTO_VERSION_ID (C macro) +
    + + +
    NGHTTP2_PROTO_VERSION_ID_LEN (C macro) +
    + + +
    NGHTTP2_PROTOCOL_ERROR (C macro) +
    + + +
    NGHTTP2_PUSH_PROMISE (C macro) +
    + + +
    nghttp2_push_promise (C type) +
    + + +
    nghttp2_push_promise.hd (C member) +
    + + +
    nghttp2_push_promise.nva (C member) +
    + + +
    nghttp2_push_promise.nvlen (C member) +
    + + +
    nghttp2_push_promise.promised_stream_id (C member) +
    + + +
    nghttp2_recv_callback (C type) +
    + + +
    NGHTTP2_REFUSED_STREAM (C macro) +
    + + +
    NGHTTP2_RST_STREAM (C macro) +
    + + +
    nghttp2_rst_stream (C type) +
    + + +
    nghttp2_rst_stream.error_code (C member) +
    + + +
    nghttp2_rst_stream.hd (C member) +
    + + +
    nghttp2_select_next_protocol (C function) +
    + + +
    nghttp2_send_callback (C type) +
    + + +
    nghttp2_session (C type) +
    + + +
    nghttp2_session_callbacks (C type) +
    + + +
    nghttp2_session_callbacks.before_frame_send_callback (C member) +
    + + +
    nghttp2_session_callbacks.nghttp2_on_frame_recv_parse_error_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_data_chunk_recv_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_data_recv_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_data_send_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_frame_not_send_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_frame_recv_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_frame_send_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_invalid_frame_recv_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_request_recv_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_stream_close_callback (C member) +
    + + +
    nghttp2_session_callbacks.on_unknown_frame_recv_callback (C member) +
    + + +
    nghttp2_session_callbacks.recv_callback (C member) +
    + + +
    nghttp2_session_callbacks.send_callback (C member) +
    + + +
    nghttp2_session_client_new (C function) +
    + + +
    nghttp2_session_continue (C function) +
    + + +
    nghttp2_session_del (C function) +
    + + +
    nghttp2_session_fail_session (C function) +
    + + +
    nghttp2_session_get_effective_local_window_size (C function) +
    + + +
    nghttp2_session_get_effective_recv_data_length (C function) +
    + + +
    nghttp2_session_get_outbound_queue_size (C function) +
    + + +
    nghttp2_session_get_stream_effective_local_window_size (C function) +
    + + +
    nghttp2_session_get_stream_effective_recv_data_length (C function) +
    + + +
    nghttp2_session_get_stream_user_data (C function) +
    + + +
    nghttp2_session_mem_recv (C function) +
    + + +
    nghttp2_session_recv (C function) +
    + + +
    nghttp2_session_resume_data (C function) +
    + + +
    nghttp2_session_send (C function) +
    + + +
    nghttp2_session_server_new (C function) +
    + + +
    nghttp2_session_set_option (C function) +
    + + +
    nghttp2_session_upgrade (C function) +
    + + +
    nghttp2_session_want_read (C function) +
    + + +
    nghttp2_session_want_write (C function) +
    + + +
    NGHTTP2_SETTINGS (C macro) +
    + + +
    nghttp2_settings (C type) +
    + + +
    nghttp2_settings.hd (C member) +
    + + +
    nghttp2_settings.iv (C member) +
    + + +
    nghttp2_settings.niv (C member) +
    + + +
    NGHTTP2_SETTINGS_ENABLE_PUSH (C macro) +
    + + +
    nghttp2_settings_entry (C type) +
    + + +
    nghttp2_settings_entry.settings_id (C member) +
    + + +
    nghttp2_settings_entry.value (C member) +
    + + +
    NGHTTP2_SETTINGS_FLOW_CONTROL_OPTIONS (C macro) +
    + + +
    NGHTTP2_SETTINGS_HEADER_TABLE_SIZE (C macro) +
    + + +
    nghttp2_settings_id (C type) +
    + + +
    NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE (C macro) +
    + + +
    NGHTTP2_SETTINGS_MAX (C macro) +
    + + +
    NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS (C macro) +
    + + +
    NGHTTP2_SETTINGS_TIMEOUT (C macro) +
    + + +
    NGHTTP2_STREAM_CLOSED (C macro) +
    + + +
    nghttp2_strerror (C function) +
    + + +
    nghttp2_submit_data (C function) +
    + + +
    nghttp2_submit_goaway (C function) +
    + + +
    nghttp2_submit_headers (C function) +
    + + +
    nghttp2_submit_ping (C function) +
    + + +
    nghttp2_submit_priority (C function) +
    + + +
    nghttp2_submit_push_promise (C function) +
    + + +
    nghttp2_submit_request (C function) +
    + + +
    nghttp2_submit_request2 (C function) +
    + + +
    nghttp2_submit_response (C function) +
    + + +
    nghttp2_submit_rst_stream (C function) +
    + + +
    nghttp2_submit_settings (C function) +
    + + +
    nghttp2_submit_window_update (C function) +
    + + +
    nghttp2_version (C function) +
    + + +
    NGHTTP2_VERSION (C macro) +
    + + +
    NGHTTP2_VERSION_AGE (C macro) +
    + + +
    NGHTTP2_VERSION_NUM (C macro) +
    + + +
    NGHTTP2_WINDOW_UPDATE (C macro) +
    + + +
    nghttp2_window_update (C type) +
    + + +
    nghttp2_window_update.hd (C member) +
    + + +
    nghttp2_window_update.window_size_increment (C member) +
    + +
    + + + +
    +
    +
    +
    +

    Menu

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2012, 2013, Tatsuhiro Tsujikawa. + Created using Sphinx 1.1.3. +
    + + \ No newline at end of file diff --git a/released-versions/v0.2.0/index.html b/released-versions/v0.2.0/index.html new file mode 100644 index 00000000..6f0bc66d --- /dev/null +++ b/released-versions/v0.2.0/index.html @@ -0,0 +1,159 @@ + + + + + + + + + + nghttp2 - HTTP/2.0 C Library — nghttp2 0.2.0 documentation + + + + + + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + + + + + +
    +
    +
    +
    +

    Menu

    + +

    Table Of Contents

    + + +

    Next topic

    +

    nghttp2 - HTTP/2.0 C Library

    +

    This Page

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2012, 2013, Tatsuhiro Tsujikawa. + Created using Sphinx 1.1.3. +
    + + \ No newline at end of file diff --git a/released-versions/v0.2.0/nghttp2.h.html b/released-versions/v0.2.0/nghttp2.h.html new file mode 100644 index 00000000..47b849da --- /dev/null +++ b/released-versions/v0.2.0/nghttp2.h.html @@ -0,0 +1,2404 @@ + + + + + + + + + + nghttp2.h — nghttp2 0.2.0 documentation + + + + + + + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + +
    +

    nghttp2.hΒΆ

    +
    /*
+ * nghttp2 - HTTP/2.0 C Library
+ *
+ * Copyright (c) 2013 Tatsuhiro Tsujikawa
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+#ifndef NGHTTP2_H
+#define NGHTTP2_H
+
+#ifdef  __cplusplus
+extern "C" {
+#endif
+
+#include <stdlib.h>
+#include <stdint.h>
+#include <sys/types.h>
+
+#include <nghttp2/nghttp2ver.h>
+
+/**
+ * @macro
+ *
+ * The protocol version identification of this library supports.
+ */
+#define NGHTTP2_PROTO_VERSION_ID "HTTP-draft-07/2.0"
+/**
+ * @macro
+ *
+ * The length of :macro:`NGHTTP2_PROTO_VERSION_ID`.
+ */
+#define NGHTTP2_PROTO_VERSION_ID_LEN 17
+
+struct nghttp2_session;
+/**
+ * @struct
+ *
+ * The primary structure to hold the resources needed for a HTTP/2.0
+ * session. The details of this structure are intentionally hidden
+ * from the public API.
+ */
+typedef struct nghttp2_session nghttp2_session;
+
+/**
+ * @macro
+ *
+ * The age of :type:`nghttp2_info`
+ */
+#define NGHTTP2_VERSION_AGE 1
+
+/**
+ * @struct
+ *
+ * This struct is what `nghttp2_version()` returns. It holds
+ * information about the particular nghttp2 version.
+ */
+typedef struct {
+  /**
+   * Age of this struct. This instance of nghttp2 sets it to
+   * :macro:`NGHTTP2_VERSION_AGE` but a future version may bump it and
+   * add more struct fields at the bottom
+   */
+  int age;
+  /**
+   * the :macro:`NGHTTP2_VERSION_NUM` number (since age ==1)
+   */
+  int version_num;
+  /**
+   * points to the :macro:`NGHTTP2_VERSION` string (since age ==1)
+   */
+  const char *version_str;
+  /**
+   * points to the :macro:`NGHTTP2_PROTO_VERSION_ID` string this
+   * instance implements (since age ==1)
+   */
+  const char *proto_str;
+  /* -------- the above fields all exist when age == 1 */
+} nghttp2_info;
+
+/**
+ * @macro
+ *
+ * The default priority value
+ */
+#define NGHTTP2_PRI_DEFAULT (1 << 30)
+/**
+ * @macro
+ *
+ * The lowest priority value
+ */
+#define NGHTTP2_PRI_LOWEST ((1U << 31) - 1)
+
+/**
+ * @macro
+ *
+ * The maximum window size
+ */
+#define NGHTTP2_MAX_WINDOW_SIZE ((int32_t)((1U << 31) - 1))
+
+/**
+ * @macro
+ *
+ * The initial window size for stream level flow control.
+ */
+#define NGHTTP2_INITIAL_WINDOW_SIZE ((1 << 16) - 1)
+/**
+ * @macro
+ *
+ * The initial window size for connection level flow control.
+ */
+#define NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZE ((1 << 16) - 1)
+
+/**
+ * @macro
+ *
+ * The maximum header table size.
+ */
+#define NGHTTP2_MAX_HEADER_TABLE_SIZE (1 << 16)
+
+/**
+ * @macro
+ *
+ * The client connection header.
+ */
+#define NGHTTP2_CLIENT_CONNECTION_HEADER "PRI * HTTP/2.0\r\n\r\nSM\r\n\r\n"
+/**
+ * @macro
+ *
+ * The length of :macro:`NGHTTP2_CLIENT_CONNECTION_HEADER`.
+ */
+#define NGHTTP2_CLIENT_CONNECTION_HEADER_LEN 24
+
+/**
+ * @enum
+ *
+ * Error codes used in this library. The code range is [-999, -500],
+ * inclusive. The following values are defined:
+ */
+typedef enum {
+  /**
+   * Invalid argument passed.
+   */
+  NGHTTP2_ERR_INVALID_ARGUMENT = -501,
+  /**
+   * The specified protocol version is not supported.
+   */
+  NGHTTP2_ERR_UNSUPPORTED_VERSION = -503,
+  /**
+   * Used as a return value from :type:`nghttp2_send_callback` and
+   * :type:`nghttp2_recv_callback` to indicate that the operation
+   * would block.
+   */
+  NGHTTP2_ERR_WOULDBLOCK = -504,
+  /**
+   * General protocol error
+   */
+  NGHTTP2_ERR_PROTO = -505,
+  /**
+   * The frame is invalid.
+   */
+  NGHTTP2_ERR_INVALID_FRAME = -506,
+  /**
+   * The peer performed a shutdown on the connection.
+   */
+  NGHTTP2_ERR_EOF = -507,
+  /**
+   * Used as a return value from
+   * :func:`nghttp2_data_source_read_callback` to indicate that data
+   * transfer is postponed. See
+   * :func:`nghttp2_data_source_read_callback` for details.
+   */
+  NGHTTP2_ERR_DEFERRED = -508,
+  /**
+   * Stream ID has reached the maximum value. Therefore no stream ID
+   * is available.
+   */
+  NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE = -509,
+  /**
+   * The stream is already closed; or the stream ID is invalid.
+   */
+  NGHTTP2_ERR_STREAM_CLOSED = -510,
+  /**
+   * RST_STREAM has been added to the outbound queue. The stream is in
+   * closing state.
+   */
+  NGHTTP2_ERR_STREAM_CLOSING = -511,
+  /**
+   * The transmission is not allowed for this stream (e.g., a frame
+   * with END_STREAM flag set has already sent).
+   */
+  NGHTTP2_ERR_STREAM_SHUT_WR = -512,
+  /**
+   * The stream ID is invalid.
+   */
+  NGHTTP2_ERR_INVALID_STREAM_ID = -513,
+  /**
+   * The state of the stream is not valid (e.g., DATA cannot be sent
+   * to the stream if response HEADERS has not been sent).
+   */
+  NGHTTP2_ERR_INVALID_STREAM_STATE = -514,
+  /**
+   * Another DATA frame has already been deferred.
+   */
+  NGHTTP2_ERR_DEFERRED_DATA_EXIST = -515,
+  /**
+   * Starting new stream is not allowed. (e.g., GOAWAY has been sent
+   * and/or received.
+   */
+  NGHTTP2_ERR_START_STREAM_NOT_ALLOWED = -516,
+  /**
+   * GOAWAY has already been sent.
+   */
+  NGHTTP2_ERR_GOAWAY_ALREADY_SENT = -517,
+  /**
+   * The received frame contains the invalid header block. (e.g.,
+   * There are duplicate header names; or the header names are not
+   * encoded in US-ASCII character set and not lower cased; or the
+   * header name is zero-length string; or the header value contains
+   * multiple in-sequence NUL bytes).
+   */
+  NGHTTP2_ERR_INVALID_HEADER_BLOCK = -518,
+  /**
+   * Indicates that the context is not suitable to perform the
+   * requested operation.
+   */
+  NGHTTP2_ERR_INVALID_STATE = -519,
+  /**
+   * The gzip error.
+   */
+  NGHTTP2_ERR_GZIP = -520,
+  /**
+   * The user callback function failed due to the temporal error.
+   */
+  NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE = -521,
+  /**
+   * The length of the frame is invalid, either too large or too small.
+   */
+  NGHTTP2_ERR_FRAME_SIZE_ERROR = -522,
+  /**
+   * Header block inflate/deflate error.
+   */
+  NGHTTP2_ERR_HEADER_COMP = -523,
+  /**
+   * Flow control error
+   */
+  NGHTTP2_ERR_FLOW_CONTROL = -524,
+  /**
+   * Insufficient buffer size given to function.
+   */
+  NGHTTP2_ERR_INSUFF_BUFSIZE = -525,
+  /**
+   * Callback was paused by the application
+   */
+  NGHTTP2_ERR_PAUSE = -526,
+  /**
+   * There are too many in-flight SETTING frame and no more
+   * transmission of SETTINGS is allowed.
+   */
+  NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGS = -527,
+  /**
+   * The server push is disabled.
+   */
+  NGHTTP2_ERR_PUSH_DISABLED = -528,
+  /**
+   * The errors < :enum:`NGHTTP2_ERR_FATAL` mean that the library is
+   * under unexpected condition and cannot process any further data
+   * reliably (e.g., out of memory).
+   */
+  NGHTTP2_ERR_FATAL = -900,
+  /**
+   * Out of memory. This is a fatal error.
+   */
+  NGHTTP2_ERR_NOMEM = -901,
+  /**
+   * The user callback function failed. This is a fatal error.
+   */
+  NGHTTP2_ERR_CALLBACK_FAILURE = -902
+} nghttp2_error;
+
+typedef enum {
+  NGHTTP2_MSG_MORE
+} nghttp2_io_flag;
+
+/**
+ * @struct
+ *
+ * The name/value pair, which mainly used to represent header fields.
+ */
+typedef struct {
+  /**
+   * The |name| byte string, which is not necessarily ``NULL``
+   * terminated.
+   */
+  uint8_t *name;
+  /**
+   * The |value| byte string, which is not necessarily ``NULL``
+   * terminated.
+   */
+  uint8_t *value;
+  /**
+   * The length of the |name|.
+   */
+  uint16_t namelen;
+  /**
+   * The length of the |value|.
+   */
+  uint16_t valuelen;
+} nghttp2_nv;
+
+/**
+ * @enum
+ * The control frame types in HTTP/2.0.
+ */
+typedef enum {
+  /**
+   * The DATA frame.
+   */
+  NGHTTP2_DATA = 0,
+  /**
+   * The HEADERS frame.
+   */
+  NGHTTP2_HEADERS = 1,
+  /**
+   * The PRIORITY frame.
+   */
+  NGHTTP2_PRIORITY = 2,
+  /**
+   * The RST_STREAM frame.
+   */
+  NGHTTP2_RST_STREAM = 3,
+  /**
+   * The SETTINGS frame.
+   */
+  NGHTTP2_SETTINGS = 4,
+  /**
+   * The PUSH_PROMISE frame.
+   */
+  NGHTTP2_PUSH_PROMISE = 5,
+  /**
+   * The PING frame.
+   */
+  NGHTTP2_PING = 6,
+  /**
+   * The GOAWAY frame.
+   */
+  NGHTTP2_GOAWAY = 7,
+  /**
+   * The WINDOW_UPDATE frame.
+   */
+  NGHTTP2_WINDOW_UPDATE = 9
+} nghttp2_frame_type;
+
+/**
+ * @enum
+ *
+ * The flags for HTTP/2.0 frames. This enum defines all flags for
+ * frames, assuming that the same flag name has the same mask.
+ */
+typedef enum {
+  /**
+   * No flag set.
+   */
+  NGHTTP2_FLAG_NONE = 0,
+  /**
+   * The END_STREAM flag.
+   */
+  NGHTTP2_FLAG_END_STREAM = 0x1,
+  /**
+   * The END_HEADERS flag.
+   */
+  NGHTTP2_FLAG_END_HEADERS = 0x4,
+  /**
+   * The PRIORITY flag.
+   */
+  NGHTTP2_FLAG_PRIORITY = 0x8,
+  /**
+   * The END_PUSH_PROMISE flag.
+   */
+  NGHTTP2_FLAG_END_PUSH_PROMISE = 0x4,
+  /**
+   * The ACK flag.
+   */
+  NGHTTP2_FLAG_ACK = 0x1
+} nghttp2_flag;
+
+/**
+ * @enum
+ * The SETTINGS ID.
+ */
+typedef enum {
+  /**
+   * SETTINGS_HEADER_TABLE_SIZE
+   */
+  NGHTTP2_SETTINGS_HEADER_TABLE_SIZE = 1,
+  /**
+   * SETTINGS_ENABLE_PUSH
+   */
+  NGHTTP2_SETTINGS_ENABLE_PUSH = 2,
+  /**
+   * SETTINGS_MAX_CONCURRENT_STREAMS
+   */
+  NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS = 4,
+  /**
+   * SETTINGS_INITIAL_WINDOW_SIZE
+   */
+  NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE = 7,
+  /**
+   * SETTINGS_FLOW_CONTROL_OPTIONS
+   */
+  NGHTTP2_SETTINGS_FLOW_CONTROL_OPTIONS = 10,
+  /**
+   * Maximum ID of :type:`nghttp2_settings_id`.
+   */
+  NGHTTP2_SETTINGS_MAX = 10
+} nghttp2_settings_id;
+
+/**
+ * @macro
+ * Default maximum concurrent streams.
+ */
+#define NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMS ((1U << 31) - 1)
+
+/**
+ * @enum
+ * The status codes for the RST_STREAM and GOAWAY frames.
+ */
+typedef enum {
+  /**
+   * No errors.
+   */
+  NGHTTP2_NO_ERROR = 0,
+  /**
+   * PROTOCOL_ERROR
+   */
+  NGHTTP2_PROTOCOL_ERROR = 1,
+  /**
+   * INTERNAL_ERROR
+   */
+  NGHTTP2_INTERNAL_ERROR = 2,
+  /**
+   * FLOW_CONTROL_ERROR
+   */
+  NGHTTP2_FLOW_CONTROL_ERROR = 3,
+  /**
+   * SETTINGS_TIMEOUT
+   */
+  NGHTTP2_SETTINGS_TIMEOUT = 4,
+  /**
+   * STREAM_CLOSED
+   */
+  NGHTTP2_STREAM_CLOSED = 5,
+  /**
+   * FRAME_SIZE_ERROR
+   */
+  NGHTTP2_FRAME_SIZE_ERROR = 6,
+  /**
+   * REFUSED_STREAM
+   */
+  NGHTTP2_REFUSED_STREAM = 7,
+  /**
+   * CANCEL
+   */
+  NGHTTP2_CANCEL = 8,
+  /**
+   * COMPRESSION_ERROR
+   */
+  NGHTTP2_COMPRESSION_ERROR = 9,
+  /**
+   * CONNECT_ERROR
+   */
+  NGHTTP2_CONNECT_ERROR = 10,
+  /**
+   * ENHANCE_YOUR_CALM
+   */
+  NGHTTP2_ENHANCE_YOUR_CALM = 420
+} nghttp2_error_code;
+
+/**
+ * @struct
+ * The frame header.
+ */
+typedef struct {
+  /**
+   * The length field of this frame, excluding frame header.
+   */
+  uint16_t length;
+  /**
+   * The type of this frame. See `nghttp2_frame`.
+   */
+  uint8_t type;
+  /**
+   * The flags.
+   */
+  uint8_t flags;
+  /**
+   * The stream identifier (aka, stream ID)
+   */
+  int32_t stream_id;
+} nghttp2_frame_hd;
+
+
+/**
+ * @union
+ *
+ * This union represents the some kind of data source passed to
+ * :type:`nghttp2_data_source_read_callback`.
+ */
+typedef union {
+  /**
+   * The integer field, suitable for a file descriptor.
+   */
+  int fd;
+  /**
+   * The pointer to an arbitrary object.
+   */
+  void *ptr;
+} nghttp2_data_source;
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when the library wants to read data from
+ * the |source|. The read data is sent in the stream |stream_id|. The
+ * implementation of this function must read at most |length| bytes of
+ * data from |source| (or possibly other places) and store them in
+ * |buf| and return number of data stored in |buf|. If EOF is reached,
+ * set |*eof| to 1.  If the application wants to postpone DATA frames,
+ * (e.g., asynchronous I/O, or reading data blocks for long time), it
+ * is achieved by returning :enum:`NGHTTP2_ERR_DEFERRED` without
+ * reading any data in this invocation.  The library removes DATA
+ * frame from the outgoing queue temporarily.  To move back deferred
+ * DATA frame to outgoing queue, call `nghttp2_session_resume_data()`.
+ * In case of error, there are 2 choices. Returning
+ * :enum:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will close the stream
+ * by issuing RST_STREAM with :enum:`NGHTTP2_INTERNAL_ERROR`.
+ * Returning :enum:`NGHTTP2_ERR_CALLBACK_FAILURE` will signal the
+ * entire session failure.
+ */
+typedef ssize_t (*nghttp2_data_source_read_callback)
+(nghttp2_session *session, int32_t stream_id,
+ uint8_t *buf, size_t length, int *eof,
+ nghttp2_data_source *source, void *user_data);
+
+/**
+ * @struct
+ *
+ * This struct represents the data source and the way to read a chunk
+ * of data from it.
+ */
+typedef struct {
+  /**
+   * The data source.
+   */
+  nghttp2_data_source source;
+  /**
+   * The callback function to read a chunk of data from the |source|.
+   */
+  nghttp2_data_source_read_callback read_callback;
+} nghttp2_data_provider;
+
+/**
+ * @enum
+ *
+ * The category of HEADERS, which indicates the role of the frame. In
+ * HTTP/2.0 spec, request, response, push response and other arbitrary
+ * headers (e.g., trailers) are all called just HEADERS. To give the
+ * application the role of incoming HEADERS frame, we define several
+ * categories.
+ */
+typedef enum {
+  /**
+   * The HEADERS frame is opening new stream, which is analogous to
+   * SYN_STREAM in SPDY.
+   */
+  NGHTTP2_HCAT_REQUEST = 0,
+  /**
+   * The HEADERS frame is the first response headers, which is
+   * analogous to SYN_REPLY in SPDY.
+   */
+  NGHTTP2_HCAT_RESPONSE = 1,
+  /**
+   * The HEADERS frame is the first headers sent against reserved
+   * stream.
+   */
+  NGHTTP2_HCAT_PUSH_RESPONSE = 2,
+  /**
+   * The HEADERS frame which does not apply for the above categories,
+   * which is analogous to HEADERS in SPDY.
+   */
+  NGHTTP2_HCAT_HEADERS = 3
+} nghttp2_headers_category;
+
+/**
+ * @struct
+ * The HEADERS frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The priority.
+   */
+  int32_t pri;
+  /**
+   * The name/value pairs.
+   */
+  nghttp2_nv *nva;
+  /**
+   * The number of name/value pairs in |nva|.
+   */
+  size_t nvlen;
+  nghttp2_headers_category cat;
+} nghttp2_headers;
+
+/**
+ * @struct
+ * The PRIORITY frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The priority.
+   */
+  int32_t pri;
+} nghttp2_priority;
+
+/**
+ * @struct
+ * The RST_STREAM frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The error code. See :type:`nghttp2_error_code`.
+   */
+  nghttp2_error_code error_code;
+} nghttp2_rst_stream;
+
+/**
+ * @struct
+ * The SETTINGS ID/Value pair. It has the following members:
+ */
+typedef struct {
+  /**
+   * The SETTINGS ID. See :type:`nghttp2_settings_id`.
+   */
+  int32_t settings_id;
+  /**
+   * The value of this entry.
+   */
+  uint32_t value;
+} nghttp2_settings_entry;
+
+/**
+ * @struct
+ * The SETTINGS frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The number of SETTINGS ID/Value pairs in |iv|.
+   */
+  size_t niv;
+  /**
+   * The pointer to the array of SETTINGS ID/Value pair.
+   */
+  nghttp2_settings_entry *iv;
+} nghttp2_settings;
+
+/**
+ * @struct
+ * The PUSH_PROMISE frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The promised stream ID
+   */
+  int32_t promised_stream_id;
+  /**
+   * The name/value pairs.
+   */
+  nghttp2_nv *nva;
+  /**
+   * The number of name/value pairs in |nva|.
+   */
+  size_t nvlen;
+} nghttp2_push_promise;
+
+/**
+ * @struct
+ * The PING frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The opaque data
+   */
+  uint8_t opaque_data[8];
+} nghttp2_ping;
+
+/**
+ * @struct
+ * The GOAWAY frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The last stream stream ID.
+   */
+  int32_t last_stream_id;
+  /**
+   * The error code. See :type:`nghttp2_error_code`.
+   */
+  nghttp2_error_code error_code;
+  /**
+   * The additional debug data
+   */
+  uint8_t *opaque_data;
+  /**
+   * The length of |opaque_data| member.
+   */
+  size_t opaque_data_len;
+} nghttp2_goaway;
+
+/**
+ * @struct
+ *
+ * The WINDOW_UPDATE frame. It has the following members:
+ */
+typedef struct {
+  /**
+   * The frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The window size increment.
+   */
+  int32_t window_size_increment;
+} nghttp2_window_update;
+
+/**
+ * @union
+ *
+ * This union includes all frames to pass them to various function
+ * calls as nghttp2_frame type. The DATA frame is intentionally
+ * omitted from here.
+ */
+typedef union {
+  /**
+   * The frame header, which is convenient to inspect frame header.
+   */
+  nghttp2_frame_hd hd;
+  /**
+   * The HEADERS frame.
+   */
+  nghttp2_headers headers;
+  /**
+   * The PRIORITY frame.
+   */
+  nghttp2_priority priority;
+  /**
+   * The RST_STREAM frame.
+   */
+  nghttp2_rst_stream rst_stream;
+  /**
+   * The SETTINGS frame.
+   */
+  nghttp2_settings settings;
+  /**
+   * The PUSH_PROMISE frame.
+   */
+  nghttp2_push_promise push_promise;
+  /**
+   * The PING frame.
+   */
+  nghttp2_ping ping;
+  /**
+   * The GOAWAY frame.
+   */
+  nghttp2_goaway goaway;
+  /**
+   * The WINDOW_UPDATE frame.
+   */
+  nghttp2_window_update window_update;
+} nghttp2_frame;
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when |session| wants to send data to the
+ * remote peer. The implementation of this function must send at most
+ * |length| bytes of data stored in |data|. The |flags| is currently
+ * not used and always 0. It must return the number of bytes sent if
+ * it succeeds.  If it cannot send any single byte without blocking,
+ * it must return :enum:`NGHTTP2_ERR_WOULDBLOCK`. For other errors, it
+ * must return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`. The |user_data|
+ * pointer is the third argument passed in to the call to
+ * `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.
+ */
+typedef ssize_t (*nghttp2_send_callback)
+(nghttp2_session *session,
+ const uint8_t *data, size_t length, int flags, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when |session| wants to receive data from
+ * the remote peer. The implementation of this function must read at
+ * most |length| bytes of data and store it in |buf|. The |flags| is
+ * currently not used and always 0. It must return the number of bytes
+ * written in |buf| if it succeeds. If it cannot read any single byte
+ * without blocking, it must return :enum:`NGHTTP2_ERR_WOULDBLOCK`. If
+ * it gets EOF before it reads any single byte, it must return
+ * :enum:`NGHTTP2_ERR_EOF`. For other errors, it must return
+ * :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`. Returning 0 is treated as
+ * :enum:`NGHTTP2_ERR_WOULDBLOCK`. The |user_data| pointer is the
+ * third argument passed in to the call to
+ * `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.
+ */
+typedef ssize_t (*nghttp2_recv_callback)
+(nghttp2_session *session,
+ uint8_t *buf, size_t length, int flags, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked by `nghttp2_session_recv()` when a
+ * non-DATA frame is received. The |user_data| pointer is the third
+ * argument passed in to the call to `nghttp2_session_client_new()` or
+ * `nghttp2_session_server_new()`.
+ *
+ * If the application uses `nghttp2_session_mem_recv()`, it can return
+ * :enum:`NGHTTP2_ERR_PAUSE` to make `nghttp2_session_mem_recv()`
+ * return without processing further input bytes.  The |frame|
+ * parameter is retained until `nghttp2_session_continue()` is
+ * called. The application must retain the input bytes which was used
+ * to produce the |frame| parameter, because it may refer to the
+ * memory region included in the input bytes. The application which
+ * returns :enum:`NGHTTP2_ERR_PAUSE` must call
+ * `nghttp2_session_continue()` before `nghttp2_session_mem_recv()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. It may return :enum:`NGHTTP2_ERR_PAUSE`. If the other
+ * nonzero value is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_frame_recv_callback)
+(nghttp2_session *session, const nghttp2_frame *frame, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked by `nghttp2_session_recv()` when an
+ * invalid non-DATA frame is received. The |error_code| is one of the
+ * :enum:`nghttp2_error_code` and indicates the error. When this
+ * callback function is invoked, the library automatically submits
+ * either RST_STREAM or GOAWAY frame. The |user_data| pointer is the
+ * third argument passed in to the call to
+ * `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_invalid_frame_recv_callback)
+(nghttp2_session *session, const nghttp2_frame *frame,
+ nghttp2_error_code error_code, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when a chunk of data in DATA frame is
+ * received. The |stream_id| is the stream ID this DATA frame belongs
+ * to. The |flags| is the flags of DATA frame which this data chunk is
+ * contained. ``(flags & NGHTTP2_FLAG_END_STREAM) != 0`` does not
+ * necessarily mean this chunk of data is the last one in the
+ * stream. You should use :type:`nghttp2_on_data_recv_callback` to
+ * know all data frames are received. The |user_data| pointer is the
+ * third argument passed in to the call to
+ * `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.
+ *
+ * If the application uses `nghttp2_session_mem_recv()`, it can return
+ * :enum:`NGHTTP2_ERR_PAUSE` to make `nghttp2_session_mem_recv()`
+ * return without processing further input bytes.  The |frame|
+ * parameter is retained until `nghttp2_session_continue()` is
+ * called. The application must retain the input bytes which was used
+ * to produce the |frame| parameter, because it may refer to the
+ * memory region included in the input bytes. The application which
+ * returns :enum:`NGHTTP2_ERR_PAUSE` must call
+ * `nghttp2_session_continue()` before `nghttp2_session_mem_recv()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_data_chunk_recv_callback)
+(nghttp2_session *session, uint8_t flags, int32_t stream_id,
+ const uint8_t *data, size_t len, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when DATA frame is received. The actual
+ * data it contains are received by
+ * :type:`nghttp2_on_data_chunk_recv_callback`. The |user_data|
+ * pointer is the third argument passed in to the call to
+ * `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_data_recv_callback)
+(nghttp2_session *session, uint16_t length, uint8_t flags, int32_t stream_id,
+ void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked before the non-DATA frame |frame| is
+ * sent. This may be useful, for example, to know the stream ID of
+ * HEADERS and PUSH_PROMISE frame (see also
+ * `nghttp2_session_get_stream_user_data()`), which is not assigned
+ * when it was queued. The |user_data| pointer is the third argument
+ * passed in to the call to `nghttp2_session_client_new()` or
+ * `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_before_frame_send_callback)
+(nghttp2_session *session, const nghttp2_frame *frame, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked after the non-DATA frame |frame| is sent.
+ * The |user_data| pointer is the third argument passed in to the call
+ * to `nghttp2_session_client_new()` or
+ * `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_frame_send_callback)
+(nghttp2_session *session, const nghttp2_frame *frame, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked after the non-DATA frame |frame| is not
+ * sent because of the error. The error is indicated by the
+ * |lib_error_code|, which is one of the values defined in
+ * :type:`nghttp2_error`. The |user_data| pointer is the third
+ * argument passed in to the call to `nghttp2_session_client_new()` or
+ * `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_frame_not_send_callback)
+(nghttp2_session *session, const nghttp2_frame *frame, int lib_error_code,
+ void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked after DATA frame is sent. The |user_data|
+ * pointer is the third argument passed in to the call to
+ * `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_data_send_callback)
+(nghttp2_session *session, uint16_t length, uint8_t flags, int32_t stream_id,
+ void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when the stream |stream_id| is
+ * closed. The reason of closure is indicated by the |error_code|. The
+ * stream_user_data, which was specified in `nghttp2_submit_request()`
+ * or `nghttp2_submit_headers()`, is still available in this
+ * function. The |user_data| pointer is the third argument passed in
+ * to the call to `nghttp2_session_client_new()` or
+ * `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_stream_close_callback)
+(nghttp2_session *session, int32_t stream_id, nghttp2_error_code error_code,
+ void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when the request from the remote peer is
+ * received.  In other words, the frame with END_STREAM flag set is
+ * received.  In HTTP, this means HTTP request, including request
+ * body, is fully received. The |user_data| pointer is the third
+ * argument passed in to the call to `nghttp2_session_client_new()` or
+ * `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_request_recv_callback)
+(nghttp2_session *session, int32_t stream_id, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when the received control frame octets
+ * could not be parsed correctly. The |type| indicates the type of
+ * received non-DATA frame. The |head| is the pointer to the header of
+ * the received frame. The |headlen| is the length of the
+ * |head|. According to the spec, the |headlen| is always 8. In other
+ * words, the |head| is the first 8 bytes of the received frame.  The
+ * |payload| is the pointer to the data portion of the received frame.
+ * The |payloadlen| is the length of the |payload|. This is the data
+ * after the length field. The |lib_error_code| is one of the error
+ * code defined in :enum:`nghttp2_error` and indicates the error. The
+ * |user_data| pointer is the third argument passed in to the call to
+ * `nghttp2_session_client_new()` or `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_frame_recv_parse_error_callback)
+(nghttp2_session *session, nghttp2_frame_type type,
+ const uint8_t *head, size_t headlen,
+ const uint8_t *payload, size_t payloadlen,
+ int lib_error_code, void *user_data);
+
+/**
+ * @functypedef
+ *
+ * Callback function invoked when the received frame type is
+ * unknown. The |head| is the pointer to the header of the received
+ * frame. The |headlen| is the length of the |head|. According to the
+ * spec, the |headlen| is always 8. In other words, the |head| is the
+ * first 8 bytes of the received frame.  The |payload| is the pointer
+ * to the data portion of the received frame.  The |payloadlen| is the
+ * length of the |payload|. This is the data after the length
+ * field. The |user_data| pointer is the third argument passed in to
+ * the call to `nghttp2_session_client_new()` or
+ * `nghttp2_session_server_new()`.
+ *
+ * The implementation of this function must return 0 if it
+ * succeeds. If nonzero is returned, it is treated as fatal error and
+ * `nghttp2_session_recv()` and `nghttp2_session_send()` functions
+ * immediately return :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`.
+ */
+typedef int (*nghttp2_on_unknown_frame_recv_callback)
+(nghttp2_session *session,
+ const uint8_t *head, size_t headlen,
+ const uint8_t *payload, size_t payloadlen,
+ void *user_data);
+
+/**
+ * @struct
+ *
+ * Callback functions.
+ */
+typedef struct {
+  /**
+   * Callback function invoked when the |session| wants to send data
+   * to the remote peer.
+   */
+  nghttp2_send_callback send_callback;
+  /**
+   * Callback function invoked when the |session| wants to receive
+   * data from the remote peer.
+   */
+  nghttp2_recv_callback recv_callback;
+  /**
+   * Callback function invoked by `nghttp2_session_recv()` when a
+   * non-DATA frame is received.
+   */
+  nghttp2_on_frame_recv_callback on_frame_recv_callback;
+  /**
+   * Callback function invoked by `nghttp2_session_recv()` when an
+   * invalid non-DATA frame is received.
+   */
+  nghttp2_on_invalid_frame_recv_callback on_invalid_frame_recv_callback;
+  /**
+   * Callback function invoked when a chunk of data in DATA frame is
+   * received.
+   */
+  nghttp2_on_data_chunk_recv_callback on_data_chunk_recv_callback;
+  /**
+   * Callback function invoked when DATA frame is received.
+   */
+  nghttp2_on_data_recv_callback on_data_recv_callback;
+  /**
+   * Callback function invoked before the non-DATA frame is sent.
+   */
+  nghttp2_before_frame_send_callback before_frame_send_callback;
+  /**
+   * Callback function invoked after the non-DATA frame is sent.
+   */
+  nghttp2_on_frame_send_callback on_frame_send_callback;
+  /**
+   * The callback function invoked when a non-DATA frame is not sent
+   * because of an error.
+   */
+  nghttp2_on_frame_not_send_callback on_frame_not_send_callback;
+  /**
+   * Callback function invoked after DATA frame is sent.
+   */
+  nghttp2_on_data_send_callback on_data_send_callback;
+  /**
+   * Callback function invoked when the stream is closed.
+   */
+  nghttp2_on_stream_close_callback on_stream_close_callback;
+  /**
+   * Callback function invoked when request from the remote peer is
+   * received.
+   */
+  nghttp2_on_request_recv_callback on_request_recv_callback;
+  /**
+   * Callback function invoked when the received non-DATA frame octets
+   * could not be parsed correctly.
+   */
+  nghttp2_on_frame_recv_parse_error_callback
+  on_frame_recv_parse_error_callback;
+  /**
+   * Callback function invoked when the received frame type is
+   * unknown.
+   */
+  nghttp2_on_unknown_frame_recv_callback on_unknown_frame_recv_callback;
+} nghttp2_session_callbacks;
+
+/**
+ * @function
+ *
+ * Initializes |*session_ptr| for client use. The all members of
+ * |callbacks| are copied to |*session_ptr|. Therefore |*session_ptr|
+ * does not store |callbacks|. |user_data| is an arbitrary user
+ * supplied data, which will be passed to the callback functions.
+ *
+ * The :member:`nghttp2_session_callbacks.send_callback` must be
+ * specified.  If the application code uses `nghttp2_session_recv()`,
+ * the :member:`nghttp2_session_callbacks.recv_callback` must be
+ * specified. The other members of |callbacks| can be ``NULL``.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_session_client_new(nghttp2_session **session_ptr,
+                               const nghttp2_session_callbacks *callbacks,
+                               void *user_data);
+
+/**
+ * @function
+ *
+ * Initializes |*session_ptr| for server use. The all members of
+ * |callbacks| are copied to |*session_ptr|. Therefore |*session_ptr|
+ * does not store |callbacks|. |user_data| is an arbitrary user
+ * supplied data, which will be passed to the callback functions.
+ *
+ * The :member:`nghttp2_session_callbacks.send_callback` must be
+ * specified.  If the application code uses `nghttp2_session_recv()`,
+ * the :member:`nghttp2_session_callbacks.recv_callback` must be
+ * specified. The other members of |callbacks| can be ``NULL``.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_session_server_new(nghttp2_session **session_ptr,
+                               const nghttp2_session_callbacks *callbacks,
+                               void *user_data);
+
+/**
+ * @function
+ *
+ * Frees any resources allocated for |session|. If |session| is
+ * ``NULL``, this function does nothing.
+ */
+void nghttp2_session_del(nghttp2_session *session);
+
+/**
+ * @enum
+ *
+ * Configuration options for :type:`nghttp2_session`.
+ */
+typedef enum {
+  /**
+   * This option prevents the library from sending WINDOW_UPDATE for a
+   * stream automatically. If this option is set, the application is
+   * responsible for sending WINDOW_UPDATE using
+   * `nghttp2_submit_window_update`.
+   */
+  NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE = 1,
+  /**
+   * This option prevents the library from sending WINDOW_UPDATE for a
+   * connection automatically. If this option is set, the application
+   * is responsible for sending WINDOW_UPDATE with stream ID 0 using
+   * `nghttp2_submit_window_update`.
+   */
+  NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE = 2,
+  /**
+   * This option sets the SETTINGS_MAX_CONCURRENT_STREAMS value of
+   * remote endpoint as if it is received in SETTINGS frame. Without
+   * specifying this option, before the local endpoint receives
+   * SETTINGS_MAX_CONCURRENT_STREAMS in SETTINGS frame from remote
+   * endpoint, SETTINGS_MAX_CONCURRENT_STREAMS is unlimited. This may
+   * cause problem if local endpoint submits lots of requests
+   * initially and sending them at once to the remote peer may lead to
+   * the rejection of some requests. Specifying this option to the
+   * sensible value, say 100, may avoid this kind of issue. This value
+   * will be overwritten if the local endpoint receives
+   * SETTINGS_MAX_CONCURRENT_STREAMS from the remote endpoint.
+   */
+  NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS = 3
+} nghttp2_opt;
+
+/**
+ * @function
+ *
+ * Sets the configuration option for the |session|.  The |optname| is
+ * one of :type:`nghttp2_opt`. The |optval| is the pointer to the
+ * option value and the |optlen| is the size of |*optval|. The
+ * required type of |optval| varies depending on the |optname|. See
+ * below.
+ *
+ * The following |optname| are supported:
+ *
+ * :enum:`NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE`
+ *     The |optval| must be a pointer to ``int``. If the |*optval| is
+ *     nonzero, the library will not send WINDOW_UPDATE for a stream
+ *     automatically.  Therefore, the application is responsible for
+ *     sending WINDOW_UPDATE using
+ *     `nghttp2_submit_window_update`. This option defaults to 0.
+ *
+ * :enum:`NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE`
+ *     The |optval| must be a pointer to ``int``. If the |*optval| is
+ *     nonzero, the library will not send WINDOW_UPDATE for connection
+ *     automatically.  Therefore, the application is responsible for
+ *     sending WINDOW_UPDATE using
+ *     `nghttp2_submit_window_update`. This option defaults to 0.
+ *
+ * :enum:`NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS`
+ *     The |optval| must be a pointer to ``ssize_t``. It is an error
+ *     if |*optval| is 0 or negative.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |optname| is not supported; or the |optval| and/or the
+ *     |optlen| are invalid.
+ */
+int nghttp2_session_set_option(nghttp2_session *session,
+                               int optname, void *optval, size_t optlen);
+
+/**
+ * @function
+ *
+ * Sends pending frames to the remote peer.
+ *
+ * This function retrieves the highest prioritized frame from the
+ * outbound queue and sends it to the remote peer. It does this as
+ * many as possible until the user callback
+ * :member:`nghttp2_session_callbacks.send_callback` returns
+ * :enum:`NGHTTP2_ERR_WOULDBLOCK` or the outbound queue becomes empty.
+ * This function calls several callback functions which are passed
+ * when initializing the |session|. Here is the simple time chart
+ * which tells when each callback is invoked:
+ *
+ * 1. Get the next frame to send from outbound queue.
+ * 2. Prepare transmission of the frame.
+ * 3. If the control frame cannot be sent because some preconditions
+ *    are not met (e.g., request HEADERS cannot be sent after
+ *    GOAWAY),
+ *    :member:`nghttp2_session_callbacks.on_ctrl_not_send_callback` is
+ *    invoked. Abort the following steps.
+ * 4. If the frame is request HEADERS, the stream is opened
+ *    here.
+ * 5. :member:`nghttp2_session_callbacks.before_ctrl_send_callback` is
+ *    invoked.
+ * 6. :member:`nghttp2_session_callbacks.send_callback` is invoked one
+ *    or more times to send the frame.
+ * 7. If the frame is a control frame,
+ *    :member:`nghttp2_session_callbacks.on_ctrl_send_callback` is
+ *    invoked.
+ * 8. If the frame is a DATA frame,
+ *    :member:`nghttp2_session_callbacks.on_data_send_callback` is
+ *    invoked.
+ * 9. If the transmission of the frame triggers closure of the stream,
+ *    the stream is closed and
+ *    :member:`nghttp2_session_callbacks.on_stream_close_callback` is
+ *    invoked.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ * :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`
+ *     The callback function failed.
+ */
+int nghttp2_session_send(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Receives frames from the remote peer.
+ *
+ * This function receives as many frames as possible until the user
+ * callback :member:`nghttp2_session_callbacks.recv_callback` returns
+ * :enum:`NGHTTP2_ERR_WOULDBLOCK`. This function calls several
+ * callback functions which are passed when initializing the
+ * |session|. Here is the simple time chart which tells when each
+ * callback is invoked:
+ *
+ * 1. :member:`nghttp2_session_callbacks.recv_callback` is invoked one
+ *    or more times to receive frame header.
+ * 2. If the frame is DATA frame:
+ *
+ *   2.1. :member:`nghttp2_session_callbacks.recv_callback` is invoked
+ *        to receive DATA payload. For each chunk of data,
+ *        :member:`nghttp2_session_callbacks.on_data_chunk_recv_callback`
+ *        is invoked.
+ *   2.2. If one DATA frame is completely received,
+ *        :member:`nghttp2_session_callbacks.on_data_recv_callback` is
+ *        invoked.  If the frame is the final frame of the request,
+ *        :member:`nghttp2_session_callbacks.on_request_recv_callback`
+ *        is invoked.  If the reception of the frame triggers the
+ *        closure of the stream,
+ *        :member:`nghttp2_session_callbacks.on_stream_close_callback`
+ *        is invoked.
+ *
+ * 3. If the frame is the control frame:
+ *
+ *   3.1. :member:`nghttp2_session_callbacks.recv_callback` is invoked
+ *        one or more times to receive whole frame.
+ *   3.2. If the received frame is valid,
+ *        :member:`nghttp2_session_callbacks.on_ctrl_recv_callback` is
+ *        invoked.  If the frame is the final frame of the request,
+ *        :member:`nghttp2_session_callbacks.on_request_recv_callback`
+ *        is invoked.  If the reception of the frame triggers the
+ *        closure of the stream,
+ *        :member:`nghttp2_session_callbacks.on_stream_close_callback`
+ *        is invoked.
+ *   3.3. If the received frame is unpacked but is interpreted as
+ *        invalid,
+ *        :member:`nghttp2_session_callbacks.on_invalid_ctrl_recv_callback`
+ *        is invoked.
+ *   3.4. If the received frame could not be unpacked correctly,
+ *        :member:`nghttp2_session_callbacks.on_ctrl_recv_parse_error_callback`
+ *        is invoked.
+ *   3.5. If the received frame type is unknown,
+ *        :member:`nghttp2_session_callbacks.on_unknown_ctrl_recv_callback`
+ *        is invoked.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_EOF`
+ *     The remote peer did shutdown on the connection.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ * :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`
+ *     The callback function failed.
+ */
+int nghttp2_session_recv(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Processes data |in| as an input from the remote endpoint. The
+ * |inlen| indicates the number of bytes in the |in|.
+ *
+ * This function behaves like `nghttp2_session_recv()` except that it
+ * does not use :member:`nghttp2_session_callbacks.recv_callback` to
+ * receive data; the |in| is the only data for the invocation of this
+ * function. If all bytes are processed, this function returns. The
+ * other callbacks are called in the same way as they are in
+ * `nghttp2_session_recv()`.
+ *
+ * In the current implementation, this function always tries to
+ * processes all input data unless either an error occurs or
+ * :enum:`NGHTTP2_ERR_PAUSE` is returned from
+ * :member:`nghttp2_session_callbacks.on_frame_recv_callback` or
+ * :member:`nghttp2_session_callbacks.on_data_chunk_recv_callback`.
+ * If :enum:`NGHTTP2_ERR_PAUSE` is used, the return value includes the
+ * number of bytes which was used to produce the data or frame for the
+ * callback.
+ *
+ * This function returns the number of processed bytes, or one of the
+ * following negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ * :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`
+ *     The callback function failed.
+ */
+ssize_t nghttp2_session_mem_recv(nghttp2_session *session,
+                                 const uint8_t *in, size_t inlen);
+
+/**
+ * @function
+ *
+ * Perform post-processing after `nghttp2_session_mem_recv()` was
+ * paused by :enum:`NGHTTP2_ERR_PAUSE` from
+ * :member:`nghttp2_session_callbacks.on_frame_recv_callback` or
+ * :member:`nghttp2_session_callbacks.on_data_chunk_recv_callback`.
+ *
+ * This function frees resources associated with paused frames.  It
+ * may also call additional callbacks, such as
+ * :member:`nghttp2_session_callbacks.on_stream_close_callback`.
+ *
+ * If this function succeeds, the application can call
+ * `nghttp2_session_mem_recv()` again.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ * :enum:`NGHTTP2_ERR_CALLBACK_FAILURE`
+ *     The callback function failed.
+ *
+ */
+int nghttp2_session_continue(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Puts back previously deferred DATA frame in the stream |stream_id|
+ * to the outbound queue.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The stream does not exist or no deferred data exist.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_session_resume_data(nghttp2_session *session, int32_t stream_id);
+
+/**
+ * @function
+ *
+ * Returns nonzero value if |session| wants to receive data from the
+ * remote peer.
+ *
+ * If both `nghttp2_session_want_read()` and
+ * `nghttp2_session_want_write()` return 0, the application should
+ * drop the connection.
+ */
+int nghttp2_session_want_read(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Returns nonzero value if |session| wants to send data to the remote
+ * peer.
+ *
+ * If both `nghttp2_session_want_read()` and
+ * `nghttp2_session_want_write()` return 0, the application should
+ * drop the connection.
+ */
+int nghttp2_session_want_write(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Returns stream_user_data for the stream |stream_id|. The
+ * stream_user_data is provided by `nghttp2_submit_request()` or
+ * `nghttp2_submit_syn_stream()`.  If the stream is initiated by the
+ * remote endpoint, stream_user_data is always ``NULL``. If the stream
+ * is initiated by the local endpoint and ``NULL`` is given in
+ * `nghttp2_submit_request()` or `nghttp2_submit_syn_stream()`, then
+ * this function returns ``NULL``. If the stream does not exist, this
+ * function returns ``NULL``.
+ */
+void* nghttp2_session_get_stream_user_data(nghttp2_session *session,
+                                           int32_t stream_id);
+
+/**
+ * @function
+ *
+ * Returns the number of frames in the outbound queue. This does not
+ * include the deferred DATA frames.
+ */
+size_t nghttp2_session_get_outbound_queue_size(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Returns the number of DATA payload in bytes received without
+ * WINDOW_UPDATE transmission for the stream |stream_id|. The local
+ * (receive) window size can be adjusted by
+ * `nghttp2_submit_window_update()`. This function takes into account
+ * that and returns effective data length. In particular, if the
+ * local window size is reduced by submitting negative
+ * window_size_increment with `nghttp2_submit_window_update()`, this
+ * function returns the number of bytes less than actually received.
+ *
+ * If flow control is disabled for that stream, this function returns
+ * 0.
+ *
+ * This function returns -1 if it fails.
+ */
+int32_t nghttp2_session_get_stream_effective_recv_data_length
+(nghttp2_session *session, int32_t stream_id);
+
+/**
+ * @function
+ *
+ * Returns the local (receive) window size for the stream
+ * |stream_id|. The local window size can be adjusted by
+ * `nghttp2_submit_window_update()`. This function takes into account
+ * that and returns effective window size.
+ *
+ * This function returns -1 if it fails.
+ */
+int32_t nghttp2_session_get_stream_effective_local_window_size
+(nghttp2_session *session, int32_t stream_id);
+
+/**
+ * @function
+ *
+ * Returns the number of DATA payload in bytes received without
+ * WINDOW_UPDATE transmission for a connection. The local (receive)
+ * window size can be adjusted by
+ * `nghttp2_submit_window_update()`. This function takes into account
+ * that and returns effective data length. In particular, if the local
+ * window size is reduced by submitting negative window_size_increment
+ * with `nghttp2_submit_window_update()`, this function returns the
+ * number of bytes less than actually received.
+ *
+ * If flow control is disabled for a connection, this function returns
+ * 0.
+ *
+ * This function returns -1 if it fails.
+ */
+int32_t nghttp2_session_get_effective_recv_data_length
+(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Returns the local (receive) window size for a connection. The local
+ * window size can be adjusted by
+ * `nghttp2_submit_window_update()`. This function takes into account
+ * that and returns effective window size.
+ *
+ * This function returns -1 if it fails.
+ */
+int32_t nghttp2_session_get_effective_local_window_size
+(nghttp2_session *session);
+
+/**
+ * @function
+ *
+ * Submits GOAWAY frame with the given |error_code|.
+ *
+ * This function should be called when the connection should be
+ * terminated after sending GOAWAY. If the remaining streams should be
+ * processed after GOAWAY, use `nghttp2_submit_goaway()` instead.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_session_fail_session(nghttp2_session *session,
+                                 nghttp2_error_code error_code);
+
+/**
+ * @function
+ *
+ * Performs post-process of HTTP Upgrade request. This function can be
+ * called from both client and server, but the behavior is very
+ * different in each other.
+ *
+ * If called from client side, the |settings_payload| must be the
+ * value sent in ``HTTP2-Settings`` header field and must be decoded
+ * by base64url decoder. The |settings_payloadlen| is the length of
+ * |settings_payload|. The |settings_payload| is unpacked and its
+ * setting values will be submitted using
+ * `nghttp2_submit_settings()`. This means that the client application
+ * code does not need to submit SETTINGS by itself. The stream with
+ * stream ID=1 is opened and the |stream_user_data| is used for its
+ * stream_user_data. The opened stream becomes half-closed (local)
+ * state.
+ *
+ * If called from server side, the |settings_payload| must be the
+ * value received in ``HTTP2-Settings`` header field and must be
+ * decoded by base64url decoder. The |settings_payloadlen| is the
+ * length of |settings_payload|. It is treated as if the SETTINGS
+ * frame with that payload is received. Thus, callback functions for
+ * the reception of SETTINGS frame will be invoked. The stream with
+ * stream ID=1 is opened. The |stream_user_data| is ignored. The
+ * opened stream becomes half-closed (remote).
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |settings_payload| is badly formed.
+ * :enum:`NGHTTP2_ERR_PROTO`
+ *     The stream ID 1 is already used or closed; or is not available;
+ *     or the |settings_payload| does not include both
+ *     :enum:`NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS` and
+ *     :enum:`NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE`.
+ */
+int nghttp2_session_upgrade(nghttp2_session *session,
+                            const uint8_t *settings_payload,
+                            size_t settings_payloadlen,
+                            void *stream_user_data);
+
+/**
+ * @function
+ *
+ * Serializes the SETTINGS values |iv| in the |buf|. The size of the
+ * |buf| is specified by |buflen|. The number of entries in the |iv|
+ * array is given by |niv|. The required space in |buf| for the |niv|
+ * entries is ``8*niv`` bytes and if the given buffer is too small, an
+ * error is returned. This function is used mainly for creating a
+ * SETTINGS payload to be sent with the ``HTTP2-Settings`` header
+ * field in an HTTP Upgrade request. The data written in |buf| is NOT
+ * base64url encoded and the application is responsible for encoding.
+ *
+ * This function returns the number of bytes written in |buf|, or one
+ * of the following negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |iv| contains duplicate settings ID or invalid value.
+ *
+ * :enum:`NGHTTP2_ERR_INSUFF_BUFSIZE`
+ *     The provided |buflen| size is too small to hold the output.
+ */
+ssize_t nghttp2_pack_settings_payload(uint8_t *buf,
+                                      size_t buflen,
+                                      const nghttp2_settings_entry *iv,
+                                      size_t niv);
+
+/**
+ * @function
+ *
+ * Returns string describing the |lib_error_code|. The
+ * |lib_error_code| must be one of the :enum:`nghttp2_error`.
+ */
+const char* nghttp2_strerror(int lib_error_code);
+
+/**
+ * @function
+ *
+ * Submits HEADERS frame and optionally one or more DATA frames.
+ *
+ * The |pri| is priority of this request. 0 is the highest priority
+ * value and :macro:`NGHTTP2_PRI_LOWEST` is the lowest value.
+ *
+ * The |nv| contains the name/value pairs. For i >= 0, ``nv[2*i]``
+ * contains a pointer to the name string and ``nv[2*i+1]`` contains a
+ * pointer to the value string. The one beyond last value must be
+ * ``NULL``. That is, if the |nv| contains N name/value pairs,
+ * ``nv[2*N]`` must be ``NULL``.
+ *
+ * HTTP/2.0 specification has requirement about header fields in the
+ * request HEADERS. See the specification for more details.
+ *
+ * This function creates copies of all name/value pairs in |nv|.  It
+ * also lower-cases all names in |nv|.
+ *
+ * The string in |nv| must be NULL-terminated. Use
+ * `nghttp2_submit_request2()` if name/value pairs are not
+ * NULL-terminated strings.
+ *
+ * If |data_prd| is not ``NULL``, it provides data which will be sent
+ * in subsequent DATA frames. In this case, a method that allows
+ * request message bodies
+ * (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9) must
+ * be specified with ``:method`` key in |nv| (e.g. ``POST``). This
+ * function does not take ownership of the |data_prd|. The function
+ * copies the members of the |data_prd|. If |data_prd| is ``NULL``,
+ * HEADERS have END_STREAM set. The |stream_user_data| is data
+ * associated to the stream opened by this request and can be an
+ * arbitrary pointer, which can be retrieved later by
+ * `nghttp2_session_get_stream_user_data()`.
+ *
+ * Since the library reorders the frames and tries to send the highest
+ * prioritized one first and the HTTP/2.0 specification requires the
+ * stream ID must be strictly increasing, the stream ID of this
+ * request cannot be known until it is about to sent.  To know the
+ * stream ID of the request, the application can use
+ * :member:`nghttp2_session_callbacks.before_ctrl_send_callback`. This
+ * callback is called just before the frame is sent. For HEADERS
+ * frame, the argument frame has the stream ID assigned. Also since
+ * the stream is already opened,
+ * `nghttp2_session_get_stream_user_data()` can be used to get
+ * |stream_user_data| to identify which HEADERS we are processing.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |pri| is invalid; or the |nv| includes empty name or
+ *     ``NULL`` value.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_request(nghttp2_session *session, int32_t pri,
+                           const char **nv,
+                           const nghttp2_data_provider *data_prd,
+                           void *stream_user_data);
+
+/**
+ * @function
+ *
+ * Just like `nghttp2_submit_request()`, but this function takes the
+ * |nva|, which is an array of ``nghttp2_nv`` with |nvlen| elements,
+ * as name/value pairs. This function is useful if name/value pairs
+ * are not NULL-terminated strings.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |pri| is invalid; or the |nva| includes empty name or
+ *     name which contains invalid characters.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_request2(nghttp2_session *session, int32_t pri,
+                            const nghttp2_nv *nva, size_t nvlen,
+                            const nghttp2_data_provider *data_prd,
+                            void *stream_user_data);
+
+/**
+ * @function
+ *
+ * Submits response HEADERS frame and optionally one or more DATA
+ * frames against the stream |stream_id|.
+ *
+ * The |nv| contains the name/value pairs. For i >= 0, ``nv[2*i]``
+ * contains a pointer to the name string and ``nv[2*i+1]`` contains a
+ * pointer to the value string. The one beyond last value must be
+ * ``NULL``. That is, if the |nv| contains N name/value pairs,
+ * ``nv[2*N]`` must be ``NULL``.
+ *
+ * HTTP/2.0 specification has requirement about header fields in the
+ * response HEADERS. See the specification for more details.
+ *
+ * This function creates copies of all name/value pairs in |nv|.  It
+ * also lower-cases all names in |nv|.
+ *
+ * If |data_prd| is not ``NULL``, it provides data which will be sent
+ * in subsequent DATA frames.  This function does not take ownership
+ * of the |data_prd|. The function copies the members of the
+ * |data_prd|.  If |data_prd| is ``NULL``, HEADERS will have
+ * END_STREAM flag set.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |nv| includes empty name or ``NULL`` value.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_response(nghttp2_session *session,
+                            int32_t stream_id, const char **nv,
+                            const nghttp2_data_provider *data_prd);
+
+/**
+ * @function
+ *
+ * Submits HEADERS frame. The |flags| is bitwise OR of the
+ * following values:
+ *
+ * * :enum:`NGHTTP2_FLAG_END_STREAM`
+ * * :enum:`NGHTTP2_FLAG_END_HEADERS`
+ * * :enum:`NGHTTP2_FLAG_PRIORITY`
+ *
+ * If |flags| includes :enum:`NGHTTP2_FLAG_END_STREAM`, this frame has
+ * END_STREAM flag set. The library does not support header
+ * continuation and the HEADERS frame always has
+ * :enum:`NGHTTP2_FLAG_END_HEADERS` flag set regardless of the |flags|
+ * value.
+ *
+ * If the |stream_id| is -1, this frame is assumed as request (i.e.,
+ * request HEADERS frame which opens new stream). In this case, the
+ * actual stream ID is assigned just before the frame is sent. For
+ * response, specify stream ID in |stream_id|.
+ *
+ * The |pri| is priority of this request.
+ *
+ * The |nv| contains the name/value pairs. For i >= 0, ``nv[2*i]``
+ * contains a pointer to the name string and ``nv[2*i+1]`` contains a
+ * pointer to the value string. The one beyond last value must be
+ * ``NULL``. That is, if the |nv| contains N name/value pairs,
+ * ``nv[2*N]`` must be ``NULL``.
+ *
+ * This function creates copies of all name/value pairs in |nv|.  It
+ * also lower-cases all names in |nv|.
+ *
+ * The |stream_user_data| is a pointer to an arbitrary data which is
+ * associated to the stream this frame will open. Therefore it is only
+ * used if this frame opens streams, in other words, it changes stream
+ * state from idle or reserved to open.
+ *
+ * This function is low-level in a sense that the application code can
+ * specify flags directly. For usual HTTP request,
+ * `nghttp2_submit_request()` is useful.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |pri| is invalid; or the |nv| includes empty name or
+ *     ``NULL`` value.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_headers(nghttp2_session *session, uint8_t flags,
+                           int32_t stream_id, int32_t pri, const char **nv,
+                           void *stream_user_data);
+
+/**
+ * @function
+ *
+ * Submits one or more DATA frames to the stream |stream_id|.  The
+ * data to be sent are provided by |data_prd|. If |flags| contains
+ * :enum:`NGHTTP2_FLAG_END_STREAM`, the last DATA frame has END_STREAM
+ * flag set.
+ *
+ * This function does not take ownership of the |data_prd|. The
+ * function copies the members of the |data_prd|.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ * :enum:`NGHTTP2_ERR_STREAM_CLOSED`
+ *     The stream is already closed or does not exist.
+ */
+int nghttp2_submit_data(nghttp2_session *session, uint8_t flags,
+                        int32_t stream_id,
+                        const nghttp2_data_provider *data_prd);
+
+/**
+ * @function
+ *
+ * Submits PRIORITY frame to change the priority of stream |stream_id|
+ * to the priority value |pri|.
+ *
+ * The |flags| is currently ignored and should be
+ * :enum:`NGHTTP2_FLAG_NONE`.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |pri| is negative.
+ * :enum:`NGHTTP2_ERR_STREAM_CLOSED`
+ *     The stream is already closed or does not exist.
+ */
+int nghttp2_submit_priority(nghttp2_session *session, uint8_t flags,
+                            int32_t stream_id, int32_t pri);
+
+/**
+ * @function
+ *
+ * Submits RST_STREAM frame to cancel/reject the stream |stream_id|
+ * with the error code |error_code|.
+ *
+ * The |flags| is currently ignored and should be
+ * :enum:`NGHTTP2_FLAG_NONE`.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_rst_stream(nghttp2_session *session, uint8_t flags,
+                              int32_t stream_id,
+                              nghttp2_error_code error_code);
+
+/**
+ * @function
+ *
+ * Stores local settings and submits SETTINGS frame. The |iv| is the
+ * pointer to the array of :type:`nghttp2_settings_entry`. The |niv|
+ * indicates the number of :type:`nghttp2_settings_entry`.
+ *
+ * The |flags| is currently ignored and should be
+ * :enum:`NGHTTP2_FLAG_NONE`.
+ *
+ * This function does not take ownership of the |iv|. This function
+ * copies all the elements in the |iv|.
+ *
+ * While updating individual stream's local window size, if the window
+ * size becomes strictly larger than NGHTTP2_MAX_WINDOW_SIZE,
+ * RST_STREAM is issued against such a stream.
+ *
+ * SETTINGS with :enum:`NGHTTP2_FLAG_ACK` is automatically submitted
+ * by the library and application could not send it at its will.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |iv| contains invalid value (e.g., attempting to re-enable
+ *     flow control).
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_settings(nghttp2_session *session, uint8_t flags,
+                            const nghttp2_settings_entry *iv, size_t niv);
+
+
+/**
+ * @function
+ *
+ * Submits PUSH_PROMISE frame. The |flags| is currently ignored and
+ * the resulting PUSH_PROMISE frame always has
+ * :enum:`NGHTTP2_FLAG_END_PUSH_PROMISE` flag set due to the lack of
+ * header continuation support in the library.
+ *
+ * The |stream_id| must be client initiated stream ID.
+ *
+ * The |nv| contains the name/value pairs. For i >= 0, ``nv[2*i]``
+ * contains a pointer to the name string and ``nv[2*i+1]`` contains a
+ * pointer to the value string. The one beyond last value must be
+ * ``NULL``. That is, if the |nv| contains N name/value pairs,
+ * ``nv[2*N]`` must be ``NULL``.
+ *
+ * This function creates copies of all name/value pairs in |nv|.  It
+ * also lower-cases all names in |nv|.
+ *
+ * Since the library reorders the frames and tries to send the highest
+ * prioritized one first and the HTTP/2.0 specification requires the
+ * stream ID must be strictly increasing, the promised stream ID
+ * cannot be known until it is about to sent.  To know the promised
+ * stream ID, the application can use
+ * :member:`nghttp2_session_callbacks.before_frame_send_callback`. This
+ * callback is called just before the frame is sent. For PUSH_PROMISE
+ * frame, the argument frame has the promised stream ID assigned.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_INVALID_ARGUMENT`
+ *     The |nv| includes empty name or ``NULL`` value.
+ * :enum:`NGHTTP2_ERR_STREAM_CLOSED`
+ *     The stream is already closed or does not exist.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_push_promise(nghttp2_session *session, uint8_t flags,
+                                int32_t stream_id, const char **nv);
+
+/**
+ * @function
+ *
+ * Submits PING frame. You don't have to send PING back when you
+ * received PING frame. The library automatically submits PING frame
+ * in this case.
+ *
+ * The |flags| is currently ignored and should be
+ * :enum:`NGHTTP2_FLAG_NONE`.
+ *
+ * If the |opaque_data| is non ``NULL``, then it should point to the 8
+ * bytes array of memory to specify opaque data to send with PING
+ * frame. If the |opaque_data| is ``NULL``, zero-cleared 8 bytes will
+ * be sent as opaque data.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_ping(nghttp2_session *session, uint8_t flags,
+                        uint8_t *opaque_data);
+
+/**
+ * @function
+ *
+ * Submits GOAWAY frame with the error code |error_code|.
+ *
+ * The |flags| is currently ignored and should be
+ * :enum:`NGHTTP2_FLAG_NONE`.
+ *
+ * If the |opaque_data| is not ``NULL`` and |opaque_data_len| is not
+ * zero, those data will be sent as additional debug data.  The
+ * library makes a copy of the memory region pointed by |opaque_data|
+ * with the length |opaque_data_len|, so the caller does not need to
+ * keep this memory after the return of this function. If the
+ * |opaque_data_len| is 0, the |opaque_data| could be ``NULL``.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_goaway(nghttp2_session *session, uint8_t flags,
+                          nghttp2_error_code error_code,
+                          uint8_t *opaque_data, size_t opaque_data_len);
+
+/**
+ * @function
+ *
+ * Submits WINDOW_UPDATE frame.
+ *
+ * The |flags| is currently ignored and should be
+ * :enum:`NGHTTP2_FLAG_NONE`.
+ *
+ * If the |window_size_increment| is positive, the WINDOW_UPDATE with
+ * that value as window_size_increment is queued. If the
+ * |window_size_increment| is larger than the received bytes from the
+ * remote endpoint, the local window size is increased by that
+ * difference.
+ *
+ * If the |window_size_increment| is negative, the local window size
+ * is decreased by -|window_size_increment|.  If
+ * :enum:`NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE` (or
+ * :enum:`NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE` if |stream_id|
+ * is 0) is not set and the library decided that the WINDOW_UPDATE
+ * should be submitted, then WINDOW_UPDATE is queued with the current
+ * received bytes count.
+ *
+ * If the |window_size_increment| is 0, the function does nothing and
+ * returns 0.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_FLOW_CONTROL`
+ *     The local window size overflow or gets negative.
+ * :enum:`NGHTTP2_ERR_STREAM_CLOSED`
+ *     The stream is already closed or does not exist.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_submit_window_update(nghttp2_session *session, uint8_t flags,
+                                 int32_t stream_id,
+                                 int32_t window_size_increment);
+
+/**
+ * @function
+ *
+ * Compares lhs->name with lhs->namelen bytes and rhs->name with
+ * rhs->namelen bytes. Returns negative integer if lhs->name is found
+ * to be less than rhs->name; or returns positive integer if lhs->name
+ * is found to be greater than rhs->name; or returns 0 otherwise.
+ */
+int nghttp2_nv_compare_name(const nghttp2_nv *lhs, const nghttp2_nv *rhs);
+
+/**
+ * @function
+ *
+ * A helper function for dealing with NPN in client side.  The |in|
+ * contains server's protocol in preferable order.  The format of |in|
+ * is length-prefixed and not null-terminated.  For example,
+ * ``HTTP-draft-04/2.0`` and ``http/1.1`` stored in |in| like this::
+ *
+ *     in[0] = 17
+ *     in[1..17] = "HTTP-draft-04/2.0"
+ *     in[18] = 8
+ *     in[19..26] = "http/1.1"
+ *     inlen = 27
+ *
+ * The selection algorithm is as follows:
+ *
+ * 1. If server's list contains ``HTTP-draft-04/2.0``, it is selected
+ *    and returns 1. The following step is not taken.
+ *
+ * 2. If server's list contains ``http/1.1``, this function selects
+ *    ``http/1.1`` and returns 0. The following step is not taken.
+ *
+ * 3. This function selects nothing and returns -1. (So called
+ *    non-overlap case). In this case, |out| and |outlen| are left
+ *    untouched.
+ *
+ * Selecting ``HTTP-draft-04/2.0`` means that ``HTTP-draft-04/2.0`` is
+ * written into |*out| and its length (which is 17) is
+ * assigned to |*outlen|.
+ *
+ * See http://technotes.googlecode.com/git/nextprotoneg.html for more
+ * details about NPN.
+ *
+ * To use this method you should do something like::
+ *
+ *     static int select_next_proto_cb(SSL* ssl,
+ *                                     unsigned char **out,
+ *                                     unsigned char *outlen,
+ *                                     const unsigned char *in,
+ *                                     unsigned int inlen,
+ *                                     void *arg)
+ *     {
+ *         int rv;
+ *         rv = nghttp2_select_next_protocol(out, outlen, in, inlen);
+ *         if(rv == 1) {
+ *             ((MyType*)arg)->http2_selected = 1;
+ *         }
+ *         return SSL_TLSEXT_ERR_OK;
+ *     }
+ *     ...
+ *     SSL_CTX_set_next_proto_select_cb(ssl_ctx, select_next_proto_cb, my_obj);
+ *
+ * Note that the HTTP/2.0 spec does use ALPN instead of NPN. This
+ * function is provided for transitional period before ALPN is got
+ * implemented in major SSL/TLS libraries.
+ *
+ */
+int nghttp2_select_next_protocol(unsigned char **out, unsigned char *outlen,
+                                 const unsigned char *in, unsigned int inlen);
+
+struct nghttp2_gzip;
+
+/**
+ * @struct
+ *
+ * The gzip stream to inflate data. The details of this structure are
+ * intentionally hidden from the public API.
+ */
+typedef struct nghttp2_gzip nghttp2_gzip;
+
+/**
+ * @function
+ *
+ * A helper function to set up a per request gzip stream to inflate data.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_GZIP`
+ *     The initialization of gzip stream failed.
+ * :enum:`NGHTTP2_ERR_NOMEM`
+ *     Out of memory.
+ */
+int nghttp2_gzip_inflate_new(nghttp2_gzip **inflater_ptr);
+
+/**
+ * @function
+ *
+ * Frees the inflate stream.  The |inflater| may be ``NULL``.
+ */
+void nghttp2_gzip_inflate_del(nghttp2_gzip *inflater);
+
+/**
+ * @function
+ *
+ * Inflates data in |in| with the length |*inlen_ptr| and stores the
+ * inflated data to |out| which has allocated size at least
+ * |*outlen_ptr|. On return, |*outlen_ptr| is updated to represent
+ * the number of data written in |out|.  Similarly, |*inlen_ptr| is
+ * updated to represent the number of input bytes processed.
+ *
+ * This function returns 0 if it succeeds, or one of the following
+ * negative error codes:
+ *
+ * :enum:`NGHTTP2_ERR_GZIP`
+ *     The inflation of gzip stream failed.
+ *
+ * The example follows::
+ *
+ *     void on_data_chunk_recv_callback(nghttp2_session *session,
+ *                                      uint8_t flags,
+ *                                      int32_t stream_id,
+ *                                      const uint8_t *data, size_t len,
+ *                                      void *user_data)
+ *     {
+ *         ...
+ *         req = nghttp2_session_get_stream_user_data(session, stream_id);
+ *         nghttp2_gzip *inflater = req->inflater;
+ *         while(len > 0) {
+ *             uint8_t out[MAX_OUTLEN];
+ *             size_t outlen = MAX_OUTLEN;
+ *             size_t tlen = len;
+ *             int rv;
+ *             rv = nghttp2_gzip_inflate(inflater, out, &outlen, data, &tlen);
+ *             if(rv != 0) {
+ *                 nghttp2_submit_rst_stream(session, stream_id,
+ *                                           NGHTTP2_INTERNAL_ERROR);
+ *                 break;
+ *             }
+ *             ... Do stuff ...
+ *             data += tlen;
+ *             len -= tlen;
+ *         }
+ *         ....
+ *     }
+ */
+int nghttp2_gzip_inflate(nghttp2_gzip *inflater,
+                         uint8_t *out, size_t *outlen_ptr,
+                         const uint8_t *in, size_t *inlen_ptr);
+
+/**
+ * @function
+ *
+ * Returns a pointer to a nghttp2_info struct with version information about
+ * the run-time library in use.  The |least_version| argument can be set to a
+ * 24 bit numerical value for the least accepted version number and if the
+ * condition is not met, this function will return a NULL. Pass in 0 to skip
+ * the version checking.
+ */
+nghttp2_info *nghttp2_version(int least_version);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* NGHTTP2_H */
+
    +
    +
    + + +
    +
    +
    +
    +

    Menu

    + +

    Previous topic

    +

    API Reference

    +

    Next topic

    +

    nghttp2ver.h

    +

    This Page

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2012, 2013, Tatsuhiro Tsujikawa. + Created using Sphinx 1.1.3. +
    + + \ No newline at end of file diff --git a/released-versions/v0.2.0/nghttp2ver.h.html b/released-versions/v0.2.0/nghttp2ver.h.html new file mode 100644 index 00000000..5dc18979 --- /dev/null +++ b/released-versions/v0.2.0/nghttp2ver.h.html @@ -0,0 +1,151 @@ + + + + + + + + + + nghttp2ver.h — nghttp2 0.2.0 documentation + + + + + + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + +
    +

    nghttp2ver.hΒΆ

    +
    /*
+ * nghttp2 - HTTP/2.0 C Library
+ *
+ * Copyright (c) 2012, 2013 Tatsuhiro Tsujikawa
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+#ifndef NGHTTP2VER_H
+#define NGHTTP2VER_H
+
+/**
+ * @macro
+ * Version number of the nghttp2 library release
+ */
+#define NGHTTP2_VERSION "0.2.0"
+
+/**
+ * @macro
+ * Numerical representation of the version number of the nghttp2 library
+ * release. This is a 24 bit number with 8 bits for major number, 8 bits
+ * for minor and 8 bits for patch. Version 1.2.3 becomes 0x010203.
+ */
+#define NGHTTP2_VERSION_NUM 0x000200
+
+#endif /* NGHTTP2VER_H */
+
    +
    +
    + + +
    +
    +
    +
    +

    Menu

    + +

    Previous topic

    +

    nghttp2.h

    +

    This Page

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2012, 2013, Tatsuhiro Tsujikawa. + Created using Sphinx 1.1.3. +
    + + \ No newline at end of file diff --git a/released-versions/v0.2.0/objects.inv b/released-versions/v0.2.0/objects.inv new file mode 100644 index 0000000000000000000000000000000000000000..36165870762c62726acd9d7080818f7de358c88e GIT binary patch literal 2041 zcmVNERX>N99Zgg*Qc_4OWa&u{KZXhxWBOp+6Z)#;@bUGkzXJ~YE za54%bAXa5^b7^mGIv_AEGA=L*BOp|0Wgv28ZDDC{WMy(7Z)PBLXlZjGW@&6?AZc?T zV{dJ6a%FRKWn>_Ab7^j8AbMBRkaa@bE}F zy-^X6ZK^RaJnT+?{ao=1#16WmS1#KKN%wK?IafMmQJhBX*Q%_dZ%OdVlGT^5tNiWD zsry4YR;T2zm6=6#!d5!}>F&VN8-w~^yAkc9B@2r1IDN4Ft$WOEAJ_#4c4uuLJ#TkU ziQ`b+dQuHtqpqiVWEFlp1!0k`zOI5iF4(>u{P*h1U3xfHRen$Nx;)an$WC#|l=Pgi zln-L3S60l7O3%tUNNR?8wq#`)XDJPXBzXGbk8p|S>DJcmhk5FQL8z<$z!<1xRTZa)lCrca-e5rWmb013bju@-r5b#l zwu4yR&e5r1KNHtOtY$D>!NT*{Y@e)Z)(KHi1vEU?>Cdaz3BB5^LODhlkF5=zSRQ!G zvdG%gZL4>LK`g|c4_R;t-o$$>N{FVaV8KaYMUfRW%pzQb)~~0y0vr5Sv$DE}A^SQF zE3nsG;y_T~?H)l2&%X9n4sRUQBxnN(oH216ZI&&JpO%w8bevMjU+- zzsq2xbvF%@tYngJOITRZl>MqW`c+w&EpSj5#t(+Q{%46<#PI__n}WHpxaiq7HC5{c zR=6>A_+!961Q78T>>S&(5zm_H_ho3>rrHH6UUs2%4iLm}`F3PM#EKGXRDiXHZ@K<% zXFDFz=o4{VKpvTDL9AwHJKudo?Cj%~1gWK|o{D&Dn=DOc%jfDM4$yr@eQw1lh~F6M zma4N^FxaQ|LiIBz>J7fi-GR+{BVC1Bb z2_nF8z0SBOESl0T!8%$e35ucQJu z_hz(gw3M-T9^Db(1RPYs$7|nlIP-54(3LGkICa6@tdR|TpvuX3h9$ZQjYHSOMIf#x zM2?t1TzIAcVm&}%g)G($-ywLKDI=J~#ib#JJ&OVrfYfe{!~|=fW3Yh&Q^{d?j~9#M zshPjb>LTPR7GO%=6_4DC!tAUSeVEh(rgA`0<0gzGYZ&tJTbe)) zNQQl{RgXI4Uw^(&cNGA5dvSs%-pTM{38w#9>kpj`<2WPs25T!`qAtJazr zhzA|A0cyS=jt{J&SzWzmH4rf%z%^@X9?l>G-$v@+!64Qn-xz(deTQ>0Q$|nWcr3m{ z#g9E4;x-wBrRGgSHq{75?raOCipB+gAIY@R$IKEVZrcua5)9*zDcH^T-ey3EP_9xy z)TllX+O9Rwu@HZ!;W}n5E$FjLhGg;R?RHp~tU$1>3GxF0vK`%f!5tN~{*&wU%xF|; z>64yO1YrJTKrp`JFX;5I)1PT}S$d4t!FPN1gY3V^HaxSu!nJ!PwBdUYy?3WJpvJLn);xyT}z_eBSMYI2lQJ z#2lQ)%L{lJIU7g#^>dJrJJG?F$7cO&iKv~bW4Z9X=E~C8H}2O;$myY1(w1GBMc4VE z2qH;7IoatvHli|XYpc)d3sntBFzp4XI$FT$mg{de^ugaC&tdxJIS#W&nJB{(Z(UIl zWW-=$~-FtQEbmr8XjaR(>M18`%XmzZdpxr8OC=$+Bf5^zL(bgexN zeFEahFFBwk&xgi^xC*vr!QICi;tkg{y;(PL%($7Xa!qRPh$( zCK&_-9rgC*4qD}IHsla@@2oEm-jYnj#QO=cX?xX?ohTB(1V}kof{-_Y;Q|1_q^i*f zH6&friTA}G`oMn0ur+%NLJ;dM8$)8l_J_VhSblWPQj%0>DFjxHjNk?58Ivm#!o0fy zi|(WE(P!kPU2Grby4p)|3Cvw=enk*@b9;K%RjNBTs%;cI+g#!-qmu(=>#nd0*Dz{g XVmJbX=?Po`0o0xx%q;1D5SBEV-! + + + + + + + nghttp2 - HTTP/2.0 C Library — nghttp2 0.2.0 documentation + + + + + + + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + +
    +

    nghttp2 - HTTP/2.0 C LibraryΒΆ

    +

    This is an experimental implementation of Hypertext Transfer Protocol +version 2.0.

    +
    +

    Development StatusΒΆ

    +

    We started to implement HTTP-draft-07/2.0 +(http://tools.ietf.org/html/draft-ietf-httpbis-http2-07) and the +header compression +(http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-04).

    +

    The nghttp2 code base was forked from spdylay project.

    + ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    FeaturesHTTP-draft-07/2.0
    :authorityDone
    HPACK-draft-04Done
    SETTINGS_HEADER_TABLE_SIZEDone
    SETTINGS_ENABLE_PUSHDone
    FRAME_SIZE_ERRORDone
    SETTINGS with ACKDone
    Header Continuation 
    ALPN 
    +
    +
    +

    Public Test ServerΒΆ

    +

    The following endpoints are available to try out nghttp2 +implementation. These endpoints supports HTTP-draft-07/2.0 and +the earlier draft versions are not supporeted.

    + +
    +
    +

    RequirementsΒΆ

    +

    The following packages are needed to build the library:

    +
      +
    • pkg-config >= 0.20
      • +
    • zlib >= 1.2.3
      • +
    +

    To build and run the unit test programs, the following packages are +required:

    +
      +
    • cunit >= 2.1
      • +
    +

    To build the documentation, you need to install:

    + +

    To build and run the application programs (nghttp, nghttpd and +nghttpx) in src directory, the following packages are +required:

    +
      +
    • OpenSSL >= 1.0.1
      • +
    • libevent-openssl >= 2.0.8
      • +
    +

    To enable SPDY protocol in the application program nghttpx, the +following packages are required:

    +
      +
    • spdylay >= 1.0.0
      • +
    +

    To enable -a option (getting linked assets from the downloaded +resource) in nghttp, the following packages are needed:

    +
      +
    • libxml2 >= 2.7.7
      • +
    +

    The header compression test tools in hdtest directory require the +following package:

    +
      +
    • jansson >= 2.5
      • +
    +

    If you are using Ubuntu 12.04, you need the following packages +installed:

    +
      +
    • autoconf
      • +
    • automake
      • +
    • autotools-dev
      • +
    • libtool
      • +
    • pkg-config
      • +
    • zlib1g-dev
      • +
    • libcunit1-dev
      • +
    • libssl-dev
      • +
    • libxml2-dev
      • +
    • libevent-dev
      • +
    • libjansson-dev
      • +
    +

    spdylay is not packaged in Ubuntu, so you need to build it yourself: +http://spdylay.sourceforge.net/

    +
    +
    +

    Build from gitΒΆ

    +

    Building from git is easy, but please be sure that at least autoconf 2.68 is +used:

    +
    $ autoreconf -i
+$ automake
+$ autoconf
+$ ./configure
+$ make
    +
    +
    +
    +

    Building documentationΒΆ

    +
    +

    Note

    +

    Documentation is still incomplete.

    +
    +

    To build documentation, run:

    +
    $ make html
    +
    +

    The documents will be generated under doc/manual/html/.

    +

    The generated documents will not be installed with make install.

    +

    The online documentation is available at +http://tatsuhiro-t.github.io/nghttp2/

    +
    +
    +

    Client, Server and Proxy programsΒΆ

    +

    The src directory contains HTTP/2.0 client, server and proxy programs.

    +
    +

    nghttp - clientΒΆ

    +

    nghttp is a HTTP/2.0 client. It can connect to the HTTP/2.0 server +with prior knowledge, HTTP Upgrade and NPN TLS extension.

    +

    It has verbose output mode for framing information. Here is sample +output from nghttp client:

    +
    $ src/nghttp -vn https://localhost:8443
+[  0.003] NPN select next protocol: the remote server offers:
+          * HTTP-draft-07/2.0
+          * spdy/3
+          * spdy/2
+          * http/1.1
+          NPN selected the protocol: HTTP-draft-07/2.0
+[  0.005] send SETTINGS frame <length=16, flags=0x00, stream_id=0>
+          (niv=2)
+          [SETTINGS_MAX_CONCURRENT_STREAMS(4):100]
+          [SETTINGS_INITIAL_WINDOW_SIZE(7):65535]
+[  0.006] send HEADERS frame <length=47, flags=0x05, stream_id=1>
+          ; END_STREAM | END_HEADERS
+          ; Open new stream
+          :authority: localhost:8443
+          :method: GET
+          :path: /
+          :scheme: https
+          accept: */*
+          accept-encoding: gzip, deflate
+          user-agent: nghttp2/0.1.0-DEV
+[  0.006] recv SETTINGS frame <length=16, flags=0x00, stream_id=0>
+          (niv=2)
+          [SETTINGS_MAX_CONCURRENT_STREAMS(4):100]
+          [SETTINGS_INITIAL_WINDOW_SIZE(7):65535]
+[  0.006] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
+          ; ACK
+          (niv=0)
+[  0.006] recv WINDOW_UPDATE frame <length=4, flags=0x00, stream_id=0>
+          (window_size_increment=1000000007)
+[  0.006] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
+          ; ACK
+          (niv=0)
+[  0.006] recv HEADERS frame <length=132, flags=0x04, stream_id=1>
+          ; END_HEADERS
+          ; First response header
+          :status: 200
+          accept-ranges: bytes
+          content-encoding: gzip
+          content-length: 146
+          content-type: text/html
+          date: Sun, 27 Oct 2013 14:23:54 GMT
+          etag: "b1-4e5535a027780-gzip"
+          last-modified: Sun, 01 Sep 2013 14:34:22 GMT
+          server: Apache/2.4.6 (Debian)
+          vary: Accept-Encoding
+          via: 1.1 nghttpx
+[  0.006] recv DATA frame <length=146, flags=0x00, stream_id=1>
+[  0.006] recv DATA frame <length=0, flags=0x01, stream_id=1>
+          ; END_STREAM
+[  0.007] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
+          (last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
    +
    +

    The HTTP Upgrade is performed like this:

    +
    $ src/nghttp -vnu http://localhost:8080
+[  0.000] HTTP Upgrade request
+GET / HTTP/1.1
+Host: localhost:8080
+Connection: Upgrade, HTTP2-Settings
+Upgrade: HTTP-draft-07/2.0
+HTTP2-Settings: AAAABAAAAGQAAAAHAAD__w
+Accept: */*
+User-Agent: nghttp2/0.1.0-DEV
+
+
+[  0.000] HTTP Upgrade response
+HTTP/1.1 101 Switching Protocols
+Connection: Upgrade
+Upgrade: HTTP-draft-07/2.0
+
+
+[  0.001] HTTP Upgrade success
+[  0.001] send SETTINGS frame <length=16, flags=0x00, stream_id=0>
+          (niv=2)
+          [SETTINGS_MAX_CONCURRENT_STREAMS(4):100]
+          [SETTINGS_INITIAL_WINDOW_SIZE(7):65535]
+[  0.001] recv SETTINGS frame <length=16, flags=0x00, stream_id=0>
+          (niv=2)
+          [SETTINGS_MAX_CONCURRENT_STREAMS(4):100]
+          [SETTINGS_INITIAL_WINDOW_SIZE(7):65535]
+[  0.001] recv WINDOW_UPDATE frame <length=4, flags=0x00, stream_id=0>
+          (window_size_increment=1000000007)
+[  0.001] recv HEADERS frame <length=121, flags=0x04, stream_id=1>
+          ; END_HEADERS
+          ; First response header
+          :status: 200
+          accept-ranges: bytes
+          content-length: 177
+          content-type: text/html
+          date: Sun, 27 Oct 2013 14:26:04 GMT
+          etag: "b1-4e5535a027780"
+          last-modified: Sun, 01 Sep 2013 14:34:22 GMT
+          server: Apache/2.4.6 (Debian)
+          vary: Accept-Encoding
+          via: 1.1 nghttpx
+[  0.001] recv DATA frame <length=177, flags=0x00, stream_id=1>
+[  0.001] recv DATA frame <length=0, flags=0x01, stream_id=1>
+          ; END_STREAM
+[  0.001] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
+          ; ACK
+          (niv=0)
+[  0.001] send GOAWAY frame <length=8, flags=0x00, stream_id=0>
+          (last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
+[  0.001] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
+          ; ACK
+          (niv=0)
    +
    +
    +
    +

    nghttpd - serverΒΆ

    +

    nghttpd is static web server. It is single threaded and +multiplexes connections using non-blocking socket.

    +

    By default, it uses SSL/TLS connection. Use --no-tls option to +disable it.

    +

    nghttpd only accept the HTTP/2.0 connection via NPN or direct +HTTP/2.0 connection. No HTTP Upgrade is supported.

    +

    Just like nghttp, it has verbose output mode for framing +information. Here is sample output from nghttpd server:

    +
    $ src/nghttpd --no-tls -v 8080
+IPv4: listen on port 8080
+IPv6: listen on port 8080
+[id=1] [  1.189] send SETTINGS frame <length=8, flags=0x00, stream_id=0>
+          (niv=1)
+          [SETTINGS_MAX_CONCURRENT_STREAMS(4):100]
+[id=1] [  1.191] recv SETTINGS frame <length=16, flags=0x00, stream_id=0>
+          (niv=2)
+          [SETTINGS_MAX_CONCURRENT_STREAMS(4):100]
+          [SETTINGS_INITIAL_WINDOW_SIZE(7):65535]
+[id=1] [  1.191] recv HEADERS frame <length=47, flags=0x05, stream_id=1>
+          ; END_STREAM | END_HEADERS
+          ; Open new stream
+          :authority: localhost:8080
+          :method: GET
+          :path: /
+          :scheme: http
+          accept: */*
+          accept-encoding: gzip, deflate
+          user-agent: nghttp2/0.1.0-DEV
+[id=1] [  1.192] send SETTINGS frame <length=0, flags=0x01, stream_id=0>
+          ; ACK
+          (niv=0)
+[id=1] [  1.192] send HEADERS frame <length=70, flags=0x04, stream_id=1>
+          ; END_HEADERS
+          ; First response header
+          :status: 404
+          content-encoding: gzip
+          content-type: text/html; charset=UTF-8
+          date: Sun, 27 Oct 2013 14:27:53 GMT
+          server: nghttpd nghttp2/0.1.0-DEV
+[id=1] [  1.192] send DATA frame <length=117, flags=0x00, stream_id=1>
+[id=1] [  1.192] send DATA frame <length=0, flags=0x01, stream_id=1>
+          ; END_STREAM
+[id=1] [  1.192] stream_id=1 closed
+[id=1] [  1.192] recv SETTINGS frame <length=0, flags=0x01, stream_id=0>
+          ; ACK
+          (niv=0)
+[id=1] [  1.192] recv GOAWAY frame <length=8, flags=0x00, stream_id=0>
+          (last_stream_id=0, error_code=NO_ERROR(0), opaque_data(0)=[])
+[id=1] [  1.192] closed
    +
    +
    +
    +

    nghttpx - proxyΒΆ

    +

    The nghttpx is a multi-threaded reverse proxy for +HTTP-draft-07/2.0, SPDY and HTTP/1.1. It has several operation modes:

    + ++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Mode optionFrontendBackendNote
    default modeHTTP/2.0, SPDY, HTTP/1.1 (TLS)HTTP/1.1Reverse proxy
    --http2-proxyHTTP/2.0, SPDY, HTTP/1.1 (TLS)HTTP/1.1SPDY proxy
    --http2-bridgeHTTP/2.0, SPDY, HTTP/1.1 (TLS)HTTP/2.0 (TLS) 
    --clientHTTP/2.0, HTTP/1.1HTTP/2.0 (TLS) 
    --client-proxyHTTP/2.0, HTTP/1.1HTTP/2.0 (TLS)Forward proxy
    +

    The interesting mode at the moment is the default mode. It works like +a reverse proxy and listens HTTP-draft-07/2.0, SPDY and HTTP/1.1 and +can be deployed SSL/TLS terminator for existing web server.

    +

    The default mode, --http2-proxy and --http2-bridge modes use +SSL/TLS in the frontend connection by default. To disable SSL/TLS, use +--frontend-no-tls option. If that option is used, SPDY is disabled +in the frontend and incoming HTTP/1.1 connection can be upgraded to +HTTP/2.0 through HTTP Upgrade.

    +

    The --http2-bridge, --client and --client-proxy modes use +SSL/TLS in the backend connection by deafult. To disable SSL/TLS, use +--backend-no-tls option.

    +

    The nghttpx supports configuration file. See --conf option and +sample configuration file nghttpx.conf.sample.

    +

    In the default mode, (without any of --http2-proxy, +--http2-bridge, --client-proxy and --client options), +nghttpx works as reverse proxy to the backend server:

    +
    Client <-- (HTTP/2.0, SPDY, HTTP/1.1) --> nghttpx <-- (HTTP/1.1) --> Web Server
+                                      [reverse proxy]
+
    +
    +

    With --http2-proxy option, it works as so called secure proxy (aka +SPDY proxy):

    +
    Client <-- (HTTP/2.0, SPDY, HTTP/1.1) --> nghttpx <-- (HTTP/1.1) --> Proxy
+                                       [secure proxy]            (e.g., Squid)
+
    +
    +

    The Client in the above is needs to be configured to use +nghttpx as secure proxy.

    +

    At the time of this writing, Chrome is the only browser which supports +secure proxy. The one way to configure Chrome to use secure proxy is +create proxy.pac script like this:

    +
    function FindProxyForURL(url, host) {
+    return "HTTPS SERVERADDR:PORT";
+}
+
    +
    +

    SERVERADDR and PORT is the hostname/address and port of the +machine nghttpx is running. Please note that Chrome requires valid +certificate for secure proxy.

    +

    Then run chrome with the following arguments:

    +
    $ google-chrome --proxy-pac-url=file:///path/to/proxy.pac --use-npn
    +
    +

    With --http2-bridge, it accepts HTTP/2.0, SPDY and HTTP/1.1 +connections and communicates with backend in HTTP/2.0:

    +
    Client <-- (HTTP/2.0, SPDY, HTTP/1.1) --> nghttpx <-- (HTTP/2.0) --> Web or HTTP/2.0 Proxy etc
+                                                                     (e.g., nghttpx -s)
+
    +
    +

    With --client-proxy option, it works as forward proxy and expects +that the backend is HTTP/2.0 proxy:

    +
    Client <-- (HTTP/2.0, HTTP/1.1) --> nghttpx <-- (HTTP/2.0) --> HTTP/2.0 Proxy
+                                 [forward proxy]               (e.g., nghttpx -s)
+
    +
    +

    The Client is needs to be configured to use nghttpx as forward +proxy. The frontend HTTP/1.1 connection can be upgraded to HTTP/2.0 +through HTTP Upgrade. With the above configuration, one can use +HTTP/1.1 client to access and test their HTTP/2.0 servers.

    +

    With --client option, it works as reverse proxy and expects that +the backend is HTTP/2.0 Web server:

    +
    Client <-- (HTTP/2.0, HTTP/1.1) --> nghttpx <-- (HTTP/2.0) --> Web Server
+                                [reverse proxy]
+
    +
    +

    The frontend HTTP/1.1 connection can be upgraded to HTTP/2.0 +through HTTP Upgrade.

    +

    For the operation modes which talk to the backend in HTTP/2.0 over +SSL/TLS, the backend connections can be tunneled though HTTP +proxy. The proxy is specified using --backend-http-proxy-uri +option. The following figure illustrates the example of +--http2-bridge and --backend-http-proxy-uri option to talk to +the outside HTTP/2.0 proxy through HTTP proxy:

    +
    Client <-- (HTTP/2.0, SPDY, HTTP/1.1) --> nghttpx <-- (HTTP/2.0) --
+
+        --===================---> HTTP/2.0 Proxy
+          (HTTP proxy tunnel)     (e.g., nghttpx -s)
+
    +
    +
    +
    +
    +

    Header compression test toolsΒΆ

    +

    The hdtest directory contains header compression test tools. The +deflatehd is command-line header compression tool. The +inflatehd is command-line header decompression tool. Both tools +read input from stdin and write output to stdout. The errors are +written to stderr. They take JSON as input and output.

    +
    +

    deflatehd - header compressorΒΆ

    +

    The deflatehd reads JSON array or HTTP/1-style header fields from +stdin and outputs compressed header block in JSON array.

    +

    For the JSON input, the element of input array must be a JSON +object. Each object must have at least following key:

    +
    +
    headers
    +
    A JSON array of name/value pairs. The each element is a JSON array +of 2 strings. The index 0 must contain header name and the index 1 +must contain header value.
    +
    +

    Example:

    +
    [
+  {
+    "headers": [
+      [ ":method", "GET" ],
+      [ ":path", "/" ]
+    ]
+  },
+  {
+    "headers": [
+      [ ":method", "POST" ],
+      [ ":path", "/" ]
+    ]
+  }
+]
+
    +
    +

    These header sets are processed in the order they appear in the JSON +outer most array using same compression context.

    +

    With -t option, the program can accept more familiar HTTP/1 style +header field block. Each header set is delimited by empty line:

    +

    Example:

    +
    :method: GET
+:scheme: https
+:path: /
+
+:method: POST
+user-agent: nghttp2
+
    +
    +

    The output is a JSON array and each element is JSON object, which has +at least following keys:

    +
    +
    seq
    +
    The index of header set in the input.
    +
    inputLen
    +
    The sum of length of name/value pair in the input.
    +
    outputLength
    +
    The length of compressed header block.
    +
    percentageOfOriginalSize
    +
    inputLen / outputLength * 100
    +
    output
    +
    The compressed header block in hex string.
    +
    +

    Examples:

    +
    [
+  {
+    "seq": 0,
+    "inputLen": 66,
+    "outputLength": 20,
+    "percentageOfOriginalSize": 30.303030303030305,
+    "output": "818703881f3468e5891afcbf863c856659c62e3f"
+  },
+  {
+    "seq": 1,
+    "inputLen": 74,
+    "outputLength": 10,
+    "percentageOfOriginalSize": 13.513513513513514,
+    "output": "87038504252dd5918386"
+  }
+]
+
    +
    +

    The output can be used as the input for inflatehd.

    +

    With -d option, the extra headerTable key is added and its +associated value contains the state of dyanmic header table after the +corresponding header set was processed. The value contains following +keys:

    +
    +
    entries
    +
    The entry in the header table. If referenced is true, it +is in the reference set. The size includes the overhead (32 +bytes). The index corresponds to the index of header table. +The name is the header field name and the value is the +header field value. They may be displayed as **DEALLOCATED**, +which means that the memory for that string is freed and not +available. This will happen when specifying smaller value in +-S than -s.
    +
    size
    +
    The sum of the spaces entries occupied, this includes the +entry overhead.
    +
    maxSize
    +
    The maximum header table size.
    +
    deflateSize
    +
    The sum of the spaces entries occupied within maxDeflateSize.
    +
    maxDeflateSize
    +
    The maximum header table size encoder uses. This can be smaller +than maxSize. In this case, encoder only uses up to first +maxSize buffer. Since the header table size is still +maxSize, the encoder keeps track of entries ouside the +maxDeflateSize but inside the maxSize, but it makes sure +that they are no longer referenced.
    +
    +

    Example:

    +
    [
+  {
+    "seq": 0,
+    "inputLen": 66,
+    "outputLength": 20,
+    "percentageOfOriginalSize": 30.303030303030305,
+    "output": "818703881f3468e5891afcbf863c856659c62e3f",
+    "headerTable": {
+      "entries": [
+        {
+          "index": 0,
+          "name": "user-agent",
+          "value": "nghttp2",
+          "referenced": true,
+          "size": 49
+        },
+        {
+          "index": 1,
+          "name": ":path",
+          "value": "/",
+          "referenced": true,
+          "size": 38
+        },
+        {
+          "index": 2,
+          "name": ":authority",
+          "value": "example.org",
+          "referenced": true,
+          "size": 53
+        },
+        {
+          "index": 3,
+          "name": ":scheme",
+          "value": "https",
+          "referenced": true,
+          "size": 44
+        },
+        {
+          "index": 4,
+          "name": ":method",
+          "value": "GET",
+          "referenced": true,
+          "size": 42
+        }
+      ],
+      "size": 226,
+      "maxSize": 4096,
+      "deflateSize": 226,
+      "maxDeflateSize": 4096
+    }
+  },
+  {
+    "seq": 1,
+    "inputLen": 74,
+    "outputLength": 10,
+    "percentageOfOriginalSize": 13.513513513513514,
+    "output": "87038504252dd5918386",
+    "headerTable": {
+      "entries": [
+        {
+          "index": 0,
+          "name": ":path",
+          "value": "/account",
+          "referenced": true,
+          "size": 45
+        },
+        {
+          "index": 1,
+          "name": ":method",
+          "value": "POST",
+          "referenced": true,
+          "size": 43
+        },
+        {
+          "index": 2,
+          "name": "user-agent",
+          "value": "nghttp2",
+          "referenced": true,
+          "size": 49
+        },
+        {
+          "index": 3,
+          "name": ":path",
+          "value": "/",
+          "referenced": false,
+          "size": 38
+        },
+        {
+          "index": 4,
+          "name": ":authority",
+          "value": "example.org",
+          "referenced": true,
+          "size": 53
+        },
+        {
+          "index": 5,
+          "name": ":scheme",
+          "value": "https",
+          "referenced": true,
+          "size": 44
+        },
+        {
+          "index": 6,
+          "name": ":method",
+          "value": "GET",
+          "referenced": false,
+          "size": 42
+        }
+      ],
+      "size": 314,
+      "maxSize": 4096,
+      "deflateSize": 314,
+      "maxDeflateSize": 4096
+    }
+  }
+]
+
    +
    +
    +
    +

    inflatehd - header decompressorΒΆ

    +

    The inflatehd reads JSON array from stdin and outputs decompressed +name/value pairs in JSON array. The element of input array must be a +JSON object. Each object must have at least following key:

    +
    +
    output
    +
    compressed header block in hex string.
    +
    +

    Example:

    +
    [
+  { "output": "0284f77778ff" },
+  { "output": "0185fafd3c3c7f81" }
+]
+
    +
    +

    The output is a JSON array and each element is JSON object, which has +at least following keys:

    +
    +
    seq
    +
    The index of header set in the input.
    +
    headers
    +
    The JSON array contains decompressed name/value pairs. Each +element is JSON aray having 2 elements. The index 0 of the array +contains the header field name. The index 1 contains the header +field value.
    +
    +

    Example:

    +
    [
+  {
+    "seq": 0,
+    "headers": [
+      [":authority", "example.org"],
+      [":method", "GET"],
+      [":path", "/"],
+      [":scheme", "https"],
+      ["user-agent", "nghttp2"]
+    ]
+  },
+  {
+    "seq": 1,
+    "headers": [
+      [":authority", "example.org"],
+      [":method", "POST"],
+      [":path", "/account"],
+      [":scheme", "https"],
+      ["user-agent", "nghttp2"]
+    ]
+  }
+]
+
    +
    +

    The output can be used as the input for deflatehd.

    +

    With -d option, the extra headerTable key is added and its +associated value contains the state of dyanmic header table after the +corresponding header set was processed. The format is the same as +deflatehd.

    +
    +
    +
    + + +
    +
    +
    +
    +

    Menu

    + +

    Table Of Contents

    + + +

    Previous topic

    +

    nghttp2 - HTTP/2.0 C Library

    +

    Next topic

    +

    API Reference

    +

    This Page

    + + + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2012, 2013, Tatsuhiro Tsujikawa. + Created using Sphinx 1.1.3. +
    + + \ No newline at end of file diff --git a/released-versions/v0.2.0/search.html b/released-versions/v0.2.0/search.html new file mode 100644 index 00000000..31c64063 --- /dev/null +++ b/released-versions/v0.2.0/search.html @@ -0,0 +1,104 @@ + + + + + + + + + + Search — nghttp2 0.2.0 documentation + + + + + + + + + + + + + + + + +
    +

    Navigation

    + +
    + +
    +
    +
    +
    + +

    Search

    +
    + +

    + Please activate JavaScript to enable the search + functionality. +

    +
    +

    + From here you can search these documents. Enter your search + words into the box below and click "search". Note that the search + function will automatically search for all of the words. Pages + containing fewer words won't appear in the result list. +

    +
    + + + +
    + +
    + +
    + +
    +
    +
    +
    +

    Menu

    + +
    +
    +
    +
    +
    +

    Navigation

    + +
    +
    + © Copyright 2012, 2013, Tatsuhiro Tsujikawa. + Created using Sphinx 1.1.3. +
    + + \ No newline at end of file diff --git a/released-versions/v0.2.0/searchindex.js b/released-versions/v0.2.0/searchindex.js new file mode 100644 index 00000000..f798fdb8 --- /dev/null +++ b/released-versions/v0.2.0/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({objects:{"":{NGHTTP2_ERR_INVALID_STATE:[0,0,1,""],NGHTTP2_ERR_HEADER_COMP:[0,0,1,""],NGHTTP2_SETTINGS_HEADER_TABLE_SIZE:[0,0,1,""],nghttp2_settings_entry:[0,2,1,""],NGHTTP2_INTERNAL_ERROR:[0,0,1,""],NGHTTP2_PRI_LOWEST:[0,0,1,""],nghttp2_on_frame_recv_callback:[0,2,1,""],NGHTTP2_CLIENT_CONNECTION_HEADER_LEN:[0,0,1,""],nghttp2_goaway:[0,2,1,""],nghttp2_ping:[0,2,1,""],NGHTTP2_ERR_INVALID_FRAME:[0,0,1,""],nghttp2_frame_type:[0,2,1,""],nghttp2_on_data_recv_callback:[0,2,1,""],nghttp2_select_next_protocol:[0,3,1,""],NGHTTP2_ERR_INVALID_HEADER_BLOCK:[0,0,1,""],nghttp2_session_callbacks:[0,2,1,""],NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGS:[0,0,1,""],NGHTTP2_ERR_PROTO:[0,0,1,""],NGHTTP2_MAX_HEADER_TABLE_SIZE:[0,0,1,""],nghttp2_submit_window_update:[0,3,1,""],NGHTTP2_ERR_UNSUPPORTED_VERSION:[0,0,1,""],NGHTTP2_SETTINGS_ENABLE_PUSH:[0,0,1,""],nghttp2_window_update:[0,2,1,""],NGHTTP2_DATA:[0,0,1,""],nghttp2_frame_hd:[0,2,1,""],NGHTTP2_ERR_INVALID_STREAM_STATE:[0,0,1,""],NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE:[0,0,1,""],NGHTTP2_FLAG_ACK:[0,0,1,""],NGHTTP2_STREAM_CLOSED:[0,0,1,""],NGHTTP2_SETTINGS_MAX:[0,0,1,""],NGHTTP2_MAX_WINDOW_SIZE:[0,0,1,""],nghttp2_headers_category:[0,2,1,""],nghttp2_error_code:[0,2,1,""],NGHTTP2_REFUSED_STREAM:[0,0,1,""],nghttp2_on_data_chunk_recv_callback:[0,2,1,""],NGHTTP2_ERR_START_STREAM_NOT_ALLOWED:[0,0,1,""],NGHTTP2_ERR_FLOW_CONTROL:[0,0,1,""],nghttp2_strerror:[0,3,1,""],nghttp2_gzip_inflate_del:[0,3,1,""],NGHTTP2_ERR_FATAL:[0,0,1,""],nghttp2_submit_goaway:[0,3,1,""],nghttp2_error:[0,2,1,""],NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZE:[0,0,1,""],NGHTTP2_ERR_NOMEM:[0,0,1,""],NGHTTP2_ERR_PAUSE:[0,0,1,""],NGHTTP2_ENHANCE_YOUR_CALM:[0,0,1,""],NGHTTP2_ERR_PUSH_DISABLED:[0,0,1,""],NGHTTP2_NO_ERROR:[0,0,1,""],NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS:[0,0,1,""],NGHTTP2_ERR_DEFERRED:[0,0,1,""],nghttp2_push_promise:[0,2,1,""],NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE:[0,0,1,""],nghttp2_session_get_outbound_queue_size:[0,3,1,""],nghttp2_rst_stream:[0,2,1,""],NGHTTP2_PROTO_VERSION_ID_LEN:[0,0,1,""],NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMS:[0,0,1,""],nghttp2_data_source_read_callback:[0,2,1,""],NGHTTP2_SETTINGS_TIMEOUT:[0,0,1,""],NGHTTP2_ERR_WOULDBLOCK:[0,0,1,""],nghttp2_session_resume_data:[0,3,1,""],NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE:[0,0,1,""],NGHTTP2_PRI_DEFAULT:[0,0,1,""],nghttp2_session_server_new:[0,3,1,""],NGHTTP2_FLAG_END_PUSH_PROMISE:[0,0,1,""],NGHTTP2_ERR_INVALID_ARGUMENT:[0,0,1,""],NGHTTP2_ERR_FRAME_SIZE_ERROR:[0,0,1,""],NGHTTP2_ERR_GOAWAY_ALREADY_SENT:[0,0,1,""],NGHTTP2_HEADERS:[0,0,1,""],nghttp2_flag:[0,2,1,""],NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE:[0,0,1,""],NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS:[0,0,1,""],NGHTTP2_HCAT_REQUEST:[0,0,1,""],NGHTTP2_FLAG_END_HEADERS:[0,0,1,""],nghttp2_gzip:[0,2,1,""],NGHTTP2_FLAG_END_STREAM:[0,0,1,""],NGHTTP2_ERR_EOF:[0,0,1,""],NGHTTP2_HCAT_HEADERS:[0,0,1,""],NGHTTP2_VERSION_NUM:[0,0,1,""],NGHTTP2_SETTINGS:[0,0,1,""],nghttp2_frame:[0,2,1,""],nghttp2_submit_push_promise:[0,3,1,""],nghttp2_session_mem_recv:[0,3,1,""],NGHTTP2_ERR_DEFERRED_DATA_EXIST:[0,0,1,""],NGHTTP2_CANCEL:[0,0,1,""],nghttp2_send_callback:[0,2,1,""],NGHTTP2_ERR_INVALID_STREAM_ID:[0,0,1,""],nghttp2_on_frame_send_callback:[0,2,1,""],nghttp2_submit_request2:[0,3,1,""],NGHTTP2_VERSION:[0,0,1,""],nghttp2_session:[0,2,1,""],NGHTTP2_COMPRESSION_ERROR:[0,0,1,""],NGHTTP2_HCAT_PUSH_RESPONSE:[0,0,1,""],nghttp2_submit_rst_stream:[0,3,1,""],nghttp2_submit_headers:[0,3,1,""],nghttp2_recv_callback:[0,2,1,""],nghttp2_session_get_stream_user_data:[0,3,1,""],NGHTTP2_FLAG_PRIORITY:[0,0,1,""],nghttp2_on_data_send_callback:[0,2,1,""],nghttp2_nv:[0,2,1,""],nghttp2_on_invalid_frame_recv_callback:[0,2,1,""],nghttp2_version:[0,3,1,""],nghttp2_on_unknown_frame_recv_callback:[0,2,1,""],nghttp2_session_continue:[0,3,1,""],NGHTTP2_ERR_STREAM_CLOSED:[0,0,1,""],nghttp2_opt:[0,2,1,""],NGHTTP2_ERR_CALLBACK_FAILURE:[0,0,1,""],NGHTTP2_FLOW_CONTROL_ERROR:[0,0,1,""],nghttp2_session_set_option:[0,3,1,""],NGHTTP2_ERR_STREAM_CLOSING:[0,0,1,""],nghttp2_session_client_new:[0,3,1,""],nghttp2_session_fail_session:[0,3,1,""],nghttp2_info:[0,2,1,""],NGHTTP2_PROTO_VERSION_ID:[0,0,1,""],nghttp2_settings_id:[0,2,1,""],nghttp2_session_send:[0,3,1,""],NGHTTP2_PROTOCOL_ERROR:[0,0,1,""],nghttp2_gzip_inflate:[0,3,1,""],nghttp2_session_upgrade:[0,3,1,""],nghttp2_session_del:[0,3,1,""],NGHTTP2_ERR_INSUFF_BUFSIZE:[0,0,1,""],nghttp2_settings:[0,2,1,""],nghttp2_on_frame_not_send_callback:[0,2,1,""],nghttp2_session_get_effective_recv_data_length:[0,3,1,""],nghttp2_submit_data:[0,3,1,""],nghttp2_submit_response:[0,3,1,""],NGHTTP2_CLIENT_CONNECTION_HEADER:[0,0,1,""],NGHTTP2_FLAG_NONE:[0,0,1,""],nghttp2_on_frame_recv_parse_error_callback:[0,2,1,""],nghttp2_submit_settings:[0,3,1,""],NGHTTP2_HCAT_RESPONSE:[0,0,1,""],NGHTTP2_PING:[0,0,1,""],NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE:[0,0,1,""],nghttp2_priority:[0,2,1,""],nghttp2_session_want_read:[0,3,1,""],NGHTTP2_VERSION_AGE:[0,0,1,""],NGHTTP2_CONNECT_ERROR:[0,0,1,""],NGHTTP2_RST_STREAM:[0,0,1,""],nghttp2_on_stream_close_callback:[0,2,1,""],NGHTTP2_PUSH_PROMISE:[0,0,1,""],nghttp2_data_provider:[0,2,1,""],nghttp2_on_request_recv_callback:[0,2,1,""],nghttp2_session_recv:[0,3,1,""],nghttp2_session_get_effective_local_window_size:[0,3,1,""],NGHTTP2_INITIAL_WINDOW_SIZE:[0,0,1,""],NGHTTP2_WINDOW_UPDATE:[0,0,1,""],NGHTTP2_SETTINGS_FLOW_CONTROL_OPTIONS:[0,0,1,""],nghttp2_session_want_write:[0,3,1,""],nghttp2_submit_priority:[0,3,1,""],nghttp2_session_get_stream_effective_local_window_size:[0,3,1,""],nghttp2_headers:[0,2,1,""],nghttp2_before_frame_send_callback:[0,2,1,""],NGHTTP2_GOAWAY:[0,0,1,""],NGHTTP2_ERR_GZIP:[0,0,1,""],nghttp2_submit_ping:[0,3,1,""],NGHTTP2_FRAME_SIZE_ERROR:[0,0,1,""],nghttp2_data_source:[0,2,1,""],NGHTTP2_ERR_STREAM_SHUT_WR:[0,0,1,""],NGHTTP2_PRIORITY:[0,0,1,""],nghttp2_submit_request:[0,3,1,""],nghttp2_session_get_stream_effective_recv_data_length:[0,3,1,""],nghttp2_pack_settings_payload:[0,3,1,""],nghttp2_gzip_inflate_new:[0,3,1,""],nghttp2_nv_compare_name:[0,3,1,""]},nghttp2_session_callbacks:{on_invalid_frame_recv_callback:[0,1,1,""],before_frame_send_callback:[0,1,1,""],on_stream_close_callback:[0,1,1,""],on_data_chunk_recv_callback:[0,1,1,""],on_unknown_frame_recv_callback:[0,1,1,""],send_callback:[0,1,1,""],nghttp2_on_frame_recv_parse_error_callback:[0,1,1,""],on_frame_send_callback:[0,1,1,""],on_frame_recv_callback:[0,1,1,""],on_data_send_callback:[0,1,1,""],on_frame_not_send_callback:[0,1,1,""],on_request_recv_callback:[0,1,1,""],on_data_recv_callback:[0,1,1,""],recv_callback:[0,1,1,""]},nghttp2_frame:{push_promise:[0,1,1,""],settings:[0,1,1,""],ping:[0,1,1,""],rst_stream:[0,1,1,""],priority:[0,1,1,""],headers:[0,1,1,""],goaway:[0,1,1,""],window_update:[0,1,1,""],hd:[0,1,1,""]},nghttp2_ping:{hd:[0,1,1,""]},nghttp2_data_provider:{source:[0,1,1,""],read_callback:[0,1,1,""]},nghttp2_priority:{pri:[0,1,1,""],hd:[0,1,1,""]},nghttp2_settings_entry:{settings_id:[0,1,1,""],value:[0,1,1,""]},nghttp2_window_update:{hd:[0,1,1,""],window_size_increment:[0,1,1,""]},nghttp2_frame_hd:{stream_id:[0,1,1,""],length:[0,1,1,""],flags:[0,1,1,""],type:[0,1,1,""]},nghttp2_info:{age:[0,1,1,""],version_str:[0,1,1,""],version_num:[0,1,1,""],proto_str:[0,1,1,""]},nghttp2_rst_stream:{error_code:[0,1,1,""],hd:[0,1,1,""]},nghttp2_nv:{valuelen:[0,1,1,""],namelen:[0,1,1,""],name:[0,1,1,""],value:[0,1,1,""]},nghttp2_headers:{nvlen:[0,1,1,""],pri:[0,1,1,""],hd:[0,1,1,""],nva:[0,1,1,""]},nghttp2_goaway:{opaque_data:[0,1,1,""],error_code:[0,1,1,""],opaque_data_len:[0,1,1,""],hd:[0,1,1,""],last_stream_id:[0,1,1,""]},nghttp2_data_source:{fd:[0,1,1,""],ptr:[0,1,1,""]},nghttp2_push_promise:{promised_stream_id:[0,1,1,""],nvlen:[0,1,1,""],nva:[0,1,1,""],hd:[0,1,1,""]},nghttp2_settings:{niv:[0,1,1,""],hd:[0,1,1,""],iv:[0,1,1,""]}},terms:{represent:[0,3],all:[0,1,3],code:[0,1,2],on_unknown_frame_recv_callback:[0,1],illustr:2,nghttp2_err_start_stream_not_allow:[0,1],my_obj:[0,1],lack:[0,1],nghttp2_frame_hd:[0,1],nghttp2_cancel:[0,1],nghttp2ver_h:3,prefix:[0,1],"0x01":2,overlap:[0,1],nghttp2_session_get_stream_effective_local_window_s:[0,1],follow:[0,1,2,3],ptr:[0,1],categori:[0,1],decid:[0,1],herebi:[1,3],"const":[0,1],uint8_t:[0,1],unpack:[0,1],specif:[0,1],send:[0,1,2],program:[4,2],under:[0,1,2],sens:[0,1],fatal:[0,1],spec:[0,1],sent:[0,1],merchant:[1,3],sourc:[0,1],string:[0,1,2],nul:[0,1],percentageoforiginals:2,"void":[0,1],settings_header_table_s:[0,1,2],nghttp2_settings_enable_push:[0,1],nghttp2_flag_end_push_promis:[0,1],nghttp2_submit_p:[0,1],failur:[0,1],veri:[0,1],retriev:[0,1],"0x010203":[0,3],nghttp2_on_frame_recv_callback:[0,1],level:[0,1],did:[0,1],list:[0,1],"try":2,nghttp2_headers_categori:[0,1],settings_id:[0,1],adjust:[0,1],optlen:[0,1],small:[0,1],path:2,refer:[0,1,2,4],prepar:[0,1],pleas:2,prevent:[0,1],impli:[1,3],on_stream_close_callback:[0,1],"0x1":[0,1],direct:2,"0x4":[0,1],zero:[0,1],sensibl:[0,1],pass:[0,1],download:[4,2],further:[0,1],otherwis:[0,1,3],port:2,proxi:[4,2],index:2,what:[0,1],appear:2,compar:[0,1],settings_flow_control_opt:[0,1],neg:[0,1],sum:2,invok:[0,1],current:[0,1],version:[0,1,2,3,4],nghttp2_err_insuff_bufs:[0,1],base64url:[0,1],"new":[0,1,2],tatsuhiro:[1,2,3],on_invalid_ctrl_recv_callback:[0,1],"public":[0,1,2,4],nghttp2_session_resume_data:[0,1],on_ctrl_recv_callback:[0,1],abov:[0,1,2,3],gener:[0,1,2],http2:[0,1,2,4],onli:[0,1,2],here:[0,1,2],closur:[0,1],met:[0,1],compression_error:[0,1],ubuntu:2,depend:[0,1],becom:[0,1,3],modifi:[1,2,3],sinc:[0,1,2],valu:[0,1,2],nextprotoneg:[0,1],incom:[0,1,2],remark:[0,4],nghttp2_err_push_dis:[0,1],overwritten:[0,1],larger:[0,1],connect_error:[0,1],host:2,autoreconf:2,queue:[0,1],jansson:2,tri:[0,1],behav:[0,1],permit:[1,3],action:[1,3],nghttp2_submit_prior:[0,1],implement:[0,1,2,4],nghttp2_err_gzip:[0,1],nghttp2_frame:[0,1],nghttp2_err_goaway_already_s:[0,1],regardless:[0,1],defer:[0,1],appli:[0,1],transit:[0,1],prefer:[0,1],releas:[0,3,4],api:[0,1,4],nghttp2_session_mem_recv:[0,1],instal:2,should:[0,1],"byte":[0,1,2],select:[0,1,2],from:[0,1,2,3,4],describ:[0,1],would:[0,1],memori:[0,1,2],upgrad:[0,1,2],next:[0,1,2],call:[0,1,2],asset:2,nghttp2_nv:[0,1],nghttp2_on_invalid_frame_recv_callback:[0,1],nghttp2_version:[0,1,3],type:[0,1,2,4],until:[0,1],minor:[0,3],more:[0,1,2],nghttp2_opt_no_auto_connection_window_upd:[0,1],goawai:[0,1,2],nghttp2_set:[0,1],nghttp2_settings_header_table_s:[0,1],nghttp2_pri_default:[0,1],rst_stream:[0,1],inflater_ptr:[0,1],notic:[1,3],user_data:[0,1],flag:[0,1,2],accept:[0,1,2],nghttp2_submit_window_upd:[0,1],particular:[0,1,3],known:[0,1],hold:[0,1],nghttp2_err_wouldblock:[0,1],must:[0,1,2],inputlen:2,account:[0,1,2],endpoint:[0,1,2],word:[0,1],grant:[1,3],tunnel:2,nghttp2_settings_id:[0,1],work:2,stream_user_data:[0,1],dev:2,cat:1,descriptor:[0,1],remain:[0,1],can:[0,1,2],nghttp2_enhance_your_calm:[0,1],nghttp2_flag_ack:[0,1],purpos:[1,3],syn_repli:[0,1],control:[0,1],claim:[1,3],substanti:[1,3],stream:[0,1,2],give:[0,1],process:[0,1,2],indic:[0,1],abort:[0,1],want:[0,1],onlin:[0,2],nghttp2_header:[0,1],serial:[0,1],nghttp2_err_invalid_stream_st:[0,1],unsign:[0,1],occur:[0,1],nghttp2_settings_flow_control_opt:[0,1],alwai:[0,1],multipl:[0,1],secur:2,anoth:[0,1],charset:2,ping:[0,1],nghttp2_flag_non:[0,1],write:2,fals:2,nghttp2_err_fat:[0,1],pair:[0,1,2],sever:[0,1,2],serveraddr:2,reject:[0,1],sec9:[0,1],instead:[0,1],flow:[0,1],simpl:[0,1],updat:[0,1],nghttp2_msg_more:1,nghttp2_on_request_recv_callback:[0,1],npn:[0,1,2],resourc:[0,1,2,4],referenc:2,after:[0,1,2],spdylai:2,befor:[0,1],mai:[0,1,2],nghttp2_compression_error:[0,1],alloc:[0,1],autotool:2,attempt:[0,1],third:[0,1],opaqu:[0,1],stdin:2,nvlen:[0,1],correspond:2,exclud:[0,1],issu:[0,1],nghttp2_flag_prior:[0,1],nghttp2_err_flow_control:[0,1],nghttp2_connect_error:[0,1],nghttp2_version_num:[0,1,3],allow:[0,1],nghttp2_session_want_read:[0,1],order:[0,1,2],furnish:[1,3],includ:[0,1,2,3,4],frontend:2,nghttp2_err_stream_shut_wr:[0,1],nghttp2_err_paus:[0,1],hypertext:[4,2],move:[0,1],rang:[0,1,2],libcunit1:2,through:2,nghttp2:[0,1,2,3,4],untouch:[0,1],size_t:[0,1],nghttp2_err_unsupported_vers:[0,1],still:[0,1,2],mainli:[0,1],paramet:[0,1],typedef:[0,1,4],outer:2,fit:[1,3],precondit:[0,1],max_outlen:[0,1],nghttp2_hcat_push_respons:[0,1],tort:[1,3],window:[0,1],pend:[0,1],nghttp2_err_eof:[0,1],hidden:[0,1],therefor:[0,1],nghttp2_session_send:[0,1],inlen:[0,1],valuelen:[0,1],recept:[0,1],them:[0,1],within:2,crash:0,greater:[0,1],thei:[0,1,2],nghttp2_push_promis:[0,1],nghttp2_goawai:[0,1],initi:[0,1],disabl:[0,1,2],"break":[0,1],nghttp2_initial_max_concurrent_stream:[0,1],nghttp2_submit_head:[0,1],promis:[0,1],half:[0,1],choic:[0,1],on_frame_recv_parse_error_callback:1,document:[4,1,2,3],name:[0,1,2],nghttp2_err_callback_failur:[0,1],nghttp2_send_callback:[0,1],nghttp2_frame_typ:[0,1],no_error:2,drop:[0,1],achiev:[0,1],alreadi:[0,1],mode:2,each:[0,1,2],debug:[0,1],fulli:[0,1],side:[0,1],trailer:[0,1],mean:[0,1,2],either:[0,1],nghttp2_on_frame_send_callback:[0,1],bump:[0,1],protocol_error:[0,1],chunk:[0,1],continu:[0,1,2],nghttp2_err_temporal_callback_failur:[0,1],"static":[0,1,2],expect:2,http:[0,1,2,3,4],happen:2,patch:[0,3],event:[1,3],out:[0,1,2,3],given:[0,1],space:[0,1,2],req:[0,1],publish:[1,3],primari:[0,1],content:[4,2],etag:2,suitabl:[0,1],on_ctrl_not_send_callback:[0,1],nghttp2_client_connection_header_len:[0,1],got:[0,1],on_frame_not_send_callback:[0,1],recv_callback:[0,1],end_stream:[0,1,2],earlier:2,stderr:2,insid:2,state:[0,1,2],nghttp2_internal_error:[0,1],free:[0,1,3],nghttp2_session_fail_sess:[0,1],reason:[0,1],base:2,inflat:[0,1],usual:[0,1],put:[0,1],org:[0,1,2,4],nghttp2_flag:[0,1],alert:2,recv:2,spdy:[0,1,2],nghttp2ver:[0,1,3,4],thread:2,badli:[0,1],could:[0,1],omit:[0,1],openssl:2,keep:[0,1,2],length:[0,1,2],place:[0,1],outsid:[0,2],retain:[0,1],assign:[0,1],optval:[0,1],first:[0,1,2],oper:[0,1,2],softwar:[1,3],major:[0,1,3],nghttp2_max_header_table_s:[0,1],directli:[0,1],onc:[0,1],arrai:[0,1,2],dealloc:2,number:[0,1,3],yourself:2,restrict:[1,3],nghttp2_protocol_error:[0,1],"0x8":[0,1],done:2,messag:[0,1],stdlib:1,opaque_data:[0,1,2],on_frame_recv_callback:[0,1],open:[0,1,2],payload:[0,1],size:[0,1,2],prioriti:[0,1],differ:[0,1],smaller:2,script:2,unknown:[0,1],data_prd:[0,1],nghttp2_session_get_stream_user_data:[0,1],least:[0,1,2],on_unknown_ctrl_recv_callback:[0,1],necessarili:[0,1],draft:[0,1,2,4],too:[0,1],similarli:[0,1],termin:[0,1,2],internal_error:[0,1],conveni:[0,1],"final":[0,1],store:[0,1],on_ctrl_send_callback:[0,1],ssl_ctx:[0,1],option:[0,1,2],tool:[4,2],copi:[0,1,3],nghttp2_proto_version_id_len:[0,1],lower:[0,1],specifi:[0,1,2],nghttp2_client_connection_head:[0,1],compressor:2,github:2,pars:[0,1],sign:2,holder:[1,3],than:[0,1,2],kind:[0,1,3],scheme:2,nghttp2_err_header_comp:[0,1],remov:[0,1],see:[0,1,2],structur:[0,1],charact:[0,1],project:2,bridg:2,headert:2,entri:[0,1,2],posit:[0,1],nghttp2_session_del:[0,1],read_callback:[0,1],browser:2,lowest:[0,1],sai:[0,1],window_size_incr:[0,1,2],respons:[0,1,2],pri:[0,1],argument:[0,1,2],packag:2,increment:[0,1],tabl:[0,1,2],need:[0,1,2],element:[0,1,2],nghttp2_on_frame_recv_parse_error_callback:[0,1],syn_stream:[0,1],sell:[1,3],caus:[0,1],bitwis:[0,1],date:2,unexpect:[0,1],callback:[0,1],"0x04":2,"0x05":2,nghttp2_io_flag:1,"0x00":2,"switch":2,note:[0,1,2],nghttp2_refused_stream:[0,1],exampl:[0,1,2],unlimit:[0,1],take:[0,1,2],which:[0,1,2],nghttp2_err_deferred_data_exist:[0,1],noth:[0,1],singl:[0,1,2],opaque_data_len:[0,1],sure:2,unless:[0,1],ssize_t:[0,1],"enum":[0,1,4],shall:[1,3],buffer:[0,1,2],"__cplusplu":1,aaaabaaaagqaaaahaad__w:2,compress:[4,2],settings_max_concurrent_stream:[0,1,2],nghttp2_hcat_request:[0,1],most:[0,1,2],vnu:2,nghttp2_settings_timeout:[0,1],thi:[0,1,2,3,4],nghttp2_before_frame_send_callback:[0,1],charg:[1,3],nghttp2_error_cod:[0,1],nghttp2_err_stream_id_not_avail:[0,1],don:[0,1],http2_select:[0,1],url:2,doc:2,frame_size_error:[0,1,2],later:[0,1],request:[0,1,2],uri:2,doe:[0,1],talk:2,sun:2,nghttp2_gzip_inflate_new:[0,1],on_invalid_frame_recv_callback:[0,1],hdtest:2,show:2,text:2,hostnam:2,verbos:2,session:[0,1],pkg:2,permiss:[1,3],protocol:[0,1,2,4],deploi:2,data:[0,1,2],overflow:[0,1],access:2,nghttp2_submit_push_promis:[0,1],submit:[0,1],nghttp2_submit_rst_stream:[0,1],copyright:[1,3],refused_stream:[0,1],configur:[0,1,2],apach:2,figur:2,start:[0,1,2],before_ctrl_send_callback:[0,1],nghttp2_opt_no_auto_stream_window_upd:[0,1],nghttp2_err_invalid_stream_id:[0,1],experiment:[4,2],queu:[0,1],"4e5535a027780":2,local:[0,1],oct:2,nghttp2_session_get_stream_effective_recv_data_length:[0,1],"0284f77778ff":2,count:[0,1],over:2,nghttp2_err_proto:[0,1],variou:[0,1],get:[0,1,2],familiar:2,express:[1,3],window_upd:[0,1,2],outlen:[0,1],end_head:[0,1,2],ssl:[0,1,2],settings_initial_window_s:[0,1,2],cannot:[0,1],nghttp2_data:[0,1],optnam:[0,1],increas:[0,1],liabl:[1,3],nghttp2_flag_end_stream:[0,1],net:2,requir:[0,1,2,4],before_frame_send_callback:[0,1],nghttp2_no_error:[0,1],nghttp2_submit_respons:[0,1],enabl:[0,1,2],ietf:[4,2],skip:[0,1],nghttp2_stream_clos:[0,1],nghttp2_frame_size_error:[0,1],push_promis:[0,1],method:[0,1,2],provid:[0,1,3],stuff:[0,1],nghttp2_strerror:[0,1],contain:[0,1,2],nghttp2_window_upd:[0,1],nghttp2_gzip_inflate_del:[0,1],user:[0,1,2],certif:2,set:[0,1,2],seq:2,sep:2,nghttp2_session_continu:[0,1],ousid:2,frame:[0,1,2],knowledg:2,maximum:[0,1,2],nghttp2_submit_goawai:[0,1],temporarili:[0,1],result:[0,1],arg:[0,1],fail:[0,1],close:[0,1,2],becaus:[0,1],analog:[0,1],subject:[1,3],statu:[0,1,2,4],correctli:[0,1],vari:[0,1,2],someth:[0,1],below:[0,1],numer:[0,1,3],written:[0,1,2],nghttp2_on_data_chunk_recv_callback:[0,1],nghttp2_initial_connection_window_s:[0,1],accord:[0,1],libjansson:2,kei:[0,1,2],supporet:2,prior:2,style:2,extens:2,entir:[0,1],len:[0,1],last_stream_id:[0,1,2],beyond:[0,1],problem:[0,1],addit:[0,1],bodi:[0,1],last:[0,1,2],delimit:2,nghttp2_proto_version_id:[0,1],region:[0,1],nghttp2_session_want_writ:[0,1],against:[0,1],tempor:[0,1],damag:[1,3],etc:2,instanc:[0,1],deflatehd:2,agent:2,nghttp2_rst_stream:[0,1],on_request_recv_callback:[0,1],enhance_your_calm:[0,1],whole:[0,1],nghttp2_data_provid:[0,1],point:[0,1],int32_t:[0,1],address:2,nghttp2_err_too_many_inflight_set:[0,1],rfc2616:[0,1],nghttp2_max_window_s:[0,1],header:[0,1,2,4],nghttp2_prioriti:[0,1],non:[0,1,2],shutdown:[0,1],nghttp2_submit_request2:[0,1],cancel:[0,1],nghttp2_session:[0,1],assum:[0,1],backend:2,liabil:[1,3],settings_timeout:[0,1],nghttp2_recv_callback:[0,1],union:[0,1,4],due:[0,1],been:[0,1],insuffici:[0,1],whom:[1,3],nghttp2_on_data_send_callback:[0,1],trigger:[0,1],treat:[0,1],interest:2,stdint:1,buf:[0,1],immedi:[0,1],nghttp2_hcat_head:[0,1],nghttp2_on_unknown_frame_recv_callback:[0,1],field:[0,1,2],flight:[0,1],outputlength:2,settings_enable_push:[0,1,2],both:[0,1,2],nghttp2_opt:[0,1],lib_error_cod:[0,1],buflen:[0,1],ani:[0,1,2,3],func:1,those:[0,1],"case":[0,1,2],multi:2,subsequ:[0,1],nghttp2_settings_initial_window_s:[0,1],zlib:2,sourceforg:2,defin:[0,1,3],"while":[0,1],behavior:[0,1],error:[0,1,2],exist:[0,1,2],invoc:[0,1],listen:2,on_data_chunk_recv_callback:[0,1],nghttp2_session_callback:[0,1],helper:[0,1],stdout:2,libxml2:2,squid:2,select_next_proto_cb:[0,1],promised_stream_id:[0,1],itself:[0,1],contract:[1,3],conf:2,"return":[0,1,2],flow_control_error:[0,1],ascii:[0,1],maxsiz:2,pointer:[0,1],"null":[0,1],develop:[4,2],author:[1,2,3],perform:[0,1,2],make:[0,1,2],belong:[0,1],same:[0,1,2],nghttp2_err_invalid_header_block:[0,1],member:[0,1],pac:2,decod:[0,1],version_str:[0,1],ifndef:[1,3],nghttp2_on_stream_close_callback:[0,1],dyanmic:2,complet:[0,1],nghttp2_session_recv:[0,1],context:[0,1,2],stream_id:[0,1,2],mytyp:[0,1],effect:[0,1],on_ctrl_recv_parse_error_callback:[0,1],decompress:2,remot:[0,1,2],moment:2,"0185fafd3c3c7f81":2,zlib1g:2,ownership:[0,1],mani:[0,1],extern:1,outbound:[0,1],postpon:[0,1],nghttp2_submit_syn_stream:[0,1],niv:[0,1,2],aka:[0,1,2],deflates:2,nghttp2_h:1,noninfring:[1,3],com:[0,1],thu:[0,1],nghttp:2,nghttp2_session_get_effective_local_window_s:[0,1],without:[0,1,2,3],inflatehd:2,person:[1,3],client:[0,1,2,4],command:2,uint32_t:[0,1],endif:[1,3],error_cod:[0,1,2],nghttp2_error:[0,1],nghttp2_data_sourc:[0,1],left:[0,1],end_push_promis:[0,1],interpret:[0,1],nghttp2_err_def:[0,1],nghttp2_submit_set:[0,1],identifi:[0,1],paus:[0,1],just:[0,1,2],less:[0,1],nghttp2_on_data_recv_callback:[0,1],send_callback:[0,1],obtain:[1,3],reserv:[0,1],payloadlen:[0,1],nghttp2_gzip_infl:[0,1],"0x000200":3,via:2,multiplex:2,"87038504252dd5918386":2,ifdef:1,nghttp2_flow_control_error:[0,1],on_frame_send_callback:[0,1],previous:[0,1],web:2,nghttp2_ping:[0,1],struct:[0,1,4],easi:2,also:[0,1],extra:2,priorit:[0,1],except:[0,1],aris:[1,3],identif:[0,1],add:[0,1],other:[0,1,3],version_num:[0,1],input:[0,1,2],on_data_send_callback:[0,1],nghttp2_select_next_protocol:[0,1],gmt:2,applic:[0,1,2],nghttp2_err_frame_size_error:[0,1],format:[0,1,2],read:[0,1,2],headlen:[0,1],nghttp2_version_ag:[0,1],period:[0,1],outlen_ptr:[0,1],nghttp2_session_set_opt:[0,1],know:[0,1],nva:[0,1],step:[0,1],bit:[0,1,3],arai:2,associ:[0,1,2,3],like:[0,1,2],success:2,arbitrari:[0,1],uint16_t:[0,1],signal:[0,1],nghttp2_session_server_new:[0,1],manual:2,html:[0,1,2,4],nghttp2_pri_lowest:[0,1],server:[0,1,2,4],nghttp2_flag_end_head:[0,1],"818703881f3468e5891afcbf863c856659c62e3f":2,tlen:[0,1],have:[0,1,2],output:[0,1,2],findproxyforurl:2,stream_clos:[0,1],www:[0,1],revers:2,settings_payload:[0,1],deal:[0,1,3],nghttp2_session_client_new:[0,1],some:[0,1],back:[0,1],self:2,sampl:2,integ:[0,1],nghttp2_session_get_effective_recv_data_length:[0,1],librari:[0,1,2,3,4],distribut:[1,3],nonzero:[0,1],lead:[0,1],bottom:[0,1],nghttp2_data_source_read_callback:[0,1],though:2,octet:[0,1],per:[0,1],track:2,outgo:[0,1],larg:[0,1],unit:2,condit:[0,1,3],nghttp2_session_upgrad:[0,1],duplic:[0,1],localhost:2,freed:2,machin:2,object:[0,1,2],run:[0,1,2],reach:[0,1],inspect:[0,1],chart:[0,1],settings_payloadlen:[0,1],nghttp2_nv_compare_nam:[0,1],found:[0,1],peer:[0,1],post:[0,1,2],nghttp2_session_get_outbound_queue_s:[0,1],decompressor:2,src:2,about:[0,1],actual:[0,1],socket:2,ack:[0,1,2],maxdeflates:2,commun:2,inlen_ptr:[0,1],nghttp2_gzip:[0,1],chrome:2,idl:[0,1],nghttp2_submit_data:[0,1],nghttp2_settings_max_concurrent_stream:[0,1],ssl_tlsext_err_ok:[0,1],produc:[0,1],block:[0,1,2],on_data_recv_callback:[0,1],nghttp2_settings_entri:[0,1],nsm:1,least_vers:[0,1],sublicens:[1,3],encod:[0,1,2],automat:[0,1],ssl_ctx_set_next_proto_select_cb:[0,1],warranti:[1,3],automak:2,right:[1,3],empti:[0,1,2],chang:[0,1],merg:[1,3],occupi:2,inclus:[0,1],git:[0,1,2,4],nghttp2_hcat_respons:[0,1],wai:[0,1,2],transfer:[0,1,2,4],nghttp2_err_invalid_fram:[0,1],support:[0,1,2],hex:2,json:2,"long":[0,1],avail:[0,1,2],intention:[0,1],config:2,nghttp2_err_stream_clos:[0,1],low:[0,1],lot:[0,1],ipv6:2,forward:2,overhead:2,strictli:[0,1],individu:[0,1],"function":[0,1,2,4],head:[0,1],session_ptr:[0,1],gzip:[0,1,2],form:[0,1],offer:2,nghttp2_err_invalid_st:[0,1],taken:[0,1],libssl:2,link:2,cunit:2,line:2,highest:[0,1],"true":2,eof:[0,1],suppli:[0,1],succe:[0,1],utf:2,possibl:[0,1],whether:[1,3],nghttp2_settings_max:[0,1],caller:[0,1],googlecod:[0,1],displai:2,tell:[0,1],asynchron:[0,1],deafult:2,limit:[1,3],reorder:[0,1],hpack:2,nghttpx:2,nghttpd:2,inform:[0,1,2],autoconf:2,clear:[0,1],libev:2,connect:[0,1,2,3],nghttp2_initial_window_s:[0,1],featur:2,nghttp2_on_frame_not_send_callback:[0,1],creat:[0,1,2],"int":[0,1],httpbi:[4,2],tsujikawa:[1,3],repres:[0,1],"char":[0,1],incomplet:2,ipv4:2,decreas:[0,1],file:[0,1,2,3],check:[0,1],nghttp2_err_nomem:[0,1],concurr:[0,1],again:[0,1],macro:[0,1,3,4],functypedef:1,googl:2,when:[0,1,2],detail:[0,1],invalid:[0,1],"default":[0,1,2],build:[4,2],valid:[0,1,2],role:[0,1],futur:[0,1],test:[4,2],you:[0,1,2],transmiss:[0,1],nghttp2_info:[0,1],fork:2,sequenc:[0,1],nghttp2_pack_settings_payload:[0,1],technot:[0,1],nghttp2_opt_peer_max_concurrent_stream:[0,1],libtool:2,nghttp2_err_invalid_argu:[0,1],proto_str:[0,1],alpn:[0,1,2],debian:2,reduc:[0,1],receiv:[0,1],sphinx:2,longer:2,algorithm:[0,1],directori:2,reliabl:[0,1],mask:[0,1],indirectli:0,nghttp2_submit_request:[0,1],namelen:[0,1],portion:[0,1,3],ignor:[0,1],time:[0,1,2],push:[0,1],deflat:[0,1,2],avoid:[0,1]},objtypes:{"0":"c:macro","1":"c:member","2":"c:type","3":"c:function"},titles:["API Reference","nghttp2.h","nghttp2 - HTTP/2.0 C Library","nghttp2ver.h","nghttp2 - HTTP/2.0 C Library"],objnames:{"0":["c","macro","C macro"],"1":["c","member","C member"],"2":["c","type","C type"],"3":["c","function","C function"]},filenames:["apiref","nghttp2.h","package_README","nghttp2ver.h","index"]}) \ No newline at end of file diff --git a/search.html b/search.html index c792bb91..38bbb6d9 100644 --- a/search.html +++ b/search.html @@ -8,7 +8,7 @@ - Search — nghttp2 0.2.0-DEV documentation + Search — nghttp2 0.3.0-DEV documentation @@ -17,7 +17,7 @@ - + @@ -41,7 +41,7 @@
  • index
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • @@ -93,7 +93,7 @@
  • index
    • -
  • nghttp2 0.2.0-DEV documentation »
    • +
  • nghttp2 0.3.0-DEV documentation »
    • diff --git a/searchindex.js b/searchindex.js index e04f617a..661625b4 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({objects:{"":{NGHTTP2_ERR_INVALID_STATE:[0,0,1,""],NGHTTP2_ERR_HEADER_COMP:[0,0,1,""],NGHTTP2_SETTINGS_HEADER_TABLE_SIZE:[0,0,1,""],nghttp2_settings_entry:[0,2,1,""],NGHTTP2_INTERNAL_ERROR:[0,0,1,""],NGHTTP2_PRI_LOWEST:[0,0,1,""],nghttp2_on_frame_recv_callback:[0,2,1,""],NGHTTP2_CLIENT_CONNECTION_HEADER_LEN:[0,0,1,""],nghttp2_goaway:[0,2,1,""],nghttp2_ping:[0,2,1,""],NGHTTP2_ERR_INVALID_FRAME:[0,0,1,""],nghttp2_frame_type:[0,2,1,""],nghttp2_on_data_recv_callback:[0,2,1,""],nghttp2_select_next_protocol:[0,3,1,""],NGHTTP2_ERR_INVALID_HEADER_BLOCK:[0,0,1,""],nghttp2_session_callbacks:[0,2,1,""],NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGS:[0,0,1,""],NGHTTP2_ERR_PROTO:[0,0,1,""],NGHTTP2_MAX_HEADER_TABLE_SIZE:[0,0,1,""],nghttp2_submit_window_update:[0,3,1,""],NGHTTP2_ERR_UNSUPPORTED_VERSION:[0,0,1,""],NGHTTP2_SETTINGS_ENABLE_PUSH:[0,0,1,""],nghttp2_window_update:[0,2,1,""],NGHTTP2_DATA:[0,0,1,""],nghttp2_frame_hd:[0,2,1,""],NGHTTP2_ERR_INVALID_STREAM_STATE:[0,0,1,""],NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE:[0,0,1,""],NGHTTP2_FLAG_ACK:[0,0,1,""],NGHTTP2_STREAM_CLOSED:[0,0,1,""],NGHTTP2_SETTINGS_MAX:[0,0,1,""],NGHTTP2_MAX_WINDOW_SIZE:[0,0,1,""],nghttp2_headers_category:[0,2,1,""],nghttp2_error_code:[0,2,1,""],NGHTTP2_REFUSED_STREAM:[0,0,1,""],nghttp2_on_data_chunk_recv_callback:[0,2,1,""],NGHTTP2_ERR_START_STREAM_NOT_ALLOWED:[0,0,1,""],NGHTTP2_ERR_FLOW_CONTROL:[0,0,1,""],nghttp2_strerror:[0,3,1,""],nghttp2_gzip_inflate_del:[0,3,1,""],NGHTTP2_ERR_FATAL:[0,0,1,""],nghttp2_submit_goaway:[0,3,1,""],nghttp2_error:[0,2,1,""],NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZE:[0,0,1,""],NGHTTP2_ERR_NOMEM:[0,0,1,""],NGHTTP2_ERR_PAUSE:[0,0,1,""],NGHTTP2_ENHANCE_YOUR_CALM:[0,0,1,""],NGHTTP2_ERR_PUSH_DISABLED:[0,0,1,""],NGHTTP2_NO_ERROR:[0,0,1,""],NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS:[0,0,1,""],NGHTTP2_ERR_DEFERRED:[0,0,1,""],nghttp2_push_promise:[0,2,1,""],NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE:[0,0,1,""],nghttp2_session_get_outbound_queue_size:[0,3,1,""],nghttp2_rst_stream:[0,2,1,""],NGHTTP2_PROTO_VERSION_ID_LEN:[0,0,1,""],NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMS:[0,0,1,""],nghttp2_data_source_read_callback:[0,2,1,""],NGHTTP2_SETTINGS_TIMEOUT:[0,0,1,""],NGHTTP2_ERR_WOULDBLOCK:[0,0,1,""],nghttp2_session_resume_data:[0,3,1,""],NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE:[0,0,1,""],NGHTTP2_PRI_DEFAULT:[0,0,1,""],nghttp2_session_server_new:[0,3,1,""],NGHTTP2_FLAG_END_PUSH_PROMISE:[0,0,1,""],NGHTTP2_ERR_INVALID_ARGUMENT:[0,0,1,""],NGHTTP2_ERR_FRAME_SIZE_ERROR:[0,0,1,""],NGHTTP2_ERR_GOAWAY_ALREADY_SENT:[0,0,1,""],NGHTTP2_HEADERS:[0,0,1,""],nghttp2_flag:[0,2,1,""],NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE:[0,0,1,""],NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS:[0,0,1,""],NGHTTP2_HCAT_REQUEST:[0,0,1,""],NGHTTP2_FLAG_END_HEADERS:[0,0,1,""],nghttp2_gzip:[0,2,1,""],NGHTTP2_FLAG_END_STREAM:[0,0,1,""],NGHTTP2_ERR_EOF:[0,0,1,""],NGHTTP2_HCAT_HEADERS:[0,0,1,""],NGHTTP2_VERSION_NUM:[0,0,1,""],NGHTTP2_SETTINGS:[0,0,1,""],nghttp2_frame:[0,2,1,""],nghttp2_submit_push_promise:[0,3,1,""],nghttp2_session_mem_recv:[0,3,1,""],NGHTTP2_ERR_DEFERRED_DATA_EXIST:[0,0,1,""],NGHTTP2_CANCEL:[0,0,1,""],nghttp2_send_callback:[0,2,1,""],NGHTTP2_ERR_INVALID_STREAM_ID:[0,0,1,""],nghttp2_on_frame_send_callback:[0,2,1,""],nghttp2_submit_request2:[0,3,1,""],NGHTTP2_VERSION:[0,0,1,""],nghttp2_session:[0,2,1,""],NGHTTP2_COMPRESSION_ERROR:[0,0,1,""],NGHTTP2_HCAT_PUSH_RESPONSE:[0,0,1,""],nghttp2_submit_rst_stream:[0,3,1,""],nghttp2_submit_headers:[0,3,1,""],nghttp2_recv_callback:[0,2,1,""],nghttp2_session_get_stream_user_data:[0,3,1,""],NGHTTP2_FLAG_PRIORITY:[0,0,1,""],nghttp2_on_data_send_callback:[0,2,1,""],nghttp2_nv:[0,2,1,""],nghttp2_on_invalid_frame_recv_callback:[0,2,1,""],nghttp2_version:[0,3,1,""],nghttp2_on_unknown_frame_recv_callback:[0,2,1,""],nghttp2_session_continue:[0,3,1,""],NGHTTP2_ERR_STREAM_CLOSED:[0,0,1,""],nghttp2_opt:[0,2,1,""],NGHTTP2_ERR_CALLBACK_FAILURE:[0,0,1,""],NGHTTP2_FLOW_CONTROL_ERROR:[0,0,1,""],nghttp2_session_set_option:[0,3,1,""],NGHTTP2_ERR_STREAM_CLOSING:[0,0,1,""],nghttp2_session_client_new:[0,3,1,""],nghttp2_session_fail_session:[0,3,1,""],nghttp2_info:[0,2,1,""],NGHTTP2_PROTO_VERSION_ID:[0,0,1,""],nghttp2_settings_id:[0,2,1,""],nghttp2_session_send:[0,3,1,""],NGHTTP2_PROTOCOL_ERROR:[0,0,1,""],nghttp2_gzip_inflate:[0,3,1,""],nghttp2_session_upgrade:[0,3,1,""],nghttp2_session_del:[0,3,1,""],NGHTTP2_ERR_INSUFF_BUFSIZE:[0,0,1,""],nghttp2_settings:[0,2,1,""],nghttp2_on_frame_not_send_callback:[0,2,1,""],nghttp2_session_get_effective_recv_data_length:[0,3,1,""],nghttp2_submit_data:[0,3,1,""],nghttp2_submit_response:[0,3,1,""],NGHTTP2_CLIENT_CONNECTION_HEADER:[0,0,1,""],NGHTTP2_FLAG_NONE:[0,0,1,""],nghttp2_on_frame_recv_parse_error_callback:[0,2,1,""],nghttp2_submit_settings:[0,3,1,""],NGHTTP2_HCAT_RESPONSE:[0,0,1,""],NGHTTP2_PING:[0,0,1,""],NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE:[0,0,1,""],nghttp2_priority:[0,2,1,""],nghttp2_session_want_read:[0,3,1,""],NGHTTP2_VERSION_AGE:[0,0,1,""],NGHTTP2_CONNECT_ERROR:[0,0,1,""],NGHTTP2_RST_STREAM:[0,0,1,""],nghttp2_on_stream_close_callback:[0,2,1,""],NGHTTP2_PUSH_PROMISE:[0,0,1,""],nghttp2_data_provider:[0,2,1,""],nghttp2_on_request_recv_callback:[0,2,1,""],nghttp2_session_recv:[0,3,1,""],nghttp2_session_get_effective_local_window_size:[0,3,1,""],NGHTTP2_INITIAL_WINDOW_SIZE:[0,0,1,""],NGHTTP2_WINDOW_UPDATE:[0,0,1,""],NGHTTP2_SETTINGS_FLOW_CONTROL_OPTIONS:[0,0,1,""],nghttp2_session_want_write:[0,3,1,""],nghttp2_submit_priority:[0,3,1,""],nghttp2_session_get_stream_effective_local_window_size:[0,3,1,""],nghttp2_headers:[0,2,1,""],nghttp2_before_frame_send_callback:[0,2,1,""],NGHTTP2_GOAWAY:[0,0,1,""],NGHTTP2_ERR_GZIP:[0,0,1,""],nghttp2_submit_ping:[0,3,1,""],NGHTTP2_FRAME_SIZE_ERROR:[0,0,1,""],nghttp2_data_source:[0,2,1,""],NGHTTP2_ERR_STREAM_SHUT_WR:[0,0,1,""],NGHTTP2_PRIORITY:[0,0,1,""],nghttp2_submit_request:[0,3,1,""],nghttp2_session_get_stream_effective_recv_data_length:[0,3,1,""],nghttp2_pack_settings_payload:[0,3,1,""],nghttp2_gzip_inflate_new:[0,3,1,""],nghttp2_nv_compare_name:[0,3,1,""]},nghttp2_session_callbacks:{on_invalid_frame_recv_callback:[0,1,1,""],before_frame_send_callback:[0,1,1,""],on_stream_close_callback:[0,1,1,""],on_data_chunk_recv_callback:[0,1,1,""],on_unknown_frame_recv_callback:[0,1,1,""],send_callback:[0,1,1,""],nghttp2_on_frame_recv_parse_error_callback:[0,1,1,""],on_frame_send_callback:[0,1,1,""],on_frame_recv_callback:[0,1,1,""],on_data_send_callback:[0,1,1,""],on_frame_not_send_callback:[0,1,1,""],on_request_recv_callback:[0,1,1,""],on_data_recv_callback:[0,1,1,""],recv_callback:[0,1,1,""]},nghttp2_frame:{push_promise:[0,1,1,""],settings:[0,1,1,""],ping:[0,1,1,""],rst_stream:[0,1,1,""],priority:[0,1,1,""],headers:[0,1,1,""],goaway:[0,1,1,""],window_update:[0,1,1,""],hd:[0,1,1,""]},nghttp2_ping:{hd:[0,1,1,""]},nghttp2_data_provider:{source:[0,1,1,""],read_callback:[0,1,1,""]},nghttp2_priority:{pri:[0,1,1,""],hd:[0,1,1,""]},nghttp2_settings_entry:{settings_id:[0,1,1,""],value:[0,1,1,""]},nghttp2_window_update:{hd:[0,1,1,""],window_size_increment:[0,1,1,""]},nghttp2_frame_hd:{stream_id:[0,1,1,""],length:[0,1,1,""],flags:[0,1,1,""],type:[0,1,1,""]},nghttp2_info:{age:[0,1,1,""],version_str:[0,1,1,""],version_num:[0,1,1,""],proto_str:[0,1,1,""]},nghttp2_rst_stream:{error_code:[0,1,1,""],hd:[0,1,1,""]},nghttp2_nv:{valuelen:[0,1,1,""],namelen:[0,1,1,""],name:[0,1,1,""],value:[0,1,1,""]},nghttp2_headers:{nvlen:[0,1,1,""],pri:[0,1,1,""],hd:[0,1,1,""],nva:[0,1,1,""]},nghttp2_goaway:{opaque_data:[0,1,1,""],error_code:[0,1,1,""],opaque_data_len:[0,1,1,""],hd:[0,1,1,""],last_stream_id:[0,1,1,""]},nghttp2_data_source:{fd:[0,1,1,""],ptr:[0,1,1,""]},nghttp2_push_promise:{promised_stream_id:[0,1,1,""],nvlen:[0,1,1,""],nva:[0,1,1,""],hd:[0,1,1,""]},nghttp2_settings:{niv:[0,1,1,""],hd:[0,1,1,""],iv:[0,1,1,""]}},terms:{represent:[0,3],all:[0,1,3],code:[0,1,2],on_unknown_frame_recv_callback:[0,1],illustr:2,nghttp2_err_start_stream_not_allow:[0,1],my_obj:[0,1],lack:[0,1],nghttp2_frame_hd:[0,1],nghttp2_cancel:[0,1],nghttp2ver_h:3,prefix:[0,1],"0x01":2,overlap:[0,1],nghttp2_session_get_stream_effective_local_window_s:[0,1],follow:[0,1,2,3],ptr:[0,1],categori:[0,1],decid:[0,1],herebi:[1,3],"const":[0,1],uint8_t:[0,1],unpack:[0,1],specif:[0,1],send:[0,1,2],program:[4,2],under:[0,1,2],sens:[0,1],fatal:[0,1],spec:[0,1],sent:[0,1],merchant:[1,3],sourc:[0,1],string:[0,1,2],nul:[0,1],percentageoforiginals:2,"void":[0,1],settings_header_table_s:[0,1,2],nghttp2_settings_enable_push:[0,1],nghttp2_flag_end_push_promis:[0,1],nghttp2_submit_p:[0,1],failur:[0,1],veri:[0,1],retriev:[0,1],"0x010203":[0,3],nghttp2_on_frame_recv_callback:[0,1],level:[0,1],did:[0,1],list:[0,1],"try":2,nghttp2_headers_categori:[0,1],settings_id:[0,1],adjust:[0,1],optlen:[0,1],small:[0,1],path:2,refer:[0,1,2,4],prepar:[0,1],pleas:2,prevent:[0,1],impli:[1,3],on_stream_close_callback:[0,1],"0x1":[0,1],direct:2,"0x4":[0,1],zero:[0,1],sensibl:[0,1],pass:[0,1],download:[4,2],further:[0,1],otherwis:[0,1,3],port:2,proxi:[4,2],index:2,what:[0,1],appear:2,compar:[0,1],settings_flow_control_opt:[0,1],neg:[0,1],sum:2,invok:[0,1],current:[0,1],version:[0,1,2,3,4],nghttp2_err_insuff_bufs:[0,1],base64url:[0,1],"new":[0,1,2],tatsuhiro:[1,2,3],on_invalid_ctrl_recv_callback:[0,1],"public":[0,1,2,4],nghttp2_session_resume_data:[0,1],on_ctrl_recv_callback:[0,1],abov:[0,1,2,3],gener:[0,1,2],http2:[0,1,2,4],onli:[0,1,2],here:[0,1,2],closur:[0,1],met:[0,1],compression_error:[0,1],ubuntu:2,depend:[0,1],becom:[0,1,3],modifi:[1,2,3],sinc:[0,1,2],valu:[0,1,2],nextprotoneg:[0,1],incom:[0,1,2],remark:[0,4],nghttp2_err_push_dis:[0,1],overwritten:[0,1],larger:[0,1],connect_error:[0,1],host:2,autoreconf:2,queue:[0,1],jansson:2,tri:[0,1],behav:[0,1],permit:[1,3],action:[1,3],nghttp2_submit_prior:[0,1],implement:[0,1,2,4],nghttp2_err_gzip:[0,1],nghttp2_frame:[0,1],nghttp2_err_goaway_already_s:[0,1],regardless:[0,1],defer:[0,1],appli:[0,1],transit:[0,1],prefer:[0,1],releas:[0,3,4],api:[0,1,4],nghttp2_session_mem_recv:[0,1],instal:2,should:[0,1],"byte":[0,1,2],select:[0,1,2],from:[0,1,2,3,4],describ:[0,1],would:[0,1],memori:[0,1,2],upgrad:[0,1,2],next:[0,1,2],call:[0,1,2],asset:2,nghttp2_nv:[0,1],nghttp2_on_invalid_frame_recv_callback:[0,1],nghttp2_version:[0,1,3],type:[0,1,2,4],until:[0,1],minor:[0,3],more:[0,1,2],nghttp2_opt_no_auto_connection_window_upd:[0,1],goawai:[0,1,2],nghttp2_set:[0,1],nghttp2_settings_header_table_s:[0,1],nghttp2_pri_default:[0,1],rst_stream:[0,1],inflater_ptr:[0,1],notic:[1,3],user_data:[0,1],flag:[0,1,2],accept:[0,1,2],nghttp2_submit_window_upd:[0,1],particular:[0,1,3],known:[0,1],hold:[0,1],nghttp2_err_wouldblock:[0,1],must:[0,1,2],inputlen:2,account:[0,1,2],endpoint:[0,1,2],word:[0,1],grant:[1,3],tunnel:2,nghttp2_settings_id:[0,1],work:2,stream_user_data:[0,1],dev:[2,3],cat:1,descriptor:[0,1],remain:[0,1],can:[0,1,2],nghttp2_enhance_your_calm:[0,1],nghttp2_flag_ack:[0,1],purpos:[1,3],syn_repli:[0,1],control:[0,1],claim:[1,3],substanti:[1,3],stream:[0,1,2],give:[0,1],process:[0,1,2],indic:[0,1],abort:[0,1],want:[0,1],onlin:[0,2],nghttp2_header:[0,1],serial:[0,1],nghttp2_err_invalid_stream_st:[0,1],unsign:[0,1],occur:[0,1],nghttp2_settings_flow_control_opt:[0,1],alwai:[0,1],multipl:[0,1],secur:2,anoth:[0,1],charset:2,ping:[0,1],nghttp2_flag_non:[0,1],write:2,fals:2,nghttp2_err_fat:[0,1],pair:[0,1,2],sever:[0,1,2],serveraddr:2,reject:[0,1],sec9:[0,1],instead:[0,1],flow:[0,1],simpl:[0,1],updat:[0,1],nghttp2_msg_more:1,nghttp2_on_request_recv_callback:[0,1],npn:[0,1,2],resourc:[0,1,2,4],referenc:2,after:[0,1,2],spdylai:2,befor:[0,1],mai:[0,1,2],nghttp2_compression_error:[0,1],alloc:[0,1],autotool:2,attempt:[0,1],third:[0,1],opaqu:[0,1],stdin:2,nvlen:[0,1],correspond:2,exclud:[0,1],issu:[0,1],nghttp2_flag_prior:[0,1],nghttp2_err_flow_control:[0,1],nghttp2_connect_error:[0,1],nghttp2_version_num:[0,1,3],allow:[0,1],nghttp2_session_want_read:[0,1],order:[0,1,2],furnish:[1,3],includ:[0,1,2,3,4],frontend:2,nghttp2_err_stream_shut_wr:[0,1],nghttp2_err_paus:[0,1],hypertext:[4,2],move:[0,1],rang:[0,1,2],libcunit1:2,through:2,nghttp2:[0,1,2,3,4],untouch:[0,1],size_t:[0,1],nghttp2_err_unsupported_vers:[0,1],still:[0,1,2],mainli:[0,1],paramet:[0,1],typedef:[0,1,4],outer:2,fit:[1,3],precondit:[0,1],max_outlen:[0,1],nghttp2_hcat_push_respons:[0,1],tort:[1,3],window:[0,1],pend:[0,1],nghttp2_err_eof:[0,1],hidden:[0,1],therefor:[0,1],nghttp2_session_send:[0,1],inlen:[0,1],valuelen:[0,1],recept:[0,1],them:[0,1],within:2,crash:0,greater:[0,1],thei:[0,1,2],nghttp2_push_promis:[0,1],nghttp2_goawai:[0,1],initi:[0,1],disabl:[0,1,2],"break":[0,1],nghttp2_initial_max_concurrent_stream:[0,1],nghttp2_submit_head:[0,1],promis:[0,1],half:[0,1],choic:[0,1],on_frame_recv_parse_error_callback:1,document:[4,1,2,3],name:[0,1,2],nghttp2_err_callback_failur:[0,1],nghttp2_send_callback:[0,1],nghttp2_frame_typ:[0,1],no_error:2,drop:[0,1],achiev:[0,1],alreadi:[0,1],mode:2,each:[0,1,2],debug:[0,1],fulli:[0,1],side:[0,1],trailer:[0,1],mean:[0,1,2],either:[0,1],nghttp2_on_frame_send_callback:[0,1],bump:[0,1],protocol_error:[0,1],chunk:[0,1],continu:[0,1,2],nghttp2_err_temporal_callback_failur:[0,1],"static":[0,1,2],expect:2,http:[0,1,2,3,4],happen:2,patch:[0,3],event:[1,3],out:[0,1,2,3],given:[0,1],space:[0,1,2],req:[0,1],publish:[1,3],primari:[0,1],content:[4,2],etag:2,suitabl:[0,1],on_ctrl_not_send_callback:[0,1],nghttp2_client_connection_header_len:[0,1],got:[0,1],on_frame_not_send_callback:[0,1],recv_callback:[0,1],end_stream:[0,1,2],earlier:2,stderr:2,insid:2,state:[0,1,2],nghttp2_internal_error:[0,1],free:[0,1,3],nghttp2_session_fail_sess:[0,1],reason:[0,1],base:2,inflat:[0,1],usual:[0,1],put:[0,1],org:[0,1,2,4],nghttp2_flag:[0,1],alert:2,recv:2,spdy:[0,1,2],nghttp2ver:[0,1,3,4],thread:2,badli:[0,1],could:[0,1],omit:[0,1],openssl:2,keep:[0,1,2],length:[0,1,2],place:[0,1],outsid:[0,2],retain:[0,1],assign:[0,1],optval:[0,1],first:[0,1,2],oper:[0,1,2],softwar:[1,3],major:[0,1,3],nghttp2_max_header_table_s:[0,1],directli:[0,1],onc:[0,1],arrai:[0,1,2],dealloc:2,number:[0,1,3],yourself:2,restrict:[1,3],nghttp2_protocol_error:[0,1],"0x8":[0,1],done:2,messag:[0,1],stdlib:1,opaque_data:[0,1,2],on_frame_recv_callback:[0,1],open:[0,1,2],payload:[0,1],size:[0,1,2],prioriti:[0,1],differ:[0,1],smaller:2,script:2,unknown:[0,1],data_prd:[0,1],nghttp2_session_get_stream_user_data:[0,1],least:[0,1,2],on_unknown_ctrl_recv_callback:[0,1],necessarili:[0,1],draft:[0,1,2,4],too:[0,1],similarli:[0,1],termin:[0,1,2],internal_error:[0,1],conveni:[0,1],"final":[0,1],store:[0,1],on_ctrl_send_callback:[0,1],ssl_ctx:[0,1],option:[0,1,2],tool:[4,2],copi:[0,1,3],nghttp2_proto_version_id_len:[0,1],lower:[0,1],specifi:[0,1,2],nghttp2_client_connection_head:[0,1],compressor:2,github:2,pars:[0,1],sign:2,holder:[1,3],than:[0,1,2],kind:[0,1,3],scheme:2,nghttp2_err_header_comp:[0,1],remov:[0,1],see:[0,1,2],structur:[0,1],charact:[0,1],project:2,bridg:2,headert:2,entri:[0,1,2],posit:[0,1],nghttp2_session_del:[0,1],read_callback:[0,1],browser:2,lowest:[0,1],sai:[0,1],window_size_incr:[0,1,2],respons:[0,1,2],pri:[0,1],argument:[0,1,2],packag:2,increment:[0,1],tabl:[0,1,2],need:[0,1,2],element:[0,1,2],nghttp2_on_frame_recv_parse_error_callback:[0,1],syn_stream:[0,1],sell:[1,3],caus:[0,1],bitwis:[0,1],date:2,unexpect:[0,1],callback:[0,1],"0x04":2,"0x05":2,nghttp2_io_flag:1,"0x00":2,"switch":2,note:[0,1,2],nghttp2_refused_stream:[0,1],exampl:[0,1,2],unlimit:[0,1],take:[0,1,2],which:[0,1,2],nghttp2_err_deferred_data_exist:[0,1],noth:[0,1],singl:[0,1,2],opaque_data_len:[0,1],sure:2,unless:[0,1],ssize_t:[0,1],"enum":[0,1,4],shall:[1,3],buffer:[0,1,2],"__cplusplu":1,aaaabaaaagqaaaahaad__w:2,compress:[4,2],settings_max_concurrent_stream:[0,1,2],nghttp2_hcat_request:[0,1],most:[0,1,2],vnu:2,nghttp2_settings_timeout:[0,1],thi:[0,1,2,3,4],nghttp2_before_frame_send_callback:[0,1],charg:[1,3],nghttp2_error_cod:[0,1],nghttp2_err_stream_id_not_avail:[0,1],don:[0,1],http2_select:[0,1],url:2,doc:2,frame_size_error:[0,1,2],later:[0,1],request:[0,1,2],uri:2,doe:[0,1],talk:2,sun:2,nghttp2_gzip_inflate_new:[0,1],on_invalid_frame_recv_callback:[0,1],hdtest:2,show:2,text:2,hostnam:2,verbos:2,session:[0,1],pkg:2,permiss:[1,3],protocol:[0,1,2,4],deploi:2,data:[0,1,2],overflow:[0,1],access:2,nghttp2_submit_push_promis:[0,1],submit:[0,1],nghttp2_submit_rst_stream:[0,1],copyright:[1,3],refused_stream:[0,1],configur:[0,1,2],apach:2,figur:2,start:[0,1,2],before_ctrl_send_callback:[0,1],nghttp2_opt_no_auto_stream_window_upd:[0,1],nghttp2_err_invalid_stream_id:[0,1],experiment:[4,2],queu:[0,1],"4e5535a027780":2,local:[0,1],oct:2,nghttp2_session_get_stream_effective_recv_data_length:[0,1],"0284f77778ff":2,count:[0,1],over:2,nghttp2_err_proto:[0,1],variou:[0,1],get:[0,1,2],familiar:2,express:[1,3],window_upd:[0,1,2],outlen:[0,1],end_head:[0,1,2],ssl:[0,1,2],settings_initial_window_s:[0,1,2],cannot:[0,1],nghttp2_data:[0,1],optnam:[0,1],increas:[0,1],liabl:[1,3],nghttp2_flag_end_stream:[0,1],net:2,requir:[0,1,2,4],before_frame_send_callback:[0,1],nghttp2_no_error:[0,1],nghttp2_submit_respons:[0,1],enabl:[0,1,2],ietf:[4,2],skip:[0,1],nghttp2_stream_clos:[0,1],nghttp2_frame_size_error:[0,1],push_promis:[0,1],method:[0,1,2],provid:[0,1,3],stuff:[0,1],nghttp2_strerror:[0,1],contain:[0,1,2],nghttp2_window_upd:[0,1],nghttp2_gzip_inflate_del:[0,1],user:[0,1,2],certif:2,set:[0,1,2],seq:2,sep:2,nghttp2_session_continu:[0,1],ousid:2,frame:[0,1,2],knowledg:2,maximum:[0,1,2],nghttp2_submit_goawai:[0,1],temporarili:[0,1],result:[0,1],arg:[0,1],fail:[0,1],close:[0,1,2],becaus:[0,1],analog:[0,1],subject:[1,3],statu:[0,1,2,4],correctli:[0,1],vari:[0,1,2],someth:[0,1],below:[0,1],numer:[0,1,3],written:[0,1,2],nghttp2_on_data_chunk_recv_callback:[0,1],nghttp2_initial_connection_window_s:[0,1],accord:[0,1],libjansson:2,kei:[0,1,2],supporet:2,prior:2,style:2,extens:2,entir:[0,1],len:[0,1],last_stream_id:[0,1,2],beyond:[0,1],problem:[0,1],addit:[0,1],bodi:[0,1],last:[0,1,2],delimit:2,nghttp2_proto_version_id:[0,1],region:[0,1],nghttp2_session_want_writ:[0,1],against:[0,1],tempor:[0,1],damag:[1,3],etc:2,instanc:[0,1],deflatehd:2,agent:2,nghttp2_rst_stream:[0,1],on_request_recv_callback:[0,1],enhance_your_calm:[0,1],whole:[0,1],nghttp2_data_provid:[0,1],point:[0,1],int32_t:[0,1],address:2,nghttp2_err_too_many_inflight_set:[0,1],rfc2616:[0,1],nghttp2_max_window_s:[0,1],header:[0,1,2,4],nghttp2_prioriti:[0,1],non:[0,1,2],shutdown:[0,1],nghttp2_submit_request2:[0,1],cancel:[0,1],nghttp2_session:[0,1],assum:[0,1],backend:2,liabil:[1,3],settings_timeout:[0,1],nghttp2_recv_callback:[0,1],union:[0,1,4],due:[0,1],been:[0,1],insuffici:[0,1],whom:[1,3],nghttp2_on_data_send_callback:[0,1],trigger:[0,1],treat:[0,1],interest:2,stdint:1,buf:[0,1],immedi:[0,1],nghttp2_hcat_head:[0,1],nghttp2_on_unknown_frame_recv_callback:[0,1],field:[0,1,2],flight:[0,1],outputlength:2,settings_enable_push:[0,1,2],both:[0,1,2],nghttp2_opt:[0,1],lib_error_cod:[0,1],buflen:[0,1],ani:[0,1,2,3],func:1,those:[0,1],"case":[0,1,2],multi:2,subsequ:[0,1],nghttp2_settings_initial_window_s:[0,1],zlib:2,sourceforg:2,defin:[0,1,3],"while":[0,1],behavior:[0,1],error:[0,1,2],exist:[0,1,2],invoc:[0,1],listen:2,on_data_chunk_recv_callback:[0,1],nghttp2_session_callback:[0,1],helper:[0,1],stdout:2,libxml2:2,squid:2,select_next_proto_cb:[0,1],promised_stream_id:[0,1],itself:[0,1],contract:[1,3],conf:2,"return":[0,1,2],flow_control_error:[0,1],ascii:[0,1],maxsiz:2,pointer:[0,1],"null":[0,1],develop:[4,2],author:[1,2,3],perform:[0,1,2],make:[0,1,2],belong:[0,1],same:[0,1,2],nghttp2_err_invalid_header_block:[0,1],member:[0,1],pac:2,decod:[0,1],version_str:[0,1],ifndef:[1,3],nghttp2_on_stream_close_callback:[0,1],dyanmic:2,complet:[0,1],nghttp2_session_recv:[0,1],context:[0,1,2],stream_id:[0,1,2],mytyp:[0,1],effect:[0,1],on_ctrl_recv_parse_error_callback:[0,1],decompress:2,remot:[0,1,2],moment:2,"0185fafd3c3c7f81":2,zlib1g:2,ownership:[0,1],mani:[0,1],extern:1,outbound:[0,1],postpon:[0,1],nghttp2_submit_syn_stream:[0,1],niv:[0,1,2],aka:[0,1,2],deflates:2,nghttp2_h:1,noninfring:[1,3],com:[0,1],thu:[0,1],nghttp:2,nghttp2_session_get_effective_local_window_s:[0,1],without:[0,1,2,3],inflatehd:2,person:[1,3],client:[0,1,2,4],command:2,uint32_t:[0,1],endif:[1,3],error_cod:[0,1,2],nghttp2_error:[0,1],nghttp2_data_sourc:[0,1],left:[0,1],end_push_promis:[0,1],interpret:[0,1],nghttp2_err_def:[0,1],nghttp2_submit_set:[0,1],identifi:[0,1],paus:[0,1],just:[0,1,2],less:[0,1],nghttp2_on_data_recv_callback:[0,1],send_callback:[0,1],obtain:[1,3],reserv:[0,1],payloadlen:[0,1],nghttp2_gzip_infl:[0,1],"0x000200":3,via:2,multiplex:2,"87038504252dd5918386":2,ifdef:1,nghttp2_flow_control_error:[0,1],on_frame_send_callback:[0,1],previous:[0,1],web:2,nghttp2_ping:[0,1],struct:[0,1,4],easi:2,also:[0,1],extra:2,priorit:[0,1],except:[0,1],aris:[1,3],identif:[0,1],add:[0,1],other:[0,1,3],version_num:[0,1],input:[0,1,2],on_data_send_callback:[0,1],nghttp2_select_next_protocol:[0,1],gmt:2,applic:[0,1,2],nghttp2_err_frame_size_error:[0,1],format:[0,1,2],read:[0,1,2],headlen:[0,1],nghttp2_version_ag:[0,1],period:[0,1],outlen_ptr:[0,1],nghttp2_session_set_opt:[0,1],know:[0,1],nva:[0,1],step:[0,1],bit:[0,1,3],arai:2,associ:[0,1,2,3],like:[0,1,2],success:2,arbitrari:[0,1],uint16_t:[0,1],signal:[0,1],nghttp2_session_server_new:[0,1],manual:2,html:[0,1,2,4],nghttp2_pri_lowest:[0,1],server:[0,1,2,4],nghttp2_flag_end_head:[0,1],"818703881f3468e5891afcbf863c856659c62e3f":2,tlen:[0,1],have:[0,1,2],output:[0,1,2],findproxyforurl:2,stream_clos:[0,1],www:[0,1],revers:2,settings_payload:[0,1],deal:[0,1,3],nghttp2_session_client_new:[0,1],some:[0,1],back:[0,1],self:2,sampl:2,integ:[0,1],nghttp2_session_get_effective_recv_data_length:[0,1],librari:[0,1,2,3,4],distribut:[1,3],nonzero:[0,1],lead:[0,1],bottom:[0,1],nghttp2_data_source_read_callback:[0,1],though:2,octet:[0,1],per:[0,1],track:2,outgo:[0,1],larg:[0,1],unit:2,condit:[0,1,3],nghttp2_session_upgrad:[0,1],duplic:[0,1],localhost:2,freed:2,machin:2,object:[0,1,2],run:[0,1,2],reach:[0,1],inspect:[0,1],chart:[0,1],settings_payloadlen:[0,1],nghttp2_nv_compare_nam:[0,1],found:[0,1],peer:[0,1],post:[0,1,2],nghttp2_session_get_outbound_queue_s:[0,1],decompressor:2,src:2,about:[0,1],actual:[0,1],socket:2,ack:[0,1,2],maxdeflates:2,commun:2,inlen_ptr:[0,1],nghttp2_gzip:[0,1],chrome:2,idl:[0,1],nghttp2_submit_data:[0,1],nghttp2_settings_max_concurrent_stream:[0,1],ssl_tlsext_err_ok:[0,1],produc:[0,1],block:[0,1,2],on_data_recv_callback:[0,1],nghttp2_settings_entri:[0,1],nsm:1,least_vers:[0,1],sublicens:[1,3],encod:[0,1,2],automat:[0,1],ssl_ctx_set_next_proto_select_cb:[0,1],warranti:[1,3],automak:2,right:[1,3],empti:[0,1,2],chang:[0,1],merg:[1,3],occupi:2,inclus:[0,1],git:[0,1,2,4],nghttp2_hcat_respons:[0,1],wai:[0,1,2],transfer:[0,1,2,4],nghttp2_err_invalid_fram:[0,1],support:[0,1,2],hex:2,json:2,"long":[0,1],avail:[0,1,2],intention:[0,1],config:2,nghttp2_err_stream_clos:[0,1],low:[0,1],lot:[0,1],ipv6:2,forward:2,overhead:2,strictli:[0,1],individu:[0,1],"function":[0,1,2,4],head:[0,1],session_ptr:[0,1],gzip:[0,1,2],form:[0,1],offer:2,nghttp2_err_invalid_st:[0,1],taken:[0,1],libssl:2,link:2,cunit:2,line:2,highest:[0,1],"true":2,eof:[0,1],suppli:[0,1],succe:[0,1],utf:2,possibl:[0,1],whether:[1,3],nghttp2_settings_max:[0,1],caller:[0,1],googlecod:[0,1],displai:2,tell:[0,1],asynchron:[0,1],deafult:2,limit:[1,3],reorder:[0,1],hpack:2,nghttpx:2,nghttpd:2,inform:[0,1,2],autoconf:2,clear:[0,1],libev:2,connect:[0,1,2,3],nghttp2_initial_window_s:[0,1],featur:2,nghttp2_on_frame_not_send_callback:[0,1],creat:[0,1,2],"int":[0,1],httpbi:[4,2],tsujikawa:[1,3],repres:[0,1],"char":[0,1],incomplet:2,ipv4:2,decreas:[0,1],file:[0,1,2,3],check:[0,1],nghttp2_err_nomem:[0,1],concurr:[0,1],again:[0,1],macro:[0,1,3,4],functypedef:1,googl:2,when:[0,1,2],detail:[0,1],invalid:[0,1],"default":[0,1,2],build:[4,2],valid:[0,1,2],role:[0,1],futur:[0,1],test:[4,2],you:[0,1,2],transmiss:[0,1],nghttp2_info:[0,1],fork:2,sequenc:[0,1],nghttp2_pack_settings_payload:[0,1],technot:[0,1],nghttp2_opt_peer_max_concurrent_stream:[0,1],libtool:2,nghttp2_err_invalid_argu:[0,1],proto_str:[0,1],alpn:[0,1,2],debian:2,reduc:[0,1],receiv:[0,1],sphinx:2,longer:2,algorithm:[0,1],directori:2,reliabl:[0,1],mask:[0,1],indirectli:0,nghttp2_submit_request:[0,1],namelen:[0,1],portion:[0,1,3],ignor:[0,1],time:[0,1,2],push:[0,1],deflat:[0,1,2],avoid:[0,1]},objtypes:{"0":"c:macro","1":"c:member","2":"c:type","3":"c:function"},titles:["API Reference","nghttp2.h","nghttp2 - HTTP/2.0 C Library","nghttp2ver.h","nghttp2 - HTTP/2.0 C Library"],objnames:{"0":["c","macro","C macro"],"1":["c","member","C member"],"2":["c","type","C type"],"3":["c","function","C function"]},filenames:["apiref","nghttp2.h","package_README","nghttp2ver.h","index"]}) \ No newline at end of file +Search.setIndex({objects:{"":{NGHTTP2_ERR_INVALID_STATE:[0,0,1,""],NGHTTP2_ERR_HEADER_COMP:[0,0,1,""],NGHTTP2_SETTINGS_HEADER_TABLE_SIZE:[0,0,1,""],nghttp2_settings_entry:[0,2,1,""],NGHTTP2_INTERNAL_ERROR:[0,0,1,""],NGHTTP2_PRI_LOWEST:[0,0,1,""],nghttp2_on_frame_recv_callback:[0,2,1,""],NGHTTP2_CLIENT_CONNECTION_HEADER_LEN:[0,0,1,""],nghttp2_goaway:[0,2,1,""],nghttp2_ping:[0,2,1,""],NGHTTP2_ERR_INVALID_FRAME:[0,0,1,""],nghttp2_frame_type:[0,2,1,""],nghttp2_on_data_recv_callback:[0,2,1,""],nghttp2_select_next_protocol:[0,3,1,""],NGHTTP2_ERR_INVALID_HEADER_BLOCK:[0,0,1,""],nghttp2_session_callbacks:[0,2,1,""],NGHTTP2_ERR_TOO_MANY_INFLIGHT_SETTINGS:[0,0,1,""],NGHTTP2_ERR_PROTO:[0,0,1,""],NGHTTP2_MAX_HEADER_TABLE_SIZE:[0,0,1,""],nghttp2_submit_window_update:[0,3,1,""],NGHTTP2_ERR_UNSUPPORTED_VERSION:[0,0,1,""],NGHTTP2_SETTINGS_ENABLE_PUSH:[0,0,1,""],nghttp2_window_update:[0,2,1,""],NGHTTP2_DATA:[0,0,1,""],nghttp2_frame_hd:[0,2,1,""],NGHTTP2_ERR_INVALID_STREAM_STATE:[0,0,1,""],NGHTTP2_ERR_STREAM_ID_NOT_AVAILABLE:[0,0,1,""],NGHTTP2_FLAG_ACK:[0,0,1,""],NGHTTP2_STREAM_CLOSED:[0,0,1,""],NGHTTP2_SETTINGS_MAX:[0,0,1,""],NGHTTP2_MAX_WINDOW_SIZE:[0,0,1,""],nghttp2_headers_category:[0,2,1,""],nghttp2_error_code:[0,2,1,""],NGHTTP2_REFUSED_STREAM:[0,0,1,""],nghttp2_on_data_chunk_recv_callback:[0,2,1,""],NGHTTP2_ERR_START_STREAM_NOT_ALLOWED:[0,0,1,""],NGHTTP2_ERR_FLOW_CONTROL:[0,0,1,""],nghttp2_strerror:[0,3,1,""],nghttp2_gzip_inflate_del:[0,3,1,""],NGHTTP2_ERR_FATAL:[0,0,1,""],nghttp2_submit_goaway:[0,3,1,""],nghttp2_error:[0,2,1,""],NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZE:[0,0,1,""],NGHTTP2_ERR_NOMEM:[0,0,1,""],NGHTTP2_ERR_PAUSE:[0,0,1,""],NGHTTP2_ENHANCE_YOUR_CALM:[0,0,1,""],NGHTTP2_ERR_PUSH_DISABLED:[0,0,1,""],NGHTTP2_NO_ERROR:[0,0,1,""],NGHTTP2_OPT_PEER_MAX_CONCURRENT_STREAMS:[0,0,1,""],NGHTTP2_ERR_DEFERRED:[0,0,1,""],nghttp2_push_promise:[0,2,1,""],NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE:[0,0,1,""],nghttp2_session_get_outbound_queue_size:[0,3,1,""],nghttp2_rst_stream:[0,2,1,""],NGHTTP2_PROTO_VERSION_ID_LEN:[0,0,1,""],NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMS:[0,0,1,""],nghttp2_data_source_read_callback:[0,2,1,""],NGHTTP2_SETTINGS_TIMEOUT:[0,0,1,""],NGHTTP2_ERR_WOULDBLOCK:[0,0,1,""],nghttp2_session_resume_data:[0,3,1,""],NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE:[0,0,1,""],NGHTTP2_PRI_DEFAULT:[0,0,1,""],nghttp2_session_server_new:[0,3,1,""],NGHTTP2_FLAG_END_PUSH_PROMISE:[0,0,1,""],NGHTTP2_ERR_INVALID_ARGUMENT:[0,0,1,""],NGHTTP2_ERR_FRAME_SIZE_ERROR:[0,0,1,""],NGHTTP2_ERR_GOAWAY_ALREADY_SENT:[0,0,1,""],NGHTTP2_HEADERS:[0,0,1,""],nghttp2_flag:[0,2,1,""],NGHTTP2_OPT_NO_AUTO_STREAM_WINDOW_UPDATE:[0,0,1,""],NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS:[0,0,1,""],NGHTTP2_HCAT_REQUEST:[0,0,1,""],NGHTTP2_FLAG_END_HEADERS:[0,0,1,""],nghttp2_gzip:[0,2,1,""],NGHTTP2_FLAG_END_STREAM:[0,0,1,""],NGHTTP2_ERR_EOF:[0,0,1,""],NGHTTP2_HCAT_HEADERS:[0,0,1,""],NGHTTP2_VERSION_NUM:[0,0,1,""],NGHTTP2_SETTINGS:[0,0,1,""],nghttp2_frame:[0,2,1,""],nghttp2_submit_push_promise:[0,3,1,""],nghttp2_session_mem_recv:[0,3,1,""],NGHTTP2_ERR_DEFERRED_DATA_EXIST:[0,0,1,""],NGHTTP2_CANCEL:[0,0,1,""],nghttp2_send_callback:[0,2,1,""],NGHTTP2_ERR_INVALID_STREAM_ID:[0,0,1,""],nghttp2_on_frame_send_callback:[0,2,1,""],nghttp2_submit_request2:[0,3,1,""],NGHTTP2_VERSION:[0,0,1,""],nghttp2_session:[0,2,1,""],NGHTTP2_COMPRESSION_ERROR:[0,0,1,""],NGHTTP2_HCAT_PUSH_RESPONSE:[0,0,1,""],nghttp2_submit_rst_stream:[0,3,1,""],nghttp2_submit_headers:[0,3,1,""],nghttp2_recv_callback:[0,2,1,""],nghttp2_session_get_stream_user_data:[0,3,1,""],NGHTTP2_FLAG_PRIORITY:[0,0,1,""],nghttp2_on_data_send_callback:[0,2,1,""],nghttp2_nv:[0,2,1,""],nghttp2_on_invalid_frame_recv_callback:[0,2,1,""],nghttp2_version:[0,3,1,""],nghttp2_on_unknown_frame_recv_callback:[0,2,1,""],nghttp2_session_continue:[0,3,1,""],NGHTTP2_ERR_STREAM_CLOSED:[0,0,1,""],nghttp2_opt:[0,2,1,""],NGHTTP2_ERR_CALLBACK_FAILURE:[0,0,1,""],NGHTTP2_FLOW_CONTROL_ERROR:[0,0,1,""],nghttp2_session_set_option:[0,3,1,""],NGHTTP2_ERR_STREAM_CLOSING:[0,0,1,""],nghttp2_session_client_new:[0,3,1,""],nghttp2_session_fail_session:[0,3,1,""],nghttp2_info:[0,2,1,""],NGHTTP2_PROTO_VERSION_ID:[0,0,1,""],nghttp2_settings_id:[0,2,1,""],nghttp2_session_send:[0,3,1,""],NGHTTP2_PROTOCOL_ERROR:[0,0,1,""],nghttp2_gzip_inflate:[0,3,1,""],nghttp2_session_upgrade:[0,3,1,""],nghttp2_session_del:[0,3,1,""],NGHTTP2_ERR_INSUFF_BUFSIZE:[0,0,1,""],nghttp2_settings:[0,2,1,""],nghttp2_on_frame_not_send_callback:[0,2,1,""],nghttp2_session_get_effective_recv_data_length:[0,3,1,""],nghttp2_submit_data:[0,3,1,""],nghttp2_submit_response:[0,3,1,""],NGHTTP2_CLIENT_CONNECTION_HEADER:[0,0,1,""],NGHTTP2_FLAG_NONE:[0,0,1,""],nghttp2_on_frame_recv_parse_error_callback:[0,2,1,""],nghttp2_submit_settings:[0,3,1,""],NGHTTP2_HCAT_RESPONSE:[0,0,1,""],NGHTTP2_PING:[0,0,1,""],NGHTTP2_OPT_NO_AUTO_CONNECTION_WINDOW_UPDATE:[0,0,1,""],nghttp2_priority:[0,2,1,""],nghttp2_session_want_read:[0,3,1,""],NGHTTP2_VERSION_AGE:[0,0,1,""],NGHTTP2_CONNECT_ERROR:[0,0,1,""],NGHTTP2_RST_STREAM:[0,0,1,""],nghttp2_on_stream_close_callback:[0,2,1,""],NGHTTP2_PUSH_PROMISE:[0,0,1,""],nghttp2_data_provider:[0,2,1,""],nghttp2_on_request_recv_callback:[0,2,1,""],nghttp2_session_recv:[0,3,1,""],nghttp2_session_get_effective_local_window_size:[0,3,1,""],NGHTTP2_INITIAL_WINDOW_SIZE:[0,0,1,""],NGHTTP2_WINDOW_UPDATE:[0,0,1,""],NGHTTP2_SETTINGS_FLOW_CONTROL_OPTIONS:[0,0,1,""],nghttp2_session_want_write:[0,3,1,""],nghttp2_submit_priority:[0,3,1,""],nghttp2_session_get_stream_effective_local_window_size:[0,3,1,""],nghttp2_headers:[0,2,1,""],nghttp2_before_frame_send_callback:[0,2,1,""],NGHTTP2_GOAWAY:[0,0,1,""],NGHTTP2_ERR_GZIP:[0,0,1,""],nghttp2_submit_ping:[0,3,1,""],NGHTTP2_FRAME_SIZE_ERROR:[0,0,1,""],nghttp2_data_source:[0,2,1,""],NGHTTP2_ERR_STREAM_SHUT_WR:[0,0,1,""],NGHTTP2_PRIORITY:[0,0,1,""],nghttp2_submit_request:[0,3,1,""],nghttp2_session_get_stream_effective_recv_data_length:[0,3,1,""],nghttp2_pack_settings_payload:[0,3,1,""],nghttp2_gzip_inflate_new:[0,3,1,""],nghttp2_nv_compare_name:[0,3,1,""]},nghttp2_session_callbacks:{on_invalid_frame_recv_callback:[0,1,1,""],before_frame_send_callback:[0,1,1,""],on_stream_close_callback:[0,1,1,""],on_data_chunk_recv_callback:[0,1,1,""],on_unknown_frame_recv_callback:[0,1,1,""],send_callback:[0,1,1,""],nghttp2_on_frame_recv_parse_error_callback:[0,1,1,""],on_frame_send_callback:[0,1,1,""],on_frame_recv_callback:[0,1,1,""],on_data_send_callback:[0,1,1,""],on_frame_not_send_callback:[0,1,1,""],on_request_recv_callback:[0,1,1,""],on_data_recv_callback:[0,1,1,""],recv_callback:[0,1,1,""]},nghttp2_frame:{push_promise:[0,1,1,""],settings:[0,1,1,""],ping:[0,1,1,""],rst_stream:[0,1,1,""],priority:[0,1,1,""],headers:[0,1,1,""],goaway:[0,1,1,""],window_update:[0,1,1,""],hd:[0,1,1,""]},nghttp2_ping:{hd:[0,1,1,""]},nghttp2_data_provider:{source:[0,1,1,""],read_callback:[0,1,1,""]},nghttp2_priority:{pri:[0,1,1,""],hd:[0,1,1,""]},nghttp2_settings_entry:{settings_id:[0,1,1,""],value:[0,1,1,""]},nghttp2_window_update:{hd:[0,1,1,""],window_size_increment:[0,1,1,""]},nghttp2_frame_hd:{stream_id:[0,1,1,""],length:[0,1,1,""],flags:[0,1,1,""],type:[0,1,1,""]},nghttp2_info:{age:[0,1,1,""],version_str:[0,1,1,""],version_num:[0,1,1,""],proto_str:[0,1,1,""]},nghttp2_rst_stream:{error_code:[0,1,1,""],hd:[0,1,1,""]},nghttp2_nv:{valuelen:[0,1,1,""],namelen:[0,1,1,""],name:[0,1,1,""],value:[0,1,1,""]},nghttp2_headers:{nvlen:[0,1,1,""],pri:[0,1,1,""],hd:[0,1,1,""],nva:[0,1,1,""]},nghttp2_goaway:{opaque_data:[0,1,1,""],error_code:[0,1,1,""],opaque_data_len:[0,1,1,""],hd:[0,1,1,""],last_stream_id:[0,1,1,""]},nghttp2_data_source:{fd:[0,1,1,""],ptr:[0,1,1,""]},nghttp2_push_promise:{promised_stream_id:[0,1,1,""],nvlen:[0,1,1,""],nva:[0,1,1,""],hd:[0,1,1,""]},nghttp2_settings:{niv:[0,1,1,""],hd:[0,1,1,""],iv:[0,1,1,""]}},terms:{represent:[0,3],all:[0,1,3],code:[0,1,2],on_unknown_frame_recv_callback:[0,1],illustr:2,nghttp2_err_start_stream_not_allow:[0,1],my_obj:[0,1],lack:[0,1],nghttp2_frame_hd:[0,1],nghttp2_cancel:[0,1],nghttp2ver_h:3,prefix:[0,1],"0x01":2,overlap:[0,1],nghttp2_session_get_stream_effective_local_window_s:[0,1],follow:[0,1,2,3],ptr:[0,1],categori:[0,1],decid:[0,1],herebi:[1,3],"const":[0,1],uint8_t:[0,1],unpack:[0,1],specif:[0,1],send:[0,1,2],program:[4,2],under:[0,1,2],sens:[0,1],fatal:[0,1],spec:[0,1],sent:[0,1],merchant:[1,3],sourc:[0,1],string:[0,1,2],nul:[0,1],percentageoforiginals:2,"void":[0,1],settings_header_table_s:[0,1,2],nghttp2_settings_enable_push:[0,1],nghttp2_flag_end_push_promis:[0,1],nghttp2_submit_p:[0,1],failur:[0,1],veri:[0,1],retriev:[0,1],"0x010203":[0,3],nghttp2_on_frame_recv_callback:[0,1],level:[0,1],did:[0,1],list:[0,1],"try":2,nghttp2_headers_categori:[0,1],settings_id:[0,1],adjust:[0,1],optlen:[0,1],small:[0,1],path:2,refer:[0,1,2,4],prepar:[0,1],pleas:2,prevent:[0,1],impli:[1,3],on_stream_close_callback:[0,1],"0x1":[0,1],direct:2,"0x4":[0,1],zero:[0,1],sensibl:[0,1],pass:[0,1],download:[4,2],further:[0,1],otherwis:[0,1,3],port:2,proxi:[4,2],index:2,what:[0,1],appear:2,compar:[0,1],settings_flow_control_opt:[0,1],neg:[0,1],sum:2,invok:[0,1],current:[0,1],version:[0,1,2,3,4],nghttp2_err_insuff_bufs:[0,1],base64url:[0,1],"new":[0,1,2],tatsuhiro:[1,2,3],on_invalid_ctrl_recv_callback:[0,1],"public":[0,1,2,4],nghttp2_session_resume_data:[0,1],on_ctrl_recv_callback:[0,1],abov:[0,1,2,3],gener:[0,1,2],http2:[0,1,2,4],onli:[0,1,2],here:[0,1,2],closur:[0,1],met:[0,1],compression_error:[0,1],ubuntu:2,depend:[0,1],becom:[0,1,3],modifi:[1,2,3],sinc:[0,1,2],valu:[0,1,2],nextprotoneg:[0,1],incom:[0,1,2],remark:[0,4],nghttp2_err_push_dis:[0,1],overwritten:[0,1],larger:[0,1],connect_error:[0,1],host:2,autoreconf:2,queue:[0,1],jansson:2,tri:[0,1],behav:[0,1],permit:[1,3],action:[1,3],nghttp2_submit_prior:[0,1],implement:[0,1,2,4],nghttp2_err_gzip:[0,1],nghttp2_frame:[0,1],nghttp2_err_goaway_already_s:[0,1],regardless:[0,1],defer:[0,1],appli:[0,1],transit:[0,1],prefer:[0,1],releas:[0,3,4],api:[0,1,4],nghttp2_session_mem_recv:[0,1],instal:2,should:[0,1],"byte":[0,1,2],select:[0,1,2],from:[0,1,2,3,4],describ:[0,1],would:[0,1],memori:[0,1,2],upgrad:[0,1,2],next:[0,1,2],call:[0,1,2],asset:2,nghttp2_nv:[0,1],nghttp2_on_invalid_frame_recv_callback:[0,1],nghttp2_version:[0,1,3],type:[0,1,2,4],until:[0,1],minor:[0,3],more:[0,1,2],nghttp2_opt_no_auto_connection_window_upd:[0,1],goawai:[0,1,2],nghttp2_set:[0,1],nghttp2_settings_header_table_s:[0,1],nghttp2_pri_default:[0,1],rst_stream:[0,1],inflater_ptr:[0,1],notic:[1,3],user_data:[0,1],flag:[0,1,2],accept:[0,1,2],nghttp2_submit_window_upd:[0,1],particular:[0,1,3],known:[0,1],hold:[0,1],nghttp2_err_wouldblock:[0,1],must:[0,1,2],inputlen:2,account:[0,1,2],endpoint:[0,1,2],word:[0,1],grant:[1,3],tunnel:2,nghttp2_settings_id:[0,1],work:2,stream_user_data:[0,1],dev:[2,3],cat:1,descriptor:[0,1],remain:[0,1],can:[0,1,2],nghttp2_enhance_your_calm:[0,1],nghttp2_flag_ack:[0,1],purpos:[1,3],syn_repli:[0,1],control:[0,1],claim:[1,3],substanti:[1,3],stream:[0,1,2],give:[0,1],process:[0,1,2],indic:[0,1],abort:[0,1],want:[0,1],onlin:[0,2],nghttp2_header:[0,1],serial:[0,1],nghttp2_err_invalid_stream_st:[0,1],unsign:[0,1],occur:[0,1],nghttp2_settings_flow_control_opt:[0,1],alwai:[0,1],multipl:[0,1],secur:2,anoth:[0,1],charset:2,ping:[0,1],nghttp2_flag_non:[0,1],write:2,fals:2,nghttp2_err_fat:[0,1],pair:[0,1,2],sever:[0,1,2],serveraddr:2,reject:[0,1],sec9:[0,1],instead:[0,1],flow:[0,1],simpl:[0,1],updat:[0,1],nghttp2_msg_more:1,nghttp2_on_request_recv_callback:[0,1],npn:[0,1,2],resourc:[0,1,2,4],referenc:2,after:[0,1,2],spdylai:2,befor:[0,1],mai:[0,1,2],nghttp2_compression_error:[0,1],alloc:[0,1],autotool:2,attempt:[0,1],third:[0,1],opaqu:[0,1],stdin:2,nvlen:[0,1],correspond:2,exclud:[0,1],issu:[0,1],nghttp2_flag_prior:[0,1],nghttp2_err_flow_control:[0,1],nghttp2_connect_error:[0,1],nghttp2_version_num:[0,1,3],allow:[0,1],nghttp2_session_want_read:[0,1],order:[0,1,2],furnish:[1,3],includ:[0,1,2,3,4],frontend:2,nghttp2_err_stream_shut_wr:[0,1],nghttp2_err_paus:[0,1],hypertext:[4,2],move:[0,1],rang:[0,1,2],libcunit1:2,through:2,nghttp2:[0,1,2,3,4],untouch:[0,1],size_t:[0,1],nghttp2_err_unsupported_vers:[0,1],still:[0,1,2],mainli:[0,1],paramet:[0,1],typedef:[0,1,4],outer:2,fit:[1,3],precondit:[0,1],max_outlen:[0,1],nghttp2_hcat_push_respons:[0,1],tort:[1,3],window:[0,1],pend:[0,1],nghttp2_err_eof:[0,1],hidden:[0,1],therefor:[0,1],nghttp2_session_send:[0,1],inlen:[0,1],valuelen:[0,1],recept:[0,1],them:[0,1],within:2,crash:0,greater:[0,1],thei:[0,1,2],nghttp2_push_promis:[0,1],nghttp2_goawai:[0,1],initi:[0,1],disabl:[0,1,2],"break":[0,1],nghttp2_initial_max_concurrent_stream:[0,1],nghttp2_submit_head:[0,1],promis:[0,1],half:[0,1],choic:[0,1],on_frame_recv_parse_error_callback:1,document:[4,1,2,3],name:[0,1,2],nghttp2_err_callback_failur:[0,1],nghttp2_send_callback:[0,1],nghttp2_frame_typ:[0,1],no_error:2,drop:[0,1],achiev:[0,1],alreadi:[0,1],mode:2,each:[0,1,2],debug:[0,1],fulli:[0,1],side:[0,1],trailer:[0,1],mean:[0,1,2],either:[0,1],nghttp2_on_frame_send_callback:[0,1],bump:[0,1],protocol_error:[0,1],chunk:[0,1],continu:[0,1,2],nghttp2_err_temporal_callback_failur:[0,1],"static":[0,1,2],expect:2,http:[0,1,2,3,4],happen:2,patch:[0,3],event:[1,3],out:[0,1,2,3],given:[0,1],space:[0,1,2],req:[0,1],publish:[1,3],primari:[0,1],content:[4,2],etag:2,suitabl:[0,1],on_ctrl_not_send_callback:[0,1],nghttp2_client_connection_header_len:[0,1],got:[0,1],on_frame_not_send_callback:[0,1],recv_callback:[0,1],end_stream:[0,1,2],earlier:2,stderr:2,insid:2,state:[0,1,2],nghttp2_internal_error:[0,1],free:[0,1,3],nghttp2_session_fail_sess:[0,1],reason:[0,1],base:2,inflat:[0,1],usual:[0,1],put:[0,1],org:[0,1,2,4],nghttp2_flag:[0,1],alert:2,recv:2,spdy:[0,1,2],nghttp2ver:[0,1,3,4],thread:2,badli:[0,1],could:[0,1],omit:[0,1],openssl:2,keep:[0,1,2],length:[0,1,2],place:[0,1],outsid:[0,2],retain:[0,1],assign:[0,1],optval:[0,1],first:[0,1,2],oper:[0,1,2],softwar:[1,3],major:[0,1,3],nghttp2_max_header_table_s:[0,1],directli:[0,1],onc:[0,1],arrai:[0,1,2],dealloc:2,number:[0,1,3],yourself:2,restrict:[1,3],nghttp2_protocol_error:[0,1],"0x8":[0,1],done:2,messag:[0,1],stdlib:1,opaque_data:[0,1,2],on_frame_recv_callback:[0,1],open:[0,1,2],payload:[0,1],size:[0,1,2],prioriti:[0,1],differ:[0,1],smaller:2,script:2,unknown:[0,1],data_prd:[0,1],nghttp2_session_get_stream_user_data:[0,1],least:[0,1,2],on_unknown_ctrl_recv_callback:[0,1],necessarili:[0,1],draft:[0,1,2,4],too:[0,1],similarli:[0,1],termin:[0,1,2],internal_error:[0,1],conveni:[0,1],"final":[0,1],store:[0,1],on_ctrl_send_callback:[0,1],ssl_ctx:[0,1],option:[0,1,2],tool:[4,2],copi:[0,1,3],nghttp2_proto_version_id_len:[0,1],lower:[0,1],specifi:[0,1,2],nghttp2_client_connection_head:[0,1],compressor:2,github:2,pars:[0,1],sign:2,holder:[1,3],than:[0,1,2],kind:[0,1,3],scheme:2,nghttp2_err_header_comp:[0,1],remov:[0,1],see:[0,1,2],structur:[0,1],charact:[0,1],project:2,bridg:2,headert:2,entri:[0,1,2],posit:[0,1],nghttp2_session_del:[0,1],read_callback:[0,1],browser:2,lowest:[0,1],sai:[0,1],window_size_incr:[0,1,2],respons:[0,1,2],pri:[0,1],argument:[0,1,2],packag:2,increment:[0,1],tabl:[0,1,2],need:[0,1,2],element:[0,1,2],nghttp2_on_frame_recv_parse_error_callback:[0,1],syn_stream:[0,1],sell:[1,3],caus:[0,1],bitwis:[0,1],date:2,unexpect:[0,1],callback:[0,1],"0x04":2,"0x05":2,nghttp2_io_flag:1,"0x00":2,"switch":2,note:[0,1,2],nghttp2_refused_stream:[0,1],exampl:[0,1,2],unlimit:[0,1],take:[0,1,2],which:[0,1,2],nghttp2_err_deferred_data_exist:[0,1],noth:[0,1],singl:[0,1,2],opaque_data_len:[0,1],sure:2,unless:[0,1],ssize_t:[0,1],"enum":[0,1,4],shall:[1,3],buffer:[0,1,2],"__cplusplu":1,aaaabaaaagqaaaahaad__w:2,compress:[4,2],settings_max_concurrent_stream:[0,1,2],nghttp2_hcat_request:[0,1],most:[0,1,2],vnu:2,nghttp2_settings_timeout:[0,1],thi:[0,1,2,3,4],nghttp2_before_frame_send_callback:[0,1],charg:[1,3],nghttp2_error_cod:[0,1],nghttp2_err_stream_id_not_avail:[0,1],don:[0,1],http2_select:[0,1],url:2,doc:2,frame_size_error:[0,1,2],later:[0,1],request:[0,1,2],uri:2,doe:[0,1],talk:2,sun:2,nghttp2_gzip_inflate_new:[0,1],on_invalid_frame_recv_callback:[0,1],hdtest:2,show:2,text:2,hostnam:2,verbos:2,session:[0,1],pkg:2,permiss:[1,3],protocol:[0,1,2,4],deploi:2,data:[0,1,2],overflow:[0,1],access:2,nghttp2_submit_push_promis:[0,1],submit:[0,1],nghttp2_submit_rst_stream:[0,1],copyright:[1,3],refused_stream:[0,1],configur:[0,1,2],apach:2,figur:2,start:[0,1,2],before_ctrl_send_callback:[0,1],nghttp2_opt_no_auto_stream_window_upd:[0,1],nghttp2_err_invalid_stream_id:[0,1],experiment:[4,2],queu:[0,1],"4e5535a027780":2,local:[0,1],oct:2,nghttp2_session_get_stream_effective_recv_data_length:[0,1],"0284f77778ff":2,count:[0,1],over:2,nghttp2_err_proto:[0,1],variou:[0,1],get:[0,1,2],familiar:2,express:[1,3],window_upd:[0,1,2],outlen:[0,1],end_head:[0,1,2],ssl:[0,1,2],settings_initial_window_s:[0,1,2],cannot:[0,1],nghttp2_data:[0,1],optnam:[0,1],increas:[0,1],liabl:[1,3],nghttp2_flag_end_stream:[0,1],net:2,requir:[0,1,2,4],before_frame_send_callback:[0,1],nghttp2_no_error:[0,1],nghttp2_submit_respons:[0,1],enabl:[0,1,2],ietf:[4,2],skip:[0,1],nghttp2_stream_clos:[0,1],nghttp2_frame_size_error:[0,1],push_promis:[0,1],method:[0,1,2],provid:[0,1,3],stuff:[0,1],nghttp2_strerror:[0,1],contain:[0,1,2],nghttp2_window_upd:[0,1],nghttp2_gzip_inflate_del:[0,1],user:[0,1,2],certif:2,set:[0,1,2],seq:2,sep:2,nghttp2_session_continu:[0,1],ousid:2,frame:[0,1,2],knowledg:2,maximum:[0,1,2],nghttp2_submit_goawai:[0,1],temporarili:[0,1],result:[0,1],arg:[0,1],fail:[0,1],close:[0,1,2],becaus:[0,1],analog:[0,1],subject:[1,3],statu:[0,1,2,4],correctli:[0,1],vari:[0,1,2],someth:[0,1],below:[0,1],numer:[0,1,3],written:[0,1,2],nghttp2_on_data_chunk_recv_callback:[0,1],nghttp2_initial_connection_window_s:[0,1],accord:[0,1],libjansson:2,kei:[0,1,2],supporet:2,prior:2,style:2,extens:2,entir:[0,1],len:[0,1],last_stream_id:[0,1,2],beyond:[0,1],problem:[0,1],addit:[0,1],bodi:[0,1],last:[0,1,2],delimit:2,nghttp2_proto_version_id:[0,1],region:[0,1],"0x000300":3,nghttp2_session_want_writ:[0,1],against:[0,1],tempor:[0,1],damag:[1,3],etc:2,instanc:[0,1],deflatehd:2,agent:2,nghttp2_rst_stream:[0,1],on_request_recv_callback:[0,1],enhance_your_calm:[0,1],whole:[0,1],nghttp2_data_provid:[0,1],point:[0,1],int32_t:[0,1],address:2,nghttp2_err_too_many_inflight_set:[0,1],rfc2616:[0,1],nghttp2_max_window_s:[0,1],header:[0,1,2,4],nghttp2_prioriti:[0,1],non:[0,1,2],shutdown:[0,1],nghttp2_submit_request2:[0,1],cancel:[0,1],nghttp2_session:[0,1],assum:[0,1],backend:2,liabil:[1,3],settings_timeout:[0,1],nghttp2_recv_callback:[0,1],union:[0,1,4],due:[0,1],been:[0,1],insuffici:[0,1],whom:[1,3],nghttp2_on_data_send_callback:[0,1],trigger:[0,1],treat:[0,1],interest:2,stdint:1,buf:[0,1],immedi:[0,1],nghttp2_hcat_head:[0,1],nghttp2_on_unknown_frame_recv_callback:[0,1],field:[0,1,2],flight:[0,1],outputlength:2,settings_enable_push:[0,1,2],both:[0,1,2],nghttp2_opt:[0,1],lib_error_cod:[0,1],buflen:[0,1],ani:[0,1,2,3],func:1,those:[0,1],"case":[0,1,2],multi:2,subsequ:[0,1],nghttp2_settings_initial_window_s:[0,1],zlib:2,sourceforg:2,defin:[0,1,3],"while":[0,1],behavior:[0,1],error:[0,1,2],exist:[0,1,2],invoc:[0,1],listen:2,on_data_chunk_recv_callback:[0,1],nghttp2_session_callback:[0,1],helper:[0,1],stdout:2,libxml2:2,squid:2,select_next_proto_cb:[0,1],promised_stream_id:[0,1],itself:[0,1],contract:[1,3],conf:2,"return":[0,1,2],flow_control_error:[0,1],ascii:[0,1],maxsiz:2,pointer:[0,1],"null":[0,1],develop:[4,2],author:[1,2,3],perform:[0,1,2],make:[0,1,2],belong:[0,1],same:[0,1,2],nghttp2_err_invalid_header_block:[0,1],member:[0,1],pac:2,decod:[0,1],version_str:[0,1],ifndef:[1,3],nghttp2_on_stream_close_callback:[0,1],dyanmic:2,complet:[0,1],nghttp2_session_recv:[0,1],context:[0,1,2],stream_id:[0,1,2],mytyp:[0,1],effect:[0,1],on_ctrl_recv_parse_error_callback:[0,1],decompress:2,remot:[0,1,2],moment:2,"0185fafd3c3c7f81":2,zlib1g:2,ownership:[0,1],mani:[0,1],extern:1,outbound:[0,1],postpon:[0,1],nghttp2_submit_syn_stream:[0,1],niv:[0,1,2],aka:[0,1,2],deflates:2,nghttp2_h:1,noninfring:[1,3],com:[0,1],thu:[0,1],nghttp:2,nghttp2_session_get_effective_local_window_s:[0,1],without:[0,1,2,3],inflatehd:2,person:[1,3],client:[0,1,2,4],command:2,uint32_t:[0,1],endif:[1,3],error_cod:[0,1,2],nghttp2_error:[0,1],nghttp2_data_sourc:[0,1],left:[0,1],end_push_promis:[0,1],interpret:[0,1],nghttp2_err_def:[0,1],nghttp2_submit_set:[0,1],identifi:[0,1],paus:[0,1],just:[0,1,2],less:[0,1],nghttp2_on_data_recv_callback:[0,1],send_callback:[0,1],obtain:[1,3],reserv:[0,1],payloadlen:[0,1],nghttp2_gzip_infl:[0,1],via:2,multiplex:2,"87038504252dd5918386":2,ifdef:1,nghttp2_flow_control_error:[0,1],on_frame_send_callback:[0,1],previous:[0,1],web:2,nghttp2_ping:[0,1],struct:[0,1,4],easi:2,also:[0,1],extra:2,priorit:[0,1],except:[0,1],aris:[1,3],identif:[0,1],add:[0,1],other:[0,1,3],version_num:[0,1],input:[0,1,2],on_data_send_callback:[0,1],nghttp2_select_next_protocol:[0,1],gmt:2,applic:[0,1,2],nghttp2_err_frame_size_error:[0,1],format:[0,1,2],read:[0,1,2],headlen:[0,1],nghttp2_version_ag:[0,1],period:[0,1],outlen_ptr:[0,1],nghttp2_session_set_opt:[0,1],know:[0,1],nva:[0,1],step:[0,1],bit:[0,1,3],arai:2,associ:[0,1,2,3],like:[0,1,2],success:2,arbitrari:[0,1],uint16_t:[0,1],signal:[0,1],nghttp2_session_server_new:[0,1],manual:2,html:[0,1,2,4],nghttp2_pri_lowest:[0,1],server:[0,1,2,4],nghttp2_flag_end_head:[0,1],"818703881f3468e5891afcbf863c856659c62e3f":2,tlen:[0,1],have:[0,1,2],output:[0,1,2],findproxyforurl:2,stream_clos:[0,1],www:[0,1],revers:2,settings_payload:[0,1],deal:[0,1,3],nghttp2_session_client_new:[0,1],some:[0,1],back:[0,1],self:2,sampl:2,integ:[0,1],nghttp2_session_get_effective_recv_data_length:[0,1],librari:[0,1,2,3,4],distribut:[1,3],nonzero:[0,1],lead:[0,1],bottom:[0,1],nghttp2_data_source_read_callback:[0,1],though:2,octet:[0,1],per:[0,1],track:2,outgo:[0,1],larg:[0,1],unit:2,condit:[0,1,3],nghttp2_session_upgrad:[0,1],duplic:[0,1],localhost:2,freed:2,machin:2,object:[0,1,2],run:[0,1,2],reach:[0,1],inspect:[0,1],chart:[0,1],settings_payloadlen:[0,1],nghttp2_nv_compare_nam:[0,1],found:[0,1],peer:[0,1],post:[0,1,2],nghttp2_session_get_outbound_queue_s:[0,1],decompressor:2,src:2,about:[0,1],actual:[0,1],socket:2,ack:[0,1,2],maxdeflates:2,commun:2,inlen_ptr:[0,1],nghttp2_gzip:[0,1],chrome:2,idl:[0,1],nghttp2_submit_data:[0,1],nghttp2_settings_max_concurrent_stream:[0,1],ssl_tlsext_err_ok:[0,1],produc:[0,1],block:[0,1,2],on_data_recv_callback:[0,1],nghttp2_settings_entri:[0,1],nsm:1,least_vers:[0,1],sublicens:[1,3],encod:[0,1,2],automat:[0,1],ssl_ctx_set_next_proto_select_cb:[0,1],warranti:[1,3],automak:2,right:[1,3],empti:[0,1,2],chang:[0,1],merg:[1,3],occupi:2,inclus:[0,1],git:[0,1,2,4],nghttp2_hcat_respons:[0,1],wai:[0,1,2],transfer:[0,1,2,4],nghttp2_err_invalid_fram:[0,1],support:[0,1,2],hex:2,json:2,"long":[0,1],avail:[0,1,2],intention:[0,1],config:2,nghttp2_err_stream_clos:[0,1],low:[0,1],lot:[0,1],ipv6:2,forward:2,overhead:2,strictli:[0,1],individu:[0,1],"function":[0,1,2,4],head:[0,1],session_ptr:[0,1],gzip:[0,1,2],form:[0,1],offer:2,nghttp2_err_invalid_st:[0,1],taken:[0,1],libssl:2,link:2,cunit:2,line:2,highest:[0,1],"true":2,eof:[0,1],suppli:[0,1],succe:[0,1],utf:2,possibl:[0,1],whether:[1,3],nghttp2_settings_max:[0,1],caller:[0,1],googlecod:[0,1],displai:2,tell:[0,1],asynchron:[0,1],deafult:2,limit:[1,3],reorder:[0,1],hpack:2,nghttpx:2,nghttpd:2,inform:[0,1,2],autoconf:2,clear:[0,1],libev:2,connect:[0,1,2,3],nghttp2_initial_window_s:[0,1],featur:2,nghttp2_on_frame_not_send_callback:[0,1],creat:[0,1,2],"int":[0,1],httpbi:[4,2],tsujikawa:[1,3],repres:[0,1],"char":[0,1],incomplet:2,ipv4:2,decreas:[0,1],file:[0,1,2,3],check:[0,1],nghttp2_err_nomem:[0,1],concurr:[0,1],again:[0,1],macro:[0,1,3,4],functypedef:1,googl:2,when:[0,1,2],detail:[0,1],invalid:[0,1],"default":[0,1,2],build:[4,2],valid:[0,1,2],role:[0,1],futur:[0,1],test:[4,2],you:[0,1,2],transmiss:[0,1],nghttp2_info:[0,1],fork:2,sequenc:[0,1],nghttp2_pack_settings_payload:[0,1],technot:[0,1],nghttp2_opt_peer_max_concurrent_stream:[0,1],libtool:2,nghttp2_err_invalid_argu:[0,1],proto_str:[0,1],alpn:[0,1,2],debian:2,reduc:[0,1],receiv:[0,1],sphinx:2,longer:2,algorithm:[0,1],directori:2,reliabl:[0,1],mask:[0,1],indirectli:0,nghttp2_submit_request:[0,1],namelen:[0,1],portion:[0,1,3],ignor:[0,1],time:[0,1,2],push:[0,1],deflat:[0,1,2],avoid:[0,1]},objtypes:{"0":"c:macro","1":"c:member","2":"c:type","3":"c:function"},titles:["API Reference","nghttp2.h","nghttp2 - HTTP/2.0 C Library","nghttp2ver.h","nghttp2 - HTTP/2.0 C Library"],objnames:{"0":["c","macro","C macro"],"1":["c","member","C member"],"2":["c","type","C type"],"3":["c","function","C function"]},filenames:["apiref","nghttp2.h","package_README","nghttp2ver.h","index"]}) \ No newline at end of file