blob: 5639b1837ad90d8104a14ab1e7c91693de79da7d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
/* conversation_filter.h
* Routines for dissector-generated conversation filters for use as
* display and color filters
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
#ifndef __DISSECTOR_FILTERS_H__
#define __DISSECTOR_FILTERS_H__
#include "ws_symbol_export.h"
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/** @file
*/
/** Initialize internal structures */
extern void conversation_filters_init(void);
/** callback function definition: is a filter available for this packet? */
typedef gboolean (*is_filter_valid_func)(struct _packet_info *pinfo);
/** callback function definition: return the available filter for this packet or NULL if no filter is available,
Filter needs to be freed after use */
typedef gchar* (*build_filter_string_func)(struct _packet_info *pinfo);
/** register a dissector filter for packets */
WS_DLL_PUBLIC void register_conversation_filter(const char *proto_name, const char *display_name,
is_filter_valid_func is_filter_valid, build_filter_string_func build_filter_string);
/** register a dissector filter for logs */
WS_DLL_PUBLIC void register_log_conversation_filter(const char *proto_name, const char *display_name,
is_filter_valid_func is_filter_valid, build_filter_string_func build_filter_string);
/**
* Prepend a protocol to the list of filterable protocols.
* @param proto_name A valid protocol name.
*/
WS_DLL_PUBLIC void add_conversation_filter_protocol(const char *proto_name);
/** Cleanup internal structures */
extern void conversation_filters_cleanup(void);
/**
* Tries to build a suitable display filter for the conversation in the current
* packet. More specific matches are tried first (like TCP ports) followed by
* less specific ones (IP addresses). NULL is returned when no filter is found.
*
* @param pinfo Packet info
* @return A display filter for the conversation. Should be freed with g_free.
*/
WS_DLL_PUBLIC gchar *conversation_filter_from_packet(struct _packet_info *pinfo);
/**
* Tries to build a suitable display filter for the conversation in the current
* log entry. More specific matches are tried first (like TCP ports) followed by
* less specific ones (IP addresses). NULL is returned when no filter is found.
*
* @param pinfo Packet info
* @return A display filter for the conversation. Should be freed with g_free.
*/
WS_DLL_PUBLIC gchar *conversation_filter_from_log(struct _packet_info *pinfo);
/*** THE FOLLOWING SHOULD NOT BE USED BY ANY DISSECTORS!!! ***/
typedef struct conversation_filter_s {
const char * proto_name;
const char * display_name;
is_filter_valid_func is_filter_valid;
build_filter_string_func build_filter_string;
} conversation_filter_t;
WS_DLL_PUBLIC GList *packet_conv_filter_list;
WS_DLL_PUBLIC GList *log_conv_filter_list;
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* conversation_filter.h */
|
