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

Add note how to specify error code on NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE

This commit is contained in:
Tatsuhiro Tsujikawa 2014-08-10 00:18:41 +09:00
parent 93ed89df5f
commit 894783f572
1 changed files with 10 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -660,9 +660,12 @@ typedef enum {
* to outgoing queue, call `nghttp2_session_resume_data()`. In case * to outgoing queue, call `nghttp2_session_resume_data()`. In case
* of error, there are 2 choices. Returning * of error, there are 2 choices. Returning
* :enum:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will close the stream * :enum:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will close the stream
* by issuing RST_STREAM with :enum:`NGHTTP2_INTERNAL_ERROR`. * by issuing RST_STREAM with :enum:`NGHTTP2_INTERNAL_ERROR`. If a
* Returning :enum:`NGHTTP2_ERR_CALLBACK_FAILURE` will signal the * different error code is desirable, use
* entire session failure. * `nghttp2_submit_rst_stream()` with a desired error code and then
* return :enum:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`. Returning
* :enum:`NGHTTP2_ERR_CALLBACK_FAILURE` will signal the entire session
* failure.
*/ */
typedef ssize_t (*nghttp2_data_source_read_callback) typedef ssize_t (*nghttp2_data_source_read_callback)
(nghttp2_session *session, int32_t stream_id, (nghttp2_session *session, int32_t stream_id,
@ -1356,7 +1359,10 @@ typedef int (*nghttp2_on_begin_headers_callback)
* Returning :enum:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will close * Returning :enum:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE` will close
* the stream by issuing RST_STREAM with * the stream by issuing RST_STREAM with
* :enum:`NGHTTP2_INTERNAL_ERROR`. In this case, * :enum:`NGHTTP2_INTERNAL_ERROR`. In this case,
* :type:`nghttp2_on_frame_recv_callback` will not be invoked. * :type:`nghttp2_on_frame_recv_callback` will not be invoked. If a
* different error code is desirable, use
* `nghttp2_submit_rst_stream()` with a desired error code and then
* return :enum:`NGHTTP2_ERR_TEMPORAL_CALLBACK_FAILURE`.
* *
* The implementation of this function must return 0 if it succeeds. * The implementation of this function must return 0 if it succeeds.
* It may return :enum:`NGHTTP2_ERR_PAUSE` or * It may return :enum:`NGHTTP2_ERR_PAUSE` or