| Wireshark 4.7.0 The Wireshark network protocol analyzer

Loading...
Searching...
No Matches
capture-pcap-util.h
Go to the documentation of this file.
1
12#ifndef __CAPTURE_PCAP_UTIL_H__
13#define __CAPTURE_PCAP_UTIL_H__
14
15#include <wsutil/feature_list.h>
16
17#ifdef HAVE_LIBPCAP
18
19#include <pcap/pcap.h>
20
21#include "ui/capture_opts.h"
22
23#endif
24
25#ifdef __cplusplus
26extern "C" {
27#endif /* __cplusplus */
28
29#ifdef HAVE_LIBPCAP
30/*
31 * A snapshot length of 0 is useless - and libpcap/WinPcap/Npcap don't guarantee
32 * that a snapshot length of 0 will work, and, on some platforms, it won't
33 * (with BPF, for example, the kernel is told the snapshot length via the
34 * return value of the BPF program, and a return value of 0 means "drop
35 * the packet"), so the minimum packet size is 1 byte.
36 */
37#define MIN_PACKET_SIZE 1 /* minimum amount of packet data we can read */
38
39GList *get_interface_list_ws(int *err, char **err_str);
40GList* get_interface_list_ss(int* err, char** err_str);
41#ifdef HAVE_PCAP_REMOTE
42GList *get_remote_interface_list(const char *hostname, const char *port,
43 bool wireshark_remote,
44 int auth_type, const char *username,
45 const char *passwd, int *err, char **err_str);
46#endif /* HAVE_PCAP_REMOTE */
47
48const char *linktype_val_to_name(int dlt);
49int linktype_name_to_val(const char *linktype);
50
51int get_pcap_datalink(pcap_t *pch, const char *devicename);
52
53bool set_pcap_datalink(pcap_t *pcap_h, int datalink, char *name,
54 char *errmsg, size_t errmsg_len,
55 char *secondary_errmsg, size_t secondary_errmsg_len);
56
57/*
58 * Return true if the pcap_t in question is set up for high-precision
59 * time stamps, false otherwise.
60 */
61bool have_high_resolution_timestamp(pcap_t *pcap_h);
62
63/*
64 * Capture device open status values.
65 */
66typedef enum {
67 /* No error and no warning */
68 CAP_DEVICE_OPEN_NO_ERR,
69
70 /* Errors corresponding to libpcap errors */
71 CAP_DEVICE_OPEN_ERROR_NO_SUCH_DEVICE,
72 CAP_DEVICE_OPEN_ERROR_RFMON_NOTSUP,
73 CAP_DEVICE_OPEN_ERROR_PERM_DENIED,
74 CAP_DEVICE_OPEN_ERROR_IFACE_NOT_UP,
75 CAP_DEVICE_OPEN_ERROR_PROMISC_PERM_DENIED,
76
77 /* Error, none of the above */
78 CAP_DEVICE_OPEN_ERROR_OTHER,
79
80 /* Error from pcap_open_live() or pcap_open() rather than pcap_activate() */
81 CAP_DEVICE_OPEN_ERROR_GENERIC,
82
83 /* Warnings corresponding to libpcap warnings */
84 CAP_DEVICE_OPEN_WARNING_PROMISC_NOTSUP,
85 CAP_DEVICE_OPEN_WARNING_TSTAMP_TYPE_NOTSUP,
86
87 /* Warning, none of the above */
88 CAP_DEVICE_OPEN_WARNING_OTHER
89} cap_device_open_status;
90extern if_capabilities_t *get_if_capabilities(interface_options *interface_opts,
91 cap_device_open_status *status, char **status_str);
92extern pcap_t *open_capture_device(capture_options *capture_opts,
93 interface_options *interface_opts,
94 int timeout, cap_device_open_status *open_status,
95 char (*open_status_str)[PCAP_ERRBUF_SIZE]);
96
97#endif /* HAVE_LIBPCAP */
98
99extern void gather_caplibs_compile_info(feature_list l);
100
101/*
102 * Append to a GString an indication of the version of capture libraries
103 * with which we're running, or an indication that we're not running
104 * with capture libraries, if we were compiled with WinPcap or Npcap but
105 * WinPcap/Npcap wasn't loaded, or nothing, if we weren't compiled with
106 * libpcap/WinPcap/Npcap.
107 */
108extern void gather_caplibs_runtime_info(feature_list l);
109
110#ifdef _WIN32
111extern bool caplibs_have_npcap(void);
112extern bool caplibs_get_npcap_version(unsigned int *major,
113 unsigned int *minor);
114#endif
115
116#ifdef __cplusplus
117}
118#endif /* __cplusplus */
119
120#endif /* __CAPTURE_PCAP_UTIL_H__ */
capture_opts.h
feature_list.h
feature_list
GList ** feature_list
Semi-opaque handle to a list of features or dependencies.
Definition feature_list.h:33
capture_options_tag
Definition capture_opts.h:236
if_capabilities_t
Definition capture_ifinfo.h:43
interface_options_tag
Definition capture_opts.h:185