mirror of
https://github.com/nghttp2/nghttp2.git
synced 2025-12-08 11:08:52 +08:00
b157d4ebb2
Previously we did not check HTTP semantics and it is left out for application. Although checking is relatively easy, but they are scattered and error prone. We have implemented these checks in our applications and also feel they are tedious. To make application development a bit easier, this commit adds basic HTTP semantics validation to library code. We do following checks: server: * HEADERS is either request header or trailer header. Other type of header is disallowed. client: * HEADERS is either zero or more non-final response header or final response header or trailer header. Other type of header is disallowed. For both: * Check mandatory pseudo header fields. * Make sure that content-length matches the amount of DATA we received. If validation fails, RST_STREAM of type PROTOCOL_ERROR is issued.
113 lines
4.8 KiB
C
113 lines
4.8 KiB
C
/*
|
|
* nghttp2 - HTTP/2 C Library
|
|
*
|
|
* Copyright (c) 2012 Tatsuhiro Tsujikawa
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
* LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
#ifndef NGHTTP2_TEST_HELPER_H
|
|
#define NGHTTP2_TEST_HELPER_H
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include <config.h>
|
|
#endif /* HAVE_CONFIG_H */
|
|
|
|
#include "nghttp2_frame.h"
|
|
#include "nghttp2_hd.h"
|
|
#include "nghttp2_session.h"
|
|
|
|
#define MAKE_NV(NAME, VALUE) \
|
|
{ \
|
|
(uint8_t *) NAME, (uint8_t *)VALUE, strlen(NAME), strlen(VALUE), \
|
|
NGHTTP2_NV_FLAG_NONE \
|
|
}
|
|
#define ARRLEN(ARR) (sizeof(ARR) / sizeof(ARR[0]))
|
|
|
|
#define assert_nv_equal(A, B, len) \
|
|
do { \
|
|
size_t alloclen = sizeof(nghttp2_nv) * len; \
|
|
const nghttp2_nv *sa = A, *sb = B; \
|
|
nghttp2_nv *a = malloc(alloclen); \
|
|
nghttp2_nv *b = malloc(alloclen); \
|
|
ssize_t i_; \
|
|
memcpy(a, sa, alloclen); \
|
|
memcpy(b, sb, alloclen); \
|
|
nghttp2_nv_array_sort(a, len); \
|
|
nghttp2_nv_array_sort(b, len); \
|
|
for (i_ = 0; i_ < (ssize_t)len; ++i_) { \
|
|
CU_ASSERT(nghttp2_nv_equal(&a[i_], &b[i_])); \
|
|
} \
|
|
free(b); \
|
|
free(a); \
|
|
} while (0);
|
|
|
|
int unpack_framebuf(nghttp2_frame *frame, nghttp2_bufs *bufs);
|
|
|
|
int unpack_frame(nghttp2_frame *frame, const uint8_t *in, size_t len);
|
|
|
|
int strmemeq(const char *a, const uint8_t *b, size_t bn);
|
|
|
|
int nvnameeq(const char *a, nghttp2_nv *nv);
|
|
|
|
int nvvalueeq(const char *a, nghttp2_nv *nv);
|
|
|
|
typedef struct {
|
|
nghttp2_nv nva[256];
|
|
size_t nvlen;
|
|
} nva_out;
|
|
|
|
void nva_out_init(nva_out *out);
|
|
void nva_out_reset(nva_out *out);
|
|
|
|
void add_out(nva_out *out, nghttp2_nv *nv);
|
|
|
|
ssize_t inflate_hd(nghttp2_hd_inflater *inflater, nva_out *out,
|
|
nghttp2_bufs *bufs, size_t offset);
|
|
|
|
int pack_headers(nghttp2_bufs *bufs, nghttp2_hd_deflater *deflater,
|
|
int32_t stream_id, int flags, const nghttp2_nv *nva,
|
|
size_t nvlen, nghttp2_mem *mem);
|
|
|
|
int pack_push_promise(nghttp2_bufs *bufs, nghttp2_hd_deflater *deflater,
|
|
int32_t stream_id, int flags, int32_t promised_stream_id,
|
|
const nghttp2_nv *nva, size_t nvlen, nghttp2_mem *mem);
|
|
|
|
int frame_pack_bufs_init(nghttp2_bufs *bufs);
|
|
|
|
void bufs_large_init(nghttp2_bufs *bufs, size_t chunk_size);
|
|
|
|
nghttp2_stream *open_stream(nghttp2_session *session, int32_t stream_id);
|
|
|
|
nghttp2_stream *open_stream_with_dep(nghttp2_session *session,
|
|
int32_t stream_id,
|
|
nghttp2_stream *dep_stream);
|
|
|
|
nghttp2_stream *open_stream_with_dep_weight(nghttp2_session *session,
|
|
int32_t stream_id, int32_t weight,
|
|
nghttp2_stream *dep_stream);
|
|
|
|
nghttp2_stream *open_stream_with_dep_excl(nghttp2_session *session,
|
|
int32_t stream_id,
|
|
nghttp2_stream *dep_stream);
|
|
|
|
nghttp2_outbound_item *create_data_ob_item(void);
|
|
|
|
#endif /* NGHTTP2_TEST_HELPER_H */
|