packet-http.h

/* packet-http.h
 *
 * Wireshark - Network traffic analyzer
 * By Gerald Combs <[email protected]>
 * Copyright 1998 Gerald Combs
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */
 
#ifndef __PACKET_HTTP_H__
#define __PACKET_HTTP_H__
 
#include <epan/packet.h>
#include "ws_symbol_export.h"
 
extern const value_string vals_http_status_code[];
 
WS_DLL_PUBLIC
void http_tcp_dissector_add(uint32_t port, dissector_handle_t handle);
WS_DLL_PUBLIC
void http_tcp_dissector_delete(uint32_t port);
WS_DLL_PUBLIC
void http_tcp_port_add(uint32_t port);
 
WS_DLL_PUBLIC
void http_add_path_components_to_tree(tvbuff_t* tvb, packet_info* pinfo _U_, proto_item* item, int offset, int length);
 
WS_DLL_PUBLIC
dissector_handle_t http_upgrade_dissector(const char *protocol);
 
/* Used for HTTP statistics */
typedef struct _http_info_value_t {
    uint32_t framenum;
    char    *request_method;
    unsigned     response_code;
    char    *http_host;
    const char    *request_uri;
    const char    *referer_uri;
    const char    *full_uri;
    const char    *location_base_uri;
    const char    *location_target;
} http_info_value_t;
 
#define HTTP_PROTO_DATA_REQRES  0
#define HTTP_PROTO_DATA_INFO    1
 
typedef struct _http_req_res_t {
    uint32_t number;
    uint32_t req_framenum;
    uint32_t res_framenum;
    nstime_t req_ts;
    unsigned response_code;
    char    *request_method;
    char    *http_host;
    char    *request_uri;
    char    *full_uri;
    bool req_has_range;
    bool resp_has_range;
 
    void* private_data;
} http_req_res_t;
 
typedef struct _http_upgrade_info_t {
    uint16_t    server_port;
    uint8_t     http_version;
    const char *(*get_header_value)(packet_info *, const char *, bool);
    bool        from_server;
} http_upgrade_info_t;
 
typedef struct _http_conv_t {
 
        /* Used to speed up desegmenting of chunked Transfer-Encoding. */
    wmem_map_t *chunk_offsets_fwd;
    wmem_map_t *chunk_offsets_rev;
 
    /* Fields related to proxied/tunneled/Upgraded connections. */
    uint32_t     startframe;    /* First frame of proxied connection */
    int      startoffset;   /* Offset within the frame where the new protocol begins. */
    dissector_handle_t next_handle; /* New protocol */
    http_upgrade_info_t *upgrade_info; /* Data for new protocol */
 
    /* Server address and port, known after first server response */
    uint16_t server_port;
    address server_addr;
    http_req_res_t *req_res_tail;
    /* true means current message is chunked streaming, and not ended yet.
     * This is only meaningful during the first scan.
     */
    bool message_ended;
 
    /* Used for req/res matching */
    GSList *req_list;
        wmem_map_t *matches_table;
 
} http_conv_t;
 
/* Used for HTTP Export Object feature */
typedef struct _http_eo_t {
    char    *hostname;
    char    *filename;
    char    *content_type;
    tvbuff_t *payload;
} http_eo_t;
 
/* Resolves a URI reference that might be relative to a given base URI and
 * returns a string. Roughly similar to the algorithm in RFC 3986 5.2 but
 * not entirely accurate to it (sacrificing some accuracy for simplicity.)
 *
 * @param scope wmem allocator scope for the returned string
 * @param base_url base URI
 * @param location_url a URI reference that might be relative to base_url
 * (or might be an absolute URI)
 * @return A string allocated in scope that represents a target URI after
 * resolving location_url, using base_url as the possible base URI
 */
extern char *
determine_http_location_target(wmem_allocator_t *scope, const char *base_url, const char * location_url);
 
#endif /* __PACKET_HTTP_H__ */