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