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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
/** @file
*
* Definitions for routines to get information about capture interfaces
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
#ifndef __CAPTURE_IFINFO_H__
#define __CAPTURE_IFINFO_H__
#include <glib.h>
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/*
* Explicitly set the interface_type enum values as these values are exposed
* in the preferences gui.interfaces_hidden_types string.
*/
typedef enum {
IF_WIRED = 0,
IF_AIRPCAP = 1,
IF_PIPE = 2,
IF_STDIN = 3,
IF_BLUETOOTH = 4,
IF_WIRELESS = 5,
IF_DIALUP = 6,
IF_USB = 7,
IF_EXTCAP = 8,
IF_VIRTUAL = 9
} interface_type;
/*
* "get_if_capabilities()" and "capture_if_capabilities()" return a pointer
* to an allocated instance of this structure. "free_if_capabilities()"
* frees the returned instance.
*/
typedef struct {
bool can_set_rfmon; /* true if can be put into monitor mode */
GList *data_link_types; /* GList of data_link_info_t's */
GList *data_link_types_rfmon; /* GList of data_link_info_t's */
GList *timestamp_types; /* GList of timestamp_info_t's */
int status;
char *primary_msg; /* If non-NULL, the query failed, and a message explaining why */
const char *secondary_msg; /* An optional supplementary message */
} if_capabilities_t;
/*
* The list of interfaces returned by "get_interface_list()" is
* a list of these structures.
*/
typedef struct {
char *name; /* e.g. "eth0" */
char *friendly_name; /* from OS, e.g. "Local Area Connection", or
NULL if not available */
char *vendor_description;
/* vendor description from pcap_findalldevs(),
e.g. "Realtek PCIe GBE Family Controller",
or NULL if not available */
GSList *addrs; /* containing address values of if_addr_t */
interface_type type; /* type of interface */
bool loopback; /* true if loopback, false otherwise */
char *extcap; /* extcap arguments, which present the data to call the extcap interface */
if_capabilities_t *caps;
} if_info_t;
/*
* An address in the "addrs" list.
*/
typedef enum {
IF_AT_IPv4,
IF_AT_IPv6
} if_address_type;
typedef struct {
if_address_type ifat_type;
union {
uint32_t ip4_addr; /* 4 byte IP V4 address, or */
uint8_t ip6_addr[16];/* 16 byte IP V6 address */
} addr;
} if_addr_t;
extern GList *deserialize_interface_list(char *data, int *err, char **err_str);
/**
* Return the list of interfaces.
*
* Local interfaces are fetched by running dumpcap.
* The remote and extcap interfaces are appended to the list after that.
*/
extern GList *capture_interface_list(int *err, char **err_str, void (*update_cb)(void));
/* Error values from "get_interface_list()/capture_interface_list()". */
#define CANT_GET_INTERFACE_LIST 1 /* error getting list */
#define DONT_HAVE_PCAP 2 /* couldn't load WinPcap/Npcap */
void free_interface_list(GList *if_list);
/**
* Deep copy an interface list
*/
GList * interface_list_copy(GList *if_list);
/**
* Get an if_info_t for a particular interface.
* (May require privilege, so should only be used by dumpcap.)
*/
extern if_info_t *if_info_get(const char *name);
/**
* Free an if_info_t.
*/
void if_info_free(if_info_t *if_info);
/**
* Deep copy an if_info_t.
*/
if_info_t *if_info_copy(const if_info_t *if_info);
/**
* Deep copy an if_addr_t.
*/
if_addr_t *if_addr_copy(const if_addr_t *if_addr);
typedef struct {
const char *name;
bool monitor_mode;
const char *auth_username;
const char *auth_password;
} if_cap_query_t;
/*
* Information about data link types.
*/
typedef struct {
int dlt; /* e.g. DLT_EN10MB (which is 1) */
char *name; /* e.g. "EN10MB" or "DLT 1" */
char *description; /* descriptive name from wiretap e.g. "Ethernet", NULL if unknown */
} data_link_info_t;
/*
* Information about timestamp types.
*/
typedef struct {
char *name; /* e.g. "adapter_unsynced" */
char *description; /* description from libpcap e.g. "Adapter, not synced with system time" */
} timestamp_info_t;
/**
* Fetch the linktype list for the specified interface from a child process.
*/
extern if_capabilities_t *
capture_get_if_capabilities(const char *devname, bool monitor_mode,
const char *auth_string,
char **err_primary_msg, char **err_secondary_msg,
void (*update_cb)(void));
/**
* Fetch the linktype list for the specified interface from a child process.
*/
extern GHashTable *
capture_get_if_list_capabilities(GList *if_cap_queries,
char **err_primary_msg, char **err_secondary_msg,
void (*update_cb)(void));
void free_if_capabilities(if_capabilities_t *caps);
#ifdef HAVE_PCAP_REMOTE
void add_interface_to_remote_list(if_info_t *if_info);
GList* append_remote_list(GList *iflist);
#endif
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* __CAPTURE_IFINFO_H__ */
|
