wireshark/epan/req_resp_hdrs.h

74 lines
2.7 KiB
C

/** @file
* Declarations of routines handling protocols with a request/response line,
* headers, a blank line, and an optional body.
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
#ifndef __REQ_RESP_HDRS_H__
#define __REQ_RESP_HDRS_H__
#include "ws_symbol_export.h"
/**
* Optionally do reassembly of the request/response line, headers, and body.
*
* @param tvb The buffer.
* @param offset The offset in the buffer to begin inspection.
* @param pinfo Packet info from the parent protocol.
* @param desegment_headers Do desegmentation on headers.
* @param desegment_body Do desegmentation on body.
* @param desegment_until_fin When desegment_body is enabled and no
* Content-Length header is found, assume that all data following the headers
* are part of the body.
* @param[in,out] last_chunk_offset For the chunked Transfer-Encoding,
* the offset (relative to the initial tvb offset) of the last chunk size
* found. The result can be fed back into a future call in order to skip
* to a later chunk and reduce processing from O(N^2) to O(N). Use 0 for
* the initial call. Only set when chunked TE is found. May be NULL.
* @param streaming_subdissector_table For searching a streaming reassembly
* mode supported subdissector on it by the content-type header value.
* @param[out] streaming_chunk_handle Only set when this is the beginning of
* a chunk stream. (There is 'Transfer-Encoding: chunked' header and a
* streaming reassembly mode supported subdissector is found according to
* Content-Type header)
* @return TRUE if desegmentation is complete otherwise FALSE
*/
WS_DLL_PUBLIC gboolean
req_resp_hdrs_do_reassembly(tvbuff_t *tvb, const int offset, packet_info *pinfo,
const gboolean desegment_headers, const gboolean desegment_body,
gboolean desegment_until_fin, int *last_chunk_offset,
dissector_table_t streaming_subdissector_table, dissector_handle_t *streaming_chunk_handle);
/** Check whether the first line is the beginning of a chunk. */
static inline gboolean
starts_with_chunk_size(tvbuff_t* tvb, const int offset, packet_info* pinfo)
{
guint chunk_size = 0;
gint linelen = tvb_find_line_end(tvb, offset, tvb_reported_length_remaining(tvb, offset), NULL, TRUE);
if (linelen < 0)
return FALSE;
gchar* chunk_string = tvb_get_string_enc(pinfo->pool, tvb, offset, linelen, ENC_ASCII);
gchar* c = chunk_string;
/* ignore extensions */
if ((c = strchr(c, ';'))) {
*c = '\0';
}
if (sscanf(chunk_string, "%x", &chunk_size) < 1) {
return FALSE; /* can not get chunk size*/
} else if (chunk_size > (1U << 31)) {
return FALSE; /* chunk size is unreasonable */
}
return TRUE;
}
#endif