diff --git a/apiref.html b/apiref.html index efdac373..3a84bb92 100644 --- a/apiref.html +++ b/apiref.html @@ -7,7 +7,7 @@ - API Reference — nghttp2 0.5.1-DEV documentation + API Reference — nghttp2 0.5.2-DEV documentation @@ -28,7 +28,7 @@ - + @@ -729,13 +729,6 @@ The END_HEADERS flag.

The ACK flag.

-
-
-NGHTTP2_FLAG_END_SEGMENT
-

(0x02) -The END_SEGMENT flag.

-
-
NGHTTP2_FLAG_PADDED
@@ -784,6 +777,20 @@ SETTINGS_MAX_CONCURRENT_STREAMS

SETTINGS_INITIAL_WINDOW_SIZE

+
+
+NGHTTP2_SETTINGS_MAX_FRAME_SIZE
+

(0x05) +SETTINGS_MAX_FRAME_SIZE

+
+ +
+
+NGHTTP2_SETTINGS_MAX_HEADER_LIST_SIZE
+

(0x06) +SETTINGS_MAX_HEADER_LIST_SIZE

+
+
@@ -941,7 +948,9 @@ stream.

NGHTTP2_HCAT_HEADERS

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

+which is analogous to HEADERS in SPDY. If non-final response +(e.g., status 1xx) is used, final response HEADERS frame will be +categorized here.

@@ -1980,25 +1989,14 @@ void nghttp2_option_del( -
-void nghttp2_option_set_no_auto_stream_window_update(nghttp2_option *option, int val)
-

This option prevents the library from sending WINDOW_UPDATE for a -stream automatically. If this option is set to nonzero, the -library won’t send WINDOW_UPDATE for a stream and the application -is responsible for sending WINDOW_UPDATE using -nghttp2_submit_window_update(). By default, this option is set to -zero.

-
- -
-
-void nghttp2_option_set_no_auto_connection_window_update(nghttp2_option *option, int val)
+
+void nghttp2_option_set_no_auto_window_update(nghttp2_option *option, int val)

This option prevents the library from sending WINDOW_UPDATE for a connection automatically. If this option is set to nonzero, the -library won’t send WINDOW_UPDATE for a connection and the -application is responsible for sending WINDOW_UPDATE with stream ID -0 using nghttp2_submit_window_update(). By default, this option is -set to zero.

+library won’t send WINDOW_UPDATE for DATA until application calls +nghttp2_session_consume() to indicate the consumed amount of +data. Don’t use nghttp2_submit_window_update() for this purpose. +By default, this option is set to zero.

@@ -2453,6 +2451,26 @@ The id must be one of values defined in nghttp2_settings_id.

+
+
+int nghttp2_session_consume(nghttp2_session *session, int32_t stream_id, size_t size)
+

Tells the session that size bytes for a stream denoted by +stream_id were consumed by application and are ready to +WINDOW_UPDATE. This function is intended to be used without +automatic window update (see +nghttp2_option_set_no_auto_window_update()).

+

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 stream_id is 0.
+
NGHTTP2_ERR_INVALID_STATE
+
Automatic WINDOW_UPDATE is not disabled.
+
+
+
int nghttp2_session_upgrade(nghttp2_session *session, const uint8_t *settings_payload, size_t settings_payloadlen, void *stream_user_data)
@@ -2699,8 +2717,7 @@ int nghttp2_submit_data(NGHTTP2_FLAG_END_STREAM, the last DATA frame has END_STREAM -flag set. If flags contains NGHTTP2_FLAG_END_SEGMENT, -the last DATA frame has END_SEGMENT flag set.

+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 @@ -2896,12 +2913,11 @@ that value as window_size_increment is queued. If the remote endpoint, the local window size is increased by that difference.

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

+is decreased by -window_size_increment. If automatic +WINDOW_UPDATE is enabled +(nghttp2_option_set_no_auto_window_update()), and the library +decided that the WINDOW_UPDATE should be submitted, then +WINDOW_UPDATE is queued with the current received bytes count.

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

This function returns 0 if it succeeds, or one of the following @@ -2922,7 +2938,7 @@ int nghttp2_submit_altsvc(NGHTTP2_FLAG_NONE.

Only the server can send the ALTSVC frame. If session is initialized as client, this function fails and returns -NGHTTP2_ERR_INVALID_STATE.

+NGHTTP2_ERR_PROTO.

If the protocol_id_len is 0, the protocol_id could be NULL.

If the host_len is 0, the host could be NULL.

If the origin_len is 0, the origin could be NULL.

@@ -3061,16 +3077,6 @@ void nghttp2_hd_deflate_del( -
-void nghttp2_hd_deflate_set_no_refset(nghttp2_hd_deflater *deflater, uint8_t no_refset)
-

Sets the availability of reference set in the deflater. If -no_refset is nonzero, the deflater will first emit “Reference Set -Emptying” in the each subsequent invocation of -nghttp2_hd_deflate_hd() to clear up reference set. By default, -the deflater uses reference set.

-
-
int nghttp2_hd_deflate_change_table_size(nghttp2_hd_deflater *deflater, size_t settings_hd_table_bufsize_max)
@@ -3282,7 +3288,7 @@ always succeeds.

@@ -1940,10 +1940,6 @@ -
NGHTTP2_FLAG_END_SEGMENT (C macro) -
- -
NGHTTP2_FLAG_END_STREAM (C macro)
@@ -2104,10 +2100,6 @@ -
nghttp2_hd_deflate_set_no_refset (C function) -
- -
nghttp2_hd_deflater (C type)
@@ -2207,8 +2199,6 @@
nghttp2_info.version_num (C member)
-
-
nghttp2_info.version_str (C member)
@@ -2217,6 +2207,8 @@
NGHTTP2_INITIAL_CONNECTION_WINDOW_SIZE (C macro)
+
+
NGHTTP2_INITIAL_MAX_CONCURRENT_STREAMS (C macro)
@@ -2338,11 +2330,7 @@ -
nghttp2_option_set_no_auto_connection_window_update (C function) -
- - -
nghttp2_option_set_no_auto_stream_window_update (C function) +
nghttp2_option_set_no_auto_window_update (C function)
@@ -2554,6 +2542,10 @@ +
nghttp2_session_consume (C function) +
+ +
nghttp2_session_del (C function)
@@ -2702,6 +2694,14 @@ +
NGHTTP2_SETTINGS_MAX_FRAME_SIZE (C macro) +
+ + +
NGHTTP2_SETTINGS_MAX_HEADER_LIST_SIZE (C macro) +
+ +
NGHTTP2_SETTINGS_TIMEOUT (C macro)
@@ -3291,7 +3291,7 @@ @@ -226,7 +226,7 @@