c76aab706d2071c9f7014b1b387cb95a7cff6e6c
[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 enum iwinfo_80211 {
27 IWINFO_80211_A = 0,
28 IWINFO_80211_B,
29 IWINFO_80211_G,
30 IWINFO_80211_N,
31 IWINFO_80211_AC,
32 IWINFO_80211_AD,
33 IWINFO_80211_AX,
34
35 /* keep last */
36 IWINFO_80211_COUNT
37 };
38
39 #define IWINFO_80211_A (1 << IWINFO_80211_A)
40 #define IWINFO_80211_B (1 << IWINFO_80211_B)
41 #define IWINFO_80211_G (1 << IWINFO_80211_G)
42 #define IWINFO_80211_N (1 << IWINFO_80211_N)
43 #define IWINFO_80211_AC (1 << IWINFO_80211_AC)
44 #define IWINFO_80211_AD (1 << IWINFO_80211_AD)
45 #define IWINFO_80211_AX (1 << IWINFO_80211_AX)
46
47 extern const char * const IWINFO_80211_NAMES[IWINFO_80211_COUNT];
48
49
50 enum iwinfo_band {
51 IWINFO_BAND_24 = 0,
52 IWINFO_BAND_5,
53 IWINFO_BAND_6,
54 IWINFO_BAND_60,
55
56 /* keep last */
57 IWINFO_BAND_COUNT
58 };
59
60 #define IWINFO_BAND_24 (1 << IWINFO_BAND_24)
61 #define IWINFO_BAND_5 (1 << IWINFO_BAND_5)
62 #define IWINFO_BAND_6 (1 << IWINFO_BAND_6)
63 #define IWINFO_BAND_60 (1 << IWINFO_BAND_60)
64
65 extern const char * const IWINFO_BAND_NAMES[IWINFO_BAND_COUNT];
66
67
68 enum iwinfo_cipher {
69 IWINFO_CIPHER_NONE = 0,
70 IWINFO_CIPHER_WEP40,
71 IWINFO_CIPHER_TKIP,
72 IWINFO_CIPHER_WRAP,
73 IWINFO_CIPHER_CCMP,
74 IWINFO_CIPHER_WEP104,
75 IWINFO_CIPHER_AESOCB,
76 IWINFO_CIPHER_CKIP,
77 IWINFO_CIPHER_GCMP,
78 IWINFO_CIPHER_CCMP256,
79 IWINFO_CIPHER_GCMP256,
80
81 /* keep last */
82 IWINFO_CIPHER_COUNT
83 };
84
85 #define IWINFO_CIPHER_NONE (1 << IWINFO_CIPHER_NONE)
86 #define IWINFO_CIPHER_WEP40 (1 << IWINFO_CIPHER_WEP40)
87 #define IWINFO_CIPHER_TKIP (1 << IWINFO_CIPHER_TKIP)
88 #define IWINFO_CIPHER_WRAP (1 << IWINFO_CIPHER_WRAP)
89 #define IWINFO_CIPHER_CCMP (1 << IWINFO_CIPHER_CCMP)
90 #define IWINFO_CIPHER_WEP104 (1 << IWINFO_CIPHER_WEP104)
91 #define IWINFO_CIPHER_AESOCB (1 << IWINFO_CIPHER_AESOCB)
92 #define IWINFO_CIPHER_CKIP (1 << IWINFO_CIPHER_CKIP)
93 #define IWINFO_CIPHER_GCMP (1 << IWINFO_CIPHER_GCMP)
94 #define IWINFO_CIPHER_CCMP256 (1 << IWINFO_CIPHER_CCMP256)
95 #define IWINFO_CIPHER_GCMP256 (1 << IWINFO_CIPHER_GCMP256)
96
97 extern const char * const IWINFO_CIPHER_NAMES[IWINFO_CIPHER_COUNT];
98
99
100 enum iwinfo_kmgmt {
101 IWINFO_KMGMT_NONE = 0,
102 IWINFO_KMGMT_8021x,
103 IWINFO_KMGMT_PSK,
104 IWINFO_KMGMT_SAE,
105 IWINFO_KMGMT_OWE,
106
107 /* keep last */
108 IWINFO_KMGMT_COUNT
109 };
110
111 #define IWINFO_KMGMT_NONE (1 << IWINFO_KMGMT_NONE)
112 #define IWINFO_KMGMT_8021x (1 << IWINFO_KMGMT_8021x)
113 #define IWINFO_KMGMT_PSK (1 << IWINFO_KMGMT_PSK)
114 #define IWINFO_KMGMT_SAE (1 << IWINFO_KMGMT_SAE)
115 #define IWINFO_KMGMT_OWE (1 << IWINFO_KMGMT_OWE)
116
117 extern const char * const IWINFO_KMGMT_NAMES[IWINFO_KMGMT_COUNT];
118
119
120 enum iwinfo_auth {
121 IWINFO_AUTH_OPEN = 0,
122 IWINFO_AUTH_SHARED,
123
124 /* keep last */
125 IWINFO_AUTH_COUNT
126 };
127
128 extern const char * const IWINFO_AUTH_NAMES[IWINFO_AUTH_COUNT];
129
130
131 enum iwinfo_freq_flag {
132 IWINFO_FREQ_NO_10MHZ = 0,
133 IWINFO_FREQ_NO_20MHZ,
134 IWINFO_FREQ_NO_HT40PLUS,
135 IWINFO_FREQ_NO_HT40MINUS,
136 IWINFO_FREQ_NO_80MHZ,
137 IWINFO_FREQ_NO_160MHZ,
138 IWINFO_FREQ_NO_HE,
139 IWINFO_FREQ_NO_IR,
140 IWINFO_FREQ_INDOOR_ONLY,
141
142 /* keep last */
143 IWINFO_FREQ_FLAG_COUNT,
144 };
145
146 #define IWINFO_FREQ_NO_10MHZ (1 << IWINFO_FREQ_NO_10MHZ)
147 #define IWINFO_FREQ_NO_20MHZ (1 << IWINFO_FREQ_NO_20MHZ)
148 #define IWINFO_FREQ_NO_HT40PLUS (1 << IWINFO_FREQ_NO_HT40PLUS)
149 #define IWINFO_FREQ_NO_HT40MINUS (1 << IWINFO_FREQ_NO_HT40MINUS)
150 #define IWINFO_FREQ_NO_80MHZ (1 << IWINFO_FREQ_NO_80MHZ)
151 #define IWINFO_FREQ_NO_160MHZ (1 << IWINFO_FREQ_NO_160MHZ)
152 #define IWINFO_FREQ_NO_HE (1 << IWINFO_FREQ_NO_HE)
153 #define IWINFO_FREQ_NO_IR (1 << IWINFO_FREQ_NO_IR)
154 #define IWINFO_FREQ_INDOOR_ONLY (1 << IWINFO_FREQ_INDOOR_ONLY)
155
156
157 enum iwinfo_opmode {
158 IWINFO_OPMODE_UNKNOWN = 0,
159 IWINFO_OPMODE_MASTER,
160 IWINFO_OPMODE_ADHOC,
161 IWINFO_OPMODE_CLIENT,
162 IWINFO_OPMODE_MONITOR,
163 IWINFO_OPMODE_AP_VLAN,
164 IWINFO_OPMODE_WDS,
165 IWINFO_OPMODE_MESHPOINT,
166 IWINFO_OPMODE_P2P_CLIENT,
167 IWINFO_OPMODE_P2P_GO,
168
169 /* keep last */
170 IWINFO_OPMODE_COUNT
171 };
172
173 extern const char * const IWINFO_OPMODE_NAMES[IWINFO_OPMODE_COUNT];
174
175
176 enum iwinfo_htmode {
177 IWINFO_HTMODE_HT20 = 0,
178 IWINFO_HTMODE_HT40,
179 IWINFO_HTMODE_VHT20,
180 IWINFO_HTMODE_VHT40,
181 IWINFO_HTMODE_VHT80,
182 IWINFO_HTMODE_VHT80_80,
183 IWINFO_HTMODE_VHT160,
184 IWINFO_HTMODE_NOHT,
185 IWINFO_HTMODE_HE20,
186 IWINFO_HTMODE_HE40,
187 IWINFO_HTMODE_HE80,
188 IWINFO_HTMODE_HE80_80,
189 IWINFO_HTMODE_HE160,
190
191 /* keep last */
192 IWINFO_HTMODE_COUNT
193 };
194
195 #define IWINFO_HTMODE_HT20 (1 << IWINFO_HTMODE_HT20)
196 #define IWINFO_HTMODE_HT40 (1 << IWINFO_HTMODE_HT40)
197 #define IWINFO_HTMODE_VHT20 (1 << IWINFO_HTMODE_VHT20)
198 #define IWINFO_HTMODE_VHT40 (1 << IWINFO_HTMODE_VHT40)
199 #define IWINFO_HTMODE_VHT80 (1 << IWINFO_HTMODE_VHT80)
200 #define IWINFO_HTMODE_VHT80_80 (1 << IWINFO_HTMODE_VHT80_80)
201 #define IWINFO_HTMODE_VHT160 (1 << IWINFO_HTMODE_VHT160)
202 #define IWINFO_HTMODE_NOHT (1 << IWINFO_HTMODE_NOHT)
203 #define IWINFO_HTMODE_HE20 (1 << IWINFO_HTMODE_HE20)
204 #define IWINFO_HTMODE_HE40 (1 << IWINFO_HTMODE_HE40)
205 #define IWINFO_HTMODE_HE80 (1 << IWINFO_HTMODE_HE80)
206 #define IWINFO_HTMODE_HE80_80 (1 << IWINFO_HTMODE_HE80_80)
207 #define IWINFO_HTMODE_HE160 (1 << IWINFO_HTMODE_HE160)
208
209 extern const char * const IWINFO_HTMODE_NAMES[IWINFO_HTMODE_COUNT];
210
211
212 struct iwinfo_rate_entry {
213 uint32_t rate;
214 int8_t mcs;
215 uint8_t is_40mhz:1;
216 uint8_t is_short_gi:1;
217 uint8_t is_ht:1;
218 uint8_t is_vht:1;
219 uint8_t is_he:1;
220 uint8_t he_gi;
221 uint8_t he_dcm;
222 uint8_t mhz;
223 uint8_t nss;
224 };
225
226 struct iwinfo_assoclist_entry {
227 uint8_t mac[6];
228 int8_t signal;
229 int8_t signal_avg;
230 int8_t noise;
231 uint32_t inactive;
232 uint32_t connected_time;
233 uint32_t rx_packets;
234 uint32_t tx_packets;
235 uint64_t rx_drop_misc;
236 struct iwinfo_rate_entry rx_rate;
237 struct iwinfo_rate_entry tx_rate;
238 uint32_t rx_bytes;
239 uint32_t tx_bytes;
240 uint32_t tx_retries;
241 uint32_t tx_failed;
242 uint64_t t_offset;
243 uint8_t is_authorized:1;
244 uint8_t is_authenticated:1;
245 uint8_t is_preamble_short:1;
246 uint8_t is_wme:1;
247 uint8_t is_mfp:1;
248 uint8_t is_tdls:1;
249 uint32_t thr;
250 uint16_t llid;
251 uint16_t plid;
252 char plink_state[16];
253 char local_ps[16];
254 char peer_ps[16];
255 char nonpeer_ps[16];
256 };
257
258 struct iwinfo_survey_entry {
259 uint64_t active_time;
260 uint64_t busy_time;
261 uint64_t busy_time_ext;
262 uint64_t rxtime;
263 uint64_t txtime;
264 uint32_t mhz;
265 uint8_t noise;
266 };
267
268 struct iwinfo_txpwrlist_entry {
269 uint8_t dbm;
270 uint16_t mw;
271 };
272
273 struct iwinfo_freqlist_entry {
274 uint8_t band;
275 uint8_t channel;
276 uint32_t mhz;
277 uint8_t restricted;
278 uint32_t flags;
279 };
280
281 struct iwinfo_crypto_entry {
282 uint8_t enabled;
283 uint8_t wpa_version;
284 uint16_t group_ciphers;
285 uint16_t pair_ciphers;
286 uint8_t auth_suites;
287 uint8_t auth_algs;
288 };
289
290 struct iwinfo_scanlist_ht_chan_entry {
291 uint8_t primary_chan;
292 uint8_t secondary_chan_off;
293 uint8_t chan_width;
294 };
295
296 struct iwinfo_scanlist_vht_chan_entry {
297 uint8_t chan_width;
298 uint8_t center_chan_1;
299 uint8_t center_chan_2;
300 };
301
302 extern const char * const ht_secondary_offset[4];
303 /* 0 = 20 MHz
304 1 = 40 MHz or higher (refer to vht if supported) */
305 extern const uint16_t ht_chan_width[2];
306 /* 0 = 40 MHz or lower (refer to ht to a more precise width)
307 1 = 80 MHz
308 2 = 160 MHz
309 3 = 80+80 MHz */
310 extern const uint16_t vht_chan_width[4];
311
312 struct iwinfo_scanlist_entry {
313 uint8_t mac[6];
314 char ssid[IWINFO_ESSID_MAX_SIZE+1];
315 enum iwinfo_opmode mode;
316 uint8_t band;
317 uint8_t channel;
318 uint32_t mhz;
319 uint8_t signal;
320 uint8_t quality;
321 uint8_t quality_max;
322 struct iwinfo_crypto_entry crypto;
323 struct iwinfo_scanlist_ht_chan_entry ht_chan_info;
324 struct iwinfo_scanlist_vht_chan_entry vht_chan_info;
325 };
326
327 struct iwinfo_country_entry {
328 uint16_t iso3166;
329 char ccode[4];
330 };
331
332 struct iwinfo_iso3166_label {
333 uint16_t iso3166;
334 const char name[28];
335 };
336
337 struct iwinfo_hardware_id {
338 uint16_t vendor_id;
339 uint16_t device_id;
340 uint16_t subsystem_vendor_id;
341 uint16_t subsystem_device_id;
342 char compatible[128];
343 };
344
345 struct iwinfo_hardware_entry {
346 char vendor_name[64];
347 char device_name[64];
348 uint16_t vendor_id;
349 uint16_t device_id;
350 uint16_t subsystem_vendor_id;
351 uint16_t subsystem_device_id;
352 int16_t txpower_offset;
353 int16_t frequency_offset;
354 char compatible[128];
355 };
356
357 extern const struct iwinfo_iso3166_label IWINFO_ISO3166_NAMES[];
358
359 #define IWINFO_HARDWARE_FILE "/usr/share/libiwinfo/devices.txt"
360
361
362 struct iwinfo_ops {
363 const char *name;
364
365 int (*probe)(const char *ifname);
366 int (*mode)(const char *, int *);
367 int (*channel)(const char *, int *);
368 int (*center_chan1)(const char *, int *);
369 int (*center_chan2)(const char *, int *);
370 int (*frequency)(const char *, int *);
371 int (*frequency_offset)(const char *, int *);
372 int (*txpower)(const char *, int *);
373 int (*txpower_offset)(const char *, int *);
374 int (*bitrate)(const char *, int *);
375 int (*signal)(const char *, int *);
376 int (*noise)(const char *, int *);
377 int (*quality)(const char *, int *);
378 int (*quality_max)(const char *, int *);
379 int (*mbssid_support)(const char *, int *);
380 int (*hwmodelist)(const char *, int *);
381 int (*htmodelist)(const char *, int *);
382 int (*htmode)(const char *, int *);
383 int (*ssid)(const char *, char *);
384 int (*bssid)(const char *, char *);
385 int (*country)(const char *, char *);
386 int (*hardware_id)(const char *, char *);
387 int (*hardware_name)(const char *, char *);
388 int (*encryption)(const char *, char *);
389 int (*phyname)(const char *, char *);
390 int (*assoclist)(const char *, char *, int *);
391 int (*txpwrlist)(const char *, char *, int *);
392 int (*scanlist)(const char *, char *, int *);
393 int (*freqlist)(const char *, char *, int *);
394 int (*countrylist)(const char *, char *, int *);
395 int (*survey)(const char *, char *, int *);
396 int (*lookup_phy)(const char *, char *);
397 int (*phy_path)(const char *phyname, const char **path);
398 void (*close)(void);
399 };
400
401 const char * iwinfo_type(const char *ifname);
402 const struct iwinfo_ops * iwinfo_backend(const char *ifname);
403 const struct iwinfo_ops * iwinfo_backend_by_name(const char *name);
404 void iwinfo_finish(void);
405
406 extern const struct iwinfo_ops wext_ops;
407 extern const struct iwinfo_ops madwifi_ops;
408 extern const struct iwinfo_ops nl80211_ops;
409 extern const struct iwinfo_ops wl_ops;
410
411 #include "iwinfo/utils.h"
412
413 #endif