mirror of
https://github.com/nghttp2/nghttp2.git
synced 2025-12-08 11:08:52 +08:00
This commit deprecates all APIs, including structs and callback functions, that use ssize_t. New APIs that use nghttp2_ssize are added as a replacement. The usage of ssize_t is problematic for several reasons. Some platforms do not define ssize_t. The minimum value of ssize_t that POSIX requires is -1 which makes nghttp2 error code out of range. nghttp2_ssize is an alias of ptrdiff_t that is in C standard and covers our error code range. New code should use new nghttp2_ssize APIs. The existing applications should consider migrating to new APIs. The deprecated ssize_t APIs continue to work for backward compatibility. Here is the summary of the deprecated APIs and their replacements: Callback functions: - nghttp2_data_source_read_callback => nghttp2_data_source_read_callback2 - nghttp2_data_source_read_length_callback => nghttp2_data_source_read_length_callback2 - nghttp2_pack_extension_callback => nghttp2_pack_extension_callback2 - nghttp2_recv_callback => nghttp2_recv_callback2 - nghttp2_select_padding_callback => nghttp2_select_padding_callback2 - nghttp2_send_callback => nghttp2_send_callback2 Structs: - nghttp2_data_provider => nghttp2_data_provider2 Functions: - nghttp2_hd_deflate_hd => nghttp2_hd_deflate_hd2 - nghttp2_hd_deflate_hd_vec => nghttp2_hd_deflate_hd_vec2 - nghttp2_hd_inflate_hd2 => nghttp2_hd_inflate_hd3 - nghttp2_pack_settings_payload => nghttp2_pack_settings_payload2 - nghttp2_session_callbacks_set_data_source_read_length_callback => nghttp2_session_callbacks_set_data_source_read_length_callback2 - nghttp2_session_callbacks_set_pack_extension_callback => nghttp2_session_callbacks_set_pack_extension_callback2 - nghttp2_session_callbacks_set_recv_callback => nghttp2_session_callbacks_set_recv_callback2 - nghttp2_session_callbacks_set_select_padding_callback => nghttp2_session_callbacks_set_select_padding_callback2 - nghttp2_session_callbacks_set_send_callback => nghttp2_session_callbacks_set_send_callback2 - nghttp2_session_mem_recv => nghttp2_session_mem_recv2 - nghttp2_session_mem_send => nghttp2_session_mem_send2 - nghttp2_submit_data => nghttp2_submit_data2 - nghttp2_submit_request => nghttp2_submit_request2 - nghttp2_submit_response => nghttp2_submit_response2 For those applications that do not want to see ssize_t in nghttp2.h header file, define NGHTTP2_NO_SSIZE_T macro before including nghttp2.h. It hides all ssize_t APIs.
204 lines
7.4 KiB
C
204 lines
7.4 KiB
C
/*
|
|
* nghttp2 - HTTP/2 C Library
|
|
*
|
|
* Copyright (c) 2014 Tatsuhiro Tsujikawa
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
* LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
#include "nghttp2_callbacks.h"
|
|
|
|
#include <stdlib.h>
|
|
|
|
int nghttp2_session_callbacks_new(nghttp2_session_callbacks **callbacks_ptr) {
|
|
*callbacks_ptr = calloc(1, sizeof(nghttp2_session_callbacks));
|
|
|
|
if (*callbacks_ptr == NULL) {
|
|
return NGHTTP2_ERR_NOMEM;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_del(nghttp2_session_callbacks *callbacks) {
|
|
free(callbacks);
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_send_callback(
|
|
nghttp2_session_callbacks *cbs, nghttp2_send_callback send_callback) {
|
|
cbs->send_callback = send_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_send_callback2(
|
|
nghttp2_session_callbacks *cbs, nghttp2_send_callback2 send_callback) {
|
|
cbs->send_callback2 = send_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_recv_callback(
|
|
nghttp2_session_callbacks *cbs, nghttp2_recv_callback recv_callback) {
|
|
cbs->recv_callback = recv_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_recv_callback2(
|
|
nghttp2_session_callbacks *cbs, nghttp2_recv_callback2 recv_callback) {
|
|
cbs->recv_callback2 = recv_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_frame_recv_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_frame_recv_callback on_frame_recv_callback) {
|
|
cbs->on_frame_recv_callback = on_frame_recv_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_invalid_frame_recv_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_invalid_frame_recv_callback on_invalid_frame_recv_callback) {
|
|
cbs->on_invalid_frame_recv_callback = on_invalid_frame_recv_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_data_chunk_recv_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_data_chunk_recv_callback on_data_chunk_recv_callback) {
|
|
cbs->on_data_chunk_recv_callback = on_data_chunk_recv_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_before_frame_send_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_before_frame_send_callback before_frame_send_callback) {
|
|
cbs->before_frame_send_callback = before_frame_send_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_frame_send_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_frame_send_callback on_frame_send_callback) {
|
|
cbs->on_frame_send_callback = on_frame_send_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_frame_not_send_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_frame_not_send_callback on_frame_not_send_callback) {
|
|
cbs->on_frame_not_send_callback = on_frame_not_send_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_stream_close_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_stream_close_callback on_stream_close_callback) {
|
|
cbs->on_stream_close_callback = on_stream_close_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_begin_headers_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_begin_headers_callback on_begin_headers_callback) {
|
|
cbs->on_begin_headers_callback = on_begin_headers_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_header_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_header_callback on_header_callback) {
|
|
cbs->on_header_callback = on_header_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_header_callback2(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_header_callback2 on_header_callback2) {
|
|
cbs->on_header_callback2 = on_header_callback2;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_invalid_header_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_invalid_header_callback on_invalid_header_callback) {
|
|
cbs->on_invalid_header_callback = on_invalid_header_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_invalid_header_callback2(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_invalid_header_callback2 on_invalid_header_callback2) {
|
|
cbs->on_invalid_header_callback2 = on_invalid_header_callback2;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_select_padding_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_select_padding_callback select_padding_callback) {
|
|
cbs->select_padding_callback = select_padding_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_select_padding_callback2(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_select_padding_callback2 select_padding_callback) {
|
|
cbs->select_padding_callback2 = select_padding_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_data_source_read_length_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_data_source_read_length_callback data_source_read_length_callback) {
|
|
cbs->read_length_callback = data_source_read_length_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_data_source_read_length_callback2(
|
|
nghttp2_session_callbacks *cbs, nghttp2_data_source_read_length_callback2
|
|
data_source_read_length_callback) {
|
|
cbs->read_length_callback2 = data_source_read_length_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_begin_frame_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_begin_frame_callback on_begin_frame_callback) {
|
|
cbs->on_begin_frame_callback = on_begin_frame_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_send_data_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_send_data_callback send_data_callback) {
|
|
cbs->send_data_callback = send_data_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_pack_extension_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_pack_extension_callback pack_extension_callback) {
|
|
cbs->pack_extension_callback = pack_extension_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_pack_extension_callback2(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_pack_extension_callback2 pack_extension_callback) {
|
|
cbs->pack_extension_callback2 = pack_extension_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_unpack_extension_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_unpack_extension_callback unpack_extension_callback) {
|
|
cbs->unpack_extension_callback = unpack_extension_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_on_extension_chunk_recv_callback(
|
|
nghttp2_session_callbacks *cbs,
|
|
nghttp2_on_extension_chunk_recv_callback on_extension_chunk_recv_callback) {
|
|
cbs->on_extension_chunk_recv_callback = on_extension_chunk_recv_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_error_callback(
|
|
nghttp2_session_callbacks *cbs, nghttp2_error_callback error_callback) {
|
|
cbs->error_callback = error_callback;
|
|
}
|
|
|
|
void nghttp2_session_callbacks_set_error_callback2(
|
|
nghttp2_session_callbacks *cbs, nghttp2_error_callback2 error_callback2) {
|
|
cbs->error_callback2 = error_callback2;
|
|
}
|