iwinfo/include/iwinfo.h
Andre Heider 0d5ea34245
nl80211: add "band" to iwinfo_freqlist_entry
So that consumers don't have to fiddle around with mapping frequencies
to bands, which everyone seems to do a little differently.

Note: This changes the ABI.

Signed-off-by: Andre Heider <a.heider@gmail.com>
2023-01-20 17:26:57 +01:00

411 lines
10 KiB
C

#ifndef __IWINFO_H_
#define __IWINFO_H_
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/wait.h>
#include <unistd.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <fcntl.h>
#include <glob.h>
#include <ctype.h>
#include <dirent.h>
#include <stdint.h>
#include <sys/ioctl.h>
#include <sys/mman.h>
#include <net/if.h>
#include <errno.h>
#define IWINFO_BUFSIZE 24 * 1024
#define IWINFO_ESSID_MAX_SIZE 32
enum iwinfo_80211 {
IWINFO_80211_A = 0,
IWINFO_80211_B,
IWINFO_80211_G,
IWINFO_80211_N,
IWINFO_80211_AC,
IWINFO_80211_AD,
IWINFO_80211_AX,
/* keep last */
IWINFO_80211_COUNT
};
#define IWINFO_80211_A (1 << IWINFO_80211_A)
#define IWINFO_80211_B (1 << IWINFO_80211_B)
#define IWINFO_80211_G (1 << IWINFO_80211_G)
#define IWINFO_80211_N (1 << IWINFO_80211_N)
#define IWINFO_80211_AC (1 << IWINFO_80211_AC)
#define IWINFO_80211_AD (1 << IWINFO_80211_AD)
#define IWINFO_80211_AX (1 << IWINFO_80211_AX)
extern const char * const IWINFO_80211_NAMES[IWINFO_80211_COUNT];
enum iwinfo_band {
IWINFO_BAND_24 = 0,
IWINFO_BAND_5,
IWINFO_BAND_6,
IWINFO_BAND_60,
/* keep last */
IWINFO_BAND_COUNT
};
#define IWINFO_BAND_24 (1 << IWINFO_BAND_24)
#define IWINFO_BAND_5 (1 << IWINFO_BAND_5)
#define IWINFO_BAND_6 (1 << IWINFO_BAND_6)
#define IWINFO_BAND_60 (1 << IWINFO_BAND_60)
extern const char * const IWINFO_BAND_NAMES[IWINFO_BAND_COUNT];
enum iwinfo_cipher {
IWINFO_CIPHER_NONE = 0,
IWINFO_CIPHER_WEP40,
IWINFO_CIPHER_TKIP,
IWINFO_CIPHER_WRAP,
IWINFO_CIPHER_CCMP,
IWINFO_CIPHER_WEP104,
IWINFO_CIPHER_AESOCB,
IWINFO_CIPHER_CKIP,
IWINFO_CIPHER_GCMP,
IWINFO_CIPHER_CCMP256,
IWINFO_CIPHER_GCMP256,
/* keep last */
IWINFO_CIPHER_COUNT
};
#define IWINFO_CIPHER_NONE (1 << IWINFO_CIPHER_NONE)
#define IWINFO_CIPHER_WEP40 (1 << IWINFO_CIPHER_WEP40)
#define IWINFO_CIPHER_TKIP (1 << IWINFO_CIPHER_TKIP)
#define IWINFO_CIPHER_WRAP (1 << IWINFO_CIPHER_WRAP)
#define IWINFO_CIPHER_CCMP (1 << IWINFO_CIPHER_CCMP)
#define IWINFO_CIPHER_WEP104 (1 << IWINFO_CIPHER_WEP104)
#define IWINFO_CIPHER_AESOCB (1 << IWINFO_CIPHER_AESOCB)
#define IWINFO_CIPHER_CKIP (1 << IWINFO_CIPHER_CKIP)
#define IWINFO_CIPHER_GCMP (1 << IWINFO_CIPHER_GCMP)
#define IWINFO_CIPHER_CCMP256 (1 << IWINFO_CIPHER_CCMP256)
#define IWINFO_CIPHER_GCMP256 (1 << IWINFO_CIPHER_GCMP256)
extern const char * const IWINFO_CIPHER_NAMES[IWINFO_CIPHER_COUNT];
enum iwinfo_kmgmt {
IWINFO_KMGMT_NONE = 0,
IWINFO_KMGMT_8021x,
IWINFO_KMGMT_PSK,
IWINFO_KMGMT_SAE,
IWINFO_KMGMT_OWE,
/* keep last */
IWINFO_KMGMT_COUNT
};
#define IWINFO_KMGMT_NONE (1 << IWINFO_KMGMT_NONE)
#define IWINFO_KMGMT_8021x (1 << IWINFO_KMGMT_8021x)
#define IWINFO_KMGMT_PSK (1 << IWINFO_KMGMT_PSK)
#define IWINFO_KMGMT_SAE (1 << IWINFO_KMGMT_SAE)
#define IWINFO_KMGMT_OWE (1 << IWINFO_KMGMT_OWE)
extern const char * const IWINFO_KMGMT_NAMES[IWINFO_KMGMT_COUNT];
enum iwinfo_auth {
IWINFO_AUTH_OPEN = 0,
IWINFO_AUTH_SHARED,
/* keep last */
IWINFO_AUTH_COUNT
};
extern const char * const IWINFO_AUTH_NAMES[IWINFO_AUTH_COUNT];
enum iwinfo_freq_flag {
IWINFO_FREQ_NO_10MHZ = 0,
IWINFO_FREQ_NO_20MHZ,
IWINFO_FREQ_NO_HT40PLUS,
IWINFO_FREQ_NO_HT40MINUS,
IWINFO_FREQ_NO_80MHZ,
IWINFO_FREQ_NO_160MHZ,
IWINFO_FREQ_NO_HE,
IWINFO_FREQ_NO_IR,
IWINFO_FREQ_INDOOR_ONLY,
/* keep last */
IWINFO_FREQ_FLAG_COUNT,
};
#define IWINFO_FREQ_NO_10MHZ (1 << IWINFO_FREQ_NO_10MHZ)
#define IWINFO_FREQ_NO_20MHZ (1 << IWINFO_FREQ_NO_20MHZ)
#define IWINFO_FREQ_NO_HT40PLUS (1 << IWINFO_FREQ_NO_HT40PLUS)
#define IWINFO_FREQ_NO_HT40MINUS (1 << IWINFO_FREQ_NO_HT40MINUS)
#define IWINFO_FREQ_NO_80MHZ (1 << IWINFO_FREQ_NO_80MHZ)
#define IWINFO_FREQ_NO_160MHZ (1 << IWINFO_FREQ_NO_160MHZ)
#define IWINFO_FREQ_NO_HE (1 << IWINFO_FREQ_NO_HE)
#define IWINFO_FREQ_NO_IR (1 << IWINFO_FREQ_NO_IR)
#define IWINFO_FREQ_INDOOR_ONLY (1 << IWINFO_FREQ_INDOOR_ONLY)
enum iwinfo_opmode {
IWINFO_OPMODE_UNKNOWN = 0,
IWINFO_OPMODE_MASTER,
IWINFO_OPMODE_ADHOC,
IWINFO_OPMODE_CLIENT,
IWINFO_OPMODE_MONITOR,
IWINFO_OPMODE_AP_VLAN,
IWINFO_OPMODE_WDS,
IWINFO_OPMODE_MESHPOINT,
IWINFO_OPMODE_P2P_CLIENT,
IWINFO_OPMODE_P2P_GO,
/* keep last */
IWINFO_OPMODE_COUNT
};
extern const char * const IWINFO_OPMODE_NAMES[IWINFO_OPMODE_COUNT];
enum iwinfo_htmode {
IWINFO_HTMODE_HT20 = 0,
IWINFO_HTMODE_HT40,
IWINFO_HTMODE_VHT20,
IWINFO_HTMODE_VHT40,
IWINFO_HTMODE_VHT80,
IWINFO_HTMODE_VHT80_80,
IWINFO_HTMODE_VHT160,
IWINFO_HTMODE_NOHT,
IWINFO_HTMODE_HE20,
IWINFO_HTMODE_HE40,
IWINFO_HTMODE_HE80,
IWINFO_HTMODE_HE80_80,
IWINFO_HTMODE_HE160,
/* keep last */
IWINFO_HTMODE_COUNT
};
#define IWINFO_HTMODE_HT20 (1 << IWINFO_HTMODE_HT20)
#define IWINFO_HTMODE_HT40 (1 << IWINFO_HTMODE_HT40)
#define IWINFO_HTMODE_VHT20 (1 << IWINFO_HTMODE_VHT20)
#define IWINFO_HTMODE_VHT40 (1 << IWINFO_HTMODE_VHT40)
#define IWINFO_HTMODE_VHT80 (1 << IWINFO_HTMODE_VHT80)
#define IWINFO_HTMODE_VHT80_80 (1 << IWINFO_HTMODE_VHT80_80)
#define IWINFO_HTMODE_VHT160 (1 << IWINFO_HTMODE_VHT160)
#define IWINFO_HTMODE_NOHT (1 << IWINFO_HTMODE_NOHT)
#define IWINFO_HTMODE_HE20 (1 << IWINFO_HTMODE_HE20)
#define IWINFO_HTMODE_HE40 (1 << IWINFO_HTMODE_HE40)
#define IWINFO_HTMODE_HE80 (1 << IWINFO_HTMODE_HE80)
#define IWINFO_HTMODE_HE80_80 (1 << IWINFO_HTMODE_HE80_80)
#define IWINFO_HTMODE_HE160 (1 << IWINFO_HTMODE_HE160)
extern const char * const IWINFO_HTMODE_NAMES[IWINFO_HTMODE_COUNT];
struct iwinfo_rate_entry {
uint32_t rate;
int8_t mcs;
uint8_t is_40mhz:1;
uint8_t is_short_gi:1;
uint8_t is_ht:1;
uint8_t is_vht:1;
uint8_t is_he:1;
uint8_t he_gi;
uint8_t he_dcm;
uint8_t mhz;
uint8_t nss;
};
struct iwinfo_assoclist_entry {
uint8_t mac[6];
int8_t signal;
int8_t signal_avg;
int8_t noise;
uint32_t inactive;
uint32_t connected_time;
uint32_t rx_packets;
uint32_t tx_packets;
uint64_t rx_drop_misc;
struct iwinfo_rate_entry rx_rate;
struct iwinfo_rate_entry tx_rate;
uint32_t rx_bytes;
uint32_t tx_bytes;
uint32_t tx_retries;
uint32_t tx_failed;
uint64_t t_offset;
uint8_t is_authorized:1;
uint8_t is_authenticated:1;
uint8_t is_preamble_short:1;
uint8_t is_wme:1;
uint8_t is_mfp:1;
uint8_t is_tdls:1;
uint32_t thr;
uint16_t llid;
uint16_t plid;
char plink_state[16];
char local_ps[16];
char peer_ps[16];
char nonpeer_ps[16];
};
struct iwinfo_survey_entry {
uint64_t active_time;
uint64_t busy_time;
uint64_t busy_time_ext;
uint64_t rxtime;
uint64_t txtime;
uint32_t mhz;
uint8_t noise;
};
struct iwinfo_txpwrlist_entry {
uint8_t dbm;
uint16_t mw;
};
struct iwinfo_freqlist_entry {
uint8_t band;
uint8_t channel;
uint32_t mhz;
uint8_t restricted;
uint32_t flags;
};
struct iwinfo_crypto_entry {
uint8_t enabled;
uint8_t wpa_version;
uint16_t group_ciphers;
uint16_t pair_ciphers;
uint8_t auth_suites;
uint8_t auth_algs;
};
struct iwinfo_scanlist_ht_chan_entry {
uint8_t primary_chan;
uint8_t secondary_chan_off;
uint8_t chan_width;
};
struct iwinfo_scanlist_vht_chan_entry {
uint8_t chan_width;
uint8_t center_chan_1;
uint8_t center_chan_2;
};
extern const char * const ht_secondary_offset[4];
/* 0 = 20 MHz
1 = 40 MHz or higher (refer to vht if supported) */
extern const uint16_t ht_chan_width[2];
/* 0 = 40 MHz or lower (refer to ht to a more precise width)
1 = 80 MHz
2 = 160 MHz
3 = 80+80 MHz */
extern const uint16_t vht_chan_width[4];
struct iwinfo_scanlist_entry {
uint8_t mac[6];
char ssid[IWINFO_ESSID_MAX_SIZE+1];
enum iwinfo_opmode mode;
uint8_t channel;
uint8_t signal;
uint8_t quality;
uint8_t quality_max;
struct iwinfo_crypto_entry crypto;
struct iwinfo_scanlist_ht_chan_entry ht_chan_info;
struct iwinfo_scanlist_vht_chan_entry vht_chan_info;
};
struct iwinfo_country_entry {
uint16_t iso3166;
char ccode[4];
};
struct iwinfo_iso3166_label {
uint16_t iso3166;
const char name[28];
};
struct iwinfo_hardware_id {
uint16_t vendor_id;
uint16_t device_id;
uint16_t subsystem_vendor_id;
uint16_t subsystem_device_id;
char compatible[128];
};
struct iwinfo_hardware_entry {
char vendor_name[64];
char device_name[64];
uint16_t vendor_id;
uint16_t device_id;
uint16_t subsystem_vendor_id;
uint16_t subsystem_device_id;
int16_t txpower_offset;
int16_t frequency_offset;
char compatible[128];
};
extern const struct iwinfo_iso3166_label IWINFO_ISO3166_NAMES[];
#define IWINFO_HARDWARE_FILE "/usr/share/libiwinfo/devices.txt"
struct iwinfo_ops {
const char *name;
int (*probe)(const char *ifname);
int (*mode)(const char *, int *);
int (*channel)(const char *, int *);
int (*center_chan1)(const char *, int *);
int (*center_chan2)(const char *, int *);
int (*frequency)(const char *, int *);
int (*frequency_offset)(const char *, int *);
int (*txpower)(const char *, int *);
int (*txpower_offset)(const char *, int *);
int (*bitrate)(const char *, int *);
int (*signal)(const char *, int *);
int (*noise)(const char *, int *);
int (*quality)(const char *, int *);
int (*quality_max)(const char *, int *);
int (*mbssid_support)(const char *, int *);
int (*hwmodelist)(const char *, int *);
int (*htmodelist)(const char *, int *);
int (*htmode)(const char *, int *);
int (*ssid)(const char *, char *);
int (*bssid)(const char *, char *);
int (*country)(const char *, char *);
int (*hardware_id)(const char *, char *);
int (*hardware_name)(const char *, char *);
int (*encryption)(const char *, char *);
int (*phyname)(const char *, char *);
int (*assoclist)(const char *, char *, int *);
int (*txpwrlist)(const char *, char *, int *);
int (*scanlist)(const char *, char *, int *);
int (*freqlist)(const char *, char *, int *);
int (*countrylist)(const char *, char *, int *);
int (*survey)(const char *, char *, int *);
int (*lookup_phy)(const char *, char *);
int (*phy_path)(const char *phyname, const char **path);
void (*close)(void);
};
const char * iwinfo_type(const char *ifname);
const struct iwinfo_ops * iwinfo_backend(const char *ifname);
const struct iwinfo_ops * iwinfo_backend_by_name(const char *name);
void iwinfo_finish(void);
extern const struct iwinfo_ops wext_ops;
extern const struct iwinfo_ops madwifi_ops;
extern const struct iwinfo_ops nl80211_ops;
extern const struct iwinfo_ops wl_ops;
#include "iwinfo/utils.h"
#endif