]> git.ipfire.org Git - thirdparty/iw.git/blob - interface.c
Add cac command to allow clearing channels
[thirdparty/iw.git] / interface.c
1 #include <errno.h>
2 #include <string.h>
3 #include <stdbool.h>
4
5 #include <netlink/genl/genl.h>
6 #include <netlink/genl/family.h>
7 #include <netlink/genl/ctrl.h>
8 #include <netlink/msg.h>
9 #include <netlink/attr.h>
10
11 #include "nl80211.h"
12 #include "iw.h"
13
14 #define VALID_FLAGS "none: no special flags\n"\
15 "fcsfail: show frames with FCS errors\n"\
16 "control: show control frames\n"\
17 "otherbss: show frames from other BSSes\n"\
18 "cook: use cooked mode\n"\
19 "active: use active mode (ACK incoming unicast packets)\n"\
20 "mumimo-groupid <GROUP_ID>: use MUMIMO according to a group id\n"\
21 "mumimo-follow-mac <MAC_ADDRESS>: use MUMIMO according to a MAC address"
22
23 SECTION(interface);
24
25 static char *mntr_flags[NL80211_MNTR_FLAG_MAX + 1] = {
26 "none",
27 "fcsfail",
28 "plcpfail",
29 "control",
30 "otherbss",
31 "cook",
32 "active",
33 };
34
35 static int parse_mumimo_options(int *_argc, char ***_argv, struct nl_msg *msg)
36 {
37 uint8_t mumimo_group[VHT_MUMIMO_GROUP_LEN];
38 unsigned char mac_addr[ETH_ALEN];
39 char **argv = *_argv;
40 int argc = *_argc;
41 int i;
42 unsigned int val;
43
44 if (strcmp(*argv, "mumimo-groupid") == 0) {
45 argc--;
46 argv++;
47 if (!argc || strlen(*argv) != VHT_MUMIMO_GROUP_LEN*2) {
48 fprintf(stderr, "Invalid groupID: %s\n", *argv);
49 return 1;
50 }
51
52 for (i = 0; i < VHT_MUMIMO_GROUP_LEN; i++) {
53 if (sscanf((*argv) + i*2, "%2x", &val) != 1) {
54 fprintf(stderr, "Failed reading groupID\n");
55 return 1;
56 }
57 mumimo_group[i] = val;
58 }
59
60 NLA_PUT(msg,
61 NL80211_ATTR_MU_MIMO_GROUP_DATA,
62 VHT_MUMIMO_GROUP_LEN,
63 mumimo_group);
64 argc--;
65 argv++;
66 } else if (strcmp(*argv, "mumimo-follow-mac") == 0) {
67 argc--;
68 argv++;
69 if (!argc || mac_addr_a2n(mac_addr, *argv)) {
70 fprintf(stderr, "Invalid MAC address\n");
71 return 1;
72 }
73 NLA_PUT(msg, NL80211_ATTR_MU_MIMO_FOLLOW_MAC_ADDR,
74 ETH_ALEN, mac_addr);
75 argc--;
76 argv++;
77 }
78 nla_put_failure:
79 *_argc = argc;
80 *_argv = argv;
81 return 0;
82 }
83
84 static int parse_mntr_flags(int *_argc, char ***_argv,
85 struct nl_msg *msg)
86 {
87 struct nl_msg *flags;
88 int err = -ENOBUFS;
89 enum nl80211_mntr_flags flag;
90 int argc = *_argc;
91 char **argv = *_argv;
92
93 flags = nlmsg_alloc();
94 if (!flags)
95 return -ENOMEM;
96
97 while (argc) {
98 int ok = 0;
99
100 /* parse MU-MIMO options */
101 err = parse_mumimo_options(&argc, &argv, msg);
102 if (err)
103 goto out;
104 else if (!argc)
105 break;
106
107 /* parse monitor flags */
108 for (flag = __NL80211_MNTR_FLAG_INVALID;
109 flag <= NL80211_MNTR_FLAG_MAX; flag++) {
110 if (strcmp(*argv, mntr_flags[flag]) == 0) {
111 ok = 1;
112 /*
113 * This shouldn't be adding "flag" if that is
114 * zero, but due to a problem in the kernel's
115 * nl80211 code (using NLA_NESTED policy) it
116 * will reject an empty nested attribute but
117 * not one that contains an invalid attribute
118 */
119 NLA_PUT_FLAG(flags, flag);
120 break;
121 }
122 }
123 if (!ok) {
124 err = -EINVAL;
125 goto out;
126 }
127 argc--;
128 argv++;
129 }
130
131 nla_put_nested(msg, NL80211_ATTR_MNTR_FLAGS, flags);
132 err = 0;
133 nla_put_failure:
134 out:
135 nlmsg_free(flags);
136
137 *_argc = argc;
138 *_argv = argv;
139
140 return err;
141 }
142
143 /* for help */
144 #define IFACE_TYPES "Valid interface types are: managed, ibss, monitor, mesh, wds."
145
146 /* return 0 if ok, internal error otherwise */
147 static int get_if_type(int *argc, char ***argv, enum nl80211_iftype *type,
148 bool need_type)
149 {
150 char *tpstr;
151
152 if (*argc < 1 + !!need_type)
153 return 1;
154
155 if (need_type && strcmp((*argv)[0], "type"))
156 return 1;
157
158 tpstr = (*argv)[!!need_type];
159 *argc -= 1 + !!need_type;
160 *argv += 1 + !!need_type;
161
162 if (strcmp(tpstr, "adhoc") == 0 ||
163 strcmp(tpstr, "ibss") == 0) {
164 *type = NL80211_IFTYPE_ADHOC;
165 return 0;
166 } else if (strcmp(tpstr, "ocb") == 0) {
167 *type = NL80211_IFTYPE_OCB;
168 return 0;
169 } else if (strcmp(tpstr, "monitor") == 0) {
170 *type = NL80211_IFTYPE_MONITOR;
171 return 0;
172 } else if (strcmp(tpstr, "master") == 0 ||
173 strcmp(tpstr, "ap") == 0) {
174 *type = NL80211_IFTYPE_UNSPECIFIED;
175 fprintf(stderr, "You need to run a management daemon, e.g. hostapd,\n");
176 fprintf(stderr, "see http://wireless.kernel.org/en/users/Documentation/hostapd\n");
177 fprintf(stderr, "for more information on how to do that.\n");
178 return 2;
179 } else if (strcmp(tpstr, "__ap") == 0) {
180 *type = NL80211_IFTYPE_AP;
181 return 0;
182 } else if (strcmp(tpstr, "__ap_vlan") == 0) {
183 *type = NL80211_IFTYPE_AP_VLAN;
184 return 0;
185 } else if (strcmp(tpstr, "wds") == 0) {
186 *type = NL80211_IFTYPE_WDS;
187 return 0;
188 } else if (strcmp(tpstr, "managed") == 0 ||
189 strcmp(tpstr, "mgd") == 0 ||
190 strcmp(tpstr, "station") == 0) {
191 *type = NL80211_IFTYPE_STATION;
192 return 0;
193 } else if (strcmp(tpstr, "mp") == 0 ||
194 strcmp(tpstr, "mesh") == 0) {
195 *type = NL80211_IFTYPE_MESH_POINT;
196 return 0;
197 } else if (strcmp(tpstr, "__p2pcl") == 0) {
198 *type = NL80211_IFTYPE_P2P_CLIENT;
199 return 0;
200 } else if (strcmp(tpstr, "__p2pdev") == 0) {
201 *type = NL80211_IFTYPE_P2P_DEVICE;
202 return 0;
203 } else if (strcmp(tpstr, "__p2pgo") == 0) {
204 *type = NL80211_IFTYPE_P2P_GO;
205 return 0;
206 } else if (strcmp(tpstr, "__nan") == 0) {
207 *type = NL80211_IFTYPE_NAN;
208 return 0;
209 }
210
211 fprintf(stderr, "invalid interface type %s\n", tpstr);
212 return 2;
213 }
214
215 static int parse_4addr_flag(const char *value, struct nl_msg *msg)
216 {
217 if (strcmp(value, "on") == 0)
218 NLA_PUT_U8(msg, NL80211_ATTR_4ADDR, 1);
219 else if (strcmp(value, "off") == 0)
220 NLA_PUT_U8(msg, NL80211_ATTR_4ADDR, 0);
221 else
222 return 1;
223 return 0;
224
225 nla_put_failure:
226 return 1;
227 }
228
229 static int handle_interface_add(struct nl80211_state *state,
230 struct nl_msg *msg,
231 int argc, char **argv,
232 enum id_input id)
233 {
234 char *name;
235 char *mesh_id = NULL;
236 enum nl80211_iftype type;
237 int tpset;
238 unsigned char mac_addr[ETH_ALEN];
239 int found_mac = 0;
240
241 if (argc < 1)
242 return 1;
243
244 name = argv[0];
245 argc--;
246 argv++;
247
248 tpset = get_if_type(&argc, &argv, &type, true);
249 if (tpset)
250 return tpset;
251
252 try_another:
253 if (argc) {
254 if (strcmp(argv[0], "mesh_id") == 0) {
255 argc--;
256 argv++;
257
258 if (!argc)
259 return 1;
260 mesh_id = argv[0];
261 argc--;
262 argv++;
263 } else if (strcmp(argv[0], "addr") == 0) {
264 argc--;
265 argv++;
266 if (mac_addr_a2n(mac_addr, argv[0])) {
267 fprintf(stderr, "Invalid MAC address\n");
268 return 2;
269 }
270 argc--;
271 argv++;
272 found_mac = 1;
273 goto try_another;
274 } else if (strcmp(argv[0], "4addr") == 0) {
275 argc--;
276 argv++;
277 if (parse_4addr_flag(argv[0], msg)) {
278 fprintf(stderr, "4addr error\n");
279 return 2;
280 }
281 argc--;
282 argv++;
283 } else if (strcmp(argv[0], "flags") == 0) {
284 argc--;
285 argv++;
286 if (parse_mntr_flags(&argc, &argv, msg)) {
287 fprintf(stderr, "flags error\n");
288 return 2;
289 }
290 } else {
291 return 1;
292 }
293 }
294
295 if (argc)
296 return 1;
297
298 NLA_PUT_STRING(msg, NL80211_ATTR_IFNAME, name);
299 NLA_PUT_U32(msg, NL80211_ATTR_IFTYPE, type);
300 if (mesh_id)
301 NLA_PUT(msg, NL80211_ATTR_MESH_ID, strlen(mesh_id), mesh_id);
302 if (found_mac)
303 NLA_PUT(msg, NL80211_ATTR_MAC, ETH_ALEN, mac_addr);
304
305 return 0;
306 nla_put_failure:
307 return -ENOBUFS;
308 }
309 COMMAND(interface, add, "<name> type <type> [mesh_id <meshid>] [4addr on|off] [flags <flag>*] [addr <mac-addr>]",
310 NL80211_CMD_NEW_INTERFACE, 0, CIB_PHY, handle_interface_add,
311 "Add a new virtual interface with the given configuration.\n"
312 IFACE_TYPES "\n\n"
313 "The flags are only used for monitor interfaces, valid flags are:\n"
314 VALID_FLAGS "\n\n"
315 "The mesh_id is used only for mesh mode.");
316 COMMAND(interface, add, "<name> type <type> [mesh_id <meshid>] [4addr on|off] [flags <flag>*] [addr <mac-addr>]",
317 NL80211_CMD_NEW_INTERFACE, 0, CIB_NETDEV, handle_interface_add, NULL);
318
319 static int handle_interface_del(struct nl80211_state *state,
320 struct nl_msg *msg,
321 int argc, char **argv,
322 enum id_input id)
323 {
324 return 0;
325 }
326 TOPLEVEL(del, NULL, NL80211_CMD_DEL_INTERFACE, 0, CIB_NETDEV, handle_interface_del,
327 "Remove this virtual interface");
328 HIDDEN(interface, del, NULL, NL80211_CMD_DEL_INTERFACE, 0, CIB_NETDEV, handle_interface_del);
329
330 static char *channel_type_name(enum nl80211_channel_type channel_type)
331 {
332 switch (channel_type) {
333 case NL80211_CHAN_NO_HT:
334 return "NO HT";
335 case NL80211_CHAN_HT20:
336 return "HT20";
337 case NL80211_CHAN_HT40MINUS:
338 return "HT40-";
339 case NL80211_CHAN_HT40PLUS:
340 return "HT40+";
341 default:
342 return "unknown";
343 }
344 }
345
346 char *channel_width_name(enum nl80211_chan_width width)
347 {
348 switch (width) {
349 case NL80211_CHAN_WIDTH_20_NOHT:
350 return "20 MHz (no HT)";
351 case NL80211_CHAN_WIDTH_20:
352 return "20 MHz";
353 case NL80211_CHAN_WIDTH_40:
354 return "40 MHz";
355 case NL80211_CHAN_WIDTH_80:
356 return "80 MHz";
357 case NL80211_CHAN_WIDTH_80P80:
358 return "80+80 MHz";
359 case NL80211_CHAN_WIDTH_160:
360 return "160 MHz";
361 case NL80211_CHAN_WIDTH_5:
362 return "5 MHz";
363 case NL80211_CHAN_WIDTH_10:
364 return "10 MHz";
365 default:
366 return "unknown";
367 }
368 }
369
370 static int print_iface_handler(struct nl_msg *msg, void *arg)
371 {
372 struct genlmsghdr *gnlh = nlmsg_data(nlmsg_hdr(msg));
373 struct nlattr *tb_msg[NL80211_ATTR_MAX + 1];
374 unsigned int *wiphy = arg;
375 const char *indent = "";
376
377 nla_parse(tb_msg, NL80211_ATTR_MAX, genlmsg_attrdata(gnlh, 0),
378 genlmsg_attrlen(gnlh, 0), NULL);
379
380 if (wiphy && tb_msg[NL80211_ATTR_WIPHY]) {
381 unsigned int thiswiphy = nla_get_u32(tb_msg[NL80211_ATTR_WIPHY]);
382 indent = "\t";
383 if (*wiphy != thiswiphy)
384 printf("phy#%d\n", thiswiphy);
385 *wiphy = thiswiphy;
386 }
387
388 if (tb_msg[NL80211_ATTR_IFNAME])
389 printf("%sInterface %s\n", indent, nla_get_string(tb_msg[NL80211_ATTR_IFNAME]));
390 else
391 printf("%sUnnamed/non-netdev interface\n", indent);
392 if (tb_msg[NL80211_ATTR_IFINDEX])
393 printf("%s\tifindex %d\n", indent, nla_get_u32(tb_msg[NL80211_ATTR_IFINDEX]));
394 if (tb_msg[NL80211_ATTR_WDEV])
395 printf("%s\twdev 0x%llx\n", indent,
396 (unsigned long long)nla_get_u64(tb_msg[NL80211_ATTR_WDEV]));
397 if (tb_msg[NL80211_ATTR_MAC]) {
398 char mac_addr[20];
399 mac_addr_n2a(mac_addr, nla_data(tb_msg[NL80211_ATTR_MAC]));
400 printf("%s\taddr %s\n", indent, mac_addr);
401 }
402 if (tb_msg[NL80211_ATTR_SSID]) {
403 printf("%s\tssid ", indent);
404 print_ssid_escaped(nla_len(tb_msg[NL80211_ATTR_SSID]),
405 nla_data(tb_msg[NL80211_ATTR_SSID]));
406 printf("\n");
407 }
408 if (tb_msg[NL80211_ATTR_IFTYPE])
409 printf("%s\ttype %s\n", indent, iftype_name(nla_get_u32(tb_msg[NL80211_ATTR_IFTYPE])));
410 if (!wiphy && tb_msg[NL80211_ATTR_WIPHY])
411 printf("%s\twiphy %d\n", indent, nla_get_u32(tb_msg[NL80211_ATTR_WIPHY]));
412 if (tb_msg[NL80211_ATTR_WIPHY_FREQ]) {
413 uint32_t freq = nla_get_u32(tb_msg[NL80211_ATTR_WIPHY_FREQ]);
414
415 printf("%s\tchannel %d (%d MHz)", indent,
416 ieee80211_frequency_to_channel(freq), freq);
417
418 if (tb_msg[NL80211_ATTR_CHANNEL_WIDTH]) {
419 printf(", width: %s",
420 channel_width_name(nla_get_u32(tb_msg[NL80211_ATTR_CHANNEL_WIDTH])));
421 if (tb_msg[NL80211_ATTR_CENTER_FREQ1])
422 printf(", center1: %d MHz",
423 nla_get_u32(tb_msg[NL80211_ATTR_CENTER_FREQ1]));
424 if (tb_msg[NL80211_ATTR_CENTER_FREQ2])
425 printf(", center2: %d MHz",
426 nla_get_u32(tb_msg[NL80211_ATTR_CENTER_FREQ2]));
427 } else if (tb_msg[NL80211_ATTR_WIPHY_CHANNEL_TYPE]) {
428 enum nl80211_channel_type channel_type;
429
430 channel_type = nla_get_u32(tb_msg[NL80211_ATTR_WIPHY_CHANNEL_TYPE]);
431 printf(" %s", channel_type_name(channel_type));
432 }
433
434 printf("\n");
435 }
436
437 if (tb_msg[NL80211_ATTR_WIPHY_TX_POWER_LEVEL]) {
438 uint32_t txp = nla_get_u32(tb_msg[NL80211_ATTR_WIPHY_TX_POWER_LEVEL]);
439
440 printf("%s\ttxpower %d.%.2d dBm\n",
441 indent, txp / 100, txp % 100);
442 }
443
444 return NL_SKIP;
445 }
446
447 static int handle_interface_info(struct nl80211_state *state,
448 struct nl_msg *msg,
449 int argc, char **argv,
450 enum id_input id)
451 {
452 register_handler(print_iface_handler, NULL);
453 return 0;
454 }
455 TOPLEVEL(info, NULL, NL80211_CMD_GET_INTERFACE, 0, CIB_NETDEV, handle_interface_info,
456 "Show information for this interface.");
457
458 static int handle_interface_set(struct nl80211_state *state,
459 struct nl_msg *msg,
460 int argc, char **argv,
461 enum id_input id)
462 {
463 if (!argc)
464 return 1;
465
466 NLA_PUT_U32(msg, NL80211_ATTR_IFTYPE, NL80211_IFTYPE_MONITOR);
467
468 switch (parse_mntr_flags(&argc, &argv, msg)) {
469 case 0:
470 return 0;
471 case 1:
472 return 1;
473 case -ENOMEM:
474 fprintf(stderr, "failed to allocate flags\n");
475 return 2;
476 case -EINVAL:
477 fprintf(stderr, "unknown flag %s\n", *argv);
478 return 2;
479 default:
480 return 2;
481 }
482 nla_put_failure:
483 return -ENOBUFS;
484 }
485 COMMAND(set, monitor, "<flag>*",
486 NL80211_CMD_SET_INTERFACE, 0, CIB_NETDEV, handle_interface_set,
487 "Set monitor flags. Valid flags are:\n"
488 VALID_FLAGS);
489
490 static int handle_interface_meshid(struct nl80211_state *state,
491 struct nl_msg *msg,
492 int argc, char **argv,
493 enum id_input id)
494 {
495 char *mesh_id = NULL;
496
497 if (argc != 1)
498 return 1;
499
500 mesh_id = argv[0];
501
502 NLA_PUT(msg, NL80211_ATTR_MESH_ID, strlen(mesh_id), mesh_id);
503
504 return 0;
505 nla_put_failure:
506 return -ENOBUFS;
507 }
508 COMMAND(set, meshid, "<meshid>",
509 NL80211_CMD_SET_INTERFACE, 0, CIB_NETDEV, handle_interface_meshid, NULL);
510
511 static unsigned int dev_dump_wiphy;
512
513 static int handle_dev_dump(struct nl80211_state *state,
514 struct nl_msg *msg,
515 int argc, char **argv,
516 enum id_input id)
517 {
518 dev_dump_wiphy = -1;
519 register_handler(print_iface_handler, &dev_dump_wiphy);
520 return 0;
521 }
522 TOPLEVEL(dev, NULL, NL80211_CMD_GET_INTERFACE, NLM_F_DUMP, CIB_NONE, handle_dev_dump,
523 "List all network interfaces for wireless hardware.");
524
525 static int handle_interface_type(struct nl80211_state *state,
526 struct nl_msg *msg,
527 int argc, char **argv,
528 enum id_input id)
529 {
530 enum nl80211_iftype type;
531 int tpset;
532
533 tpset = get_if_type(&argc, &argv, &type, false);
534 if (tpset)
535 return tpset;
536
537 if (argc)
538 return 1;
539
540 NLA_PUT_U32(msg, NL80211_ATTR_IFTYPE, type);
541
542 return 0;
543 nla_put_failure:
544 return -ENOBUFS;
545 }
546 COMMAND(set, type, "<type>",
547 NL80211_CMD_SET_INTERFACE, 0, CIB_NETDEV, handle_interface_type,
548 "Set interface type/mode.\n"
549 IFACE_TYPES);
550
551 static int handle_interface_4addr(struct nl80211_state *state,
552 struct nl_msg *msg,
553 int argc, char **argv,
554 enum id_input id)
555 {
556 if (argc != 1)
557 return 1;
558 return parse_4addr_flag(argv[0], msg);
559 }
560 COMMAND(set, 4addr, "<on|off>",
561 NL80211_CMD_SET_INTERFACE, 0, CIB_NETDEV, handle_interface_4addr,
562 "Set interface 4addr (WDS) mode.");
563
564 static int handle_interface_noack_map(struct nl80211_state *state,
565 struct nl_msg *msg,
566 int argc, char **argv,
567 enum id_input id)
568 {
569 uint16_t noack_map;
570 char *end;
571
572 if (argc != 1)
573 return 1;
574
575 noack_map = strtoul(argv[0], &end, 16);
576 if (*end)
577 return 1;
578
579 NLA_PUT_U16(msg, NL80211_ATTR_NOACK_MAP, noack_map);
580
581 return 0;
582 nla_put_failure:
583 return -ENOBUFS;
584
585 }
586 COMMAND(set, noack_map, "<map>",
587 NL80211_CMD_SET_NOACK_MAP, 0, CIB_NETDEV, handle_interface_noack_map,
588 "Set the NoAck map for the TIDs. (0x0009 = BE, 0x0006 = BK, 0x0030 = VI, 0x00C0 = VO)");
589
590
591 static int handle_interface_wds_peer(struct nl80211_state *state,
592 struct nl_msg *msg,
593 int argc, char **argv,
594 enum id_input id)
595 {
596 unsigned char mac_addr[ETH_ALEN];
597
598 if (argc < 1)
599 return 1;
600
601 if (mac_addr_a2n(mac_addr, argv[0])) {
602 fprintf(stderr, "Invalid MAC address\n");
603 return 2;
604 }
605
606 argc--;
607 argv++;
608
609 if (argc)
610 return 1;
611
612 NLA_PUT(msg, NL80211_ATTR_MAC, ETH_ALEN, mac_addr);
613
614 return 0;
615 nla_put_failure:
616 return -ENOBUFS;
617 }
618 COMMAND(set, peer, "<MAC address>",
619 NL80211_CMD_SET_WDS_PEER, 0, CIB_NETDEV, handle_interface_wds_peer,
620 "Set interface WDS peer.");
621
622 static int set_mcast_rate(struct nl80211_state *state,
623 struct nl_msg *msg,
624 int argc, char **argv,
625 enum id_input id)
626 {
627 float rate;
628 char *end;
629
630 if (argc != 1)
631 return 1;
632
633 rate = strtod(argv[0], &end);
634 if (*end != '\0')
635 return 1;
636
637 NLA_PUT_U32(msg, NL80211_ATTR_MCAST_RATE, (int)(rate * 10));
638
639 return 0;
640 nla_put_failure:
641 return -ENOBUFS;
642 }
643
644 COMMAND(set, mcast_rate, "<rate in Mbps>",
645 NL80211_CMD_SET_MCAST_RATE, 0, CIB_NETDEV, set_mcast_rate,
646 "Set the multicast bitrate.");