7 #include <netlink/genl/genl.h>
8 #include <netlink/genl/family.h>
9 #include <netlink/genl/ctrl.h>
10 #include <netlink/msg.h>
11 #include <netlink/attr.h>
16 #define WLAN_CAPABILITY_ESS (1<<0)
17 #define WLAN_CAPABILITY_IBSS (1<<1)
18 #define WLAN_CAPABILITY_CF_POLLABLE (1<<2)
19 #define WLAN_CAPABILITY_CF_POLL_REQUEST (1<<3)
20 #define WLAN_CAPABILITY_PRIVACY (1<<4)
21 #define WLAN_CAPABILITY_SHORT_PREAMBLE (1<<5)
22 #define WLAN_CAPABILITY_PBCC (1<<6)
23 #define WLAN_CAPABILITY_CHANNEL_AGILITY (1<<7)
24 #define WLAN_CAPABILITY_SPECTRUM_MGMT (1<<8)
25 #define WLAN_CAPABILITY_QOS (1<<9)
26 #define WLAN_CAPABILITY_SHORT_SLOT_TIME (1<<10)
27 #define WLAN_CAPABILITY_APSD (1<<11)
28 #define WLAN_CAPABILITY_DSSS_OFDM (1<<13)
30 static unsigned char wifi_oui
[3] = { 0x00, 0x50, 0xf2 };
31 static unsigned char ieee80211_oui
[3] = { 0x00, 0x0f, 0xac };
37 static int handle_scan(struct nl80211_state
*state
,
40 int argc
, char **argv
)
42 struct nl_msg
*ssids
= NULL
, *freqs
= NULL
;
53 bool passive
= false, have_ssids
= false, have_freqs
= false;
55 ssids
= nlmsg_alloc();
59 freqs
= nlmsg_alloc();
65 for (i
= 0; i
< argc
; i
++) {
66 if (parse
== NONE
&& strcmp(argv
[i
], "freq") == 0) {
70 } else if (parse
< SSID
&& strcmp(argv
[i
], "ssid") == 0) {
74 } else if (parse
< SSID
&& strcmp(argv
[i
], "passive") == 0) {
85 freq
= strtoul(argv
[i
], &eptr
, 10);
86 if (eptr
!= argv
[i
] + strlen(argv
[i
]))
88 NLA_PUT_U32(freqs
, i
, freq
);
91 NLA_PUT(ssids
, i
, strlen(argv
[i
]), argv
[i
]);
97 NLA_PUT(ssids
, 1, 0, "");
99 nla_put_nested(msg
, NL80211_ATTR_SCAN_SSIDS
, ssids
);
102 nla_put_nested(msg
, NL80211_ATTR_SCAN_FREQUENCIES
, freqs
);
110 COMMAND(scan
, trigger
, "[freq <freq>*] [ssid <ssid>*|passive]",
111 NL80211_CMD_TRIGGER_SCAN
, 0, CIB_NETDEV
, handle_scan
,
112 "Trigger a scan on the given frequencies with probing for the given\n"
113 "SSIDs (or wildcard if not given) unless passive scanning is requested.");
115 static void tab_on_first(bool *first
)
123 static void print_ssid(const uint8_t type
, uint8_t len
, const uint8_t *data
)
129 for (i
= 0; i
< len
; i
++) {
130 if (isprint(data
[i
]))
131 printf("%c", data
[i
]);
133 printf("\\x%.2x", data
[i
]);
138 static void print_supprates(const uint8_t type
, uint8_t len
, const uint8_t *data
)
144 for (i
= 0; i
< len
; i
++) {
145 int r
= data
[i
] & 0x7f;
146 printf("%d.%d%s ", r
/2, 5*(r
&1), data
[i
] & 0x80 ? "*":"");
151 static void print_ds(const uint8_t type
, uint8_t len
, const uint8_t *data
)
153 printf(" channel %d\n", data
[0]);
156 static void print_country(const uint8_t type
, uint8_t len
, const uint8_t *data
)
160 printf(" %.*s", 2, data
);
166 printf(" (outdoor)");
169 printf(" (in/outdoor)");
172 printf(" (invalid environment)");
176 for(i
=0; i
<len
-3; i
++)
177 printf(" %.02x", data
[i
+ 3]);
181 static void print_powerconstraint(const uint8_t type
, uint8_t len
, const uint8_t *data
)
183 printf(" %d dB\n", data
[0]);
186 static void print_erp(const uint8_t type
, uint8_t len
, const uint8_t *data
)
189 printf(" <no flags>");
191 printf(" NonERP_Present");
193 printf(" Use_Protection");
195 printf(" Barker_Preamble_Mode");
199 static void print_cipher(const uint8_t *data
)
201 if (memcmp(data
, wifi_oui
, 3) == 0) {
204 printf("Use group cipher suite");
219 printf("%.02x-%.02x-%.02x:%d",
220 data
[0], data
[1] ,data
[2], data
[3]);
223 } else if (memcmp(data
, ieee80211_oui
, 3) == 0) {
226 printf("Use group cipher suite");
241 printf("AES-128-CMAC");
244 printf("%.02x-%.02x-%.02x:%d",
245 data
[0], data
[1] ,data
[2], data
[3]);
249 printf("%.02x-%.02x-%.02x:%d",
250 data
[0], data
[1] ,data
[2], data
[3]);
253 static void print_auth(const uint8_t *data
)
255 if (memcmp(data
, wifi_oui
, 3) == 0) {
258 printf("IEEE 802.1X");
264 printf("%.02x-%.02x-%.02x:%d",
265 data
[0], data
[1] ,data
[2], data
[3]);
268 } else if (memcmp(data
, ieee80211_oui
, 3) == 0) {
271 printf("IEEE 802.1X");
277 printf("FT/IEEE 802.1X");
283 printf("IEEE 802.1X/SHA-256");
286 printf("PSK/SHA-256");
289 printf("%.02x-%.02x-%.02x:%d",
290 data
[0], data
[1] ,data
[2], data
[3]);
294 printf("%.02x-%.02x-%.02x:%d",
295 data
[0], data
[1] ,data
[2], data
[3]);
298 static void print_rsn_ie(const char *defcipher
, const char *defauth
,
299 uint8_t len
, const uint8_t *data
)
302 __u16 version
, count
, capa
;
305 version
= data
[0] + (data
[1] << 8);
306 tab_on_first(&first
);
307 printf("\t * Version: %d\n", version
);
313 tab_on_first(&first
);
314 printf("\t * Group cipher: %s\n", defcipher
);
315 printf("\t * Pairwise ciphers: %s\n", defcipher
);
319 tab_on_first(&first
);
320 printf("\t * Group cipher: ");
328 tab_on_first(&first
);
329 printf("\t * Pairwise ciphers: %s\n", defcipher
);
333 count
= data
[0] | (data
[1] << 8);
334 if (2 + (count
* 4) > len
)
337 tab_on_first(&first
);
338 printf("\t * Pairwise ciphers:");
339 for (i
= 0; i
< count
; i
++) {
341 print_cipher(data
+ 2 + (i
* 4));
345 data
+= 2 + (count
* 4);
346 len
-= 2 + (count
* 4);
349 tab_on_first(&first
);
350 printf("\t * Authentication suites: %s\n", defauth
);
354 count
= data
[0] | (data
[1] << 8);
355 if (2 + (count
* 4) > len
)
358 tab_on_first(&first
);
359 printf("\t * Authentication suites:");
360 for (i
= 0; i
< count
; i
++) {
362 print_auth(data
+ 2 + (i
* 4));
366 data
+= 2 + (count
* 4);
367 len
-= 2 + (count
* 4);
370 capa
= data
[0] | (data
[1] << 8);
371 tab_on_first(&first
);
372 printf("\t * Capabilities:");
376 printf(" NoPairwise");
377 switch ((capa
& 0x000c) >> 2) {
381 printf(" 2-PTKSA-RC");
384 printf(" 4-PTKSA-RC");
387 printf(" 16-PTKSA-RC");
390 switch ((capa
& 0x0030) >> 4) {
394 printf(" 2-GTKSA-RC");
397 printf(" 4-GTKSA-RC");
400 printf(" 16-GTKSA-RC");
404 printf(" MFP-required");
406 printf(" MFP-capable");
408 printf(" Peerkey-enabled");
410 printf(" SPP-AMSDU-capable");
412 printf(" SPP-AMSDU-required");
413 printf(" (0x%.4x)\n", capa
);
420 printf("\t\t * bogus tail data (%d):", len
);
422 printf(" %.2x", *data
);
430 static void print_rsn(const uint8_t type
, uint8_t len
, const uint8_t *data
)
432 print_rsn_ie("CCMP", "IEEE 802.1X", len
, data
);
435 static void print_capabilities(const uint8_t type
, uint8_t len
, const uint8_t *data
)
441 for (i
= 0; i
< len
; i
++) {
444 for (bit
= 0; bit
< 8; bit
++) {
445 if (!(data
[i
] & (1 << bit
)))
453 switch (bit
+ base
) {
455 printf(" HT Information Exchange Supported");
458 printf(" On-demand Beacon");
461 printf(" Extended Channel Switching");
464 printf(" Wave Indication");
467 printf(" PSMP Capability");
470 printf(" Service Interval Granularity");
473 printf(" S-PSMP Capability");
487 void (*print
)(const uint8_t type
, uint8_t len
, const uint8_t *data
);
488 uint8_t minlen
, maxlen
;
491 static void print_ie(const struct ie_print
*p
, const uint8_t type
,
492 uint8_t len
, const uint8_t *data
)
499 printf("\t%s:", p
->name
);
500 if (len
< p
->minlen
|| len
> p
->maxlen
) {
502 printf(" <invalid: %d bytes:", len
);
503 for (i
= 0; i
< len
; i
++)
504 printf(" %.02x", data
[i
]);
507 printf(" <invalid: 1 byte: %.02x>\n", data
[0]);
509 printf(" <invalid: no data>\n");
513 p
->print(type
, len
, data
);
516 #define PRINT_IGN { \
523 static const struct ie_print ieprinters
[] = {
524 [0] = { "SSID", print_ssid
, 0, 32, },
525 [1] = { "Supported rates", print_supprates
, 0, 255, },
526 [3] = { "DS Paramater set", print_ds
, 1, 1, },
528 [7] = { "Country", print_country
, 3, 255, },
529 [32] = { "Power constraint", print_powerconstraint
, 1, 1, },
530 [42] = { "ERP", print_erp
, 1, 255, },
531 [48] = { "RSN", print_rsn
, 2, 255, },
532 [50] = { "Extended supported rates", print_supprates
, 0, 255, },
533 [127] = { "Extended capabilities", print_capabilities
, 0, 255, },
536 static void print_wifi_wpa(const uint8_t type
, uint8_t len
, const uint8_t *data
)
538 print_rsn_ie("TKIP", "IEEE 802.1X", len
, data
);
541 static void print_wifi_wmm(const uint8_t type
, uint8_t len
, const uint8_t *data
)
547 printf(" information:");
550 printf(" parameter:");
553 printf(" type %d:", data
[0]);
557 for(i
= 0; i
< len
- 1; i
++)
558 printf(" %.02x", data
[i
+ 1]);
562 static void print_wifi_wps(const uint8_t type
, uint8_t len
, const uint8_t *data
)
565 __u16 subtype
, sublen
;
568 subtype
= (data
[0] << 8) + data
[1];
569 sublen
= (data
[2] << 8) + data
[3];
575 tab_on_first(&first
);
576 printf("\t * Version: %d.%d\n", data
[4] >> 4, data
[4] & 0xF);
579 tab_on_first(&first
);
580 printf("\t * Device name: %.*s\n", sublen
, data
+ 4);
583 tab_on_first(&first
);
584 printf("\t * Manufacturer: %.*s\n", sublen
, data
+ 4);
587 tab_on_first(&first
);
588 printf("\t * Model: %.*s\n", sublen
, data
+ 4);
591 __u16 val
= (data
[4] << 8) | data
[5];
592 tab_on_first(&first
);
593 printf("\t * AP setup locked: 0x%.4x\n", val
);
597 __u16 meth
= (data
[4] << 8) + data
[5];
599 tab_on_first(&first
);
600 printf("\t * Config methods:");
601 #define T(bit, name) do { \
602 if (meth & (1<<bit)) { \
630 printf("\t\t * bogus tail data (%d):", len
);
632 printf(" %.2x", *data
);
640 static const struct ie_print wifiprinters
[] = {
641 [1] = { "WPA", print_wifi_wpa
, 2, 255, },
642 [2] = { "WMM", print_wifi_wmm
, 1, 255, },
643 [4] = { "WPS", print_wifi_wps
, 0, 255, },
646 static void print_vendor(unsigned char len
, unsigned char *data
,
647 struct scan_params
*params
)
652 printf("\tVendor specific: <too short> data:");
653 for(i
= 0; i
< len
; i
++)
654 printf(" %.02x", data
[i
]);
659 if (len
>= 4 && memcmp(data
, wifi_oui
, 3) == 0) {
660 if (data
[3] < ARRAY_SIZE(wifiprinters
) && wifiprinters
[data
[3]].name
) {
661 print_ie(&wifiprinters
[data
[3]], data
[3], len
- 4, data
+ 4);
664 if (!params
->unknown
)
666 printf("\tWiFi OUI %#.2x, data:", data
[3]);
667 for(i
= 0; i
< len
- 4; i
++)
668 printf(" %.02x", data
[i
+ 4]);
673 if (!params
->unknown
)
676 printf("\tVendor specific: OUI %.2x:%.2x:%.2x, data:",
677 data
[0], data
[1], data
[2]);
678 for (i
= 3; i
< len
; i
++)
679 printf(" %.2x", data
[i
]);
683 static void print_ies(unsigned char *ie
, int ielen
, struct scan_params
*params
)
685 while (ielen
>= 2 && ielen
>= ie
[1]) {
686 if (ie
[0] < ARRAY_SIZE(ieprinters
) && ieprinters
[ie
[0]].name
) {
687 print_ie(&ieprinters
[ie
[0]], ie
[0], ie
[1], ie
+ 2);
688 } else if (ie
[0] == 221 /* vendor */) {
689 print_vendor(ie
[1], ie
+ 2, params
);
690 } else if (params
->unknown
) {
693 printf("\tUnknown IE (%d):", ie
[0]);
694 for (i
=0; i
<ie
[1]; i
++)
695 printf(" %.2x", ie
[2+i
]);
703 static int print_bss_handler(struct nl_msg
*msg
, void *arg
)
705 struct nlattr
*tb
[NL80211_ATTR_MAX
+ 1];
706 struct genlmsghdr
*gnlh
= nlmsg_data(nlmsg_hdr(msg
));
707 struct nlattr
*bss
[NL80211_BSS_MAX
+ 1];
708 char mac_addr
[20], dev
[20];
709 static struct nla_policy bss_policy
[NL80211_BSS_MAX
+ 1] = {
710 [NL80211_BSS_TSF
] = { .type
= NLA_U64
},
711 [NL80211_BSS_FREQUENCY
] = { .type
= NLA_U32
},
712 [NL80211_BSS_BSSID
] = { },
713 [NL80211_BSS_BEACON_INTERVAL
] = { .type
= NLA_U16
},
714 [NL80211_BSS_CAPABILITY
] = { .type
= NLA_U16
},
715 [NL80211_BSS_INFORMATION_ELEMENTS
] = { },
716 [NL80211_BSS_SIGNAL_MBM
] = { .type
= NLA_U32
},
717 [NL80211_BSS_SIGNAL_UNSPEC
] = { .type
= NLA_U8
},
720 nla_parse(tb
, NL80211_ATTR_MAX
, genlmsg_attrdata(gnlh
, 0),
721 genlmsg_attrlen(gnlh
, 0), NULL
);
723 if (!tb
[NL80211_ATTR_BSS
]) {
724 fprintf(stderr
, "bss info missing!");
727 if (nla_parse_nested(bss
, NL80211_BSS_MAX
,
728 tb
[NL80211_ATTR_BSS
],
730 fprintf(stderr
, "failed to parse nested attributes!");
734 if (!bss
[NL80211_BSS_BSSID
])
737 mac_addr_n2a(mac_addr
, nla_data(bss
[NL80211_BSS_BSSID
]));
738 if_indextoname(nla_get_u32(tb
[NL80211_ATTR_IFINDEX
]), dev
);
739 printf("BSS %s (on %s)\n", mac_addr
, dev
);
741 if (bss
[NL80211_BSS_TSF
]) {
742 unsigned long long tsf
;
743 tsf
= (unsigned long long)nla_get_u64(bss
[NL80211_BSS_TSF
]);
744 printf("\tTSF: %llu usec (%llud, %.2lld:%.2llu:%.2llu)\n",
745 tsf
, tsf
/1000/1000/60/60/24, (tsf
/1000/1000/60/60) % 24,
746 (tsf
/1000/1000/60) % 60, (tsf
/1000/1000) % 60);
748 if (bss
[NL80211_BSS_FREQUENCY
])
749 printf("\tfreq: %d\n",
750 nla_get_u32(bss
[NL80211_BSS_FREQUENCY
]));
751 if (bss
[NL80211_BSS_BEACON_INTERVAL
])
752 printf("\tbeacon interval: %d\n",
753 nla_get_u16(bss
[NL80211_BSS_BEACON_INTERVAL
]));
754 if (bss
[NL80211_BSS_CAPABILITY
]) {
755 __u16 capa
= nla_get_u16(bss
[NL80211_BSS_CAPABILITY
]);
756 printf("\tcapability:");
757 if (capa
& WLAN_CAPABILITY_ESS
)
759 if (capa
& WLAN_CAPABILITY_IBSS
)
761 if (capa
& WLAN_CAPABILITY_PRIVACY
)
763 if (capa
& WLAN_CAPABILITY_SHORT_PREAMBLE
)
764 printf(" ShortPreamble");
765 if (capa
& WLAN_CAPABILITY_PBCC
)
767 if (capa
& WLAN_CAPABILITY_CHANNEL_AGILITY
)
768 printf(" ChannelAgility");
769 if (capa
& WLAN_CAPABILITY_SPECTRUM_MGMT
)
770 printf(" SpectrumMgmt");
771 if (capa
& WLAN_CAPABILITY_QOS
)
773 if (capa
& WLAN_CAPABILITY_SHORT_SLOT_TIME
)
774 printf(" ShortSlotTime");
775 if (capa
& WLAN_CAPABILITY_APSD
)
777 if (capa
& WLAN_CAPABILITY_DSSS_OFDM
)
778 printf(" DSSS-OFDM");
779 printf(" (0x%.4x)\n", capa
);
781 if (bss
[NL80211_BSS_SIGNAL_MBM
]) {
782 int s
= nla_get_u32(bss
[NL80211_BSS_SIGNAL_MBM
]);
783 printf("\tsignal: %d.%.2d dBm\n", s
/100, s
%100);
785 if (bss
[NL80211_BSS_SIGNAL_UNSPEC
]) {
786 unsigned char s
= nla_get_u8(bss
[NL80211_BSS_SIGNAL_UNSPEC
]);
787 printf("\tsignal: %d/100\n", s
);
789 if (bss
[NL80211_BSS_INFORMATION_ELEMENTS
])
790 print_ies(nla_data(bss
[NL80211_BSS_INFORMATION_ELEMENTS
]),
791 nla_len(bss
[NL80211_BSS_INFORMATION_ELEMENTS
]),
797 static struct scan_params scan_params
;
799 static int handle_scan_dump(struct nl80211_state
*state
,
802 int argc
, char **argv
)
807 scan_params
.unknown
= false;
808 if (argc
== 1 && !strcmp(argv
[0], "-u"))
809 scan_params
.unknown
= true;
811 nl_cb_set(cb
, NL_CB_VALID
, NL_CB_CUSTOM
, print_bss_handler
,
815 COMMAND(scan
, dump
, "[-u]",
816 NL80211_CMD_GET_SCAN
, NLM_F_DUMP
, CIB_NETDEV
, handle_scan_dump
,
817 "Dump the current scan results. If -u is specified, print unknown\n"
818 "data in scan results.");
820 static int handle_scan_combined(struct nl80211_state
*state
,
823 int argc
, char **argv
)
826 static char *dump_argv
[] = {
832 static const __u32 cmds
[] = {
833 NL80211_CMD_NEW_SCAN_RESULTS
,
834 NL80211_CMD_SCAN_ABORTED
,
836 int trig_argc
, dump_argc
, err
;
838 if (argc
>= 3 && !strcmp(argv
[2], "-u")) {
844 trig_argc
= 3 + (argc
- 2) + (3 - dump_argc
);
845 trig_argv
= calloc(trig_argc
, sizeof(*trig_argv
));
848 trig_argv
[0] = argv
[0];
849 trig_argv
[1] = "scan";
850 trig_argv
[2] = "trigger";
852 for (i
= 0; i
< argc
- 2 - (dump_argc
- 3); i
++)
853 trig_argv
[i
+ 3] = argv
[i
+ 2 + (dump_argc
- 3)];
854 err
= handle_cmd(state
, II_NETDEV
, trig_argc
, trig_argv
);
860 * WARNING: DO NOT COPY THIS CODE INTO YOUR APPLICATION
862 * This code has a bug, which requires creating a separate
863 * nl80211 socket to fix:
864 * It is possible for a NL80211_CMD_NEW_SCAN_RESULTS or
865 * NL80211_CMD_SCAN_ABORTED message to be sent by the kernel
866 * before (!) we listen to it, because we only start listening
867 * after we send our scan request.
869 * Doing it the other way around has a race condition as well,
870 * if you first open the events socket you may get a notification
871 * for a previous scan.
873 * The only proper way to fix this would be to listen to events
874 * before sending the command, and for the kernel to send the
875 * scan request along with the event, so that you can match up
876 * whether the scan you requested was finished or aborted (this
877 * may result in processing a scan that another application
878 * requested, but that doesn't seem to be a problem).
880 * Alas, the kernel doesn't do that (yet).
883 if (listen_events(state
, ARRAY_SIZE(cmds
), cmds
) ==
884 NL80211_CMD_SCAN_ABORTED
) {
885 printf("scan aborted!\n");
889 dump_argv
[0] = argv
[0];
890 return handle_cmd(state
, II_NETDEV
, dump_argc
, dump_argv
);
892 TOPLEVEL(scan
, "[-u] [freq <freq>*] [ssid <ssid>*|passive]", 0, 0,
893 CIB_NETDEV
, handle_scan_combined
,
894 "Scan on the given frequencies and probe for the given SSIDs\n"
895 "(or wildcard if not given) unless passive scanning is requested.\n"
896 "If -u is specified print unknown data in the scan results.");