]> git.ipfire.org Git - thirdparty/iw.git/blame - iw.h
iw: support 160MHz frequency command for 6GHz band
[thirdparty/iw.git] / iw.h
CommitLineData
cad53b3f
JB
1#ifndef __IW_H
2#define __IW_H
3
7fabd346 4#include <stdbool.h>
45d543f0 5#include <netlink/netlink.h>
cad53b3f
JB
6#include <netlink/genl/genl.h>
7#include <netlink/genl/family.h>
8#include <netlink/genl/ctrl.h>
a82abc2c 9#include <endian.h>
cad53b3f 10
f408e01b 11#include "nl80211.h"
a82abc2c 12#include "ieee80211.h"
f408e01b 13
50918cbb
GS
14#ifndef NL_CAPABILITY_VERSION_3_5_0
15#define nla_nest_start(msg, attrtype) \
16 nla_nest_start(msg, NLA_F_NESTED | (attrtype))
17#endif
18
3a807325
JB
19/* support for extack if compilation headers are too old */
20#ifndef NETLINK_EXT_ACK
21#define NETLINK_EXT_ACK 11
22enum nlmsgerr_attrs {
23 NLMSGERR_ATTR_UNUSED,
24 NLMSGERR_ATTR_MSG,
25 NLMSGERR_ATTR_OFFS,
26 NLMSGERR_ATTR_COOKIE,
27
28 __NLMSGERR_ATTR_MAX,
29 NLMSGERR_ATTR_MAX = __NLMSGERR_ATTR_MAX - 1
30};
31#endif
32#ifndef NLM_F_CAPPED
33#define NLM_F_CAPPED 0x100
34#endif
35#ifndef NLM_F_ACK_TLVS
36#define NLM_F_ACK_TLVS 0x200
37#endif
86da57ad
JB
38#ifndef SOL_NETLINK
39#define SOL_NETLINK 270
40#endif
3a807325 41
3d1e8704 42#define ETH_ALEN 6
386bacb2 43#define VHT_MUMIMO_GROUP_LEN 24
3d1e8704 44
ded667b0
YY
45/* libnl 1.x compatibility code */
46#if !defined(CONFIG_LIBNL20) && !defined(CONFIG_LIBNL30)
57077d64 47# define nl_sock nl_handle
dfd13ee5 48#endif
57077d64
PE
49
50struct nl80211_state {
51 struct nl_sock *nl_sock;
f09cee6d 52 int nl80211_id;
cad53b3f
JB
53};
54
bd396f2a
JB
55enum command_identify_by {
56 CIB_NONE,
57 CIB_PHY,
58 CIB_NETDEV,
290a3dd4 59 CIB_WDEV,
7c37a24d
JB
60};
61
62enum id_input {
63 II_NONE,
64 II_NETDEV,
65 II_PHY_NAME,
66 II_PHY_IDX,
290a3dd4 67 II_WDEV,
bd396f2a 68};
45c7212c 69
b2c4bf45 70#define HANDLER_RET_USAGE 1
94af668b
JB
71#define HANDLER_RET_DONE 3
72
bd396f2a 73struct cmd {
bd396f2a
JB
74 const char *name;
75 const char *args;
01ae06f9 76 const char *help;
bd396f2a
JB
77 const enum nl80211_commands cmd;
78 int nl_msg_flags;
ce5af55c 79 int hidden;
bd396f2a 80 const enum command_identify_by idby;
5e75fd04
JB
81 /*
82 * The handler should return a negative error code,
86a9801f
OO
83 * zero on success, 1 if the arguments were wrong.
84 * Return 2 iff you provide the error message yourself.
5e75fd04 85 */
7c37a24d 86 int (*handler)(struct nl80211_state *state,
bd396f2a 87 struct nl_msg *msg,
05514f95
JB
88 int argc, char **argv,
89 enum id_input id);
1633ddf7 90 const struct cmd *(*selector)(int argc, char **argv);
4698bfc2 91 const struct cmd *parent;
bd396f2a 92};
3d1e8704 93
c1b2b633
SE
94struct chanmode {
95 const char *name;
96 unsigned int width;
97 int freq1_diff;
98 int chantype; /* for older kernel */
99};
100
997c60fd
BB
101struct chandef {
102 enum nl80211_chan_width width;
103
104 unsigned int control_freq;
105 unsigned int center_freq1;
106 unsigned int center_freq2;
107};
108
7d736016 109#define ARRAY_SIZE(ar) (sizeof(ar)/sizeof(ar[0]))
3ff24563 110#define DIV_ROUND_UP(x, y) (((x) + (y - 1)) / (y))
7d736016 111
1633ddf7 112#define __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel)\
78bebb71 113 static struct cmd \
338059ac 114 __cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden = {\
9b92e691
JB
115 .name = (_name), \
116 .args = (_args), \
117 .cmd = (_nlcmd), \
118 .nl_msg_flags = (_flags), \
119 .hidden = (_hidden), \
120 .idby = (_idby), \
121 .handler = (_handler), \
01ae06f9 122 .help = (_help), \
4698bfc2 123 .parent = _section, \
1633ddf7 124 .selector = (_sel), \
338059ac
JB
125 }; \
126 static struct cmd *__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden ## _p \
127 __attribute__((used,section("__cmd"))) = \
128 &__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
1633ddf7
JB
129#define __ACMD(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel, _alias)\
130 __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel);\
131 static const struct cmd *_alias = &__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
01ae06f9 132#define COMMAND(section, name, args, cmd, flags, idby, handler, help) \
1633ddf7
JB
133 __COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, NULL)
134#define COMMAND_ALIAS(section, name, args, cmd, flags, idby, handler, help, selector, alias)\
135 __ACMD(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, selector, alias)
01ae06f9 136#define HIDDEN(section, name, args, cmd, flags, idby, handler) \
1633ddf7 137 __COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 1, idby, handler, NULL, NULL)
4698bfc2
JB
138
139#define TOPLEVEL(_name, _args, _nlcmd, _flags, _idby, _handler, _help) \
338059ac 140 struct cmd __section ## _ ## _name = { \
4698bfc2
JB
141 .name = (#_name), \
142 .args = (_args), \
143 .cmd = (_nlcmd), \
144 .nl_msg_flags = (_flags), \
145 .idby = (_idby), \
146 .handler = (_handler), \
147 .help = (_help), \
338059ac
JB
148 }; \
149 static struct cmd *__section ## _ ## _name ## _p \
150 __attribute__((used,section("__cmd"))) = &__section ## _ ## _name
151
4698bfc2 152#define SECTION(_name) \
338059ac 153 struct cmd __section ## _ ## _name = { \
4698bfc2
JB
154 .name = (#_name), \
155 .hidden = 1, \
338059ac
JB
156 }; \
157 static struct cmd *__section ## _ ## _name ## _p \
158 __attribute__((used,section("__cmd"))) = &__section ## _ ## _name
4698bfc2
JB
159
160#define DECLARE_SECTION(_name) \
78bebb71 161 extern struct cmd __section ## _ ## _name;
14a0380d 162
8e58fe92
JB
163struct vendor_event {
164 unsigned int vendor_id, subcmd;
165 void (*callback)(unsigned int vendor_id, unsigned int subcmd,
166 struct nlattr *data);
167};
168
169#define VENDOR_EVENT(_id, _subcmd, _callback) \
f71bd68b 170 static const struct vendor_event \
8e58fe92
JB
171 vendor_event_ ## _id ## _ ## _subcmd = { \
172 .vendor_id = _id, \
173 .subcmd = _subcmd, \
174 .callback = _callback, \
175 }, * const vendor_event_ ## _id ## _ ## _subcmd ## _p \
176 __attribute__((used,section("vendor_event"))) = \
177 &vendor_event_ ## _id ## _ ## _subcmd
178
133b069f 179extern const char iw_version[];
7c37a24d 180
957a0f07
JB
181extern int iw_debug;
182
7c37a24d
JB
183int handle_cmd(struct nl80211_state *state, enum id_input idby,
184 int argc, char **argv);
7fabd346
JB
185
186struct print_event_args {
981b21ad
JB
187 struct timeval ts; /* internal */
188 bool have_ts; /* must be set false */
c3df363e 189 bool frame, time, reltime, ctime;
7fabd346
JB
190};
191
72041aa0
JB
192__u32 listen_events(struct nl80211_state *state,
193 const int n_waits, const __u32 *waits);
ee374e4d
JB
194int __prepare_listen_events(struct nl80211_state *state);
195__u32 __do_listen_events(struct nl80211_state *state,
196 const int n_waits, const __u32 *waits,
2e192cea 197 const int n_prints, const __u32 *prints,
ee374e4d 198 struct print_event_args *args);
7c37a24d 199
34b23014
JB
200int valid_handler(struct nl_msg *msg, void *arg);
201void register_handler(int (*handler)(struct nl_msg *, void *), void *data);
7c37a24d 202
3d1e8704 203int mac_addr_a2n(unsigned char *mac_addr, char *arg);
7f87d3cf 204void mac_addr_n2a(char *mac_addr, const unsigned char *arg);
3ff24563
JB
205int parse_hex_mask(char *hexmask, unsigned char **result, size_t *result_len,
206 unsigned char **mask);
236d4191 207unsigned char *parse_hex(char *hex, size_t *outlen);
3d1e8704 208
0e39f109 209int parse_keys(struct nl_msg *msg, char **argv[], int *argc);
997c60fd 210int parse_freqchan(struct chandef *chandef, bool chan, int argc, char **argv, int *parsed);
c37f6c64 211enum nl80211_chan_width str_to_bw(const char *str);
910792c0
THJ
212int parse_txq_stats(char *buf, int buflen, struct nlattr *tid_stats_attr, int header,
213 int tid, const char *indent);
997c60fd 214int put_chandef(struct nl_msg *msg, struct chandef *chandef);
51e9bd80 215
7ddfb679 216void print_ht_mcs(const __u8 *mcs);
0950993f
LR
217void print_ampdu_length(__u8 exponent);
218void print_ampdu_spacing(__u8 spacing);
357c1a5d 219void print_ht_capability(__u16 cap);
54eb1613 220void print_vht_info(__u32 capa, const __u8 *mcs);
17e8564a 221void print_he_capability(const uint8_t *ie, int len);
c741be9f 222void print_he_info(struct nlattr *nl_iftype);
deb3501c 223
c5df9eb6 224char *channel_width_name(enum nl80211_chan_width width);
541ef425 225const char *iftype_name(enum nl80211_iftype iftype);
a6cedc6d
JB
226void print_iftype_list(const char *name, const char *pfx, struct nlattr *attr);
227void print_iftype_line(struct nlattr *attr);
9990c1e9 228const char *command_name(enum nl80211_commands cmd);
58b46da2 229int ieee80211_channel_to_frequency(int chan, enum nl80211_band band);
379f8397 230int ieee80211_frequency_to_channel(int freq);
541ef425 231
748f8489
JB
232void print_ssid_escaped(const uint8_t len, const uint8_t *data);
233
57077d64 234int nl_get_multicast_id(struct nl_sock *sock, const char *family, const char *group);
2c61ba61 235
601c6ab2
LR
236char *reg_initiator_to_string(__u8 initiator);
237
27c49ed6 238const char *get_reason_str(uint16_t reason);
22c7d879 239const char *get_status_str(uint16_t status);
27c49ed6 240
febeb0c0
JB
241enum print_ie_type {
242 PRINT_SCAN,
243 PRINT_LINK,
244};
245
246#define BIT(x) (1ULL<<(x))
247
248void print_ies(unsigned char *ie, int ielen, bool unknown,
249 enum print_ie_type ptype);
250
e94f0201 251void parse_bitrate(struct nlattr *bitrate_attr, char *buf, int buflen);
492354de 252void iw_hexdump(const char *prefix, const __u8 *data, size_t len);
4698bfc2 253
c1b2b633
SE
254int get_cf1(const struct chanmode *chanmode, unsigned long freq);
255
3c0117c1
JB
256int parse_random_mac_addr(struct nl_msg *msg, char *addrs);
257
9ae0d103
AS
258#define SCHED_SCAN_OPTIONS "[interval <in_msecs> | scan_plans [<interval_secs:iterations>*] <interval_secs>] " \
259 "[delay <in_secs>] [freqs <freq>+] [matches [ssid <ssid>]+]] [active [ssid <ssid>]+|passive] " \
5ec60ed9 260 "[randomise[=<addr>/<mask>]] [coloc] [flush]"
b1622287
LC
261int parse_sched_scan(struct nl_msg *msg, int *argc, char ***argv);
262
63d6aac5
RZ
263void nan_bf(uint8_t idx, uint8_t *bf, uint16_t bf_len, const uint8_t *buf,
264 size_t len);
265
60b6c638
IP
266char *hex2bin(const char *hex, char *buf);
267
4d2749a6
TC
268int set_bitrates(struct nl_msg *msg, int argc, char **argv,
269 enum nl80211_attrs attr);
270
3d3d8fc9
JB
271
272/* sections */
273DECLARE_SECTION(ap);
274DECLARE_SECTION(auth);
275DECLARE_SECTION(cac);
276DECLARE_SECTION(channels);
277DECLARE_SECTION(coalesce);
278DECLARE_SECTION(commands);
279DECLARE_SECTION(connect);
280DECLARE_SECTION(cqm);
281DECLARE_SECTION(del);
282DECLARE_SECTION(dev);
283DECLARE_SECTION(disconnect);
284DECLARE_SECTION(event);
285DECLARE_SECTION(features);
286DECLARE_SECTION(ftm);
287DECLARE_SECTION(get);
288DECLARE_SECTION(help);
289DECLARE_SECTION(hwsim);
290DECLARE_SECTION(ibss);
291DECLARE_SECTION(info);
292DECLARE_SECTION(interface);
293DECLARE_SECTION(link);
294DECLARE_SECTION(list);
295DECLARE_SECTION(measurement);
296DECLARE_SECTION(mesh);
297DECLARE_SECTION(mesh_param);
298DECLARE_SECTION(mgmt);
299DECLARE_SECTION(mpath);
300DECLARE_SECTION(mpp);
301DECLARE_SECTION(nan);
302DECLARE_SECTION(ocb);
303DECLARE_SECTION(offchannel);
304DECLARE_SECTION(p2p);
305DECLARE_SECTION(phy);
306DECLARE_SECTION(reg);
307DECLARE_SECTION(roc);
308DECLARE_SECTION(scan);
309DECLARE_SECTION(set);
310DECLARE_SECTION(station);
311DECLARE_SECTION(survey);
312DECLARE_SECTION(switch);
313DECLARE_SECTION(vendor);
314DECLARE_SECTION(wowlan);
315
cad53b3f 316#endif /* __IW_H */