fee665cc5266baf273c08c6332a9baaae3052621
[project/iwinfo.git] / include / iwinfo.h
1 #ifndef __IWINFO_H_
2 #define __IWINFO_H_
3
4 #include <sys/types.h>
5 #include <sys/stat.h>
6 #include <sys/wait.h>
7 #include <unistd.h>
8 #include <stdio.h>
9 #include <stdlib.h>
10 #include <string.h>
11 #include <fcntl.h>
12 #include <glob.h>
13 #include <ctype.h>
14 #include <dirent.h>
15 #include <stdint.h>
16
17 #include <sys/ioctl.h>
18 #include <sys/mman.h>
19 #include <net/if.h>
20 #include <errno.h>
21
22
23 #define IWINFO_BUFSIZE 24 * 1024
24 #define IWINFO_ESSID_MAX_SIZE 32
25
26 #define IWINFO_80211_A (1 << 0)
27 #define IWINFO_80211_B (1 << 1)
28 #define IWINFO_80211_G (1 << 2)
29 #define IWINFO_80211_N (1 << 3)
30 #define IWINFO_80211_AC (1 << 4)
31 #define IWINFO_80211_AD (1 << 5)
32 #define IWINFO_80211_AX (1 << 6)
33
34 #define IWINFO_BAND_24 (1 << 0)
35 #define IWINFO_BAND_5 (1 << 1)
36 #define IWINFO_BAND_6 (1 << 2)
37 #define IWINFO_BAND_60 (1 << 3)
38 #define IWINFO_BAND_COUNT 4
39
40 #define IWINFO_CIPHER_NONE (1 << 0)
41 #define IWINFO_CIPHER_WEP40 (1 << 1)
42 #define IWINFO_CIPHER_TKIP (1 << 2)
43 #define IWINFO_CIPHER_WRAP (1 << 3)
44 #define IWINFO_CIPHER_CCMP (1 << 4)
45 #define IWINFO_CIPHER_WEP104 (1 << 5)
46 #define IWINFO_CIPHER_AESOCB (1 << 6)
47 #define IWINFO_CIPHER_CKIP (1 << 7)
48 #define IWINFO_CIPHER_GCMP (1 << 8)
49 #define IWINFO_CIPHER_CCMP256 (1 << 9)
50 #define IWINFO_CIPHER_GCMP256 (1 << 10)
51 #define IWINFO_CIPHER_COUNT 11
52
53 #define IWINFO_KMGMT_NONE (1 << 0)
54 #define IWINFO_KMGMT_8021x (1 << 1)
55 #define IWINFO_KMGMT_PSK (1 << 2)
56 #define IWINFO_KMGMT_SAE (1 << 3)
57 #define IWINFO_KMGMT_OWE (1 << 4)
58 #define IWINFO_KMGMT_COUNT 5
59
60 #define IWINFO_AUTH_OPEN (1 << 0)
61 #define IWINFO_AUTH_SHARED (1 << 1)
62 #define IWINFO_AUTH_COUNT 2
63
64 #define IWINFO_FREQ_NO_10MHZ (1 << 0)
65 #define IWINFO_FREQ_NO_20MHZ (1 << 1)
66 #define IWINFO_FREQ_NO_HT40PLUS (1 << 2)
67 #define IWINFO_FREQ_NO_HT40MINUS (1 << 3)
68 #define IWINFO_FREQ_NO_80MHZ (1 << 4)
69 #define IWINFO_FREQ_NO_160MHZ (1 << 5)
70 #define IWINFO_FREQ_NO_HE (1 << 6)
71
72 extern const char * const IWINFO_BAND_NAMES[IWINFO_BAND_COUNT];
73 extern const char * const IWINFO_CIPHER_NAMES[IWINFO_CIPHER_COUNT];
74 extern const char * const IWINFO_KMGMT_NAMES[IWINFO_KMGMT_COUNT];
75 extern const char * const IWINFO_AUTH_NAMES[IWINFO_AUTH_COUNT];
76
77
78 enum iwinfo_opmode {
79 IWINFO_OPMODE_UNKNOWN = 0,
80 IWINFO_OPMODE_MASTER = 1,
81 IWINFO_OPMODE_ADHOC = 2,
82 IWINFO_OPMODE_CLIENT = 3,
83 IWINFO_OPMODE_MONITOR = 4,
84 IWINFO_OPMODE_AP_VLAN = 5,
85 IWINFO_OPMODE_WDS = 6,
86 IWINFO_OPMODE_MESHPOINT = 7,
87 IWINFO_OPMODE_P2P_CLIENT = 8,
88 IWINFO_OPMODE_P2P_GO = 9,
89
90 IWINFO_OPMODE_COUNT = 10,
91 };
92
93 extern const char * const IWINFO_OPMODE_NAMES[IWINFO_OPMODE_COUNT];
94
95
96 enum iwinfo_htmode {
97 IWINFO_HTMODE_HT20 = (1 << 0),
98 IWINFO_HTMODE_HT40 = (1 << 1),
99 IWINFO_HTMODE_VHT20 = (1 << 2),
100 IWINFO_HTMODE_VHT40 = (1 << 3),
101 IWINFO_HTMODE_VHT80 = (1 << 4),
102 IWINFO_HTMODE_VHT80_80 = (1 << 5),
103 IWINFO_HTMODE_VHT160 = (1 << 6),
104 IWINFO_HTMODE_NOHT = (1 << 7),
105 IWINFO_HTMODE_HE20 = (1 << 8),
106 IWINFO_HTMODE_HE40 = (1 << 9),
107 IWINFO_HTMODE_HE80 = (1 << 10),
108 IWINFO_HTMODE_HE80_80 = (1 << 11),
109 IWINFO_HTMODE_HE160 = (1 << 12),
110
111 IWINFO_HTMODE_COUNT = 13
112 };
113
114 extern const char * const IWINFO_HTMODE_NAMES[IWINFO_HTMODE_COUNT];
115
116
117 struct iwinfo_rate_entry {
118 uint32_t rate;
119 int8_t mcs;
120 uint8_t is_40mhz:1;
121 uint8_t is_short_gi:1;
122 uint8_t is_ht:1;
123 uint8_t is_vht:1;
124 uint8_t is_he:1;
125 uint8_t he_gi;
126 uint8_t he_dcm;
127 uint8_t mhz;
128 uint8_t nss;
129 };
130
131 struct iwinfo_assoclist_entry {
132 uint8_t mac[6];
133 int8_t signal;
134 int8_t signal_avg;
135 int8_t noise;
136 uint32_t inactive;
137 uint32_t connected_time;
138 uint32_t rx_packets;
139 uint32_t tx_packets;
140 uint64_t rx_drop_misc;
141 struct iwinfo_rate_entry rx_rate;
142 struct iwinfo_rate_entry tx_rate;
143 uint32_t rx_bytes;
144 uint32_t tx_bytes;
145 uint32_t tx_retries;
146 uint32_t tx_failed;
147 uint64_t t_offset;
148 uint8_t is_authorized:1;
149 uint8_t is_authenticated:1;
150 uint8_t is_preamble_short:1;
151 uint8_t is_wme:1;
152 uint8_t is_mfp:1;
153 uint8_t is_tdls:1;
154 uint32_t thr;
155 uint16_t llid;
156 uint16_t plid;
157 char plink_state[16];
158 char local_ps[16];
159 char peer_ps[16];
160 char nonpeer_ps[16];
161 };
162
163 struct iwinfo_survey_entry {
164 uint64_t active_time;
165 uint64_t busy_time;
166 uint64_t busy_time_ext;
167 uint64_t rxtime;
168 uint64_t txtime;
169 uint32_t mhz;
170 uint8_t noise;
171 };
172
173 struct iwinfo_txpwrlist_entry {
174 uint8_t dbm;
175 uint16_t mw;
176 };
177
178 struct iwinfo_freqlist_entry {
179 uint8_t channel;
180 uint32_t mhz;
181 uint8_t restricted;
182 uint32_t flags;
183 };
184
185 struct iwinfo_crypto_entry {
186 uint8_t enabled;
187 uint8_t wpa_version;
188 uint16_t group_ciphers;
189 uint16_t pair_ciphers;
190 uint8_t auth_suites;
191 uint8_t auth_algs;
192 };
193
194 struct iwinfo_scanlist_ht_chan_entry {
195 uint8_t primary_chan;
196 uint8_t secondary_chan_off;
197 uint8_t chan_width;
198 };
199
200 struct iwinfo_scanlist_vht_chan_entry {
201 uint8_t chan_width;
202 uint8_t center_chan_1;
203 uint8_t center_chan_2;
204 };
205
206 extern const char * const ht_secondary_offset[4];
207 /* 0 = 20 MHz
208 1 = 40 MHz or higher (refer to vht if supported) */
209 extern const uint16_t ht_chan_width[2];
210 /* 0 = 40 MHz or lower (refer to ht to a more precise width)
211 1 = 80 MHz
212 2 = 160 MHz
213 3 = 80+80 MHz */
214 extern const uint16_t vht_chan_width[4];
215
216 struct iwinfo_scanlist_entry {
217 uint8_t mac[6];
218 char ssid[IWINFO_ESSID_MAX_SIZE+1];
219 enum iwinfo_opmode mode;
220 uint8_t channel;
221 uint8_t signal;
222 uint8_t quality;
223 uint8_t quality_max;
224 struct iwinfo_crypto_entry crypto;
225 struct iwinfo_scanlist_ht_chan_entry ht_chan_info;
226 struct iwinfo_scanlist_vht_chan_entry vht_chan_info;
227 };
228
229 struct iwinfo_country_entry {
230 uint16_t iso3166;
231 char ccode[4];
232 };
233
234 struct iwinfo_iso3166_label {
235 uint16_t iso3166;
236 const char name[28];
237 };
238
239 struct iwinfo_hardware_id {
240 uint16_t vendor_id;
241 uint16_t device_id;
242 uint16_t subsystem_vendor_id;
243 uint16_t subsystem_device_id;
244 };
245
246 struct iwinfo_hardware_entry {
247 char vendor_name[64];
248 char device_name[64];
249 uint16_t vendor_id;
250 uint16_t device_id;
251 uint16_t subsystem_vendor_id;
252 uint16_t subsystem_device_id;
253 int16_t txpower_offset;
254 int16_t frequency_offset;
255 };
256
257 extern const struct iwinfo_iso3166_label IWINFO_ISO3166_NAMES[];
258
259 #define IWINFO_HARDWARE_FILE "/usr/share/libiwinfo/devices.txt"
260
261
262 struct iwinfo_ops {
263 const char *name;
264
265 int (*probe)(const char *ifname);
266 int (*mode)(const char *, int *);
267 int (*channel)(const char *, int *);
268 int (*center_chan1)(const char *, int *);
269 int (*center_chan2)(const char *, int *);
270 int (*frequency)(const char *, int *);
271 int (*frequency_offset)(const char *, int *);
272 int (*txpower)(const char *, int *);
273 int (*txpower_offset)(const char *, int *);
274 int (*bitrate)(const char *, int *);
275 int (*signal)(const char *, int *);
276 int (*noise)(const char *, int *);
277 int (*quality)(const char *, int *);
278 int (*quality_max)(const char *, int *);
279 int (*mbssid_support)(const char *, int *);
280 int (*hwmodelist)(const char *, int *);
281 int (*htmodelist)(const char *, int *);
282 int (*htmode)(const char *, int *);
283 int (*ssid)(const char *, char *);
284 int (*bssid)(const char *, char *);
285 int (*country)(const char *, char *);
286 int (*hardware_id)(const char *, char *);
287 int (*hardware_name)(const char *, char *);
288 int (*encryption)(const char *, char *);
289 int (*phyname)(const char *, char *);
290 int (*assoclist)(const char *, char *, int *);
291 int (*txpwrlist)(const char *, char *, int *);
292 int (*scanlist)(const char *, char *, int *);
293 int (*freqlist)(const char *, char *, int *);
294 int (*countrylist)(const char *, char *, int *);
295 int (*survey)(const char *, char *, int *);
296 int (*lookup_phy)(const char *, char *);
297 int (*phy_path)(const char *phyname, const char **path);
298 void (*close)(void);
299 };
300
301 const char * iwinfo_type(const char *ifname);
302 const struct iwinfo_ops * iwinfo_backend(const char *ifname);
303 const struct iwinfo_ops * iwinfo_backend_by_name(const char *name);
304 void iwinfo_finish(void);
305
306 extern const struct iwinfo_ops wext_ops;
307 extern const struct iwinfo_ops madwifi_ops;
308 extern const struct iwinfo_ops nl80211_ops;
309 extern const struct iwinfo_ops wl_ops;
310
311 #include "iwinfo/utils.h"
312
313 #endif