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];
209 snprintf(buf, sizeof(buf), "unknown");
214 if (c->auth_algs && !c->wpa_version)
216 if ((c->auth_algs & IWINFO_AUTH_OPEN) &&
217 (c->auth_algs & IWINFO_AUTH_SHARED))
219 snprintf(buf, sizeof(buf), "WEP Open/Shared (%s)",
220 format_enc_ciphers(c->pair_ciphers));
222 else if (c->auth_algs & IWINFO_AUTH_OPEN)
224 snprintf(buf, sizeof(buf), "WEP Open System (%s)",
225 format_enc_ciphers(c->pair_ciphers));
227 else if (c->auth_algs & IWINFO_AUTH_SHARED)
229 snprintf(buf, sizeof(buf), "WEP Shared Auth (%s)",
230 format_enc_ciphers(c->pair_ciphers));
235 else if (c->wpa_version)
237 switch (c->wpa_version) {
239 snprintf(buf, sizeof(buf), "WPA3 %s (%s)",
240 format_enc_suites(c->auth_suites),
241 format_enc_ciphers(c->pair_ciphers | c->group_ciphers));
245 snprintf(buf, sizeof(buf), "mixed WPA/WPA2 %s (%s)",
246 format_enc_suites(c->auth_suites),
247 format_enc_ciphers(c->pair_ciphers | c->group_ciphers));
251 snprintf(buf, sizeof(buf), "WPA2 %s (%s)",
252 format_enc_suites(c->auth_suites),
253 format_enc_ciphers(c->pair_ciphers | c->group_ciphers));
257 snprintf(buf, sizeof(buf), "WPA %s (%s)",
258 format_enc_suites(c->auth_suites),
259 format_enc_ciphers(c->pair_ciphers | c->group_ciphers));
265 snprintf(buf, sizeof(buf), "none");
270 snprintf(buf, sizeof(buf), "none");
276 static char * format_hwmodes(int modes)
281 snprintf(buf, sizeof(buf), "unknown");
283 snprintf(buf, sizeof(buf), "802.11%s%s%s%s%s%s",
284 (modes & IWINFO_80211_A) ? "a" : "",
285 (modes & IWINFO_80211_B) ? "b" : "",
286 (modes & IWINFO_80211_G) ? "g" : "",
287 (modes & IWINFO_80211_N) ? "n" : "",
288 (modes & IWINFO_80211_AC) ? "ac" : "",
289 (modes & IWINFO_80211_AD) ? "ad" : "");
294 static char * format_assocrate(struct iwinfo_rate_entry *r)
302 snprintf(buf, sizeof(buf), "unknown");
306 p += snprintf(p, l, "%s", format_rate(r->rate));
307 l = sizeof(buf) - (p - buf);
311 p += snprintf(p, l, ", MCS %d, %dMHz", r->mcs, r->mhz);
312 l = sizeof(buf) - (p - buf);
316 p += snprintf(p, l, ", VHT-MCS %d, %dMHz", r->mcs, r->mhz);
317 l = sizeof(buf) - (p - buf);
321 p += snprintf(p, l, ", VHT-NSS %d", r->nss);
322 l = sizeof(buf) - (p - buf);
331 static const char * print_type(const struct iwinfo_ops *iw, const char *ifname)
333 const char *type = iwinfo_type(ifname);
334 return type ? type : "unknown";
337 static char * print_hardware_id(const struct iwinfo_ops *iw, const char *ifname)
340 struct iwinfo_hardware_id ids;
342 if (!iw->hardware_id(ifname, (char *)&ids))
344 snprintf(buf, sizeof(buf), "%04X:%04X %04X:%04X",
345 ids.vendor_id, ids.device_id,
346 ids.subsystem_vendor_id, ids.subsystem_device_id);
350 snprintf(buf, sizeof(buf), "unknown");
356 static char * print_hardware_name(const struct iwinfo_ops *iw, const char *ifname)
358 static char buf[128];
360 if (iw->hardware_name(ifname, buf))
361 snprintf(buf, sizeof(buf), "unknown");
366 static char * print_txpower_offset(const struct iwinfo_ops *iw, const char *ifname)
371 if (iw->txpower_offset(ifname, &off))
372 snprintf(buf, sizeof(buf), "unknown");
374 snprintf(buf, sizeof(buf), "%d dB", off);
376 snprintf(buf, sizeof(buf), "none");
381 static char * print_frequency_offset(const struct iwinfo_ops *iw, const char *ifname)
386 if (iw->frequency_offset(ifname, &off))
387 snprintf(buf, sizeof(buf), "unknown");
389 snprintf(buf, sizeof(buf), "%.3f GHz", ((float)off / 1000.0));
391 snprintf(buf, sizeof(buf), "none");
396 static char * print_ssid(const struct iwinfo_ops *iw, const char *ifname)
398 char buf[IWINFO_ESSID_MAX_SIZE+1] = { 0 };
400 if (iw->ssid(ifname, buf))
401 memset(buf, 0, sizeof(buf));
403 return format_ssid(buf);
406 static char * print_bssid(const struct iwinfo_ops *iw, const char *ifname)
408 static char buf[18] = { 0 };
410 if (iw->bssid(ifname, buf))
411 snprintf(buf, sizeof(buf), "00:00:00:00:00:00");
416 static char * print_mode(const struct iwinfo_ops *iw, const char *ifname)
419 static char buf[128];
421 if (iw->mode(ifname, &mode))
422 mode = IWINFO_OPMODE_UNKNOWN;
424 snprintf(buf, sizeof(buf), "%s", IWINFO_OPMODE_NAMES[mode]);
429 static char * print_channel(const struct iwinfo_ops *iw, const char *ifname)
432 if (iw->channel(ifname, &ch))
435 return format_channel(ch);
438 static char * print_frequency(const struct iwinfo_ops *iw, const char *ifname)
441 if (iw->frequency(ifname, &freq))
444 return format_frequency(freq);
447 static char * print_txpower(const struct iwinfo_ops *iw, const char *ifname)
450 if (iw->txpower_offset(ifname, &off))
453 if (iw->txpower(ifname, &pwr))
458 return format_txpower(pwr);
461 static char * print_quality(const struct iwinfo_ops *iw, const char *ifname)
464 if (iw->quality(ifname, &qual))
467 return format_quality(qual);
470 static char * print_quality_max(const struct iwinfo_ops *iw, const char *ifname)
473 if (iw->quality_max(ifname, &qmax))
476 return format_quality_max(qmax);
479 static char * print_signal(const struct iwinfo_ops *iw, const char *ifname)
482 if (iw->signal(ifname, &sig))
485 return format_signal(sig);
488 static char * print_noise(const struct iwinfo_ops *iw, const char *ifname)
491 if (iw->noise(ifname, &noise))
494 return format_noise(noise);
497 static char * print_rate(const struct iwinfo_ops *iw, const char *ifname)
500 if (iw->bitrate(ifname, &rate))
503 return format_rate(rate);
506 static char * print_encryption(const struct iwinfo_ops *iw, const char *ifname)
508 struct iwinfo_crypto_entry c = { 0 };
509 if (iw->encryption(ifname, (char *)&c))
510 return format_encryption(NULL);
512 return format_encryption(&c);
515 static char * print_hwmodes(const struct iwinfo_ops *iw, const char *ifname)
518 if (iw->hwmodelist(ifname, &modes))
521 return format_hwmodes(modes);
524 static char * print_mbssid_supp(const struct iwinfo_ops *iw, const char *ifname)
529 if (iw->mbssid_support(ifname, &supp))
530 snprintf(buf, sizeof(buf), "no");
532 snprintf(buf, sizeof(buf), "%s", supp ? "yes" : "no");
537 static char * print_phyname(const struct iwinfo_ops *iw, const char *ifname)
541 if (!iw->phyname(ifname, buf))
548 static void print_info(const struct iwinfo_ops *iw, const char *ifname)
550 printf("%-9s ESSID: %s\n",
552 print_ssid(iw, ifname));
553 printf(" Access Point: %s\n",
554 print_bssid(iw, ifname));
555 printf(" Mode: %s Channel: %s (%s)\n",
556 print_mode(iw, ifname),
557 print_channel(iw, ifname),
558 print_frequency(iw, ifname));
559 printf(" Tx-Power: %s Link Quality: %s/%s\n",
560 print_txpower(iw, ifname),
561 print_quality(iw, ifname),
562 print_quality_max(iw, ifname));
563 printf(" Signal: %s Noise: %s\n",
564 print_signal(iw, ifname),
565 print_noise(iw, ifname));
566 printf(" Bit Rate: %s\n",
567 print_rate(iw, ifname));
568 printf(" Encryption: %s\n",
569 print_encryption(iw, ifname));
570 printf(" Type: %s HW Mode(s): %s\n",
571 print_type(iw, ifname),
572 print_hwmodes(iw, ifname));
573 printf(" Hardware: %s [%s]\n",
574 print_hardware_id(iw, ifname),
575 print_hardware_name(iw, ifname));
576 printf(" TX power offset: %s\n",
577 print_txpower_offset(iw, ifname));
578 printf(" Frequency offset: %s\n",
579 print_frequency_offset(iw, ifname));
580 printf(" Supports VAPs: %s PHY name: %s\n",
581 print_mbssid_supp(iw, ifname),
582 print_phyname(iw, ifname));
586 static void print_scanlist(const struct iwinfo_ops *iw, const char *ifname)
589 char buf[IWINFO_BUFSIZE];
590 struct iwinfo_scanlist_entry *e;
592 if (iw->scanlist(ifname, buf, &len))
594 printf("Scanning not possible\n\n");
599 printf("No scan results\n\n");
603 for (i = 0, x = 1; i < len; i += sizeof(struct iwinfo_scanlist_entry), x++)
605 e = (struct iwinfo_scanlist_entry *) &buf[i];
607 printf("Cell %02d - Address: %s\n",
609 format_bssid(e->mac));
610 printf(" ESSID: %s\n",
611 format_ssid(e->ssid));
612 printf(" Mode: %s Channel: %s\n",
613 IWINFO_OPMODE_NAMES[e->mode],
614 format_channel(e->channel));
615 printf(" Signal: %s Quality: %s/%s\n",
616 format_signal(e->signal - 0x100),
617 format_quality(e->quality),
618 format_quality_max(e->quality_max));
619 printf(" Encryption: %s\n\n",
620 format_encryption(&e->crypto));
625 static void print_txpwrlist(const struct iwinfo_ops *iw, const char *ifname)
627 int len, pwr, off, i;
628 char buf[IWINFO_BUFSIZE];
629 struct iwinfo_txpwrlist_entry *e;
631 if (iw->txpwrlist(ifname, buf, &len) || len <= 0)
633 printf("No TX power information available\n");
637 if (iw->txpower(ifname, &pwr))
640 if (iw->txpower_offset(ifname, &off))
643 for (i = 0; i < len; i += sizeof(struct iwinfo_txpwrlist_entry))
645 e = (struct iwinfo_txpwrlist_entry *) &buf[i];
647 printf("%s%3d dBm (%4d mW)\n",
648 (pwr == e->dbm) ? "*" : " ",
650 iwinfo_dbm2mw(e->dbm + off));
655 static void print_freqlist(const struct iwinfo_ops *iw, const char *ifname)
658 char buf[IWINFO_BUFSIZE];
659 struct iwinfo_freqlist_entry *e;
661 if (iw->freqlist(ifname, buf, &len) || len <= 0)
663 printf("No frequency information available\n");
667 if (iw->channel(ifname, &ch))
670 for (i = 0; i < len; i += sizeof(struct iwinfo_freqlist_entry))
672 e = (struct iwinfo_freqlist_entry *) &buf[i];
674 printf("%s %s (Channel %s)%s\n",
675 (ch == e->channel) ? "*" : " ",
676 format_frequency(e->mhz),
677 format_channel(e->channel),
678 e->restricted ? " [restricted]" : "");
683 static void print_assoclist(const struct iwinfo_ops *iw, const char *ifname)
686 char buf[IWINFO_BUFSIZE];
687 struct iwinfo_assoclist_entry *e;
689 if (iw->assoclist(ifname, buf, &len))
691 printf("No information available\n");
696 printf("No station connected\n");
700 for (i = 0; i < len; i += sizeof(struct iwinfo_assoclist_entry))
702 e = (struct iwinfo_assoclist_entry *) &buf[i];
704 printf("%s %s / %s (SNR %d) %d ms ago\n",
705 format_bssid(e->mac),
706 format_signal(e->signal),
707 format_noise(e->noise),
708 (e->signal - e->noise),
711 printf(" RX: %-38s %8d Pkts.\n",
712 format_assocrate(&e->rx_rate),
716 printf(" TX: %-38s %8d Pkts.\n",
717 format_assocrate(&e->tx_rate),
721 printf(" expected throughput: %s\n\n",
722 format_rate(e->thr));
727 static char * lookup_country(char *buf, int len, int iso3166)
730 struct iwinfo_country_entry *c;
732 for (i = 0; i < len; i += sizeof(struct iwinfo_country_entry))
734 c = (struct iwinfo_country_entry *) &buf[i];
736 if (c->iso3166 == iso3166)
743 static void print_countrylist(const struct iwinfo_ops *iw, const char *ifname)
746 char buf[IWINFO_BUFSIZE];
749 const struct iwinfo_iso3166_label *l;
751 if (iw->countrylist(ifname, buf, &len))
753 printf("No country code information available\n");
757 if (iw->country(ifname, curcode))
758 memset(curcode, 0, sizeof(curcode));
760 for (l = IWINFO_ISO3166_NAMES; l->iso3166; l++)
762 if ((ccode = lookup_country(buf, len, l->iso3166)) != NULL)
764 printf("%s %4s %c%c\n",
765 strncmp(ccode, curcode, 2) ? " " : "*",
766 ccode, (l->iso3166 / 256), (l->iso3166 % 256));
771 static void print_htmodelist(const struct iwinfo_ops *iw, const char *ifname)
775 if (iw->htmodelist(ifname, &htmodes))
777 printf("No HT mode information available\n");
781 for (i = 0; i < ARRAY_SIZE(IWINFO_HTMODE_NAMES); i++)
782 if (htmodes & (1 << i))
783 printf("%s ", IWINFO_HTMODE_NAMES[i]);
788 static void lookup_phy(const struct iwinfo_ops *iw, const char *section)
790 char buf[IWINFO_BUFSIZE];
794 fprintf(stderr, "Not supported\n");
798 if (iw->lookup_phy(section, buf))
800 fprintf(stderr, "Phy not found\n");
808 int main(int argc, char **argv)
812 const struct iwinfo_ops *iw;
815 if (argc > 1 && argc < 3)
819 " iwinfo <device> info\n"
820 " iwinfo <device> scan\n"
821 " iwinfo <device> txpowerlist\n"
822 " iwinfo <device> freqlist\n"
823 " iwinfo <device> assoclist\n"
824 " iwinfo <device> countrylist\n"
825 " iwinfo <device> htmodelist\n"
826 " iwinfo <backend> phyname <section>\n"
834 glob("/sys/class/net/*", 0, NULL, &globbuf);
836 for (i = 0; i < globbuf.gl_pathc; i++)
838 p = strrchr(globbuf.gl_pathv[i], '/');
843 iw = iwinfo_backend(++p);
858 iw = iwinfo_backend_by_name(argv[1]);
862 fprintf(stderr, "No such wireless backend: %s\n", argv[1]);
870 lookup_phy(iw, argv[3]);
874 fprintf(stderr, "Unknown command: %s\n", argv[2]);
881 iw = iwinfo_backend(argv[1]);
885 fprintf(stderr, "No such wireless device: %s\n", argv[1]);
890 for (i = 2; i < argc; i++)
895 print_info(iw, argv[1]);
899 print_scanlist(iw, argv[1]);
903 print_txpwrlist(iw, argv[1]);
907 print_freqlist(iw, argv[1]);
911 print_assoclist(iw, argv[1]);
915 print_countrylist(iw, argv[1]);
919 print_htmodelist(iw, argv[1]);
923 fprintf(stderr, "Unknown command: %s\n", argv[i]);