ws80211_utils.h

Go to the documentation of this file.

 
#ifndef __WS80211_UTILS_H__
#define __WS80211_UTILS_H__
 
#include <wireshark.h>
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
/* For our (monitor mode tuning) purposes we shouldn't care about 20 MHz
 * non HT vs 20 MHz HT. We do care about HT40- vs HT40+ vs HE40 (whether
 * the center freq must be provided, */
 
enum ws80211_channel_type {
    WS80211_CHAN_NO_HT,     
    WS80211_CHAN_HT20,      
    WS80211_CHAN_HT40MINUS, 
    WS80211_CHAN_HT40PLUS,  
    WS80211_CHAN_HE40,      
    WS80211_CHAN_VHT80,     
    WS80211_CHAN_VHT80P80,  
    WS80211_CHAN_VHT160,    
    WS80211_CHAN_EHT320     
};
 
#define CHAN_NO_HT    "NOHT"
#define CHAN_HT20     "HT20"
#define CHAN_HT40MINUS "HT40-"
#define CHAN_HT40PLUS  "HT40+"
#define CHAN_HE40     "HE40"
#define CHAN_VHT80    "VHT80"
#define CHAN_VHT80P80  "VHT80+80"
#define CHAN_VHT160   "VHT160"
#define CHAN_EHT320   "EHT320"
 
/* These are *not* the same values as the Linux NL80211_BAND_* enum,
 * because we don't support the 60 GHz or 900 MHz (S1G, HaLow) bands,
 * which have different channel widths. */
 
enum ws80211_band_type {
    WS80211_BAND_2GHZ, 
    WS80211_BAND_5GHZ, 
    WS80211_BAND_6GHZ  
};
 
enum ws80211_fcs_validation {
    WS80211_FCS_ALL,     
    WS80211_FCS_VALID,   
    WS80211_FCS_INVALID  
};
 
struct ws80211_frequency
{
    uint32_t freq;   
    int channel_mask; 
};
 
struct ws80211_band
{
    GArray *frequencies;  
    int channel_types;    
};
 
struct ws80211_interface
{
    char *ifname;        
    bool can_set_freq;   
    bool can_check_fcs;  
    GArray *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; 
};
 
/*
 * List of error types.
 * WS80211_ERROR is a generic error that might have a platform-specific
 * error message that depends on the last failed operation.
 */
#define WS80211_OK                  0
#define WS80211_ERROR_NOT_SUPPORTED 1
#define WS80211_ERROR               2
 
const char *ws80211_geterror(int error);
 
int ws80211_init(void);
 
/* 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);
 
void ws80211_free_interfaces(GArray *interfaces);
 
void ws80211_clear_band(struct ws80211_band *band);
 
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(enum ws80211_channel_type type);
 
const char *ws80211_band_type_to_str(enum ws80211_band_type type);
 
bool ws80211_has_fcs_filter(void);
 
int ws80211_set_fcs_validation(const char *name, enum ws80211_fcs_validation fcs_validation);
 
 
const char *ws80211_get_helper_path(void);
 
 
int ws80211_get_center_frequency(int control_frequency, enum ws80211_channel_type channel_type);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* __WS80211_UTILS_H__ */