Adding upstream version 4.2.2.upstream/4.2.2

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

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__ */