commit c6d958c92ea75ee285b3caa126893665fcf42faa Author: Tatsuhiro Tsujikawa Date: Sun Jul 28 21:26:41 2013 +0900 First pages commit diff --git a/_sources/apiref.txt b/_sources/apiref.txt new file mode 100644 index 00000000..81fd24aa --- /dev/null +++ b/_sources/apiref.txt @@ -0,0 +1,1553 @@ +API Reference +============= + +Includes +-------- + +To use the public APIs, include ``nghttp2/nghttp2.h``:: + + #include + +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_PROTO_VERSION_ID + + + The protocol version identification of this library supports. + +.. macro:: NGHTTP2_PROTO_VERSION_ID_LEN + + + The length of NGHTTP2_PROTO_VERSION_ID. + +.. macro:: NGHTTP2_PRI_DEFAULT + + + The default priority value + +.. macro:: NGHTTP2_PRI_LOWEST + + + The lowest priority value + +.. 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_CLIENT_CONNECTION_HEADER + + + The client connection header. + +.. macro:: NGHTTP2_CLIENT_CONNECTION_HEADER_LEN + + + The length of 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_TOO_LARGE + + (``-522``) + The length of the frame is too large. + .. macro:: NGHTTP2_ERR_HEADER_COMP + + (``-523``) + Header block inflate/deflate error. + .. 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 + + (``0x1``) + The END_PUSH_PROMISE flag. + .. macro:: NGHTTP2_FLAG_PONG + + (``0x1``) + The PONG flag. + .. macro:: NGHTTP2_FLAG_END_FLOW_CONTROL + + (``0x1``) + The END_FLOW_CONTROL flag. + + +.. type:: nghttp2_settings_id + + The SETTINGS ID. + + .. 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_STREAM_CLOSED + + (``5``) + STREAM_CLOSED + .. macro:: NGHTTP2_FRAME_TOO_LARGE + + (``6``) + FRAME_TOO_LARGE + .. macro:: NGHTTP2_REFUSED_STREAM + + (``7``) + REFUSED_STREAM + .. macro:: NGHTTP2_CANCEL + + (``8``) + CANCEL + .. macro:: NGHTTP2_COMPRESSION_ERROR + + (``9``) + COMPRESSION_ERROR + + +.. 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_WINDOW_UPDATE + + (``1``) + This option prevents the library from sending WINDOW_UPDATE + automatically. If this option is set, the application is + responsible for sending WINDOW_UPDATE using + `nghttp2_submit_window_update`. + + + +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_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_mem_chunk + + + The structure to hold chunk of memory. + + TODO Drop this if it is not used anymore. + + .. member:: uint8_t *data + + The pointer to the data. + .. member:: size_t length + + The length of the data. + + +.. 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`. + +.. 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`. + +.. type:: typedef void (*nghttp2_on_frame_recv_callback) (nghttp2_session *session, nghttp2_frame *frame, void *user_data) + + + Callback function invoked by `nghttp2_session_recv()` when a + non-DATA frame is received. + +.. type:: typedef void (*nghttp2_on_invalid_frame_recv_callback) (nghttp2_session *session, 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. + +.. type:: typedef void (*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. + +.. type:: typedef void (*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`. + +.. type:: typedef void (*nghttp2_before_frame_send_callback) (nghttp2_session *session, 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. + +.. type:: typedef void (*nghttp2_on_frame_send_callback) (nghttp2_session *session, nghttp2_frame *frame, void *user_data) + + + Callback function invoked after the non-DATA frame *frame* is sent. + +.. type:: typedef void (*nghttp2_on_frame_not_send_callback) (nghttp2_session *session, 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`. + +.. type:: typedef void (*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. + +.. type:: typedef void (*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. + +.. type:: typedef void (*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. + +.. type:: typedef void (*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. + +.. type:: typedef void (*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. + +.. 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_WINDOW_UPDATE` + The *optval* must be a pointer to ``int``. If the *\*optval* is + nonzero, the library will not send WINDOW_UPDATE automatically. + Therefore, the application is responsible for sending + WINDOW_UPDATE using `nghttp2_submit_window_update`. This option + defaults to 0. + + 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 an error occurs. + + This function returns the number of processed bytes, or one of the + following negative error codes: + + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. 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:: 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:: 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. Use `nghttp2_session_get_pri_lowest()` to know the lowest + priority value for this *session*. + + 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``. + + The *nv* must include following name/value pairs: + + ``:method`` + HTTP method (e.g., ``GET``, ``POST``, ``HEAD``, etc) + ``:scheme`` + URI scheme (e.g., ``https``) + ``:path`` + Absolute path and parameters of this request (e.g., ``/foo``, + ``/foo;bar;haz?h=j&y=123``) + ``:host`` + The hostport portion of the URI for this request (e.g., + ``example.org:443``). This is the same as the HTTP "Host" header + field. + + 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. 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_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``. + + The *nv* must include following name/value pairs: + + ``:status`` + HTTP status code (e.g., ``200`` or ``200 OK``) + + 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_PRIORITY` + + If *flags* includes :macro:`NGHTTP2_FLAG_END_STREAM`, this frame has + END_STREAM flag set. + + If the *stream_id* is -1, this frame is assumed as request (i.e., + first 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 and the Associated-To-Stream-ID 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 *assoc_stream_id* 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. + +.. function:: int nghttp2_submit_priority(nghttp2_session *session, int32_t stream_id, int32_t pri) + + + Submits PRIORITY frame to change the priority of stream *stream_id* + to the priority value *pri*. + + 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. + +.. function:: int nghttp2_submit_rst_stream(nghttp2_session *session, 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*. + + 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, 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 bitwise-OR of one or more values from + :type:`nghttp2_settings_flag`. + + This function does not take ownership of the *iv*. This function + copies all the elements in the *iv*. + + This function returns 0 if it succeeds, 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_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. + + 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_ctrl_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_NOMEM` + Out of memory. + +.. function:: int nghttp2_submit_ping(nghttp2_session *session, 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. + + 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, 8 zero 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, nghttp2_error_code error_code, uint8_t *opaque_data, size_t opaque_data_len) + + + Submits GOAWAY frame with the error code *error_code*. + + 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 effective range of the + *window_size_increment* is [1, (1 << 31)-1], inclusive. But the + application must be responsible to keep the resulting window size + <= (1 << 31)-1. If NGHTTP2_FLAG_END_FLOW_CONTROL bit set in the + *flags*, 0 can be specified in the *window_size_increment*. In + fact, if this flag is set, the value specified in the + *window_size_increment* is ignored. + + This function returns 0 if it succeeds, or one of the following + negative error codes: + + :macro:`NGHTTP2_ERR_INVALID_ARGUMENT` + The *delta_window_size* is 0 or negative if + NGHTTP2_FLAG_END_FLOW_CONTROL bit is not set in *flags*. + :macro:`NGHTTP2_ERR_STREAM_CLOSED` + The stream is already closed or does not exist. + :macro:`NGHTTP2_ERR_NOMEM` + Out of memory. + +.. 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; + } + .... + } + + diff --git a/_sources/index.txt b/_sources/index.txt new file mode 100644 index 00000000..c29c6607 --- /dev/null +++ b/_sources/index.txt @@ -0,0 +1,23 @@ +.. 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 + +Resources +--------- + +* http://tools.ietf.org/html/draft-ietf-httpbis-http2-04 diff --git a/_sources/package_README.txt b/_sources/package_README.txt new file mode 100644 index 00000000..72a33558 --- /dev/null +++ b/_sources/package_README.txt @@ -0,0 +1 @@ +.. include:: ../README.rst diff --git a/_static/ajax-loader.gif b/_static/ajax-loader.gif new file mode 100644 index 00000000..61faf8ca Binary files /dev/null and b/_static/ajax-loader.gif differ diff --git a/_static/basic.css b/_static/basic.css new file mode 100644 index 00000000..43e8bafa --- /dev/null +++ b/_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/_static/comment-bright.png b/_static/comment-bright.png new file mode 100644 index 00000000..551517b8 Binary files /dev/null and b/_static/comment-bright.png differ diff --git a/_static/comment-close.png b/_static/comment-close.png new file mode 100644 index 00000000..09b54be4 Binary files /dev/null and b/_static/comment-close.png differ diff --git a/_static/comment.png b/_static/comment.png new file mode 100644 index 00000000..92feb52b Binary files /dev/null and b/_static/comment.png differ diff --git a/_static/default.css b/_static/default.css new file mode 100644 index 00000000..e85f33ce --- /dev/null +++ b/_static/default.css @@ -0,0 +1,256 @@ +/* + * default.css_t + * ~~~~~~~~~~~~~ + * + * Sphinx stylesheet -- default theme. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +@import url("basic.css"); + +/* -- page layout ----------------------------------------------------------- */ + +body { + font-family: roboto, sans-serif; + font-size: 100%; + background-color: none; + color: #000; + margin: 0; + padding: 0; +} + +div.document { + background-color: none; +} + +div.documentwrapper { + float: left; + width: 100%; +} + +div.bodywrapper { + margin: 0 0 0 230px; +} + +div.body { + background-color: #ffffff; + color: #000000; + padding: 0 20px 30px 20px; +} + +div.footer { + color: #444; + width: 100%; + padding: 9px 0 9px 0; + text-align: center; + font-size: 75%; +} + +div.footer a { + color: #444; + text-decoration: underline; +} + +div.related { + background-color: #fff; + line-height: 30px; + color: #444; +} + +div.related a { + color: #444; +} + +div.sphinxsidebar { +} + +div.sphinxsidebar h3 { + font-family: roboto, "Trebuchet MS", sans-serif; + color: #444; + font-size: 1.4em; + font-weight: normal; + margin: 0; + padding: 0; +} + +div.sphinxsidebar h3 a { + color: #444; +} + +div.sphinxsidebar h4 { + font-family: roboto, "Trebuchet MS", sans-serif; + color: #444; + font-size: 1.3em; + font-weight: normal; + margin: 5px 0 0 0; + padding: 0; +} + +div.sphinxsidebar p { + color: #444; +} + +div.sphinxsidebar p.topless { + margin: 5px 10px 10px 10px; +} + +div.sphinxsidebar ul { + margin: 10px; + padding: 0; + color: #444; +} + +div.sphinxsidebar a { + color: #444; +} + +div.sphinxsidebar input { + border: 1px solid #444; + font-family: sans-serif; + font-size: 1em; +} + + + +/* -- hyperlink styles ------------------------------------------------------ */ + +a { + color: #355f7c; + text-decoration: none; +} + +a:visited { + color: #355f7c; + text-decoration: none; +} + +a:hover { + text-decoration: underline; +} + + + +/* -- body styles ----------------------------------------------------------- */ + +div.body h1, +div.body h2, +div.body h3, +div.body h4, +div.body h5, +div.body h6 { + font-family: roboto, "Trebuchet MS", sans-serif; + background-color: none; + font-weight: normal; + color: #20435c; + border-bottom: 1px solid #ccc; + margin: 20px -20px 10px -20px; + padding: 3px 0 3px 10px; +} + +div.body h1 { margin-top: 0; font-size: 200%; } +div.body h2 { font-size: 160%; } +div.body h3 { font-size: 140%; } +div.body h4 { font-size: 120%; } +div.body h5 { font-size: 110%; } +div.body h6 { font-size: 100%; } + +a.headerlink { + color: #c60f0f; + font-size: 0.8em; + padding: 0 4px 0 4px; + text-decoration: none; +} + +a.headerlink:hover { + background-color: #c60f0f; + color: white; +} + +div.body p, div.body dd, div.body li { + text-align: justify; + line-height: 130%; +} + +div.admonition p.admonition-title + p { + display: inline; +} + +div.admonition p { + margin-bottom: 5px; +} + +div.admonition pre { + margin-bottom: 5px; +} + +div.admonition ul, div.admonition ol { + margin-bottom: 5px; +} + +div.note { + background-color: #eee; + border: 1px solid #ccc; +} + +div.seealso { + background-color: #ffc; + border: 1px solid #ff6; +} + +div.topic { + background-color: #eee; +} + +div.warning { + background-color: #ffe4e4; + border: 1px solid #f66; +} + +p.admonition-title { + display: inline; +} + +p.admonition-title:after { + content: ":"; +} + +pre { + padding: 5px; + background-color: #eeffcc; + color: #333333; + line-height: 120%; + border: 1px solid #ac9; + border-left: none; + border-right: none; +} + +tt { + background-color: #ecf0f3; + padding: 0 1px 0 1px; + font-size: 0.95em; +} + +th { + background-color: #ede; +} + +.warning tt { + background: #efc2c2; +} + +.note tt { + background: #d6d6d6; +} + +.viewcode-back { + font-family: roboto, sans-serif; +} + +div.viewcode-block:target { + background-color: #f4debf; + border-top: 1px solid #ac9; + border-bottom: 1px solid #ac9; +} \ No newline at end of file diff --git a/_static/default2.css b/_static/default2.css new file mode 100644 index 00000000..e5ebaf98 --- /dev/null +++ b/_static/default2.css @@ -0,0 +1,15 @@ +@import url(http://fonts.googleapis.com/css?family=Roboto:400,400italic,500,500italic); + +pre, tt { + font-family: monospace, sans-serif; +} + +tt { + font-size: 100%; +} + +div.body h1, div.body h2, div.body h3, div.body h4, div.body h5, div.body h6 { + border: 0; + margin: 0; + padding: 0.3em 0; +} diff --git a/_static/doctools.js b/_static/doctools.js new file mode 100644 index 00000000..d4619fdf --- /dev/null +++ b/_static/doctools.js @@ -0,0 +1,247 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +} + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s == 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * small function to check if an array contains + * a given item. + */ +jQuery.contains = function(arr, item) { + for (var i = 0; i < arr.length; i++) { + if (arr[i] == item) + return true; + } + return false; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node) { + if (node.nodeType == 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 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/_static/down-pressed.png b/_static/down-pressed.png new file mode 100644 index 00000000..6f7ad782 Binary files /dev/null and b/_static/down-pressed.png differ diff --git a/_static/down.png b/_static/down.png new file mode 100644 index 00000000..3003a887 Binary files /dev/null and b/_static/down.png differ diff --git a/_static/file.png b/_static/file.png new file mode 100644 index 00000000..d18082e3 Binary files /dev/null and b/_static/file.png differ diff --git a/_static/jquery.js b/_static/jquery.js new file mode 100644 index 00000000..c3e1fdd9 --- /dev/null +++ b/_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: Sat May 11 13:37:56 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>
+
+
+
+
+

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_PROTO_VERSION_ID
+

The protocol version identification of this library supports.

+
+ +
+
+NGHTTP2_PROTO_VERSION_ID_LEN
+

The length of NGHTTP2_PROTO_VERSION_ID.

+
+ +
+
+NGHTTP2_PRI_DEFAULT
+

The default priority value

+
+ +
+
+NGHTTP2_PRI_LOWEST
+

The lowest priority value

+
+ +
+
+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_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_TOO_LARGE
+

(-522) +The length of the frame is too large.

+
+ +
+
+NGHTTP2_ERR_HEADER_COMP
+

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

+
+ +
+
+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
+

(0x1) +The END_PUSH_PROMISE flag.

+
+ +
+
+NGHTTP2_FLAG_PONG
+

(0x1) +The PONG flag.

+
+ +
+
+NGHTTP2_FLAG_END_FLOW_CONTROL
+

(0x1) +The END_FLOW_CONTROL flag.

+
+ +
+ +
+
+nghttp2_settings_id
+

The SETTINGS ID.

+
+
+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_STREAM_CLOSED
+

(5) +STREAM_CLOSED

+
+ +
+
+NGHTTP2_FRAME_TOO_LARGE
+

(6) +FRAME_TOO_LARGE

+
+ +
+
+NGHTTP2_REFUSED_STREAM
+

(7) +REFUSED_STREAM

+
+ +
+
+NGHTTP2_CANCEL
+

(8) +CANCEL

+
+ +
+
+NGHTTP2_COMPRESSION_ERROR
+

(9) +COMPRESSION_ERROR

+
+ +
+ +
+
+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_WINDOW_UPDATE
+

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

+
+ +
+ +
+
+

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_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_mem_chunk
+

The structure to hold chunk of memory.

+

TODO Drop this if it is not used anymore.

+
+
+uint8_t *data
+

The pointer to the data.

+
+ +
+
+size_t length
+

The length of the data.

+
+ +
+ +
+
+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.

+
+ +
+
+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.

+
+ +
+
+typedef void (*nghttp2_on_frame_recv_callback)(nghttp2_session *session, nghttp2_frame *frame, void *user_data)
+

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

+
+ +
+
+typedef void (*nghttp2_on_invalid_frame_recv_callback)(nghttp2_session *session, 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.

+
+ +
+
+typedef void (*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.

+
+ +
+
+typedef void (*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.

+
+ +
+
+typedef void (*nghttp2_before_frame_send_callback)(nghttp2_session *session, 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.

+
+ +
+
+typedef void (*nghttp2_on_frame_send_callback)(nghttp2_session *session, nghttp2_frame *frame, void *user_data)
+

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

+
+ +
+
+typedef void (*nghttp2_on_frame_not_send_callback)(nghttp2_session *session, 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.

+
+ +
+
+typedef void (*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.

+
+ +
+
+typedef void (*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.

+
+ +
+
+typedef void (*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.

+
+ +
+
+typedef void (*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.

+
+ +
+
+typedef void (*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.

+
+ +
+
+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_WINDOW_UPDATE
+
The optval must be a pointer to int. If the *optval is +nonzero, the library will not send WINDOW_UPDATE automatically. +Therefore, the application is responsible for sending +WINDOW_UPDATE using nghttp2_submit_window_update(). This option +defaults to 0.
+
+

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 an error occurs.

+

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

+
+
NGHTTP2_ERR_NOMEM
+
Out of memory.
+
+
+ +
+
+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.

+
+ +
+
+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.
+
+
+ +
+
+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. Use nghttp2_session_get_pri_lowest() to know the lowest +priority value for this session.

+

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.

+

The nv must include following name/value pairs:

+
+
:method
+
HTTP method (e.g., GET, POST, HEAD, etc)
+
:scheme
+
URI scheme (e.g., https)
+
:path
+
Absolute path and parameters of this request (e.g., /foo, +/foo;bar;haz?h=j&y=123)
+
:host
+
The hostport portion of the URI for this request (e.g., +example.org:443). This is the same as the HTTP “Host” header +field.
+
+

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. 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_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.

+

The nv must include following name/value pairs:

+
+
:status
+
HTTP status code (e.g., 200 or 200 OK)
+
+

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.

+

If the stream_id is -1, this frame is assumed as request (i.e., +first 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 and the Associated-To-Stream-ID 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 assoc_stream_id 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.
+
+
+ +
+
+int nghttp2_submit_priority(nghttp2_session *session, int32_t stream_id, int32_t pri)
+

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

+

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.
+
+
+ +
+
+int nghttp2_submit_rst_stream(nghttp2_session *session, 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.

+

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, 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 bitwise-OR of one or more values from +nghttp2_settings_flag.

+

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

+

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

+
+
NGHTTP2_ERR_INVALID_ARGUMENT
+
The iv contains duplicate settings ID or invalid value.
+
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.

+

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_ctrl_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_NOMEM
+
Out of memory.
+
+
+ +
+
+int nghttp2_submit_ping(nghttp2_session *session, 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.

+

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, 8 zero 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, nghttp2_error_code error_code, uint8_t *opaque_data, size_t opaque_data_len)
+

Submits GOAWAY frame with the error code error_code.

+

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 effective range of the +window_size_increment is [1, (1 << 31)-1], inclusive. But the +application must be responsible to keep the resulting window size +<= (1 << 31)-1. If NGHTTP2_FLAG_END_FLOW_CONTROL bit set in the +flags, 0 can be specified in the window_size_increment. In +fact, if this flag is set, the value specified in the +window_size_increment is ignored.

+

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

+
+
NGHTTP2_ERR_INVALID_ARGUMENT
+
The delta_window_size is 0 or negative if +NGHTTP2_FLAG_END_FLOW_CONTROL bit is not set in flags.
+
NGHTTP2_ERR_STREAM_CLOSED
+
The stream is already closed or does not exist.
+
NGHTTP2_ERR_NOMEM
+
Out of memory.
+
+
+ +
+
+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;
+    }
+    ....
+}
+
+
+
+ +
+
+ + +
+
+
+
+

Menu

+ +

Table Of Contents

+ + +

Previous 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/genindex.html b/genindex.html new file mode 100644 index 00000000..dddbb1a2 --- /dev/null +++ b/genindex.html @@ -0,0 +1,906 @@ + + + + + + + + + + + + Index — nghttp2 0.1.0-DEV 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_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_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_FRAME_TOO_LARGE (C macro) +
+ + +
NGHTTP2_ERR_GOAWAY_ALREADY_SENT (C macro) +
+ + +
NGHTTP2_ERR_GZIP (C macro) +
+ + +
NGHTTP2_ERR_HEADER_COMP (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_PROTO (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_UNSUPPORTED_VERSION (C macro) +
+ + +
NGHTTP2_ERR_WOULDBLOCK (C macro) +
+ + +
nghttp2_error (C type) +
+ + +
nghttp2_error_code (C type) +
+ + +
nghttp2_flag (C type) +
+ + +
NGHTTP2_FLAG_END_FLOW_CONTROL (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_PONG (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_TOO_LARGE (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_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_mem_chunk (C type) +
+ + +
nghttp2_mem_chunk.data (C member) +
+ + +
nghttp2_mem_chunk.length (C member) +
+ + +
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_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_WINDOW_UPDATE (C macro) +
+ + +
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_del (C function) +
+ + +
nghttp2_session_fail_session (C function) +
+ + +
nghttp2_session_get_outbound_queue_size (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_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_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_id (C type) +
+ + +
NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE (C macro) +
+ + +
NGHTTP2_SETTINGS_MAX (C macro) +
+ + +
NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS (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_response (C function) +
+ + +
nghttp2_submit_rst_stream (C function) +
+ + +
nghttp2_submit_settings (C function) +
+ + +
nghttp2_submit_window_update (C function) +
+ + +
NGHTTP2_VERSION (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/index.html b/index.html new file mode 100644 index 00000000..494fe7e7 --- /dev/null +++ b/index.html @@ -0,0 +1,145 @@ + + + + + + + + + + nghttp2 - HTTP/2.0 C Library — nghttp2 0.1.0-DEV documentation + + + + + + + + + + + + + +
+

Navigation

+ +
+ +
+
+
+
+ +
+

nghttp2 - HTTP/2.0 C Library

+

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

+

Contents:

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

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/objects.inv b/objects.inv new file mode 100644 index 00000000..95fd3c78 Binary files /dev/null and b/objects.inv differ diff --git a/package_README.html b/package_README.html new file mode 100644 index 00000000..b3ebac50 --- /dev/null +++ b/package_README.html @@ -0,0 +1,441 @@ + + + + + + + + + + nghttp2 - HTTP/2.0 C Library — nghttp2 0.1.0-DEV 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-defat-04/2.0 +(http://tools.ietf.org/html/draft-ietf-httpbis-http2-04) based on +spdylay code base.

+

The following features are not implemented:

+
    +
  • Header continuation
    • +
  • ALPN: instead, NPN is used
    • +
  • HTTP Upgrade dance
    • +
+
+
+

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 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 +resouce) in nghttp, the following +packages are needed:

+
    +
  • libxml2 >= 2.7.7
    • +
+

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
    • +
+

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.

+
+
+

Client, Server and Proxy programs

+

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

+
+

nghttp - client

+

nghttp is HTTP-default04/2.0 client. It can connect to the +HTTP/2.0 server with prior knowledge (without HTTP Upgrade) and NPN in +TLS extension.

+

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

+

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

+
$ src/nghttp -nv https://localhost:3000/
+[  0.000] NPN select next protocol: the remote server offers:
+          * HTTP-draft-04/2.0
+          * spdy/3
+          * spdy/2
+          * http/1.1
+          NPN selected the protocol: HTTP-draft-04/2.0
+[  0.005] send SETTINGS frame <length=0, flags=0, stream_id=0>
+          (niv=0)
+[  0.005] send HEADERS frame <length=58, flags=5, stream_id=1>
+          ; END_STREAM | END_HEADERS
+          ; Open new stream
+          :host: localhost:3000
+          :method: GET
+          :path: /
+          :scheme: https
+          accept: */*
+          accept-encoding: gzip, deflate
+          user-agent: nghttp2/0.1.0-DEV
+[  0.005] recv SETTINGS frame <length=16, flags=0, stream_id=0>
+          (niv=2)
+          [4:100]
+          [7:65536]
+[  0.005] recv WINDOW_UPDATE frame <length=4, flags=1, stream_id=0>
+          ; END_FLOW_CONTROL
+          (window_size_increment=0)
+[  0.006] recv HEADERS frame <length=179, flags=4, stream_id=1>
+          ; END_HEADERS
+          ; First response header
+          :status: 200 OK
+          accept-ranges: bytes
+          content-encoding: gzip
+          content-length: 56
+          content-type: text/html
+          date: Sat, 27 Jul 2013 12:08:56 GMT
+          etag: "cf405c-2d-45adabdf282c0"
+          last-modified: Tue, 04 Nov 2008 10:44:03 GMT
+          server: Apache/2.2.22 (Debian)
+          vary: Accept-Encoding
+          via: 1.1 nghttpx
+[  0.006] recv DATA frame (length=56, flags=0, stream_id=1)
+[  0.006] recv DATA frame (length=0, flags=1, stream_id=1)
+[  0.006] send GOAWAY frame <length=8, flags=0, stream_id=0>
+          (last_stream_id=0, error_code=NO_ERROR(0), opaque_data=)
+
+
+
+

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.

+

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

+
$ src/nghttpd 3000 --no-tls -v
+IPv4: listen on port 3000
+IPv6: listen on port 3000
+[id=1] [  1.020] send SETTINGS frame <length=8, flags=0, stream_id=0>
+          (niv=1)
+          [4:100]
+[id=1] [  1.020] closed
+[id=2] [  1.838] send SETTINGS frame <length=8, flags=0, stream_id=0>
+          (niv=1)
+          [4:100]
+[id=2] [  1.838] recv SETTINGS frame <length=0, flags=0, stream_id=0>
+          (niv=0)
+[id=2] [  1.838] recv HEADERS frame <length=58, flags=5, stream_id=1>
+          ; END_STREAM | END_HEADERS
+          ; Open new stream
+          :host: localhost:3000
+          :method: GET
+          :path: /
+          :scheme: http
+          accept: */*
+          accept-encoding: gzip, deflate
+          user-agent: nghttp2/0.1.0-DEV
+[id=2] [  1.838] send HEADERS frame <length=105, flags=4, stream_id=1>
+          ; END_HEADERS
+          ; First response header
+          :status: 404 Not Found
+          content-encoding: gzip
+          content-type: text/html; charset=UTF-8
+          date: Sat, 27 Jul 2013 12:32:10 GMT
+          server: nghttpd nghttp2/0.1.0-DEV
+[id=2] [  1.838] send DATA frame (length=127, flags=0, stream_id=1)
+[id=2] [  1.838] send DATA frame (length=0, flags=1, stream_id=1)
+[id=2] [  1.838] stream_id=1 closed
+[id=2] [  1.839] closed
+
+
+
+

nghttpx - proxy

+

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

+ ++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Mode optionFrontendBackendNote
defaultHTTP/2.0, SPDY, HTTPSHTTP/1.1Reverse proxy
--spdyHTTP/2.0, SPDY, HTTPSHTTP/1.1SPDY proxy
--spdy-bridgeHTTP/2.0, SPDY, HTTPSHTTP/2.0SPDY proxy
--clientHTTP/1.1HTTP/2.01.1 <-> 2.0 conversion
--client-proxyHTTP/1.1HTTP/2.0Forward proxy
+

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

+

By default, it uses SSL/TLS connection for HTTP/2.0 and SPDY. Use +--frontend-spdy--no-tls to disable it in frontend +connection. Likewise, use --backend-spdy-no-tls option to disable +it in backend connection.

+

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

+

The nghttpx is ported from shrpx in spdylay project, and it +still has SPDY color in option names. They will be fixed as the +development goes.

+

Without any of -s, --spdy-bridge, -p and --client +options, nghttpx works as reverse proxy to the backend server:

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

With -s option, it works as so called secure SPDY proxy:

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

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

+

At the time of this writing, Chrome is the only browser which supports +secure SPDY proxy. The one way to configure Chrome to use secure SPDY +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 SPDY proxy.

+

Then run chrome with the following arguments:

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

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

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

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

+
Client <-- (HTTP) --> 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.

+

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) --> nghttpx <-- (HTTP/2.0) --> Web Server
+                 [reverse proxy]
+
+
+

For the operation modes which talk to the backend in HTTP/2.0, 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 --spdy-bridge and +--backend-http-proxy-uri option to talk to the outside HTTP/2.0 proxy +through HTTP proxy:

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

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/search.html b/search.html new file mode 100644 index 00000000..1bec921e --- /dev/null +++ b/search.html @@ -0,0 +1,104 @@ + + + + + + + + + + Search — nghttp2 0.1.0-DEV 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/searchindex.js b/searchindex.js new file mode 100644 index 00000000..0936dd5d --- /dev/null +++ b/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({objects:{"":{NGHTTP2_ERR_INVALID_STATE:[0,0,1,""],NGHTTP2_ERR_FRAME_TOO_LARGE:[0,0,1,""],NGHTTP2_ERR_HEADER_COMP:[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_FLAG_PONG:[0,0,1,""],NGHTTP2_CLIENT_CONNECTION_HEADER_LEN:[0,0,1,""],nghttp2_goaway:[0,2,1,""],NGHTTP2_OPT_NO_AUTO_WINDOW_UPDATE:[0,0,1,""],nghttp2_submit_rst_stream:[0,3,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_PROTO:[0,0,1,""],NGHTTP2_FRAME_TOO_LARGE:[0,0,1,""],nghttp2_submit_window_update:[0,3,1,""],NGHTTP2_ERR_UNSUPPORTED_VERSION:[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_STREAM_CLOSED:[0,0,1,""],NGHTTP2_SETTINGS_MAX:[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_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_NO_ERROR:[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_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_submit_push_promise:[0,3,1,""],NGHTTP2_ERR_GOAWAY_ALREADY_SENT:[0,0,1,""],nghttp2_session_mem_recv:[0,3,1,""],nghttp2_flag:[0,2,1,""],NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS:[0,0,1,""],NGHTTP2_HCAT_REQUEST:[0,0,1,""],nghttp2_ping:[0,2,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_SETTINGS:[0,0,1,""],nghttp2_frame:[0,2,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_session_client_new:[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_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_FLAG_END_FLOW_CONTROL:[0,0,1,""],nghttp2_on_unknown_frame_recv_callback:[0,2,1,""],NGHTTP2_ERR_STREAM_CLOSED:[0,0,1,""],nghttp2_opt:[0,2,1,""],NGHTTP2_ERR_CALLBACK_FAILURE:[0,0,1,""],nghttp2_on_invalid_frame_recv_callback:[0,2,1,""],NGHTTP2_FLOW_CONTROL_ERROR:[0,0,1,""],nghttp2_session_set_option:[0,3,1,""],NGHTTP2_ERR_STREAM_CLOSING:[0,0,1,""],nghttp2_session_fail_session:[0,3,1,""],NGHTTP2_PROTO_VERSION_ID:[0,0,1,""],nghttp2_settings_id:[0,2,1,""],NGHTTP2_HEADERS:[0,0,1,""],nghttp2_session_send:[0,3,1,""],NGHTTP2_PROTOCOL_ERROR:[0,0,1,""],nghttp2_gzip_inflate:[0,3,1,""],nghttp2_session_del:[0,3,1,""],nghttp2_settings:[0,2,1,""],nghttp2_on_frame_not_send_callback:[0,2,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_FLAG_END_HEADERS:[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_mem_chunk:[0,2,1,""],nghttp2_priority:[0,2,1,""],nghttp2_session_want_read:[0,3,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_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_headers:[0,2,1,""],nghttp2_before_frame_send_callback:[0,2,1,""],NGHTTP2_PING:[0,0,1,""],NGHTTP2_GOAWAY:[0,0,1,""],NGHTTP2_ERR_GZIP:[0,0,1,""],nghttp2_submit_ping:[0,3,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_gzip_inflate_new:[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_mem_chunk:{length:[0,1,1,""],data:[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,""],type:[0,1,1,""],flags:[0,1,1,""]},nghttp2_ping:{hd:[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:{all:0,code:[0,1],on_unknown_frame_recv_callback:0,illustr:1,nghttp2_err_start_stream_not_allow:0,my_obj:0,nghttp2_frame_hd:0,nghttp2_cancel:0,prefix:0,overlap:0,follow:[0,1],ptr:0,categori:0,"const":0,uint8_t:0,unpack:0,send:[0,1],program:[2,1],under:[0,1],sens:0,fatal:0,spec:0,sent:0,sourc:0,string:0,nul:0,"void":0,nghttp2_flag_end_push_promis:0,nghttp2_submit_p:0,failur:0,retriev:0,tri:0,nghttp2_on_frame_recv_callback:0,foo:0,level:0,did:0,list:0,nghttp2_headers_categori:0,settings_id:0,concurr:0,optlen:0,refer:[0,2],prepar:0,pleas:1,prevent:0,on_stream_close_callback:0,"0x1":0,"0x4":0,zero:0,pass:0,download:1,further:0,port:1,settings_flow_control_opt:0,neg:0,invok:0,current:0,version:[0,1,2],"new":[0,1],net:1,on_invalid_ctrl_recv_callback:0,"public":0,nghttp2_session_resume_data:0,on_ctrl_recv_callback:0,gener:[0,1],onli:[0,1],here:[0,1],closur:0,met:0,nghttp2_rst_stream:0,ubuntu:1,nghttp2_opt_no_auto_window_upd:0,depend:0,becom:0,modifi:1,sinc:0,valu:0,nextprotoneg:0,remark:[0,2],convers:1,anymor:0,step:0,autoreconf:1,queue:0,prior:1,behav:0,nghttp2_submit_prior:0,aka:0,nghttp2_err_gzip:0,nghttp2_frame:0,nghttp2_err_goaway_already_s:0,appli:0,transit:0,prefer:0,put:0,api:[0,2],org:[0,1,2],instal:1,should:0,"byte":[0,1],select:[0,1],from:[0,1,2],describ:0,would:0,memori:0,upgrad:1,next:[0,1],call:[0,1],asset:1,nghttp2_nv:0,nghttp2_on_invalid_frame_recv_callback:0,nghttp2_version:0,type:[0,1,2],until:0,reorder:0,more:0,goawai:[0,1],nghttp2_set:0,nghttp2_pri_default:0,rst_stream:0,inflater_ptr:0,user_data:0,flag:[0,1],accept:1,nghttp2_submit_window_upd:0,known:0,hold:0,nghttp2_err_wouldblock:0,must:0,endpoint:0,word:0,tunnel:1,nghttp2_settings_id:0,work:1,stream_user_data:0,dev:1,nghttp2_session_fail_sess:0,remain:0,can:[0,1],http2:[2,1],could:0,control:0,defer:0,stream:[0,1],give:0,process:0,indic:0,abort:0,want:0,incom:0,nghttp2_header:0,pong:0,nghttp2_err_invalid_stream_st:0,unsign:0,occur:0,nghttp2_settings_flow_control_opt:0,alwai:0,multipl:0,secur:1,anoth:0,charset:1,ping:0,nghttp2_flag_non:0,write:1,nghttp2_err_fat:0,pair:0,sever:[0,1],serveraddr:1,reject:0,sec9:0,instead:[0,1],simpl:0,updat:0,nghttp2_on_request_recv_callback:0,npn:[0,1],resourc:[0,2],default04:1,after:0,spdylai:1,nghttp2_session_get_pri_lowest:0,befor:0,mai:0,nghttp2_compression_error:0,alloc:0,autotool:1,nghttp2_err_frame_too_larg:0,opaqu:0,nvlen:0,element:0,issu:0,nghttp2_flag_prior:0,ssize_t:0,nghttp2_session_want_read:0,order:0,talk:1,includ:[0,2],frontend:1,nghttp2_err_stream_shut_wr:0,hypertext:[2,1],move:0,becaus:0,libcunit1:1,through:1,untouch:0,size_t:0,nghttp2_err_unsupported_vers:0,still:[0,1],mainli:0,paramet:0,typedef:[0,2],fix:1,precondit:0,max_outlen:0,nghttp2_hcat_push_respons:0,window:0,pend:0,nghttp2_err_eof:0,hidden:0,therefor:0,nghttp2_session_send:0,inlen:0,valuelen:0,recept:0,them:0,"return":[0,1],thei:[0,1],nghttp2_push_promis:0,nghttp2_goawai:0,initi:0,"break":0,nghttp2_initial_max_concurrent_stream:0,nghttp2_submit_head:0,promis:0,nov:1,choic:0,document:[2,1],name:[0,1],nghttp2_err_callback_failur:0,nghttp2_send_callback:0,nghttp2_frame_typ:0,no_error:1,drop:0,achiev:0,nghttp2_flow_control_error:0,mode:1,each:0,debug:0,fulli:0,side:0,trailer:0,mean:0,protocol_error:0,chunk:0,continu:1,nghttp2_err_temporal_callback_failur:0,"static":[0,1],connect:[0,1],http:[0,1,2],beyond:0,todo:0,out:0,goe:1,req:0,payload:0,end_flow_control:[0,1],etag:1,suitabl:0,on_ctrl_not_send_callback:0,nghttp2_client_connection_header_len:0,got:0,on_frame_not_send_callback:0,recv_callback:0,end_stream:[0,1],proxi:[2,1],state:0,nghttp2_internal_error:0,free:0,reason:0,base:1,inflat:0,usual:0,releas:0,nghttp2_session_mem_recv:0,nghttp2_flag:0,recv:1,spdy:[0,1],thread:1,syn_repli:0,omit:0,openssl:1,keep:0,length:[0,1],place:0,outsid:[0,1],assign:0,optval:0,first:[0,1],oper:[0,1],rang:[0,1],directli:0,arrai:0,number:0,yourself:1,nghttp2_protocol_error:0,alreadi:0,least:[0,1],nghttp2_on_frame_send_callback:0,opaque_data:[0,1],on_frame_recv_callback:0,open:[0,1],primari:0,size:0,prioriti:0,given:0,"long":0,script:1,unknown:0,data_prd:0,nghttp2_session_get_stream_user_data:0,messag:0,on_unknown_ctrl_recv_callback:0,necessarili:0,draft:[0,1,2],too:0,similarli:0,nghttp2_frame_too_larg:0,internal_error:0,conveni:0,"final":0,store:0,low:0,ssl_ctx:0,option:[0,1],tool:[2,1],copi:0,nghttp2_proto_version_id_len:0,specifi:[0,1],nghttp2_client_connection_head:0,pars:0,termin:[0,1],kind:0,scheme:[0,1],provid:0,remov:0,see:[0,1],structur:0,charact:0,project:1,defat:1,entri:0,nghttp2_session_del:0,read_callback:0,danc:1,nghttp2_error:0,"function":[0,1,2],window_size_incr:[0,1],respons:[0,1],pri:0,argument:[0,1],packag:1,increment:0,reserv:0,need:[0,1],exclud:0,nghttp2_on_frame_recv_parse_error_callback:0,sat:1,bitwis:0,outbound:0,callback:0,payloadlen:0,note:[0,1],nghttp2_refused_stream:0,exampl:[0,1],take:0,which:[0,1],noth:0,singl:[0,1],opaque_data_len:0,sure:1,unless:0,allow:0,"enum":[0,2],though:1,object:0,reach:0,settings_max_concurrent_stream:0,nghttp2_hcat_request:0,most:0,nghttp2_flag_pong:0,thi:[0,1,2],nghttp2_before_frame_send_callback:0,nghttp2_error_cod:0,nghttp2_err_stream_id_not_avail:0,don:0,http2_select:0,url:1,doc:1,later:0,request:0,uri:[0,1],doe:0,nghttp2_gzip_inflate_new:0,fact:0,on_invalid_frame_recv_callback:0,text:1,hostnam:1,verbos:1,session:0,pkg:1,protocol:[0,1,2],data:[0,1],absolut:0,nghttp2_submit_push_promis:0,nghttp2_submit_rst_stream:0,refused_stream:0,configur:[0,1],apach:1,figur:1,before_ctrl_send_callback:0,nghttp2_err_invalid_stream_id:0,experiment:[2,1],queu:0,local:0,nghttp2_err_proto:0,syn_stream:0,variou:0,get:[0,1],likewis:1,window_upd:[0,1],outlen:0,end_head:[0,1],ssl:[0,1],settings_initial_window_s:0,cannot:0,nghttp2_data:0,optnam:0,increas:0,nghttpd:1,requir:[0,1,2],before_frame_send_callback:0,nghttp2_no_error:0,nghttp2_submit_respons:0,bar:0,enabl:1,ietf:[2,1],possibl:0,push_promis:0,method:[0,1],nghttp2_err_header_comp:0,stuff:0,nghttp2_strerror:0,contain:[0,1],nghttp2_window_upd:0,nghttp2_gzip_inflate_del:0,user:[0,1],certif:1,set:[0,1],frame:[0,1],knowledg:1,nghttp2_submit_goawai:0,temporarili:0,result:0,arg:0,fail:0,close:[0,1],analog:0,statu:[0,1,2],correctli:0,vari:[0,1],someth:0,written:0,bridg:1,nghttp2_flag_end_flow_control:0,assoc_stream_id:0,nghttp2_on_data_chunk_recv_callback:0,nghttp2_initial_connection_window_s:0,accord:0,kei:0,flow:0,extens:1,entir:0,len:0,last_stream_id:[0,1],nghttp2_ping:0,tue:1,addit:0,bodi:0,cf405c:1,last:[0,1],nghttp2_proto_version_id:0,region:0,nghttp2_session_want_writ:0,against:0,tempor:0,etc:[0,1],agent:1,compression_error:0,on_request_recv_callback:0,browser:1,whole:0,nghttp2_data_provid:0,point:0,color:1,int32_t:0,address:1,rfc2616:0,header:[0,1],nghttp2_prioriti:0,non:[0,1],shutdown:0,path:[0,1],cancel:0,nghttp2_on_frame_not_send_callback:0,nghttp2_session:0,assum:0,backend:1,nghttp2_recv_callback:0,union:[0,2],due:0,been:0,nghttp2_on_data_send_callback:0,trigger:0,interpret:0,interest:1,nghttp2_hcat_head:0,date:1,nghttp2_on_unknown_frame_recv_callback:0,nghttp2_err_nomem:0,nghttp2_session_server_new:0,both:0,nghttp2_opt:0,lib_error_cod:0,ani:[0,1],repres:0,those:0,"case":0,multi:1,subsequ:0,nghttp2_settings_initial_window_s:0,zlib:1,sourceforg:1,defin:0,"while":0,abov:[0,1],error:0,nghttp2_flag_end_stream:0,invoc:0,listen:1,on_data_chunk_recv_callback:0,nghttp2_session_callback:0,helper:0,libxml2:1,squid:1,select_next_proto_cb:0,promised_stream_id:0,inform:1,conf:1,crash:0,flow_control_error:0,ascii:0,pointer:0,frame_too_larg:0,"null":0,develop:[2,1],perform:0,make:[0,1],belong:0,same:0,member:0,pac:1,headlen:0,nghttp2_on_stream_close_callback:0,start:[0,1],complet:0,nghttp2_session_recv:0,context:0,mytyp:0,effect:0,on_ctrl_recv_parse_error_callback:0,nghttp2_err_deferred_data_exist:0,remot:[0,1],moment:1,zlib1g:1,ownership:0,mani:0,build:[2,1],postpon:0,nghttp2_submit_syn_stream:0,niv:[0,1],implement:[0,1,2],"45adabdf282c0":1,lower:0,com:0,nghttp:1,well:1,without:[0,1],client:[0,1,2],uint32_t:0,resouc:1,error_cod:[0,1],nghttp2_data_sourc:0,left:0,end_push_promis:0,nghttp2_err_def:0,nghttp2_submit_set:0,identifi:0,just:[0,1],nghttp2_on_data_recv_callback:0,send_callback:0,nghttp2_gzip_infl:0,via:1,multiplex:1,config:1,on_frame_send_callback:0,previous:0,web:1,"0x8":0,struct:[0,2],easi:1,also:0,priorit:0,except:0,identif:0,haz:0,other:0,input:0,on_data_send_callback:0,nghttp2_select_next_protocol:0,gmt:1,applic:[0,1],format:0,read:0,caller:0,period:0,outlen_ptr:0,nghttp2_session_set_opt:0,know:0,nva:0,bit:0,associ:0,delta_window_s:0,like:[0,1],specif:0,arbitrari:0,uint16_t:0,signal:0,manual:1,html:[0,1,2],nghttp2_pri_lowest:0,server:[0,1,2],nghttp2_flag_end_head:0,tlen:0,have:0,output:1,stream_clos:0,www:0,revers:1,deal:0,hostport:0,nghttp2_session_client_new:0,some:0,back:0,sampl:1,integ:0,librari:[0,1,2],transmiss:0,nonzero:0,lead:0,nghttp2_data_source_read_callback:0,octet:0,per:0,outgo:0,larg:0,unit:1,condit:0,duplic:0,localhost:1,either:0,machin:1,run:1,post:0,inspect:0,chart:0,host:[0,1],found:1,peer:0,major:0,nghttp2_session_get_outbound_queue_s:0,src:1,about:0,actual:0,socket:1,commun:1,inlen_ptr:0,nghttp2_gzip:0,chrome:1,idl:0,nghttp2_submit_data:0,nghttp2_settings_max_concurrent_stream:0,ssl_tlsext_err_ok:0,disabl:1,block:[0,1],on_data_recv_callback:0,nghttp2_settings_entri:0,nghttp2_err_invalid_fram:0,deploi:1,encod:[0,1],automat:0,ssl_ctx_set_next_proto_select_cb:0,automak:1,stream_id:[0,1],empti:0,chang:0,inclus:0,git:[0,1,2],nghttp2_hcat_respons:0,wai:[0,1],transfer:[0,1,2],support:[0,1],submit:0,avail:0,intention:0,nghttp2:[0,1,2],nghttp2_err_stream_clos:0,on_ctrl_send_callback:0,ipv6:1,forward:1,findproxyforurl:1,strictli:0,ipv4:1,lowest:0,head:0,session_ptr:0,gzip:[0,1],unexpect:0,offer:1,jul:1,nghttp2_err_invalid_st:0,content:[2,1],taken:0,link:1,highest:0,buf:0,suppli:0,succe:0,utf:1,nghttp2_stream_clos:0,"default":[0,1],nghttp2_settings_max:0,access:1,googlecod:0,maximum:0,tell:0,asynchron:0,below:0,nghttpx:1,autoconf:1,libev:1,expect:1,nghttp2_initial_window_s:0,featur:1,shrpx:1,creat:[0,1],"int":0,httpbi:[2,1],descriptor:0,"char":0,incomplet:1,exist:[0,1],file:[0,1],nghttp2_err_invalid_header_block:0,macro:[0,2],nghttp2_mem_chunk:0,googl:1,when:0,detail:0,invalid:0,field:0,valid:[0,1],role:0,nghttp2_err_invalid_argu:0,test:1,you:[0,1],libssl:1,sequenc:0,indirectli:0,technot:0,libtool:1,alpn:[0,1],debian:1,receiv:0,cunit:1,eof:0,algorithm:0,directori:1,reliabl:0,mask:0,nghttp2_settings_flag:0,nghttp2_submit_request:0,namelen:0,portion:0,ignor:0,time:[0,1],push:0,deflat:[0,1]},objtypes:{"0":"c:macro","1":"c:member","2":"c:type","3":"c:function"},titles:["API Reference","nghttp2 - HTTP/2.0 C Library","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","package_README","index"]}) \ No newline at end of file