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/.
24 static char * format_bssid(unsigned char *mac)
28 snprintf(buf, sizeof(buf), "%02X:%02X:%02X:%02X:%02X:%02X",
29 mac[0], mac[1], mac[2], mac[3], mac[4], mac[5]);
34 static char * format_ssid(char *ssid)
36 static char buf[IWINFO_ESSID_MAX_SIZE+3];
39 snprintf(buf, sizeof(buf), "\"%s\"", ssid);
41 snprintf(buf, sizeof(buf), "unknown");
46 static char * format_channel(int ch)
51 snprintf(buf, sizeof(buf), "unknown");
53 snprintf(buf, sizeof(buf), "%d", ch);
58 static char * format_frequency(int freq)
63 snprintf(buf, sizeof(buf), "unknown");
65 snprintf(buf, sizeof(buf), "%.3f GHz", ((float)freq / 1000.0));
70 static char * format_txpower(int pwr)
75 snprintf(buf, sizeof(buf), "unknown");
77 snprintf(buf, sizeof(buf), "%d dBm", pwr);
82 static char * format_quality(int qual)
87 snprintf(buf, sizeof(buf), "unknown");
89 snprintf(buf, sizeof(buf), "%d", qual);
94 static char * format_quality_max(int qmax)
99 snprintf(buf, sizeof(buf), "unknown");
101 snprintf(buf, sizeof(buf), "%d", qmax);
106 static char * format_signal(int sig)
111 snprintf(buf, sizeof(buf), "unknown");
113 snprintf(buf, sizeof(buf), "%d dBm", sig);
118 static char * format_noise(int noise)
123 snprintf(buf, sizeof(buf), "unknown");
125 snprintf(buf, sizeof(buf), "%d dBm", noise);
130 static char * format_rate(int rate)
135 snprintf(buf, sizeof(buf), "unknown");
137 snprintf(buf, sizeof(buf), "%.1f MBit/s", ((float)rate / 1000.0));
142 static char * format_enc_ciphers(int ciphers)
144 static char str[128] = { 0 };
147 if (ciphers & IWINFO_CIPHER_WEP40)
148 pos += sprintf(pos, "WEP-40, ");
150 if (ciphers & IWINFO_CIPHER_WEP104)
151 pos += sprintf(pos, "WEP-104, ");
153 if (ciphers & IWINFO_CIPHER_TKIP)
154 pos += sprintf(pos, "TKIP, ");
156 if (ciphers & IWINFO_CIPHER_CCMP)
157 pos += sprintf(pos, "CCMP, ");
159 if (ciphers & IWINFO_CIPHER_WRAP)
160 pos += sprintf(pos, "WRAP, ");
162 if (ciphers & IWINFO_CIPHER_AESOCB)
163 pos += sprintf(pos, "AES-OCB, ");
165 if (ciphers & IWINFO_CIPHER_CKIP)
166 pos += sprintf(pos, "CKIP, ");
168 if (!ciphers || (ciphers & IWINFO_CIPHER_NONE))
169 pos += sprintf(pos, "NONE, ");
176 static char * format_enc_suites(int suites)
178 static char str[64] = { 0 };
181 if (suites & IWINFO_KMGMT_PSK)
182 pos += sprintf(pos, "PSK/");
184 if (suites & IWINFO_KMGMT_8021x)
185 pos += sprintf(pos, "802.1X/");
187 if (!suites || (suites & IWINFO_KMGMT_NONE))
188 pos += sprintf(pos, "NONE/");
195 static char * format_encryption(struct iwinfo_crypto_entry *c)
197 static char buf[512];
201 snprintf(buf, sizeof(buf), "unknown");
206 if (c->auth_algs && !c->wpa_version)
208 if ((c->auth_algs & IWINFO_AUTH_OPEN) &&
209 (c->auth_algs & IWINFO_AUTH_SHARED))
211 snprintf(buf, sizeof(buf), "WEP Open/Shared (%s)",
212 format_enc_ciphers(c->pair_ciphers));
214 else if (c->auth_algs & IWINFO_AUTH_OPEN)
216 snprintf(buf, sizeof(buf), "WEP Open System (%s)",
217 format_enc_ciphers(c->pair_ciphers));
219 else if (c->auth_algs & IWINFO_AUTH_SHARED)
221 snprintf(buf, sizeof(buf), "WEP Shared Auth (%s)",
222 format_enc_ciphers(c->pair_ciphers));
227 else if (c->wpa_version)
229 switch (c->wpa_version) {
231 snprintf(buf, sizeof(buf), "mixed WPA/WPA2 %s (%s)",
232 format_enc_suites(c->auth_suites),
233 format_enc_ciphers(c->pair_ciphers & c->group_ciphers));
237 snprintf(buf, sizeof(buf), "WPA2 %s (%s)",
238 format_enc_suites(c->auth_suites),
239 format_enc_ciphers(c->pair_ciphers & c->group_ciphers));
243 snprintf(buf, sizeof(buf), "WPA %s (%s)",
244 format_enc_suites(c->auth_suites),
245 format_enc_ciphers(c->pair_ciphers & c->group_ciphers));
251 snprintf(buf, sizeof(buf), "none");
256 snprintf(buf, sizeof(buf), "none");
262 static char * format_hwmodes(int modes)
267 snprintf(buf, sizeof(buf), "unknown");
269 snprintf(buf, sizeof(buf), "802.11%s%s%s%s",
270 (modes & IWINFO_80211_A) ? "a" : "",
271 (modes & IWINFO_80211_B) ? "b" : "",
272 (modes & IWINFO_80211_G) ? "g" : "",
273 (modes & IWINFO_80211_N) ? "n" : "");
279 static const char * print_type(const struct iwinfo_ops *iw, const char *ifname)
281 const char *type = iwinfo_type(ifname);
282 return type ? type : "unknown";
285 static char * print_hardware_id(const struct iwinfo_ops *iw, const char *ifname)
288 struct iwinfo_hardware_id ids;
290 if (!iw->hardware_id(ifname, (char *)&ids))
292 snprintf(buf, sizeof(buf), "%04X:%04X %04X:%04X",
293 ids.vendor_id, ids.device_id,
294 ids.subsystem_vendor_id, ids.subsystem_device_id);
298 snprintf(buf, sizeof(buf), "unknown");
304 static char * print_hardware_name(const struct iwinfo_ops *iw, const char *ifname)
306 static char buf[128];
308 if (iw->hardware_name(ifname, buf))
309 snprintf(buf, sizeof(buf), "unknown");
314 static char * print_txpower_offset(const struct iwinfo_ops *iw, const char *ifname)
319 if (iw->txpower_offset(ifname, &off))
320 snprintf(buf, sizeof(buf), "unknown");
322 snprintf(buf, sizeof(buf), "%d dB", off);
324 snprintf(buf, sizeof(buf), "none");
329 static char * print_frequency_offset(const struct iwinfo_ops *iw, const char *ifname)
334 if (iw->frequency_offset(ifname, &off))
335 snprintf(buf, sizeof(buf), "unknown");
337 snprintf(buf, sizeof(buf), "%.3f GHz", ((float)off / 1000.0));
339 snprintf(buf, sizeof(buf), "none");
344 static char * print_ssid(const struct iwinfo_ops *iw, const char *ifname)
346 char buf[IWINFO_ESSID_MAX_SIZE+1] = { 0 };
348 if (iw->ssid(ifname, buf))
349 memset(buf, 0, sizeof(buf));
351 return format_ssid(buf);
354 static char * print_bssid(const struct iwinfo_ops *iw, const char *ifname)
356 static char buf[18] = { 0 };
358 if (iw->bssid(ifname, buf))
359 snprintf(buf, sizeof(buf), "00:00:00:00:00:00");
364 static char * print_mode(const struct iwinfo_ops *iw, const char *ifname)
366 static char buf[128];
368 if (iw->mode(ifname, buf))
369 snprintf(buf, sizeof(buf), "unknown");
374 static char * print_channel(const struct iwinfo_ops *iw, const char *ifname)
377 if (iw->channel(ifname, &ch))
380 return format_channel(ch);
383 static char * print_frequency(const struct iwinfo_ops *iw, const char *ifname)
386 if (iw->frequency(ifname, &freq))
389 return format_frequency(freq);
392 static char * print_txpower(const struct iwinfo_ops *iw, const char *ifname)
395 if (iw->txpower_offset(ifname, &off))
398 if (iw->txpower(ifname, &pwr))
403 return format_txpower(pwr);
406 static char * print_quality(const struct iwinfo_ops *iw, const char *ifname)
409 if (iw->quality(ifname, &qual))
412 return format_quality(qual);
415 static char * print_quality_max(const struct iwinfo_ops *iw, const char *ifname)
418 if (iw->quality_max(ifname, &qmax))
421 return format_quality_max(qmax);
424 static char * print_signal(const struct iwinfo_ops *iw, const char *ifname)
427 if (iw->signal(ifname, &sig))
430 return format_signal(sig);
433 static char * print_noise(const struct iwinfo_ops *iw, const char *ifname)
436 if (iw->noise(ifname, &noise))
439 return format_noise(noise);
442 static char * print_rate(const struct iwinfo_ops *iw, const char *ifname)
445 if (iw->bitrate(ifname, &rate))
448 return format_rate(rate);
451 static char * print_encryption(const struct iwinfo_ops *iw, const char *ifname)
453 struct iwinfo_crypto_entry c = { 0 };
454 if (iw->encryption(ifname, (char *)&c))
455 return format_encryption(NULL);
457 return format_encryption(&c);
460 static char * print_hwmodes(const struct iwinfo_ops *iw, const char *ifname)
463 if (iw->hwmodelist(ifname, &modes))
466 return format_hwmodes(modes);
469 static char * print_mbssid_supp(const struct iwinfo_ops *iw, const char *ifname)
474 if (iw->mbssid_support(ifname, &supp))
475 snprintf(buf, sizeof(buf), "no");
477 snprintf(buf, sizeof(buf), "%s", supp ? "yes" : "no");
483 static void print_info(const struct iwinfo_ops *iw, const char *ifname)
485 printf("%-9s ESSID: %s\n",
487 print_ssid(iw, ifname));
488 printf(" Access Point: %s\n",
489 print_bssid(iw, ifname));
490 printf(" Mode: %s Channel: %s (%s)\n",
491 print_mode(iw, ifname),
492 print_channel(iw, ifname),
493 print_frequency(iw, ifname));
494 printf(" Tx-Power: %s Link Quality: %s/%s\n",
495 print_txpower(iw, ifname),
496 print_quality(iw, ifname),
497 print_quality_max(iw, ifname));
498 printf(" Signal: %s Noise: %s\n",
499 print_signal(iw, ifname),
500 print_noise(iw, ifname));
501 printf(" Bit Rate: %s\n",
502 print_rate(iw, ifname));
503 printf(" Encryption: %s\n",
504 print_encryption(iw, ifname));
505 printf(" Type: %s HW Mode(s): %s\n",
506 print_type(iw, ifname),
507 print_hwmodes(iw, ifname));
508 printf(" Hardware: %s [%s]\n",
509 print_hardware_id(iw, ifname),
510 print_hardware_name(iw, ifname));
511 printf(" TX power offset: %s\n",
512 print_txpower_offset(iw, ifname));
513 printf(" Frequency offset: %s\n",
514 print_frequency_offset(iw, ifname));
515 printf(" Supports VAPs: %s\n",
516 print_mbssid_supp(iw, ifname));
520 static void print_scanlist(const struct iwinfo_ops *iw, const char *ifname)
523 char buf[IWINFO_BUFSIZE];
524 struct iwinfo_scanlist_entry *e;
526 if (iw->scanlist(ifname, buf, &len))
528 printf("Scanning not possible\n\n");
533 printf("No scan results\n\n");
537 for (i = 0, x = 1; i < len; i += sizeof(struct iwinfo_scanlist_entry), x++)
539 e = (struct iwinfo_scanlist_entry *) &buf[i];
541 printf("Cell %02d - Address: %s\n",
543 format_bssid(e->mac));
544 printf(" ESSID: %s\n",
545 format_ssid(e->ssid));
546 printf(" Mode: %s Channel: %s\n",
547 e->mode ? (char *)e->mode : "unknown",
548 format_channel(e->channel));
549 printf(" Signal: %s Quality: %s/%s\n",
550 format_signal(e->signal - 0x100),
551 format_quality(e->quality),
552 format_quality_max(e->quality_max));
553 printf(" Encryption: %s\n\n",
554 format_encryption(&e->crypto));
559 static void print_txpwrlist(const struct iwinfo_ops *iw, const char *ifname)
561 int len, pwr, off, i;
562 char buf[IWINFO_BUFSIZE];
563 struct iwinfo_txpwrlist_entry *e;
565 if (iw->txpwrlist(ifname, buf, &len) || len <= 0)
567 printf("No TX power information available\n");
571 if (iw->txpower(ifname, &pwr))
574 if (iw->txpower_offset(ifname, &off))
577 for (i = 0; i < len; i += sizeof(struct iwinfo_txpwrlist_entry))
579 e = (struct iwinfo_txpwrlist_entry *) &buf[i];
581 printf("%s%3d dBm (%4d mW)\n",
582 (pwr == e->dbm) ? "*" : " ",
584 iwinfo_dbm2mw(e->dbm + off));
589 static void print_freqlist(const struct iwinfo_ops *iw, const char *ifname)
592 char buf[IWINFO_BUFSIZE];
593 struct iwinfo_freqlist_entry *e;
595 if (iw->freqlist(ifname, buf, &len) || len <= 0)
597 printf("No frequency information available\n");
601 if (iw->channel(ifname, &ch))
604 for (i = 0; i < len; i += sizeof(struct iwinfo_freqlist_entry))
606 e = (struct iwinfo_freqlist_entry *) &buf[i];
608 printf("%s %s (Channel %s)%s\n",
609 (ch == e->channel) ? "*" : " ",
610 format_frequency(e->mhz),
611 format_channel(e->channel),
612 e->restricted ? " [restricted]" : "");
617 static void print_assoclist(const struct iwinfo_ops *iw, const char *ifname)
620 char buf[IWINFO_BUFSIZE];
621 struct iwinfo_assoclist_entry *e;
623 if (iw->assoclist(ifname, buf, &len))
625 printf("No information available\n");
630 printf("No station connected\n");
634 for (i = 0; i < len; i += sizeof(struct iwinfo_assoclist_entry))
636 e = (struct iwinfo_assoclist_entry *) &buf[i];
638 printf("%s %s / %s (SNR %d)\n",
639 format_bssid(e->mac),
640 format_signal(e->signal),
641 format_noise(e->noise),
642 (e->signal - e->noise));
647 static char * lookup_country(char *buf, int len, int iso3166)
650 struct iwinfo_country_entry *c;
652 for (i = 0; i < len; i += sizeof(struct iwinfo_country_entry))
654 c = (struct iwinfo_country_entry *) &buf[i];
656 if (c->iso3166 == iso3166)
663 static void print_countrylist(const struct iwinfo_ops *iw, const char *ifname)
666 char buf[IWINFO_BUFSIZE];
669 const struct iwinfo_iso3166_label *l;
671 if (iw->countrylist(ifname, buf, &len))
673 printf("No country code information available\n");
677 if (iw->country(ifname, curcode))
678 memset(curcode, 0, sizeof(curcode));
680 for (l = IWINFO_ISO3166_NAMES; l->iso3166; l++)
682 if ((ccode = lookup_country(buf, len, l->iso3166)) != NULL)
684 printf("%s %4s %c%c\n",
685 strncmp(ccode, curcode, 2) ? " " : "*",
686 ccode, (l->iso3166 / 256), (l->iso3166 % 256));
692 int main(int argc, char **argv)
695 const struct iwinfo_ops *iw;
701 " iwinfo <device> info\n"
702 " iwinfo <device> scan\n"
703 " iwinfo <device> txpowerlist\n"
704 " iwinfo <device> freqlist\n"
705 " iwinfo <device> assoclist\n"
706 " iwinfo <device> countrylist\n"
712 iw = iwinfo_backend(argv[1]);
716 fprintf(stderr, "No such wireless device: %s\n", argv[1]);
720 for (i = 2; i < argc; i++)
725 print_info(iw, argv[1]);
729 print_scanlist(iw, argv[1]);
733 print_txpwrlist(iw, argv[1]);
737 print_freqlist(iw, argv[1]);
741 print_assoclist(iw, argv[1]);
745 print_countrylist(iw, argv[1]);
749 fprintf(stderr, "Unknown command: %s\n", argv[i]);