diff options
Diffstat (limited to 'capture/ws80211_utils.h')
| -rw-r--r-- | capture/ws80211_utils.h | 135 |
1 files changed, 135 insertions, 0 deletions
diff --git a/capture/ws80211_utils.h b/capture/ws80211_utils.h new file mode 100644 index 00000000..a354e51e --- /dev/null +++ b/capture/ws80211_utils.h @@ -0,0 +1,135 @@ +/** @file + * + * Copyright 2012, Pontus Fuchs <pontus.fuchs@gmail.com> + * + * Wireshark - Network traffic analyzer + * By Gerald Combs <gerald@wireshark.org> + * Copyright 1998 Gerald Combs + * + * SPDX-License-Identifier: GPL-2.0-or-later + */ + +#ifndef __WS80211_UTILS_H__ +#define __WS80211_UTILS_H__ + +#include <wireshark.h> + +#ifdef __cplusplus +extern "C" { +#endif /* __cplusplus */ + +enum ws80211_channel_type { + WS80211_CHAN_NO_HT, + WS80211_CHAN_HT20, + WS80211_CHAN_HT40MINUS, + WS80211_CHAN_HT40PLUS, + WS80211_CHAN_VHT80, + WS80211_CHAN_VHT80P80, + WS80211_CHAN_VHT160 +}; + +#define CHAN_NO_HT "NOHT" +#define CHAN_HT20 "HT20" +#define CHAN_HT40MINUS "HT40-" +#define CHAN_HT40PLUS "HT40+" +#define CHAN_VHT80 "VHT80" +#define CHAN_VHT80P80 "VHT80+80" +#define CHAN_VHT160 "VHT160" + +/* XXX This doesn't match AirpcapValidationType. Should it? */ +enum ws80211_fcs_validation { + WS80211_FCS_ALL, + WS80211_FCS_VALID, + WS80211_FCS_INVALID +}; + +struct ws80211_interface +{ + char *ifname; + bool can_set_freq; + bool can_check_fcs; + GArray *frequencies; /* Array of uint32_t? */ + int channel_types; /* Union for all bands */ + int cap_monitor; +}; + +struct ws80211_iface_info { + int current_freq; + enum ws80211_channel_type current_chan_type; + int current_center_freq1; + int current_center_freq2; + enum ws80211_fcs_validation current_fcs_validation; +}; + +/** Initialize the 802.11 environment. + * On Linux this initializes an nl80211_state struct. + * On Windows this checks the AirPcap status. It does *not* load the + * AirPcap DLL. That happens when the program starts. + * + * @return WS80211_INIT_OK on success, WS80211_INIT_NOT_SUPPORTED if the + * 802.11 environment isn't supported, or the negative of an errno value + * on failure. + */ +#define WS80211_INIT_OK 0 +#define WS80211_INIT_NOT_SUPPORTED 1 + +int ws80211_init(void); + +/** Build a list of 802.11 interfaces. + * + * @return A GArray of pointers to struct ws80211_interface on success, NULL on failure. + */ +/* XXX Should we make this an array of structs instead of an array of struct pointers? + * It'd save a bit of mallocing and freeing. */ +GArray* ws80211_find_interfaces(void); + +int ws80211_get_iface_info(const char *name, struct ws80211_iface_info *iface_info); + +/** Free an interface list. + * + * @param interfaces A list of interfaces created with ws80211_find_interfaces(). + */ +void ws80211_free_interfaces(GArray *interfaces); + +/** Set the frequency and channel width for an interface. + * + * @param name The interface name. + * @param freq The frequency in MHz. + * @param chan_type The HT channel type (no, 20Mhz, 40Mhz...). + * @param center_freq The center frequency in MHz (if 80MHz, 80+80MHz or 160MHz). + * @param center_freq2 The 2nd center frequency in MHz (if 80+80MHz). + * @return Zero on success, nonzero on failure. + */ +int ws80211_set_freq(const char *name, uint32_t freq, int chan_type, uint32_t _U_ center_freq, uint32_t _U_ center_freq2); + +int ws80211_str_to_chan_type(const char *s); +const char *ws80211_chan_type_to_str(int type); + +/** Check to see if we have FCS filtering. + * + * @return true if FCS filtering is supported on this platform. + */ +bool ws80211_has_fcs_filter(void); + +/** Set the FCS validation behavior for an interface. + * + * @param name The interface name. + * @param fcs_validation The desired validation behavior. + * @return Zero on success, nonzero on failure. + */ +int ws80211_set_fcs_validation(const char *name, enum ws80211_fcs_validation fcs_validation); + + +/** Get the path to a helper application. + * Return the path to a separate 802.11 helper application, e.g. + * the AirPcap control panel or the GNOME Network Manager. + * + * @return The path to the helper on success, NULL on failure. + */ +const char *ws80211_get_helper_path(void); + +#ifdef __cplusplus +} +#endif /* __cplusplus */ + +#endif /* __WS80211_UTILS_H__ */ |