2 * iwinfo - Wireless Information Library - Command line frontend
4 * Copyright (C) 2011 Jo-Philipp Wich <xm@subsignal.org>
6 * The iwinfo library is free software: you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License version 2
8 * as published by the Free Software Foundation.
10 * The iwinfo library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 * See the GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with the iwinfo library. If not, see http://www.gnu.org/licenses/.
25 static char * format_bssid(unsigned char *mac
)
29 snprintf(buf
, sizeof(buf
), "%02X:%02X:%02X:%02X:%02X:%02X",
30 mac
[0], mac
[1], mac
[2], mac
[3], mac
[4], mac
[5]);
35 static char * format_ssid(char *ssid
)
37 static char buf
[IWINFO_ESSID_MAX_SIZE
+3];
40 snprintf(buf
, sizeof(buf
), "\"%s\"", ssid
);
42 snprintf(buf
, sizeof(buf
), "unknown");
47 static char * format_channel(int ch
)
52 snprintf(buf
, sizeof(buf
), "unknown");
54 snprintf(buf
, sizeof(buf
), "%d", ch
);
59 static char * format_frequency(int freq
)
64 snprintf(buf
, sizeof(buf
), "unknown");
66 snprintf(buf
, sizeof(buf
), "%.3f GHz", ((float)freq
/ 1000.0));
71 static char * format_txpower(int pwr
)
76 snprintf(buf
, sizeof(buf
), "unknown");
78 snprintf(buf
, sizeof(buf
), "%d dBm", pwr
);
83 static char * format_quality(int qual
)
88 snprintf(buf
, sizeof(buf
), "unknown");
90 snprintf(buf
, sizeof(buf
), "%d", qual
);
95 static char * format_quality_max(int qmax
)
100 snprintf(buf
, sizeof(buf
), "unknown");
102 snprintf(buf
, sizeof(buf
), "%d", qmax
);
107 static char * format_signal(int sig
)
112 snprintf(buf
, sizeof(buf
), "unknown");
114 snprintf(buf
, sizeof(buf
), "%d dBm", sig
);
119 static char * format_noise(int noise
)
124 snprintf(buf
, sizeof(buf
), "unknown");
126 snprintf(buf
, sizeof(buf
), "%d dBm", noise
);
131 static char * format_rate(int rate
)
136 snprintf(buf
, sizeof(buf
), "unknown");
138 snprintf(buf
, sizeof(buf
), "%d.%d MBit/s",
139 rate
/ 1000, (rate
% 1000) / 100);
144 static char * format_enc_ciphers(int ciphers
)
146 static char str
[128] = { 0 };
149 if (ciphers
& IWINFO_CIPHER_WEP40
)
150 pos
+= sprintf(pos
, "WEP-40, ");
152 if (ciphers
& IWINFO_CIPHER_WEP104
)
153 pos
+= sprintf(pos
, "WEP-104, ");
155 if (ciphers
& IWINFO_CIPHER_TKIP
)
156 pos
+= sprintf(pos
, "TKIP, ");
158 if (ciphers
& IWINFO_CIPHER_CCMP
)
159 pos
+= sprintf(pos
, "CCMP, ");
161 if (ciphers
& IWINFO_CIPHER_WRAP
)
162 pos
+= sprintf(pos
, "WRAP, ");
164 if (ciphers
& IWINFO_CIPHER_AESOCB
)
165 pos
+= sprintf(pos
, "AES-OCB, ");
167 if (ciphers
& IWINFO_CIPHER_CKIP
)
168 pos
+= sprintf(pos
, "CKIP, ");
170 if (!ciphers
|| (ciphers
& IWINFO_CIPHER_NONE
))
171 pos
+= sprintf(pos
, "NONE, ");
178 static char * format_enc_suites(int suites
)
180 static char str
[64] = { 0 };
183 if (suites
& IWINFO_KMGMT_PSK
)
184 pos
+= sprintf(pos
, "PSK/");
186 if (suites
& IWINFO_KMGMT_8021x
)
187 pos
+= sprintf(pos
, "802.1X/");
189 if (suites
& IWINFO_KMGMT_SAE
)
190 pos
+= sprintf(pos
, "SAE/");
192 if (suites
& IWINFO_KMGMT_OWE
)
193 pos
+= sprintf(pos
, "OWE/");
195 if (!suites
|| (suites
& IWINFO_KMGMT_NONE
))
196 pos
+= sprintf(pos
, "NONE/");
203 static char * format_encryption(struct iwinfo_crypto_entry
*c
)
205 static char buf
[512];
211 snprintf(buf
, sizeof(buf
), "unknown");
216 if (c
->auth_algs
&& !c
->wpa_version
)
218 if ((c
->auth_algs
& IWINFO_AUTH_OPEN
) &&
219 (c
->auth_algs
& IWINFO_AUTH_SHARED
))
221 snprintf(buf
, sizeof(buf
), "WEP Open/Shared (%s)",
222 format_enc_ciphers(c
->pair_ciphers
));
224 else if (c
->auth_algs
& IWINFO_AUTH_OPEN
)
226 snprintf(buf
, sizeof(buf
), "WEP Open System (%s)",
227 format_enc_ciphers(c
->pair_ciphers
));
229 else if (c
->auth_algs
& IWINFO_AUTH_SHARED
)
231 snprintf(buf
, sizeof(buf
), "WEP Shared Auth (%s)",
232 format_enc_ciphers(c
->pair_ciphers
));
237 else if (c
->wpa_version
)
239 for (i
= 0, n
= 0; i
< 3; i
++)
240 if (c
->wpa_version
& (1 << i
))
244 pos
+= sprintf(pos
, "mixed ");
246 for (i
= 0; i
< 3; i
++)
247 if (c
->wpa_version
& (1 << i
))
249 pos
+= sprintf(pos
, "WPA%d/", i
+ 1);
251 pos
+= sprintf(pos
, "WPA/");
255 sprintf(pos
, " %s (%s)",
256 format_enc_suites(c
->auth_suites
),
257 format_enc_ciphers(c
->pair_ciphers
| c
->group_ciphers
));
261 snprintf(buf
, sizeof(buf
), "none");
266 snprintf(buf
, sizeof(buf
), "none");
272 static char * format_hwmodes(int modes
)
277 snprintf(buf
, sizeof(buf
), "unknown");
279 snprintf(buf
, sizeof(buf
), "802.11%s%s%s%s%s%s",
280 (modes
& IWINFO_80211_A
) ? "a" : "",
281 (modes
& IWINFO_80211_B
) ? "b" : "",
282 (modes
& IWINFO_80211_G
) ? "g" : "",
283 (modes
& IWINFO_80211_N
) ? "n" : "",
284 (modes
& IWINFO_80211_AC
) ? "ac" : "",
285 (modes
& IWINFO_80211_AD
) ? "ad" : "");
290 static char * format_assocrate(struct iwinfo_rate_entry
*r
)
298 snprintf(buf
, sizeof(buf
), "unknown");
302 p
+= snprintf(p
, l
, "%s", format_rate(r
->rate
));
303 l
= sizeof(buf
) - (p
- buf
);
307 p
+= snprintf(p
, l
, ", MCS %d, %dMHz", r
->mcs
, r
->mhz
);
308 l
= sizeof(buf
) - (p
- buf
);
312 p
+= snprintf(p
, l
, ", VHT-MCS %d, %dMHz", r
->mcs
, r
->mhz
);
313 l
= sizeof(buf
) - (p
- buf
);
317 p
+= snprintf(p
, l
, ", VHT-NSS %d", r
->nss
);
318 l
= sizeof(buf
) - (p
- buf
);
327 static const char * print_type(const struct iwinfo_ops
*iw
, const char *ifname
)
329 const char *type
= iwinfo_type(ifname
);
330 return type
? type
: "unknown";
333 static char * print_hardware_id(const struct iwinfo_ops
*iw
, const char *ifname
)
336 struct iwinfo_hardware_id ids
;
338 if (!iw
->hardware_id(ifname
, (char *)&ids
))
340 snprintf(buf
, sizeof(buf
), "%04X:%04X %04X:%04X",
341 ids
.vendor_id
, ids
.device_id
,
342 ids
.subsystem_vendor_id
, ids
.subsystem_device_id
);
346 snprintf(buf
, sizeof(buf
), "unknown");
352 static char * print_hardware_name(const struct iwinfo_ops
*iw
, const char *ifname
)
354 static char buf
[128];
356 if (iw
->hardware_name(ifname
, buf
))
357 snprintf(buf
, sizeof(buf
), "unknown");
362 static char * print_txpower_offset(const struct iwinfo_ops
*iw
, const char *ifname
)
367 if (iw
->txpower_offset(ifname
, &off
))
368 snprintf(buf
, sizeof(buf
), "unknown");
370 snprintf(buf
, sizeof(buf
), "%d dB", off
);
372 snprintf(buf
, sizeof(buf
), "none");
377 static char * print_frequency_offset(const struct iwinfo_ops
*iw
, const char *ifname
)
382 if (iw
->frequency_offset(ifname
, &off
))
383 snprintf(buf
, sizeof(buf
), "unknown");
385 snprintf(buf
, sizeof(buf
), "%.3f GHz", ((float)off
/ 1000.0));
387 snprintf(buf
, sizeof(buf
), "none");
392 static char * print_ssid(const struct iwinfo_ops
*iw
, const char *ifname
)
394 char buf
[IWINFO_ESSID_MAX_SIZE
+1] = { 0 };
396 if (iw
->ssid(ifname
, buf
))
397 memset(buf
, 0, sizeof(buf
));
399 return format_ssid(buf
);
402 static char * print_bssid(const struct iwinfo_ops
*iw
, const char *ifname
)
404 static char buf
[18] = { 0 };
406 if (iw
->bssid(ifname
, buf
))
407 snprintf(buf
, sizeof(buf
), "00:00:00:00:00:00");
412 static char * print_mode(const struct iwinfo_ops
*iw
, const char *ifname
)
415 static char buf
[128];
417 if (iw
->mode(ifname
, &mode
))
418 mode
= IWINFO_OPMODE_UNKNOWN
;
420 snprintf(buf
, sizeof(buf
), "%s", IWINFO_OPMODE_NAMES
[mode
]);
425 static char * print_channel(const struct iwinfo_ops
*iw
, const char *ifname
)
428 if (iw
->channel(ifname
, &ch
))
431 return format_channel(ch
);
434 static char * print_frequency(const struct iwinfo_ops
*iw
, const char *ifname
)
437 if (iw
->frequency(ifname
, &freq
))
440 return format_frequency(freq
);
443 static char * print_txpower(const struct iwinfo_ops
*iw
, const char *ifname
)
446 if (iw
->txpower_offset(ifname
, &off
))
449 if (iw
->txpower(ifname
, &pwr
))
454 return format_txpower(pwr
);
457 static char * print_quality(const struct iwinfo_ops
*iw
, const char *ifname
)
460 if (iw
->quality(ifname
, &qual
))
463 return format_quality(qual
);
466 static char * print_quality_max(const struct iwinfo_ops
*iw
, const char *ifname
)
469 if (iw
->quality_max(ifname
, &qmax
))
472 return format_quality_max(qmax
);
475 static char * print_signal(const struct iwinfo_ops
*iw
, const char *ifname
)
478 if (iw
->signal(ifname
, &sig
))
481 return format_signal(sig
);
484 static char * print_noise(const struct iwinfo_ops
*iw
, const char *ifname
)
487 if (iw
->noise(ifname
, &noise
))
490 return format_noise(noise
);
493 static char * print_rate(const struct iwinfo_ops
*iw
, const char *ifname
)
496 if (iw
->bitrate(ifname
, &rate
))
499 return format_rate(rate
);
502 static char * print_encryption(const struct iwinfo_ops
*iw
, const char *ifname
)
504 struct iwinfo_crypto_entry c
= { 0 };
505 if (iw
->encryption(ifname
, (char *)&c
))
506 return format_encryption(NULL
);
508 return format_encryption(&c
);
511 static char * print_hwmodes(const struct iwinfo_ops
*iw
, const char *ifname
)
514 if (iw
->hwmodelist(ifname
, &modes
))
517 return format_hwmodes(modes
);
520 static char * print_mbssid_supp(const struct iwinfo_ops
*iw
, const char *ifname
)
525 if (iw
->mbssid_support(ifname
, &supp
))
526 snprintf(buf
, sizeof(buf
), "no");
528 snprintf(buf
, sizeof(buf
), "%s", supp
? "yes" : "no");
533 static char * print_phyname(const struct iwinfo_ops
*iw
, const char *ifname
)
537 if (!iw
->phyname(ifname
, buf
))
544 static void print_info(const struct iwinfo_ops
*iw
, const char *ifname
)
546 printf("%-9s ESSID: %s\n",
548 print_ssid(iw
, ifname
));
549 printf(" Access Point: %s\n",
550 print_bssid(iw
, ifname
));
551 printf(" Mode: %s Channel: %s (%s)\n",
552 print_mode(iw
, ifname
),
553 print_channel(iw
, ifname
),
554 print_frequency(iw
, ifname
));
555 printf(" Tx-Power: %s Link Quality: %s/%s\n",
556 print_txpower(iw
, ifname
),
557 print_quality(iw
, ifname
),
558 print_quality_max(iw
, ifname
));
559 printf(" Signal: %s Noise: %s\n",
560 print_signal(iw
, ifname
),
561 print_noise(iw
, ifname
));
562 printf(" Bit Rate: %s\n",
563 print_rate(iw
, ifname
));
564 printf(" Encryption: %s\n",
565 print_encryption(iw
, ifname
));
566 printf(" Type: %s HW Mode(s): %s\n",
567 print_type(iw
, ifname
),
568 print_hwmodes(iw
, ifname
));
569 printf(" Hardware: %s [%s]\n",
570 print_hardware_id(iw
, ifname
),
571 print_hardware_name(iw
, ifname
));
572 printf(" TX power offset: %s\n",
573 print_txpower_offset(iw
, ifname
));
574 printf(" Frequency offset: %s\n",
575 print_frequency_offset(iw
, ifname
));
576 printf(" Supports VAPs: %s PHY name: %s\n",
577 print_mbssid_supp(iw
, ifname
),
578 print_phyname(iw
, ifname
));
582 static void print_scanlist(const struct iwinfo_ops
*iw
, const char *ifname
)
585 char buf
[IWINFO_BUFSIZE
];
586 struct iwinfo_scanlist_entry
*e
;
588 if (iw
->scanlist(ifname
, buf
, &len
))
590 printf("Scanning not possible\n\n");
595 printf("No scan results\n\n");
599 for (i
= 0, x
= 1; i
< len
; i
+= sizeof(struct iwinfo_scanlist_entry
), x
++)
601 e
= (struct iwinfo_scanlist_entry
*) &buf
[i
];
603 printf("Cell %02d - Address: %s\n",
605 format_bssid(e
->mac
));
606 printf(" ESSID: %s\n",
607 format_ssid(e
->ssid
));
608 printf(" Mode: %s Channel: %s\n",
609 IWINFO_OPMODE_NAMES
[e
->mode
],
610 format_channel(e
->channel
));
611 printf(" Signal: %s Quality: %s/%s\n",
612 format_signal(e
->signal
- 0x100),
613 format_quality(e
->quality
),
614 format_quality_max(e
->quality_max
));
615 printf(" Encryption: %s\n",
616 format_encryption(&e
->crypto
));
617 if (e
->has_bss_load
) {
618 printf(" Station count: %u\n",
620 printf(" Channel utilization: %u/255\n",
621 e
->channel_utilization
);
622 printf(" Available admission capacity: %u (*32us)\n",
623 e
->admission_capacity
);
630 static void print_txpwrlist(const struct iwinfo_ops
*iw
, const char *ifname
)
632 int len
, pwr
, off
, i
;
633 char buf
[IWINFO_BUFSIZE
];
634 struct iwinfo_txpwrlist_entry
*e
;
636 if (iw
->txpwrlist(ifname
, buf
, &len
) || len
<= 0)
638 printf("No TX power information available\n");
642 if (iw
->txpower(ifname
, &pwr
))
645 if (iw
->txpower_offset(ifname
, &off
))
648 for (i
= 0; i
< len
; i
+= sizeof(struct iwinfo_txpwrlist_entry
))
650 e
= (struct iwinfo_txpwrlist_entry
*) &buf
[i
];
652 printf("%s%3d dBm (%4d mW)\n",
653 (pwr
== e
->dbm
) ? "*" : " ",
655 iwinfo_dbm2mw(e
->dbm
+ off
));
660 static void print_freqlist(const struct iwinfo_ops
*iw
, const char *ifname
)
663 char buf
[IWINFO_BUFSIZE
];
664 struct iwinfo_freqlist_entry
*e
;
666 if (iw
->freqlist(ifname
, buf
, &len
) || len
<= 0)
668 printf("No frequency information available\n");
672 if (iw
->channel(ifname
, &ch
))
675 for (i
= 0; i
< len
; i
+= sizeof(struct iwinfo_freqlist_entry
))
677 e
= (struct iwinfo_freqlist_entry
*) &buf
[i
];
679 printf("%s %s (Channel %s)%s\n",
680 (ch
== e
->channel
) ? "*" : " ",
681 format_frequency(e
->mhz
),
682 format_channel(e
->channel
),
683 e
->restricted
? " [restricted]" : "");
688 static void print_assoclist(const struct iwinfo_ops
*iw
, const char *ifname
)
691 char buf
[IWINFO_BUFSIZE
];
692 struct iwinfo_assoclist_entry
*e
;
694 if (iw
->assoclist(ifname
, buf
, &len
))
696 printf("No information available\n");
701 printf("No station connected\n");
705 for (i
= 0; i
< len
; i
+= sizeof(struct iwinfo_assoclist_entry
))
707 e
= (struct iwinfo_assoclist_entry
*) &buf
[i
];
709 printf("%s %s / %s (SNR %d) %d ms ago\n",
710 format_bssid(e
->mac
),
711 format_signal(e
->signal
),
712 format_noise(e
->noise
),
713 (e
->signal
- e
->noise
),
716 printf(" RX: %-38s %8d Pkts.\n",
717 format_assocrate(&e
->rx_rate
),
721 printf(" TX: %-38s %8d Pkts.\n",
722 format_assocrate(&e
->tx_rate
),
726 printf(" expected throughput: %s\n\n",
727 format_rate(e
->thr
));
732 static char * lookup_country(char *buf
, int len
, int iso3166
)
735 struct iwinfo_country_entry
*c
;
737 for (i
= 0; i
< len
; i
+= sizeof(struct iwinfo_country_entry
))
739 c
= (struct iwinfo_country_entry
*) &buf
[i
];
741 if (c
->iso3166
== iso3166
)
748 static void print_countrylist(const struct iwinfo_ops
*iw
, const char *ifname
)
751 char buf
[IWINFO_BUFSIZE
];
754 const struct iwinfo_iso3166_label
*l
;
756 if (iw
->countrylist(ifname
, buf
, &len
))
758 printf("No country code information available\n");
762 if (iw
->country(ifname
, curcode
))
763 memset(curcode
, 0, sizeof(curcode
));
765 for (l
= IWINFO_ISO3166_NAMES
; l
->iso3166
; l
++)
767 if ((ccode
= lookup_country(buf
, len
, l
->iso3166
)) != NULL
)
769 printf("%s %4s %c%c\n",
770 strncmp(ccode
, curcode
, 2) ? " " : "*",
771 ccode
, (l
->iso3166
/ 256), (l
->iso3166
% 256));
776 static void print_htmodelist(const struct iwinfo_ops
*iw
, const char *ifname
)
780 if (iw
->htmodelist(ifname
, &htmodes
))
782 printf("No HT mode information available\n");
786 for (i
= 0; i
< ARRAY_SIZE(IWINFO_HTMODE_NAMES
); i
++)
787 if (htmodes
& (1 << i
))
788 printf("%s ", IWINFO_HTMODE_NAMES
[i
]);
793 static void lookup_phy(const struct iwinfo_ops
*iw
, const char *section
)
795 char buf
[IWINFO_BUFSIZE
];
799 fprintf(stderr
, "Not supported\n");
803 if (iw
->lookup_phy(section
, buf
))
805 fprintf(stderr
, "Phy not found\n");
813 int main(int argc
, char **argv
)
817 const struct iwinfo_ops
*iw
;
820 if (argc
> 1 && argc
< 3)
824 " iwinfo <device> info\n"
825 " iwinfo <device> scan\n"
826 " iwinfo <device> txpowerlist\n"
827 " iwinfo <device> freqlist\n"
828 " iwinfo <device> assoclist\n"
829 " iwinfo <device> countrylist\n"
830 " iwinfo <device> htmodelist\n"
831 " iwinfo <backend> phyname <section>\n"
839 glob("/sys/class/net/*", 0, NULL
, &globbuf
);
841 for (i
= 0; i
< globbuf
.gl_pathc
; i
++)
843 p
= strrchr(globbuf
.gl_pathv
[i
], '/');
848 iw
= iwinfo_backend(++p
);
863 iw
= iwinfo_backend_by_name(argv
[1]);
867 fprintf(stderr
, "No such wireless backend: %s\n", argv
[1]);
875 lookup_phy(iw
, argv
[3]);
879 fprintf(stderr
, "Unknown command: %s\n", argv
[2]);
886 iw
= iwinfo_backend(argv
[1]);
890 fprintf(stderr
, "No such wireless device: %s\n", argv
[1]);
895 for (i
= 2; i
< argc
; i
++)
900 print_info(iw
, argv
[1]);
904 print_scanlist(iw
, argv
[1]);
908 print_txpwrlist(iw
, argv
[1]);
912 print_freqlist(iw
, argv
[1]);
916 print_assoclist(iw
, argv
[1]);
920 print_countrylist(iw
, argv
[1]);
924 print_htmodelist(iw
, argv
[1]);
928 fprintf(stderr
, "Unknown command: %s\n", argv
[i
]);