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_RADIO_MEASURE (1<<12)
29 #define WLAN_CAPABILITY_DSSS_OFDM (1<<13)
30 #define WLAN_CAPABILITY_DEL_BACK (1<<14)
31 #define WLAN_CAPABILITY_IMM_BACK (1<<15)
32 /* DMG (60gHz) 802.11ad */
33 /* type - bits 0..1 */
34 #define WLAN_CAPABILITY_DMG_TYPE_MASK (3<<0)
36 #define WLAN_CAPABILITY_DMG_TYPE_IBSS (1<<0) /* Tx by: STA */
37 #define WLAN_CAPABILITY_DMG_TYPE_PBSS (2<<0) /* Tx by: PCP */
38 #define WLAN_CAPABILITY_DMG_TYPE_AP (3<<0) /* Tx by: AP */
40 #define WLAN_CAPABILITY_DMG_CBAP_ONLY (1<<2)
41 #define WLAN_CAPABILITY_DMG_CBAP_SOURCE (1<<3)
42 #define WLAN_CAPABILITY_DMG_PRIVACY (1<<4)
43 #define WLAN_CAPABILITY_DMG_ECPAC (1<<5)
45 #define WLAN_CAPABILITY_DMG_SPECTRUM_MGMT (1<<8)
46 #define WLAN_CAPABILITY_DMG_RADIO_MEASURE (1<<12)
48 static unsigned char ms_oui
[3] = { 0x00, 0x50, 0xf2 };
49 static unsigned char ieee80211_oui
[3] = { 0x00, 0x0f, 0xac };
50 static unsigned char wfa_oui
[3] = { 0x50, 0x6f, 0x9a };
54 enum print_ie_type type
;
55 bool show_both_ie_sets
;
58 #define IEEE80211_COUNTRY_EXTENSION_ID 201
60 union ieee80211_country_ie_triplet
{
65 } __attribute__ ((packed
)) chans
;
67 __u8 reg_extension_id
;
70 } __attribute__ ((packed
)) ext
;
71 } __attribute__ ((packed
));
73 static int handle_scan(struct nl80211_state
*state
,
76 int argc
, char **argv
,
79 struct nl_msg
*ssids
= NULL
, *freqs
= NULL
;
92 bool passive
= false, have_ssids
= false, have_freqs
= false;
93 size_t ies_len
= 0, meshid_len
= 0;
94 unsigned char *ies
= NULL
, *meshid
= NULL
, *tmpies
;
97 ssids
= nlmsg_alloc();
101 freqs
= nlmsg_alloc();
107 for (i
= 0; i
< argc
; i
++) {
110 if (strcmp(argv
[i
], "freq") == 0) {
114 } else if (strcmp(argv
[i
], "ies") == 0) {
117 } else if (strcmp(argv
[i
], "lowpri") == 0) {
119 flags
|= NL80211_SCAN_FLAG_LOW_PRIORITY
;
121 } else if (strcmp(argv
[i
], "flush") == 0) {
123 flags
|= NL80211_SCAN_FLAG_FLUSH
;
125 } else if (strcmp(argv
[i
], "ap-force") == 0) {
127 flags
|= NL80211_SCAN_FLAG_AP
;
129 } else if (strcmp(argv
[i
], "ssid") == 0) {
133 } else if (strcmp(argv
[i
], "passive") == 0) {
137 } else if (strcmp(argv
[i
], "meshid") == 0) {
144 freq
= strtoul(argv
[i
], &eptr
, 10);
145 if (eptr
!= argv
[i
] + strlen(argv
[i
])) {
146 /* failed to parse as number -- maybe a tag? */
151 NLA_PUT_U32(freqs
, i
, freq
);
154 ies
= parse_hex(argv
[i
], &ies_len
);
156 goto nla_put_failure
;
160 NLA_PUT(ssids
, i
, strlen(argv
[i
]), argv
[i
]);
163 meshid_len
= strlen(argv
[i
]);
164 meshid
= (unsigned char *) malloc(meshid_len
+ 2);
166 goto nla_put_failure
;
167 meshid
[0] = 114; /* mesh element id */
168 meshid
[1] = meshid_len
;
169 memcpy(&meshid
[2], argv
[i
], meshid_len
);
177 tmpies
= (unsigned char *) malloc(ies_len
+ meshid_len
);
179 goto nla_put_failure
;
181 memcpy(tmpies
, ies
, ies_len
);
185 memcpy(&tmpies
[ies_len
], meshid
, meshid_len
);
188 NLA_PUT(msg
, NL80211_ATTR_IE
, ies_len
+ meshid_len
, tmpies
);
193 NLA_PUT(ssids
, 1, 0, "");
195 nla_put_nested(msg
, NL80211_ATTR_SCAN_SSIDS
, ssids
);
198 nla_put_nested(msg
, NL80211_ATTR_SCAN_FREQUENCIES
, freqs
);
200 NLA_PUT_U32(msg
, NL80211_ATTR_SCAN_FLAGS
, flags
);
209 static void tab_on_first(bool *first
)
217 static void print_ssid(const uint8_t type
, uint8_t len
, const uint8_t *data
)
220 print_ssid_escaped(len
, data
);
224 #define BSS_MEMBERSHIP_SELECTOR_VHT_PHY 126
225 #define BSS_MEMBERSHIP_SELECTOR_HT_PHY 127
227 static void print_supprates(const uint8_t type
, uint8_t len
, const uint8_t *data
)
233 for (i
= 0; i
< len
; i
++) {
234 int r
= data
[i
] & 0x7f;
236 if (r
== BSS_MEMBERSHIP_SELECTOR_VHT_PHY
&& data
[i
] & 0x80)
238 else if (r
== BSS_MEMBERSHIP_SELECTOR_HT_PHY
&& data
[i
] & 0x80)
241 printf("%d.%d", r
/2, 5*(r
&1));
243 printf("%s ", data
[i
] & 0x80 ? "*" : "");
248 static void print_ds(const uint8_t type
, uint8_t len
, const uint8_t *data
)
250 printf(" channel %d\n", data
[0]);
253 static const char *country_env_str(char environment
)
255 switch (environment
) {
257 return "Indoor only";
259 return "Outdoor only";
261 return "Indoor/Outdoor";
267 static void print_country(const uint8_t type
, uint8_t len
, const uint8_t *data
)
269 printf(" %.*s", 2, data
);
271 printf("\tEnvironment: %s\n", country_env_str(data
[2]));
277 printf("\t\tNo country IE triplets present\n");
283 union ieee80211_country_ie_triplet
*triplet
= (void *) data
;
285 if (triplet
->ext
.reg_extension_id
>= IEEE80211_COUNTRY_EXTENSION_ID
) {
286 printf("\t\tExtension ID: %d Regulatory Class: %d Coverage class: %d (up to %dm)\n",
287 triplet
->ext
.reg_extension_id
,
288 triplet
->ext
.reg_class
,
289 triplet
->ext
.coverage_class
,
290 triplet
->ext
.coverage_class
* 450);
298 if (triplet
->chans
.first_channel
<= 14)
299 end_channel
= triplet
->chans
.first_channel
+ (triplet
->chans
.num_channels
- 1);
301 end_channel
= triplet
->chans
.first_channel
+ (4 * (triplet
->chans
.num_channels
- 1));
303 printf("\t\tChannels [%d - %d] @ %d dBm\n", triplet
->chans
.first_channel
, end_channel
, triplet
->chans
.max_power
);
312 static void print_powerconstraint(const uint8_t type
, uint8_t len
, const uint8_t *data
)
314 printf(" %d dB\n", data
[0]);
317 static void print_tpcreport(const uint8_t type
, uint8_t len
, const uint8_t *data
)
319 printf(" TX power: %d dBm\n", data
[0]);
320 /* printf(" Link Margin (%d dB) is reserved in Beacons\n", data[1]); */
323 static void print_erp(const uint8_t type
, uint8_t len
, const uint8_t *data
)
326 printf(" <no flags>");
328 printf(" NonERP_Present");
330 printf(" Use_Protection");
332 printf(" Barker_Preamble_Mode");
336 static void print_cipher(const uint8_t *data
)
338 if (memcmp(data
, ms_oui
, 3) == 0) {
341 printf("Use group cipher suite");
356 printf("%.02x-%.02x-%.02x:%d",
357 data
[0], data
[1] ,data
[2], data
[3]);
360 } else if (memcmp(data
, ieee80211_oui
, 3) == 0) {
363 printf("Use group cipher suite");
378 printf("AES-128-CMAC");
384 printf("%.02x-%.02x-%.02x:%d",
385 data
[0], data
[1] ,data
[2], data
[3]);
389 printf("%.02x-%.02x-%.02x:%d",
390 data
[0], data
[1] ,data
[2], data
[3]);
393 static void print_auth(const uint8_t *data
)
395 if (memcmp(data
, ms_oui
, 3) == 0) {
398 printf("IEEE 802.1X");
404 printf("%.02x-%.02x-%.02x:%d",
405 data
[0], data
[1] ,data
[2], data
[3]);
408 } else if (memcmp(data
, ieee80211_oui
, 3) == 0) {
411 printf("IEEE 802.1X");
417 printf("FT/IEEE 802.1X");
423 printf("IEEE 802.1X/SHA-256");
426 printf("PSK/SHA-256");
429 printf("%.02x-%.02x-%.02x:%d",
430 data
[0], data
[1] ,data
[2], data
[3]);
434 printf("%.02x-%.02x-%.02x:%d",
435 data
[0], data
[1] ,data
[2], data
[3]);
438 static void print_rsn_ie(const char *defcipher
, const char *defauth
,
439 uint8_t len
, const uint8_t *data
)
442 __u16 version
, count
, capa
;
445 version
= data
[0] + (data
[1] << 8);
446 tab_on_first(&first
);
447 printf("\t * Version: %d\n", version
);
453 tab_on_first(&first
);
454 printf("\t * Group cipher: %s\n", defcipher
);
455 printf("\t * Pairwise ciphers: %s\n", defcipher
);
459 tab_on_first(&first
);
460 printf("\t * Group cipher: ");
468 tab_on_first(&first
);
469 printf("\t * Pairwise ciphers: %s\n", defcipher
);
473 count
= data
[0] | (data
[1] << 8);
474 if (2 + (count
* 4) > len
)
477 tab_on_first(&first
);
478 printf("\t * Pairwise ciphers:");
479 for (i
= 0; i
< count
; i
++) {
481 print_cipher(data
+ 2 + (i
* 4));
485 data
+= 2 + (count
* 4);
486 len
-= 2 + (count
* 4);
489 tab_on_first(&first
);
490 printf("\t * Authentication suites: %s\n", defauth
);
494 count
= data
[0] | (data
[1] << 8);
495 if (2 + (count
* 4) > len
)
498 tab_on_first(&first
);
499 printf("\t * Authentication suites:");
500 for (i
= 0; i
< count
; i
++) {
502 print_auth(data
+ 2 + (i
* 4));
506 data
+= 2 + (count
* 4);
507 len
-= 2 + (count
* 4);
510 capa
= data
[0] | (data
[1] << 8);
511 tab_on_first(&first
);
512 printf("\t * Capabilities:");
516 printf(" NoPairwise");
517 switch ((capa
& 0x000c) >> 2) {
521 printf(" 2-PTKSA-RC");
524 printf(" 4-PTKSA-RC");
527 printf(" 16-PTKSA-RC");
530 switch ((capa
& 0x0030) >> 4) {
534 printf(" 2-GTKSA-RC");
537 printf(" 4-GTKSA-RC");
540 printf(" 16-GTKSA-RC");
544 printf(" MFP-required");
546 printf(" MFP-capable");
548 printf(" Peerkey-enabled");
550 printf(" SPP-AMSDU-capable");
552 printf(" SPP-AMSDU-required");
553 printf(" (0x%.4x)\n", capa
);
559 int pmkid_count
= data
[0] | (data
[1] << 8);
561 if (len
>= 2 + 16 * pmkid_count
) {
562 tab_on_first(&first
);
563 printf("\t * %d PMKIDs\n", pmkid_count
);
564 /* not printing PMKID values */
565 data
+= 2 + 16 * pmkid_count
;
566 len
-= 2 + 16 * pmkid_count
;
572 tab_on_first(&first
);
573 printf("\t * Group mgmt cipher suite: ");
582 printf("\t\t * bogus tail data (%d):", len
);
584 printf(" %.2x", *data
);
592 static void print_rsn(const uint8_t type
, uint8_t len
, const uint8_t *data
)
594 print_rsn_ie("CCMP", "IEEE 802.1X", len
, data
);
597 static void print_ht_capa(const uint8_t type
, uint8_t len
, const uint8_t *data
)
600 print_ht_capability(data
[0] | (data
[1] << 8));
601 print_ampdu_length(data
[2] & 3);
602 print_ampdu_spacing((data
[2] >> 2) & 7);
603 print_ht_mcs(data
+ 3);
606 static const char *ht_secondary_offset
[4] = {
613 static void print_ht_op(const uint8_t type
, uint8_t len
, const uint8_t *data
)
615 static const char *protection
[4] = {
621 static const char *sta_chan_width
[2] = {
627 printf("\t\t * primary channel: %d\n", data
[0]);
628 printf("\t\t * secondary channel offset: %s\n",
629 ht_secondary_offset
[data
[1] & 0x3]);
630 printf("\t\t * STA channel width: %s\n", sta_chan_width
[(data
[1] & 0x4)>>2]);
631 printf("\t\t * RIFS: %d\n", (data
[1] & 0x8)>>3);
632 printf("\t\t * HT protection: %s\n", protection
[data
[2] & 0x3]);
633 printf("\t\t * non-GF present: %d\n", (data
[2] & 0x4) >> 2);
634 printf("\t\t * OBSS non-GF present: %d\n", (data
[2] & 0x10) >> 4);
635 printf("\t\t * dual beacon: %d\n", (data
[4] & 0x40) >> 6);
636 printf("\t\t * dual CTS protection: %d\n", (data
[4] & 0x80) >> 7);
637 printf("\t\t * STBC beacon: %d\n", data
[5] & 0x1);
638 printf("\t\t * L-SIG TXOP Prot: %d\n", (data
[5] & 0x2) >> 1);
639 printf("\t\t * PCO active: %d\n", (data
[5] & 0x4) >> 2);
640 printf("\t\t * PCO phase: %d\n", (data
[5] & 0x8) >> 3);
643 static void print_capabilities(const uint8_t type
, uint8_t len
, const uint8_t *data
)
649 for (i
= 0; i
< len
; i
++) {
652 for (bit
= 0; bit
< 8; bit
++) {
653 if (!(data
[i
] & (1 << bit
)))
661 #define CAPA(bit, name) case bit: printf(" " name); break
663 switch (bit
+ base
) {
664 CAPA(0, "HT Information Exchange Supported");
665 CAPA(1, "reserved (On-demand Beacon)");
666 CAPA(2, "Extended Channel Switching");
667 CAPA(3, "reserved (Wave Indication)");
668 CAPA(4, "PSMP Capability");
669 CAPA(5, "reserved (Service Interval Granularity)");
670 CAPA(6, "S-PSMP Capability");
672 CAPA(8, "Diagnostics");
673 CAPA(9, "Multicast Diagnostics");
674 CAPA(10, "Location Tracking");
676 CAPA(12, "Proxy ARP Service");
677 CAPA(13, "Collocated Interference Reporting");
678 CAPA(14, "Civic Location");
679 CAPA(15, "Geospatial Location");
681 CAPA(17, "WNM-Sleep Mode");
682 CAPA(18, "TIM Broadcast");
683 CAPA(19, "BSS Transition");
684 CAPA(20, "QoS Traffic Capability");
685 CAPA(21, "AC Station Count");
686 CAPA(22, "Multiple BSSID");
687 CAPA(23, "Timing Measurement");
688 CAPA(24, "Channel Usage");
689 CAPA(25, "SSID List");
691 CAPA(27, "UTC TSF Offset");
692 CAPA(28, "TDLS Peer U-APSD Buffer STA Support");
693 CAPA(29, "TDLS Peer PSM Support");
694 CAPA(30, "TDLS channel switching");
695 CAPA(31, "Interworking");
698 CAPA(34, "SSPN Interface");
699 CAPA(35, "Reserved");
700 CAPA(36, "MSGCF Capability");
701 CAPA(37, "TDLS Support");
702 CAPA(38, "TDLS Prohibited");
703 CAPA(39, "TDLS Channel Switching Prohibited");
704 CAPA(40, "Reject Unadmitted Frame");
705 CAPA(44, "Identifier Location");
706 CAPA(45, "U-APSD Coexistence");
707 CAPA(46, "WNM-Notification");
708 CAPA(47, "Reserved");
709 CAPA(48, "UTF-8 SSID");
721 static void print_tim(const uint8_t type
, uint8_t len
, const uint8_t *data
)
723 printf(" DTIM Count %u DTIM Period %u Bitmap Control 0x%x "
725 data
[0], data
[1], data
[2], data
[3]);
727 printf(" (+ %u octet%s)", len
- 4, len
- 4 == 1 ? "" : "s");
731 static void print_ibssatim(const uint8_t type
, uint8_t len
, const uint8_t *data
)
733 printf(" %d TUs", (data
[1] << 8) + data
[0]);
736 static void print_vht_capa(const uint8_t type
, uint8_t len
, const uint8_t *data
)
739 print_vht_info(data
[0] | (data
[1] << 8) |
740 (data
[2] << 16) | (data
[3] << 24),
744 static void print_vht_oper(const uint8_t type
, uint8_t len
, const uint8_t *data
)
746 const char *chandwidths
[] = {
747 [0] = "20 or 40 MHz",
754 printf("\t\t * channel width: %d (%s)\n", data
[0],
755 data
[0] < ARRAY_SIZE(chandwidths
) ? chandwidths
[data
[0]] : "unknown");
756 printf("\t\t * center freq segment 1: %d\n", data
[1]);
757 printf("\t\t * center freq segment 2: %d\n", data
[2]);
758 printf("\t\t * VHT basic MCS set: 0x%.2x%.2x\n", data
[4], data
[3]);
761 static void print_obss_scan_params(const uint8_t type
, uint8_t len
, const uint8_t *data
)
764 printf("\t\t * passive dwell: %d TUs\n", (data
[1] << 8) | data
[0]);
765 printf("\t\t * active dwell: %d TUs\n", (data
[3] << 8) | data
[2]);
766 printf("\t\t * channel width trigger scan interval: %d s\n", (data
[5] << 8) | data
[4]);
767 printf("\t\t * scan passive total per channel: %d TUs\n", (data
[7] << 8) | data
[6]);
768 printf("\t\t * scan active total per channel: %d TUs\n", (data
[9] << 8) | data
[8]);
769 printf("\t\t * BSS width channel transition delay factor: %d\n", (data
[11] << 8) | data
[10]);
770 printf("\t\t * OBSS Scan Activity Threshold: %d.%02d %%\n",
771 ((data
[13] << 8) | data
[12]) / 100, ((data
[13] << 8) | data
[12]) % 100);
774 static void print_secchan_offs(const uint8_t type
, uint8_t len
, const uint8_t *data
)
776 if (data
[0] < ARRAY_SIZE(ht_secondary_offset
))
777 printf(" %s (%d)\n", ht_secondary_offset
[data
[0]], data
[0]);
779 printf(" %d\n", data
[0]);
782 static void print_bss_load(const uint8_t type
, uint8_t len
, const uint8_t *data
)
785 printf("\t\t * station count: %d\n", (data
[1] << 8) | data
[0]);
786 printf("\t\t * channel utilisation: %d/255\n", data
[2]);
787 printf("\t\t * available admission capacity: %d [*32us]\n", (data
[4] << 8) | data
[3]);
790 static void print_mesh_conf(const uint8_t type
, uint8_t len
, const uint8_t *data
)
793 printf("\t\t * Active Path Selection Protocol ID: %d\n", data
[0]);
794 printf("\t\t * Active Path Selection Metric ID: %d\n", data
[1]);
795 printf("\t\t * Congestion Control Mode ID: %d\n", data
[2]);
796 printf("\t\t * Synchronization Method ID: %d\n", data
[3]);
797 printf("\t\t * Authentication Protocol ID: %d\n", data
[4]);
798 printf("\t\t * Mesh Formation Info:\n");
799 printf("\t\t\t Number of Peerings: %d\n", (data
[5] & 0x7E) >> 1);
801 printf("\t\t\t Connected to Mesh Gate\n");
803 printf("\t\t\t Connected to AS\n");
804 printf("\t\t * Mesh Capability\n");
806 printf("\t\t\t Accepting Additional Mesh Peerings\n");
808 printf("\t\t\t MCCA Supported\n");
810 printf("\t\t\t MCCA Enabled\n");
812 printf("\t\t\t Forwarding\n");
814 printf("\t\t\t MBCA Supported\n");
816 printf("\t\t\t TBTT Adjusting\n");
818 printf("\t\t\t Mesh Power Save Level\n");
823 void (*print
)(const uint8_t type
, uint8_t len
, const uint8_t *data
);
824 uint8_t minlen
, maxlen
;
828 static void print_ie(const struct ie_print
*p
, const uint8_t type
,
829 uint8_t len
, const uint8_t *data
)
836 printf("\t%s:", p
->name
);
837 if (len
< p
->minlen
|| len
> p
->maxlen
) {
839 printf(" <invalid: %d bytes:", len
);
840 for (i
= 0; i
< len
; i
++)
841 printf(" %.02x", data
[i
]);
844 printf(" <invalid: 1 byte: %.02x>\n", data
[0]);
846 printf(" <invalid: no data>\n");
850 p
->print(type
, len
, data
);
853 #define PRINT_IGN { \
860 static const struct ie_print ieprinters
[] = {
861 [0] = { "SSID", print_ssid
, 0, 32, BIT(PRINT_SCAN
) | BIT(PRINT_LINK
), },
862 [1] = { "Supported rates", print_supprates
, 0, 255, BIT(PRINT_SCAN
), },
863 [3] = { "DS Parameter set", print_ds
, 1, 1, BIT(PRINT_SCAN
), },
864 [5] = { "TIM", print_tim
, 4, 255, BIT(PRINT_SCAN
), },
865 [6] = { "IBSS ATIM window", print_ibssatim
, 2, 2, BIT(PRINT_SCAN
), },
866 [7] = { "Country", print_country
, 3, 255, BIT(PRINT_SCAN
), },
867 [11] = { "BSS Load", print_bss_load
, 5, 5, BIT(PRINT_SCAN
), },
868 [32] = { "Power constraint", print_powerconstraint
, 1, 1, BIT(PRINT_SCAN
), },
869 [35] = { "TPC report", print_tpcreport
, 2, 2, BIT(PRINT_SCAN
), },
870 [42] = { "ERP", print_erp
, 1, 255, BIT(PRINT_SCAN
), },
871 [45] = { "HT capabilities", print_ht_capa
, 26, 26, BIT(PRINT_SCAN
), },
872 [47] = { "ERP D4.0", print_erp
, 1, 255, BIT(PRINT_SCAN
), },
873 [74] = { "Overlapping BSS scan params", print_obss_scan_params
, 14, 255, BIT(PRINT_SCAN
), },
874 [61] = { "HT operation", print_ht_op
, 22, 22, BIT(PRINT_SCAN
), },
875 [62] = { "Secondary Channel Offset", print_secchan_offs
, 1, 1, BIT(PRINT_SCAN
), },
876 [191] = { "VHT capabilities", print_vht_capa
, 12, 255, BIT(PRINT_SCAN
), },
877 [192] = { "VHT operation", print_vht_oper
, 5, 255, BIT(PRINT_SCAN
), },
878 [48] = { "RSN", print_rsn
, 2, 255, BIT(PRINT_SCAN
), },
879 [50] = { "Extended supported rates", print_supprates
, 0, 255, BIT(PRINT_SCAN
), },
880 [113] = { "MESH Configuration", print_mesh_conf
, 7, 7, BIT(PRINT_SCAN
), },
881 [114] = { "MESH ID", print_ssid
, 0, 32, BIT(PRINT_SCAN
) | BIT(PRINT_LINK
), },
882 [127] = { "Extended capabilities", print_capabilities
, 0, 255, BIT(PRINT_SCAN
), },
885 static void print_wifi_wpa(const uint8_t type
, uint8_t len
, const uint8_t *data
)
887 print_rsn_ie("TKIP", "IEEE 802.1X", len
, data
);
890 static bool print_wifi_wmm_param(const uint8_t *data
, uint8_t len
)
893 static const char *aci_tbl
[] = { "BE", "BK", "VI", "VO" };
899 printf("Parameter: not version 1: ");
903 printf("\t * Parameter version 1");
908 printf("\n\t\t * u-APSD");
912 for (i
= 0; i
< 4; i
++) {
913 printf("\n\t\t * %s:", aci_tbl
[(data
[0] >> 5) & 3]);
916 printf(" CW %d-%d", (1 << (data
[1] & 0xf)) - 1,
917 (1 << (data
[1] >> 4)) - 1);
918 printf(", AIFSN %d", data
[0] & 0xf);
919 if (data
[2] | data
[3])
920 printf(", TXOP %d usec", (data
[2] + (data
[3] << 8)) * 32);
932 static void print_wifi_wmm(const uint8_t type
, uint8_t len
, const uint8_t *data
)
938 printf(" information:");
941 if (print_wifi_wmm_param(data
+ 1, len
- 1))
945 printf(" type %d:", data
[0]);
949 for(i
= 1; i
< len
; i
++)
950 printf(" %.02x", data
[i
]);
954 static const char * wifi_wps_dev_passwd_id(uint16_t id
)
958 return "Default (PIN)";
960 return "User-specified";
962 return "Machine-specified";
968 return "Registrar-specified";
974 static void print_wifi_wps(const uint8_t type
, uint8_t len
, const uint8_t *data
)
977 __u16 subtype
, sublen
;
980 subtype
= (data
[0] << 8) + data
[1];
981 sublen
= (data
[2] << 8) + data
[3];
987 tab_on_first(&first
);
988 printf("\t * Version: %d.%d\n", data
[4] >> 4, data
[4] & 0xF);
991 tab_on_first(&first
);
992 printf("\t * Device name: %.*s\n", sublen
, data
+ 4);
996 tab_on_first(&first
);
998 printf("\t * Device Password ID: (invalid "
999 "length %d)\n", sublen
);
1002 id
= data
[4] << 8 | data
[5];
1003 printf("\t * Device Password ID: %u (%s)\n",
1004 id
, wifi_wps_dev_passwd_id(id
));
1008 tab_on_first(&first
);
1009 printf("\t * Manufacturer: %.*s\n", sublen
, data
+ 4);
1012 tab_on_first(&first
);
1013 printf("\t * Model: %.*s\n", sublen
, data
+ 4);
1016 tab_on_first(&first
);
1017 printf("\t * Model Number: %.*s\n", sublen
, data
+ 4);
1021 tab_on_first(&first
);
1022 printf("\t * Response Type: %d%s\n",
1023 val
, val
== 3 ? " (AP)" : "");
1028 tab_on_first(&first
);
1029 printf("\t * RF Bands: 0x%x\n", val
);
1034 tab_on_first(&first
);
1035 printf("\t * Selected Registrar: 0x%x\n", val
);
1039 tab_on_first(&first
);
1040 printf("\t * Serial Number: %.*s\n", sublen
, data
+ 4);
1044 tab_on_first(&first
);
1045 printf("\t * Wi-Fi Protected Setup State: %d%s%s\n",
1047 val
== 1 ? " (Unconfigured)" : "",
1048 val
== 2 ? " (Configured)" : "");
1052 tab_on_first(&first
);
1053 printf("\t * UUID: ");
1055 printf("(invalid, length=%d)\n", sublen
);
1058 printf("%02x%02x%02x%02x-%02x%02x-%02x%02x-"
1059 "%02x%02x-%02x%02x%02x%02x%02x%02x\n",
1060 data
[4], data
[5], data
[6], data
[7],
1061 data
[8], data
[9], data
[10], data
[11],
1062 data
[12], data
[13], data
[14], data
[15],
1063 data
[16], data
[17], data
[18], data
[19]);
1066 tab_on_first(&first
);
1068 printf("\t * Primary Device Type: (invalid "
1069 "length %d)\n", sublen
);
1072 printf("\t * Primary Device Type: "
1073 "%u-%02x%02x%02x%02x-%u\n",
1074 data
[4] << 8 | data
[5],
1075 data
[6], data
[7], data
[8], data
[9],
1076 data
[10] << 8 | data
[11]);
1081 tab_on_first(&first
);
1082 printf("\t * AP setup locked: 0x%.2x\n", val
);
1087 __u16 meth
= (data
[4] << 8) + data
[5];
1089 tab_on_first(&first
);
1090 printf("\t * %sConfig methods:",
1091 subtype
== 0x1053 ? "Selected Registrar ": "");
1092 #define T(bit, name) do { \
1093 if (meth & (1<<bit)) { \
1113 const __u8
*subdata
= data
+ 4;
1114 __u16 tmplen
= sublen
;
1116 tab_on_first(&first
);
1117 printf("\t * Unknown TLV (%#.4x, %d bytes):",
1120 printf(" %.2x", *subdata
);
1134 printf("\t\t * bogus tail data (%d):", len
);
1136 printf(" %.2x", *data
);
1144 static const struct ie_print wifiprinters
[] = {
1145 [1] = { "WPA", print_wifi_wpa
, 2, 255, BIT(PRINT_SCAN
), },
1146 [2] = { "WMM", print_wifi_wmm
, 1, 255, BIT(PRINT_SCAN
), },
1147 [4] = { "WPS", print_wifi_wps
, 0, 255, BIT(PRINT_SCAN
), },
1150 static inline void print_p2p(const uint8_t type
, uint8_t len
, const uint8_t *data
)
1158 sublen
= (data
[2] << 8) + data
[1];
1160 if (sublen
> len
- 3)
1164 case 0x02: /* capability */
1165 tab_on_first(&first
);
1167 printf("\t * malformed capability\n");
1170 printf("\t * Group capa: 0x%.2x, Device capa: 0x%.2x\n",
1173 case 0x0d: /* device info */
1174 if (sublen
< 6 + 2 + 8 + 1) {
1175 printf("\t * malformed device info\n");
1178 /* fall through for now */
1179 case 0x00: /* status */
1180 case 0x01: /* minor reason */
1181 case 0x03: /* device ID */
1182 case 0x04: /* GO intent */
1183 case 0x05: /* configuration timeout */
1184 case 0x06: /* listen channel */
1185 case 0x07: /* group BSSID */
1186 case 0x08: /* ext listen timing */
1187 case 0x09: /* intended interface address */
1188 case 0x0a: /* manageability */
1189 case 0x0b: /* channel list */
1190 case 0x0c: /* NoA */
1191 case 0x0e: /* group info */
1192 case 0x0f: /* group ID */
1193 case 0x10: /* interface */
1194 case 0x11: /* operating channel */
1195 case 0x12: /* invitation flags */
1196 case 0xdd: /* vendor specific */
1198 const __u8
*subdata
= data
+ 4;
1199 __u16 tmplen
= sublen
;
1201 tab_on_first(&first
);
1202 printf("\t * Unknown TLV (%#.2x, %d bytes):",
1205 printf(" %.2x", *subdata
);
1219 tab_on_first(&first
);
1220 printf("\t * bogus tail data (%d):", len
);
1222 printf(" %.2x", *data
);
1230 static const struct ie_print wfa_printers
[] = {
1231 [9] = { "P2P", print_p2p
, 2, 255, BIT(PRINT_SCAN
), },
1234 static void print_vendor(unsigned char len
, unsigned char *data
,
1235 bool unknown
, enum print_ie_type ptype
)
1240 printf("\tVendor specific: <too short> data:");
1241 for(i
= 0; i
< len
; i
++)
1242 printf(" %.02x", data
[i
]);
1247 if (len
>= 4 && memcmp(data
, ms_oui
, 3) == 0) {
1248 if (data
[3] < ARRAY_SIZE(wifiprinters
) &&
1249 wifiprinters
[data
[3]].name
&&
1250 wifiprinters
[data
[3]].flags
& BIT(ptype
)) {
1251 print_ie(&wifiprinters
[data
[3]], data
[3], len
- 4, data
+ 4);
1256 printf("\tMS/WiFi %#.2x, data:", data
[3]);
1257 for(i
= 0; i
< len
- 4; i
++)
1258 printf(" %.02x", data
[i
+ 4]);
1263 if (len
>= 4 && memcmp(data
, wfa_oui
, 3) == 0) {
1264 if (data
[3] < ARRAY_SIZE(wfa_printers
) &&
1265 wfa_printers
[data
[3]].name
&&
1266 wfa_printers
[data
[3]].flags
& BIT(ptype
)) {
1267 print_ie(&wfa_printers
[data
[3]], data
[3], len
- 4, data
+ 4);
1272 printf("\tWFA %#.2x, data:", data
[3]);
1273 for(i
= 0; i
< len
- 4; i
++)
1274 printf(" %.02x", data
[i
+ 4]);
1282 printf("\tVendor specific: OUI %.2x:%.2x:%.2x, data:",
1283 data
[0], data
[1], data
[2]);
1284 for (i
= 3; i
< len
; i
++)
1285 printf(" %.2x", data
[i
]);
1289 void print_ies(unsigned char *ie
, int ielen
, bool unknown
,
1290 enum print_ie_type ptype
)
1292 while (ielen
>= 2 && ielen
>= ie
[1]) {
1293 if (ie
[0] < ARRAY_SIZE(ieprinters
) &&
1294 ieprinters
[ie
[0]].name
&&
1295 ieprinters
[ie
[0]].flags
& BIT(ptype
)) {
1296 print_ie(&ieprinters
[ie
[0]], ie
[0], ie
[1], ie
+ 2);
1297 } else if (ie
[0] == 221 /* vendor */) {
1298 print_vendor(ie
[1], ie
+ 2, unknown
, ptype
);
1299 } else if (unknown
) {
1302 printf("\tUnknown IE (%d):", ie
[0]);
1303 for (i
=0; i
<ie
[1]; i
++)
1304 printf(" %.2x", ie
[2+i
]);
1312 static void print_capa_dmg(__u16 capa
)
1314 switch (capa
& WLAN_CAPABILITY_DMG_TYPE_MASK
) {
1315 case WLAN_CAPABILITY_DMG_TYPE_AP
:
1318 case WLAN_CAPABILITY_DMG_TYPE_PBSS
:
1321 case WLAN_CAPABILITY_DMG_TYPE_IBSS
:
1322 printf(" DMG_IBSS");
1326 if (capa
& WLAN_CAPABILITY_DMG_CBAP_ONLY
)
1327 printf(" CBAP_Only");
1328 if (capa
& WLAN_CAPABILITY_DMG_CBAP_SOURCE
)
1329 printf(" CBAP_Src");
1330 if (capa
& WLAN_CAPABILITY_DMG_PRIVACY
)
1332 if (capa
& WLAN_CAPABILITY_DMG_ECPAC
)
1334 if (capa
& WLAN_CAPABILITY_DMG_SPECTRUM_MGMT
)
1335 printf(" SpectrumMgmt");
1336 if (capa
& WLAN_CAPABILITY_DMG_RADIO_MEASURE
)
1337 printf(" RadioMeasure");
1340 static void print_capa_non_dmg(__u16 capa
)
1342 if (capa
& WLAN_CAPABILITY_ESS
)
1344 if (capa
& WLAN_CAPABILITY_IBSS
)
1346 if (capa
& WLAN_CAPABILITY_CF_POLLABLE
)
1347 printf(" CfPollable");
1348 if (capa
& WLAN_CAPABILITY_CF_POLL_REQUEST
)
1349 printf(" CfPollReq");
1350 if (capa
& WLAN_CAPABILITY_PRIVACY
)
1352 if (capa
& WLAN_CAPABILITY_SHORT_PREAMBLE
)
1353 printf(" ShortPreamble");
1354 if (capa
& WLAN_CAPABILITY_PBCC
)
1356 if (capa
& WLAN_CAPABILITY_CHANNEL_AGILITY
)
1357 printf(" ChannelAgility");
1358 if (capa
& WLAN_CAPABILITY_SPECTRUM_MGMT
)
1359 printf(" SpectrumMgmt");
1360 if (capa
& WLAN_CAPABILITY_QOS
)
1362 if (capa
& WLAN_CAPABILITY_SHORT_SLOT_TIME
)
1363 printf(" ShortSlotTime");
1364 if (capa
& WLAN_CAPABILITY_APSD
)
1366 if (capa
& WLAN_CAPABILITY_RADIO_MEASURE
)
1367 printf(" RadioMeasure");
1368 if (capa
& WLAN_CAPABILITY_DSSS_OFDM
)
1369 printf(" DSSS-OFDM");
1370 if (capa
& WLAN_CAPABILITY_DEL_BACK
)
1371 printf(" DelayedBACK");
1372 if (capa
& WLAN_CAPABILITY_IMM_BACK
)
1373 printf(" ImmediateBACK");
1376 static int print_bss_handler(struct nl_msg
*msg
, void *arg
)
1378 struct nlattr
*tb
[NL80211_ATTR_MAX
+ 1];
1379 struct genlmsghdr
*gnlh
= nlmsg_data(nlmsg_hdr(msg
));
1380 struct nlattr
*bss
[NL80211_BSS_MAX
+ 1];
1381 char mac_addr
[20], dev
[20];
1382 static struct nla_policy bss_policy
[NL80211_BSS_MAX
+ 1] = {
1383 [NL80211_BSS_TSF
] = { .type
= NLA_U64
},
1384 [NL80211_BSS_FREQUENCY
] = { .type
= NLA_U32
},
1385 [NL80211_BSS_BSSID
] = { },
1386 [NL80211_BSS_BEACON_INTERVAL
] = { .type
= NLA_U16
},
1387 [NL80211_BSS_CAPABILITY
] = { .type
= NLA_U16
},
1388 [NL80211_BSS_INFORMATION_ELEMENTS
] = { },
1389 [NL80211_BSS_SIGNAL_MBM
] = { .type
= NLA_U32
},
1390 [NL80211_BSS_SIGNAL_UNSPEC
] = { .type
= NLA_U8
},
1391 [NL80211_BSS_STATUS
] = { .type
= NLA_U32
},
1392 [NL80211_BSS_SEEN_MS_AGO
] = { .type
= NLA_U32
},
1393 [NL80211_BSS_BEACON_IES
] = { },
1395 struct scan_params
*params
= arg
;
1396 int show
= params
->show_both_ie_sets
? 2 : 1;
1397 bool is_dmg
= false;
1399 nla_parse(tb
, NL80211_ATTR_MAX
, genlmsg_attrdata(gnlh
, 0),
1400 genlmsg_attrlen(gnlh
, 0), NULL
);
1402 if (!tb
[NL80211_ATTR_BSS
]) {
1403 fprintf(stderr
, "bss info missing!\n");
1406 if (nla_parse_nested(bss
, NL80211_BSS_MAX
,
1407 tb
[NL80211_ATTR_BSS
],
1409 fprintf(stderr
, "failed to parse nested attributes!\n");
1413 if (!bss
[NL80211_BSS_BSSID
])
1416 mac_addr_n2a(mac_addr
, nla_data(bss
[NL80211_BSS_BSSID
]));
1417 printf("BSS %s", mac_addr
);
1418 if (tb
[NL80211_ATTR_IFINDEX
]) {
1419 if_indextoname(nla_get_u32(tb
[NL80211_ATTR_IFINDEX
]), dev
);
1420 printf("(on %s)", dev
);
1423 if (bss
[NL80211_BSS_STATUS
]) {
1424 switch (nla_get_u32(bss
[NL80211_BSS_STATUS
])) {
1425 case NL80211_BSS_STATUS_AUTHENTICATED
:
1426 printf(" -- authenticated");
1428 case NL80211_BSS_STATUS_ASSOCIATED
:
1429 printf(" -- associated");
1431 case NL80211_BSS_STATUS_IBSS_JOINED
:
1432 printf(" -- joined");
1435 printf(" -- unknown status: %d",
1436 nla_get_u32(bss
[NL80211_BSS_STATUS
]));
1442 if (bss
[NL80211_BSS_TSF
]) {
1443 unsigned long long tsf
;
1444 tsf
= (unsigned long long)nla_get_u64(bss
[NL80211_BSS_TSF
]);
1445 printf("\tTSF: %llu usec (%llud, %.2lld:%.2llu:%.2llu)\n",
1446 tsf
, tsf
/1000/1000/60/60/24, (tsf
/1000/1000/60/60) % 24,
1447 (tsf
/1000/1000/60) % 60, (tsf
/1000/1000) % 60);
1449 if (bss
[NL80211_BSS_FREQUENCY
]) {
1450 int freq
= nla_get_u32(bss
[NL80211_BSS_FREQUENCY
]);
1451 printf("\tfreq: %d\n", freq
);
1455 if (bss
[NL80211_BSS_BEACON_INTERVAL
])
1456 printf("\tbeacon interval: %d TUs\n",
1457 nla_get_u16(bss
[NL80211_BSS_BEACON_INTERVAL
]));
1458 if (bss
[NL80211_BSS_CAPABILITY
]) {
1459 __u16 capa
= nla_get_u16(bss
[NL80211_BSS_CAPABILITY
]);
1460 printf("\tcapability:");
1462 print_capa_dmg(capa
);
1464 print_capa_non_dmg(capa
);
1465 printf(" (0x%.4x)\n", capa
);
1467 if (bss
[NL80211_BSS_SIGNAL_MBM
]) {
1468 int s
= nla_get_u32(bss
[NL80211_BSS_SIGNAL_MBM
]);
1469 printf("\tsignal: %d.%.2d dBm\n", s
/100, s
%100);
1471 if (bss
[NL80211_BSS_SIGNAL_UNSPEC
]) {
1472 unsigned char s
= nla_get_u8(bss
[NL80211_BSS_SIGNAL_UNSPEC
]);
1473 printf("\tsignal: %d/100\n", s
);
1475 if (bss
[NL80211_BSS_SEEN_MS_AGO
]) {
1476 int age
= nla_get_u32(bss
[NL80211_BSS_SEEN_MS_AGO
]);
1477 printf("\tlast seen: %d ms ago\n", age
);
1480 if (bss
[NL80211_BSS_INFORMATION_ELEMENTS
] && show
--) {
1481 if (bss
[NL80211_BSS_BEACON_IES
])
1482 printf("\tInformation elements from Probe Response "
1484 print_ies(nla_data(bss
[NL80211_BSS_INFORMATION_ELEMENTS
]),
1485 nla_len(bss
[NL80211_BSS_INFORMATION_ELEMENTS
]),
1486 params
->unknown
, params
->type
);
1488 if (bss
[NL80211_BSS_BEACON_IES
] && show
--) {
1489 printf("\tInformation elements from Beacon frame:\n");
1490 print_ies(nla_data(bss
[NL80211_BSS_BEACON_IES
]),
1491 nla_len(bss
[NL80211_BSS_BEACON_IES
]),
1492 params
->unknown
, params
->type
);
1498 static struct scan_params scan_params
;
1500 static int handle_scan_dump(struct nl80211_state
*state
,
1503 int argc
, char **argv
,
1509 memset(&scan_params
, 0, sizeof(scan_params
));
1511 if (argc
== 1 && !strcmp(argv
[0], "-u"))
1512 scan_params
.unknown
= true;
1513 else if (argc
== 1 && !strcmp(argv
[0], "-b"))
1514 scan_params
.show_both_ie_sets
= true;
1516 scan_params
.type
= PRINT_SCAN
;
1518 nl_cb_set(cb
, NL_CB_VALID
, NL_CB_CUSTOM
, print_bss_handler
,
1523 static int handle_scan_combined(struct nl80211_state
*state
,
1526 int argc
, char **argv
,
1530 static char *dump_argv
[] = {
1536 static const __u32 cmds
[] = {
1537 NL80211_CMD_NEW_SCAN_RESULTS
,
1538 NL80211_CMD_SCAN_ABORTED
,
1540 int trig_argc
, dump_argc
, err
;
1542 if (argc
>= 3 && !strcmp(argv
[2], "-u")) {
1544 dump_argv
[3] = "-u";
1545 } else if (argc
>= 3 && !strcmp(argv
[2], "-b")) {
1547 dump_argv
[3] = "-b";
1551 trig_argc
= 3 + (argc
- 2) + (3 - dump_argc
);
1552 trig_argv
= calloc(trig_argc
, sizeof(*trig_argv
));
1555 trig_argv
[0] = argv
[0];
1556 trig_argv
[1] = "scan";
1557 trig_argv
[2] = "trigger";
1559 for (i
= 0; i
< argc
- 2 - (dump_argc
- 3); i
++)
1560 trig_argv
[i
+ 3] = argv
[i
+ 2 + (dump_argc
- 3)];
1561 err
= handle_cmd(state
, id
, trig_argc
, trig_argv
);
1567 * WARNING: DO NOT COPY THIS CODE INTO YOUR APPLICATION
1569 * This code has a bug, which requires creating a separate
1570 * nl80211 socket to fix:
1571 * It is possible for a NL80211_CMD_NEW_SCAN_RESULTS or
1572 * NL80211_CMD_SCAN_ABORTED message to be sent by the kernel
1573 * before (!) we listen to it, because we only start listening
1574 * after we send our scan request.
1576 * Doing it the other way around has a race condition as well,
1577 * if you first open the events socket you may get a notification
1578 * for a previous scan.
1580 * The only proper way to fix this would be to listen to events
1581 * before sending the command, and for the kernel to send the
1582 * scan request along with the event, so that you can match up
1583 * whether the scan you requested was finished or aborted (this
1584 * may result in processing a scan that another application
1585 * requested, but that doesn't seem to be a problem).
1587 * Alas, the kernel doesn't do that (yet).
1590 if (listen_events(state
, ARRAY_SIZE(cmds
), cmds
) ==
1591 NL80211_CMD_SCAN_ABORTED
) {
1592 printf("scan aborted!\n");
1596 dump_argv
[0] = argv
[0];
1597 return handle_cmd(state
, id
, dump_argc
, dump_argv
);
1599 TOPLEVEL(scan
, "[-u] [freq <freq>*] [ies <hex as 00:11:..>] [meshid <meshid>] [lowpri,flush,ap-force] [ssid <ssid>*|passive]", 0, 0,
1600 CIB_NETDEV
, handle_scan_combined
,
1601 "Scan on the given frequencies and probe for the given SSIDs\n"
1602 "(or wildcard if not given) unless passive scanning is requested.\n"
1603 "If -u is specified print unknown data in the scan results.\n"
1604 "Specified (vendor) IEs must be well-formed.");
1605 COMMAND(scan
, dump
, "[-u]",
1606 NL80211_CMD_GET_SCAN
, NLM_F_DUMP
, CIB_NETDEV
, handle_scan_dump
,
1607 "Dump the current scan results. If -u is specified, print unknown\n"
1608 "data in scan results.");
1609 COMMAND(scan
, trigger
, "[freq <freq>*] [ies <hex as 00:11:..>] [meshid <meshid>] [lowpri,flush,ap-force] [ssid <ssid>*|passive]",
1610 NL80211_CMD_TRIGGER_SCAN
, 0, CIB_NETDEV
, handle_scan
,
1611 "Trigger a scan on the given frequencies with probing for the given\n"
1612 "SSIDs (or wildcard if not given) unless passive scanning is requested.");