• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 #ifndef __IW_H
2 #define __IW_H
3 
4 #include <stdbool.h>
5 #include <netlink/netlink.h>
6 #include <netlink/genl/genl.h>
7 #include <netlink/genl/family.h>
8 #include <netlink/genl/ctrl.h>
9 #include <endian.h>
10 
11 #include "nl80211.h"
12 #include "ieee80211.h"
13 
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 
19 /* support for extack if compilation headers are too old */
20 #ifndef NETLINK_EXT_ACK
21 #define NETLINK_EXT_ACK 11
22 enum 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
38 #ifndef SOL_NETLINK
39 #define SOL_NETLINK 270
40 #endif
41 
42 #define ETH_ALEN 6
43 #define VHT_MUMIMO_GROUP_LEN 24
44 
45 /* libnl 1.x compatibility code */
46 #if !defined(CONFIG_LIBNL20) && !defined(CONFIG_LIBNL30)
47 #  define nl_sock nl_handle
48 #endif
49 
50 struct nl80211_state {
51 	struct nl_sock *nl_sock;
52 	int nl80211_id;
53 };
54 
55 enum command_identify_by {
56 	CIB_NONE,
57 	CIB_PHY,
58 	CIB_NETDEV,
59 	CIB_WDEV,
60 };
61 
62 enum id_input {
63 	II_NONE,
64 	II_NETDEV,
65 	II_PHY_NAME,
66 	II_PHY_IDX,
67 	II_WDEV,
68 };
69 
70 #define HANDLER_RET_USAGE 1
71 #define HANDLER_RET_DONE 3
72 
73 struct cmd {
74 	const char *name;
75 	const char *args;
76 	const char *help;
77 	const enum nl80211_commands cmd;
78 	int nl_msg_flags;
79 	int hidden;
80 	const enum command_identify_by idby;
81 	/*
82 	 * The handler should return a negative error code,
83 	 * zero on success, 1 if the arguments were wrong.
84 	 * Return 2 iff you provide the error message yourself.
85 	 */
86 	int (*handler)(struct nl80211_state *state,
87 		       struct nl_msg *msg,
88 		       int argc, char **argv,
89 		       enum id_input id);
90 	const struct cmd *(*selector)(int argc, char **argv);
91 	const struct cmd *parent;
92 };
93 
94 struct chanmode {
95 	const char *name;
96 	unsigned int width;
97 	int freq1_diff;
98 	int chantype; /* for older kernel */
99 };
100 
101 struct 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 
109 #define ARRAY_SIZE(ar) (sizeof(ar)/sizeof(ar[0]))
110 #define DIV_ROUND_UP(x, y) (((x) + (y - 1)) / (y))
111 
112 #define __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel)\
113 	static struct cmd						\
114 	__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden = {\
115 		.name = (_name),					\
116 		.args = (_args),					\
117 		.cmd = (_nlcmd),					\
118 		.nl_msg_flags = (_flags),				\
119 		.hidden = (_hidden),					\
120 		.idby = (_idby),					\
121 		.handler = (_handler),					\
122 		.help = (_help),					\
123 		.parent = _section,					\
124 		.selector = (_sel),					\
125 	};								\
126 	static struct cmd *__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden ## _p \
127 	__attribute__((used,section("__cmd"))) =			\
128 	&__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
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
132 #define COMMAND(section, name, args, cmd, flags, idby, handler, help)	\
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)
136 #define HIDDEN(section, name, args, cmd, flags, idby, handler)		\
137 	__COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 1, idby, handler, NULL, NULL)
138 
139 #define TOPLEVEL(_name, _args, _nlcmd, _flags, _idby, _handler, _help)	\
140 	struct cmd __section ## _ ## _name = {				\
141 		.name = (#_name),					\
142 		.args = (_args),					\
143 		.cmd = (_nlcmd),					\
144 		.nl_msg_flags = (_flags),				\
145 		.idby = (_idby),					\
146 		.handler = (_handler),					\
147 		.help = (_help),					\
148 	 };								\
149 	static struct cmd *__section ## _ ## _name ## _p		\
150 	__attribute__((used,section("__cmd"))) = &__section ## _ ## _name
151 
152 #define SECTION(_name)							\
153 	struct cmd __section ## _ ## _name = {				\
154 		.name = (#_name),					\
155 		.hidden = 1,						\
156 	};								\
157 	static struct cmd *__section ## _ ## _name ## _p		\
158 	__attribute__((used,section("__cmd"))) = &__section ## _ ## _name
159 
160 #define DECLARE_SECTION(_name)						\
161 	extern struct cmd __section ## _ ## _name;
162 
163 struct 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)				\
170 	static const struct vendor_event 				\
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 
179 extern const char iw_version[];
180 
181 extern int iw_debug;
182 
183 int handle_cmd(struct nl80211_state *state, enum id_input idby,
184 	       int argc, char **argv);
185 
186 struct print_event_args {
187 	struct timeval ts; /* internal */
188 	bool have_ts; /* must be set false */
189 	bool frame, time, reltime, ctime;
190 };
191 
192 __u32 listen_events(struct nl80211_state *state,
193 		    const int n_waits, const __u32 *waits);
194 int __prepare_listen_events(struct nl80211_state *state);
195 __u32 __do_listen_events(struct nl80211_state *state,
196 			 const int n_waits, const __u32 *waits,
197 			 const int n_prints, const __u32 *prints,
198 			 struct print_event_args *args);
199 
200 int valid_handler(struct nl_msg *msg, void *arg);
201 void register_handler(int (*handler)(struct nl_msg *, void *), void *data);
202 
203 int mac_addr_a2n(unsigned char *mac_addr, char *arg);
204 void mac_addr_n2a(char *mac_addr, const unsigned char *arg);
205 int parse_hex_mask(char *hexmask, unsigned char **result, size_t *result_len,
206 		   unsigned char **mask);
207 unsigned char *parse_hex(char *hex, size_t *outlen);
208 
209 int parse_keys(struct nl_msg *msg, char **argv[], int *argc);
210 int parse_freqchan(struct chandef *chandef, bool chan, int argc, char **argv, int *parsed);
211 enum nl80211_chan_width str_to_bw(const char *str);
212 int parse_txq_stats(char *buf, int buflen, struct nlattr *tid_stats_attr, int header,
213 		    int tid, const char *indent);
214 int put_chandef(struct nl_msg *msg, struct chandef *chandef);
215 
216 void print_ht_mcs(const __u8 *mcs);
217 void print_ampdu_length(__u8 exponent);
218 void print_ampdu_spacing(__u8 spacing);
219 void print_ht_capability(__u16 cap);
220 void print_vht_info(__u32 capa, const __u8 *mcs);
221 void print_he_capability(const uint8_t *ie, int len);
222 void print_he_info(struct nlattr *nl_iftype);
223 void print_eht_info(struct nlattr *nl_iftype, int band);
224 
225 char *channel_width_name(enum nl80211_chan_width width);
226 const char *iftype_name(enum nl80211_iftype iftype);
227 void print_iftype_list(const char *name, const char *pfx, struct nlattr *attr);
228 void print_iftype_line(struct nlattr *attr);
229 const char *command_name(enum nl80211_commands cmd);
230 int ieee80211_channel_to_frequency(int chan, enum nl80211_band band);
231 int ieee80211_frequency_to_channel(int freq);
232 
233 void print_ssid_escaped(const uint8_t len, const uint8_t *data);
234 
235 int nl_get_multicast_id(struct nl_sock *sock, const char *family, const char *group);
236 
237 char *reg_initiator_to_string(__u8 initiator);
238 
239 const char *get_reason_str(uint16_t reason);
240 const char *get_status_str(uint16_t status);
241 
242 enum print_ie_type {
243 	PRINT_SCAN,
244 	PRINT_LINK,
245 };
246 
247 #define BIT(x) (1ULL<<(x))
248 
249 void print_ies(unsigned char *ie, int ielen, bool unknown,
250 	       enum print_ie_type ptype);
251 
252 void parse_bitrate(struct nlattr *bitrate_attr, char *buf, int buflen);
253 void iw_hexdump(const char *prefix, const __u8 *data, size_t len);
254 
255 int get_cf1(const struct chanmode *chanmode, unsigned long freq);
256 
257 int parse_random_mac_addr(struct nl_msg *msg, char *addrs);
258 
259 #define SCHED_SCAN_OPTIONS "[interval <in_msecs> | scan_plans [<interval_secs:iterations>*] <interval_secs>] "	\
260 	"[delay <in_secs>] [freqs <freq>+] [matches [ssid <ssid>]+]] [active [ssid <ssid>]+|passive] "	\
261 	"[randomise[=<addr>/<mask>]] [coloc] [flush]"
262 int parse_sched_scan(struct nl_msg *msg, int *argc, char ***argv);
263 
264 void nan_bf(uint8_t idx, uint8_t *bf, uint16_t bf_len, const uint8_t *buf,
265 	    size_t len);
266 
267 char *hex2bin(const char *hex, char *buf);
268 
269 int set_bitrates(struct nl_msg *msg, int argc, char **argv,
270 		 enum nl80211_attrs attr);
271 
272 
273 /* sections */
274 DECLARE_SECTION(ap);
275 DECLARE_SECTION(auth);
276 DECLARE_SECTION(cac);
277 DECLARE_SECTION(channels);
278 DECLARE_SECTION(coalesce);
279 DECLARE_SECTION(commands);
280 DECLARE_SECTION(connect);
281 DECLARE_SECTION(cqm);
282 DECLARE_SECTION(del);
283 DECLARE_SECTION(dev);
284 DECLARE_SECTION(disconnect);
285 DECLARE_SECTION(event);
286 DECLARE_SECTION(features);
287 DECLARE_SECTION(ftm);
288 DECLARE_SECTION(get);
289 DECLARE_SECTION(help);
290 DECLARE_SECTION(hwsim);
291 DECLARE_SECTION(ibss);
292 DECLARE_SECTION(info);
293 DECLARE_SECTION(interface);
294 DECLARE_SECTION(link);
295 DECLARE_SECTION(list);
296 DECLARE_SECTION(measurement);
297 DECLARE_SECTION(mesh);
298 DECLARE_SECTION(mesh_param);
299 DECLARE_SECTION(mgmt);
300 DECLARE_SECTION(mpath);
301 DECLARE_SECTION(mpp);
302 DECLARE_SECTION(nan);
303 DECLARE_SECTION(ocb);
304 DECLARE_SECTION(offchannel);
305 DECLARE_SECTION(p2p);
306 DECLARE_SECTION(phy);
307 DECLARE_SECTION(reg);
308 DECLARE_SECTION(roc);
309 DECLARE_SECTION(scan);
310 DECLARE_SECTION(set);
311 DECLARE_SECTION(station);
312 DECLARE_SECTION(survey);
313 DECLARE_SECTION(switch);
314 DECLARE_SECTION(vendor);
315 DECLARE_SECTION(wowlan);
316 
317 #endif /* __IW_H */
318