package/iwinfo/src/iwinfo_cli.c

   1 /*
   2  * iwinfo - Wireless Information Library - Command line frontend
   3  *
   4  *   Copyright (C) 2011 Jo-Philipp Wich <xm@subsignal.org>
   5  *
   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.
   9  *
  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.
  14  *
  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/.
  17  */
  18
  19 #include <stdio.h>
  20
  21 #include "iwinfo.h"
  22
  23
  24 static char * format_bssid(unsigned char *mac)
  25 {
  26         static char buf[18];
  27
  28         snprintf(buf, sizeof(buf), "%02X:%02X:%02X:%02X:%02X:%02X",
  29                 mac[0], mac[1], mac[2], mac[3], mac[4], mac[5]);
  30
  31         return buf;
  32 }
  33
  34 static char * format_ssid(char *ssid)
  35 {
  36         static char buf[IWINFO_ESSID_MAX_SIZE+3];
  37
  38         if (ssid && ssid[0])
  39                 snprintf(buf, sizeof(buf), "\"%s\"", ssid);
  40         else
  41                 snprintf(buf, sizeof(buf), "unknown");
  42
  43         return buf;
  44 }
  45
  46 static char * format_channel(int ch)
  47 {
  48         static char buf[8];
  49
  50         if (ch <= 0)
  51                 snprintf(buf, sizeof(buf), "unknown");
  52         else
  53                 snprintf(buf, sizeof(buf), "%d", ch);
  54
  55         return buf;
  56 }
  57
  58 static char * format_frequency(int freq)
  59 {
  60         static char buf[10];
  61
  62         if (freq <= 0)
  63                 snprintf(buf, sizeof(buf), "unknown");
  64         else
  65                 snprintf(buf, sizeof(buf), "%.3f GHz", ((float)freq / 1000.0));
  66
  67         return buf;
  68 }
  69
  70 static char * format_txpower(int pwr)
  71 {
  72         static char buf[10];
  73
  74         if (pwr < 0)
  75                 snprintf(buf, sizeof(buf), "unknown");
  76         else
  77                 snprintf(buf, sizeof(buf), "%d dBm", pwr);
  78
  79         return buf;
  80 }
  81
  82 static char * format_quality(int qual)
  83 {
  84         static char buf[8];
  85
  86         if (qual < 0)
  87                 snprintf(buf, sizeof(buf), "unknown");
  88         else
  89                 snprintf(buf, sizeof(buf), "%d", qual);
  90
  91         return buf;
  92 }
  93
  94 static char * format_quality_max(int qmax)
  95 {
  96         static char buf[8];
  97
  98         if (qmax < 0)
  99                 snprintf(buf, sizeof(buf), "unknown");
 100         else
 101                 snprintf(buf, sizeof(buf), "%d", qmax);
 102
 103         return buf;
 104 }
 105
 106 static char * format_signal(int sig)
 107 {
 108         static char buf[10];
 109
 110         if (!sig)
 111                 snprintf(buf, sizeof(buf), "unknown");
 112         else
 113                 snprintf(buf, sizeof(buf), "%d dBm", sig);
 114
 115         return buf;
 116 }
 117
 118 static char * format_noise(int noise)
 119 {
 120         static char buf[10];
 121
 122         if (!noise)
 123                 snprintf(buf, sizeof(buf), "unknown");
 124         else
 125                 snprintf(buf, sizeof(buf), "%d dBm", noise);
 126
 127         return buf;
 128 }
 129
 130 static char * format_rate(int rate)
 131 {
 132         static char buf[14];
 133
 134         if (rate <= 0)
 135                 snprintf(buf, sizeof(buf), "unknown");
 136         else
 137                 snprintf(buf, sizeof(buf), "%.1f MBit/s", ((float)rate / 1000.0));
 138
 139         return buf;
 140 }
 141
 142 static char * format_enc_ciphers(int ciphers)
 143 {
 144         static char str[128] = { 0 };
 145         char *pos = str;
 146
 147         if (ciphers & IWINFO_CIPHER_WEP40)
 148                 pos += sprintf(pos, "WEP-40, ");
 149
 150         if (ciphers & IWINFO_CIPHER_WEP104)
 151                 pos += sprintf(pos, "WEP-104, ");
 152
 153         if (ciphers & IWINFO_CIPHER_TKIP)
 154                 pos += sprintf(pos, "TKIP, ");
 155
 156         if (ciphers & IWINFO_CIPHER_CCMP)
 157                 pos += sprintf(pos, "CCMP, ");
 158
 159         if (ciphers & IWINFO_CIPHER_WRAP)
 160                 pos += sprintf(pos, "WRAP, ");
 161
 162         if (ciphers & IWINFO_CIPHER_AESOCB)
 163                 pos += sprintf(pos, "AES-OCB, ");
 164
 165         if (ciphers & IWINFO_CIPHER_CKIP)
 166                 pos += sprintf(pos, "CKIP, ");
 167
 168         if (!ciphers || (ciphers & IWINFO_CIPHER_NONE))
 169                 pos += sprintf(pos, "NONE, ");
 170
 171         *(pos - 2) = 0;
 172
 173         return str;
 174 }
 175
 176 static char * format_enc_suites(int suites)
 177 {
 178         static char str[64] = { 0 };
 179         char *pos = str;
 180
 181         if (suites & IWINFO_KMGMT_PSK)
 182                 pos += sprintf(pos, "PSK/");
 183
 184         if (suites & IWINFO_KMGMT_8021x)
 185                 pos += sprintf(pos, "802.1X/");
 186
 187         if (!suites || (suites & IWINFO_KMGMT_NONE))
 188                 pos += sprintf(pos, "NONE/");
 189
 190         *(pos - 1) = 0;
 191
 192         return str;
 193 }
 194
 195 static char * format_encryption(struct iwinfo_crypto_entry *c)
 196 {
 197         static char buf[512];
 198
 199         if (!c)
 200         {
 201                 snprintf(buf, sizeof(buf), "unknown");
 202         }
 203         else if (c->enabled)
 204         {
 205                 /* WEP */
 206                 if (c->auth_algs && !c->wpa_version)
 207                 {
 208                         if ((c->auth_algs & IWINFO_AUTH_OPEN) &&
 209                                 (c->auth_algs & IWINFO_AUTH_SHARED))
 210                         {
 211                                 snprintf(buf, sizeof(buf), "WEP Open/Shared (%s)",
 212                                         format_enc_ciphers(c->pair_ciphers));
 213                         }
 214                         else if (c->auth_algs & IWINFO_AUTH_OPEN)
 215                         {
 216                                 snprintf(buf, sizeof(buf), "WEP Open System (%s)",
 217                                         format_enc_ciphers(c->pair_ciphers));
 218                         }
 219                         else if (c->auth_algs & IWINFO_AUTH_SHARED)
 220                         {
 221                                 snprintf(buf, sizeof(buf), "WEP Shared Auth (%s)",
 222                                         format_enc_ciphers(c->pair_ciphers));
 223                         }
 224                 }
 225
 226                 /* WPA */
 227                 else if (c->wpa_version)
 228                 {
 229                         switch (c->wpa_version) {
 230                                 case 3:
 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));
 234                                         break;
 235
 236                                 case 2:
 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));
 240                                         break;
 241
 242                                 case 1:
 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));
 246                                         break;
 247                         }
 248                 }
 249                 else
 250                 {
 251                         snprintf(buf, sizeof(buf), "none");
 252                 }
 253         }
 254         else
 255         {
 256                 snprintf(buf, sizeof(buf), "none");
 257         }
 258
 259         return buf;
 260 }
 261
 262 static char * format_hwmodes(int modes)
 263 {
 264         static char buf[12];
 265
 266         if (modes <= 0)
 267                 snprintf(buf, sizeof(buf), "unknown");
 268         else
 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" : "");
 274
 275         return buf;
 276 }
 277
 278
 279 static const char * print_type(const struct iwinfo_ops *iw, const char *ifname)
 280 {
 281         const char *type = iwinfo_type(ifname);
 282         return type ? type : "unknown";
 283 }
 284
 285 static char * print_hardware_id(const struct iwinfo_ops *iw, const char *ifname)
 286 {
 287         static char buf[20];
 288         struct iwinfo_hardware_id ids;
 289
 290         if (!iw->hardware_id(ifname, (char *)&ids))
 291         {
 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);
 295         }
 296         else
 297         {
 298                 snprintf(buf, sizeof(buf), "unknown");
 299         }
 300
 301         return buf;
 302 }
 303
 304 static char * print_hardware_name(const struct iwinfo_ops *iw, const char *ifname)
 305 {
 306         static char buf[128];
 307
 308         if (iw->hardware_name(ifname, buf))
 309                 snprintf(buf, sizeof(buf), "unknown");
 310
 311         return buf;
 312 }
 313
 314 static char * print_txpower_offset(const struct iwinfo_ops *iw, const char *ifname)
 315 {
 316         int off;
 317         static char buf[12];
 318
 319         if (iw->txpower_offset(ifname, &off))
 320                 snprintf(buf, sizeof(buf), "unknown");
 321         else if (off != 0)
 322                 snprintf(buf, sizeof(buf), "%d dB", off);
 323         else
 324                 snprintf(buf, sizeof(buf), "none");
 325
 326         return buf;
 327 }
 328
 329 static char * print_frequency_offset(const struct iwinfo_ops *iw, const char *ifname)
 330 {
 331         int off;
 332         static char buf[12];
 333
 334         if (iw->frequency_offset(ifname, &off))
 335                 snprintf(buf, sizeof(buf), "unknown");
 336         else if (off != 0)
 337                 snprintf(buf, sizeof(buf), "%.3f GHz", ((float)off / 1000.0));
 338         else
 339                 snprintf(buf, sizeof(buf), "none");
 340
 341         return buf;
 342 }
 343
 344 static char * print_ssid(const struct iwinfo_ops *iw, const char *ifname)
 345 {
 346         char buf[IWINFO_ESSID_MAX_SIZE+1] = { 0 };
 347
 348         if (iw->ssid(ifname, buf))
 349                 memset(buf, 0, sizeof(buf));
 350
 351         return format_ssid(buf);
 352 }
 353
 354 static char * print_bssid(const struct iwinfo_ops *iw, const char *ifname)
 355 {
 356         static char buf[18] = { 0 };
 357
 358         if (iw->bssid(ifname, buf))
 359                 snprintf(buf, sizeof(buf), "00:00:00:00:00:00");
 360
 361         return buf;
 362 }
 363
 364 static char * print_mode(const struct iwinfo_ops *iw, const char *ifname)
 365 {
 366         static char buf[128];
 367
 368         if (iw->mode(ifname, buf))
 369                 snprintf(buf, sizeof(buf), "unknown");
 370
 371         return buf;
 372 }
 373
 374 static char * print_channel(const struct iwinfo_ops *iw, const char *ifname)
 375 {
 376         int ch;
 377         if (iw->channel(ifname, &ch))
 378                 ch = -1;
 379
 380         return format_channel(ch);
 381 }
 382
 383 static char * print_frequency(const struct iwinfo_ops *iw, const char *ifname)
 384 {
 385         int freq;
 386         if (iw->frequency(ifname, &freq))
 387                 freq = -1;
 388
 389         return format_frequency(freq);
 390 }
 391
 392 static char * print_txpower(const struct iwinfo_ops *iw, const char *ifname)
 393 {
 394         int pwr, off;
 395         if (iw->txpower_offset(ifname, &off))
 396                 off = 0;
 397
 398         if (iw->txpower(ifname, &pwr))
 399                 pwr = -1;
 400         else
 401                 pwr += off;
 402
 403         return format_txpower(pwr);
 404 }
 405
 406 static char * print_quality(const struct iwinfo_ops *iw, const char *ifname)
 407 {
 408         int qual;
 409         if (iw->quality(ifname, &qual))
 410                 qual = -1;
 411
 412         return format_quality(qual);
 413 }
 414
 415 static char * print_quality_max(const struct iwinfo_ops *iw, const char *ifname)
 416 {
 417         int qmax;
 418         if (iw->quality_max(ifname, &qmax))
 419                 qmax = -1;
 420
 421         return format_quality_max(qmax);
 422 }
 423
 424 static char * print_signal(const struct iwinfo_ops *iw, const char *ifname)
 425 {
 426         int sig;
 427         if (iw->signal(ifname, &sig))
 428                 sig = 0;
 429
 430         return format_signal(sig);
 431 }
 432
 433 static char * print_noise(const struct iwinfo_ops *iw, const char *ifname)
 434 {
 435         int noise;
 436         if (iw->noise(ifname, &noise))
 437                 noise = 0;
 438
 439         return format_noise(noise);
 440 }
 441
 442 static char * print_rate(const struct iwinfo_ops *iw, const char *ifname)
 443 {
 444         int rate;
 445         if (iw->bitrate(ifname, &rate))
 446                 rate = -1;
 447
 448         return format_rate(rate);
 449 }
 450
 451 static char * print_encryption(const struct iwinfo_ops *iw, const char *ifname)
 452 {
 453         struct iwinfo_crypto_entry c = { 0 };
 454         if (iw->encryption(ifname, (char *)&c))
 455                 return format_encryption(NULL);
 456
 457         return format_encryption(&c);
 458 }
 459
 460 static char * print_hwmodes(const struct iwinfo_ops *iw, const char *ifname)
 461 {
 462         int modes;
 463         if (iw->hwmodelist(ifname, &modes))
 464                 modes = -1;
 465
 466         return format_hwmodes(modes);
 467 }
 468
 469 static char * print_mbssid_supp(const struct iwinfo_ops *iw, const char *ifname)
 470 {
 471         int supp;
 472         static char buf[4];
 473
 474         if (iw->mbssid_support(ifname, &supp))
 475                 snprintf(buf, sizeof(buf), "no");
 476         else
 477                 snprintf(buf, sizeof(buf), "%s", supp ? "yes" : "no");
 478
 479         return buf;
 480 }
 481
 482
 483 static void print_info(const struct iwinfo_ops *iw, const char *ifname)
 484 {
 485         printf("%-9s ESSID: %s\n",
 486                 ifname,
 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));
 517 }
 518
 519
 520 static void print_scanlist(const struct iwinfo_ops *iw, const char *ifname)
 521 {
 522         int i, x, len;
 523         char buf[IWINFO_BUFSIZE];
 524         struct iwinfo_scanlist_entry *e;
 525
 526         if (iw->scanlist(ifname, buf, &len))
 527         {
 528                 printf("Scanning not possible\n\n");
 529                 return;
 530         }
 531         else if (len <= 0)
 532         {
 533                 printf("No scan results\n\n");
 534                 return;
 535         }
 536
 537         for (i = 0, x = 1; i < len; i += sizeof(struct iwinfo_scanlist_entry), x++)
 538         {
 539                 e = (struct iwinfo_scanlist_entry *) &buf[i];
 540
 541                 printf("Cell %02d - Address: %s\n",
 542                         x,
 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));
 555         }
 556 }
 557
 558
 559 static void print_txpwrlist(const struct iwinfo_ops *iw, const char *ifname)
 560 {
 561         int len, pwr, off, i;
 562         char buf[IWINFO_BUFSIZE];
 563         struct iwinfo_txpwrlist_entry *e;
 564
 565         if (iw->txpwrlist(ifname, buf, &len) || len <= 0)
 566         {
 567                 printf("No TX power information available\n");
 568                 return;
 569         }
 570
 571         if (iw->txpower(ifname, &pwr))
 572                 pwr = -1;
 573
 574         if (iw->txpower_offset(ifname, &off))
 575                 off = 0;
 576
 577         for (i = 0; i < len; i += sizeof(struct iwinfo_txpwrlist_entry))
 578         {
 579                 e = (struct iwinfo_txpwrlist_entry *) &buf[i];
 580
 581                 printf("%s%3d dBm (%4d mW)\n",
 582                         (pwr == e->dbm) ? "*" : " ",
 583                         e->dbm + off,
 584                         iwinfo_dbm2mw(e->dbm + off));
 585         }
 586 }
 587
 588
 589 static void print_freqlist(const struct iwinfo_ops *iw, const char *ifname)
 590 {
 591         int i, len, ch;
 592         char buf[IWINFO_BUFSIZE];
 593         struct iwinfo_freqlist_entry *e;
 594
 595         if (iw->freqlist(ifname, buf, &len) || len <= 0)
 596         {
 597                 printf("No frequency information available\n");
 598                 return;
 599         }
 600
 601         if (iw->channel(ifname, &ch))
 602                 ch = -1;
 603
 604         for (i = 0; i < len; i += sizeof(struct iwinfo_freqlist_entry))
 605         {
 606                 e = (struct iwinfo_freqlist_entry *) &buf[i];
 607
 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]" : "");
 613         }
 614 }
 615
 616
 617 static void print_assoclist(const struct iwinfo_ops *iw, const char *ifname)
 618 {
 619         int i, len;
 620         char buf[IWINFO_BUFSIZE];
 621         struct iwinfo_assoclist_entry *e;
 622
 623         if (iw->assoclist(ifname, buf, &len))
 624         {
 625                 printf("No information available\n");
 626                 return;
 627         }
 628         else if (len <= 0)
 629         {
 630                 printf("No station connected\n");
 631                 return;
 632         }
 633
 634         for (i = 0; i < len; i += sizeof(struct iwinfo_assoclist_entry))
 635         {
 636                 e = (struct iwinfo_assoclist_entry *) &buf[i];
 637
 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));
 643         }
 644 }
 645
 646
 647 static char * lookup_country(char *buf, int len, int iso3166)
 648 {
 649         int i;
 650         struct iwinfo_country_entry *c;
 651
 652         for (i = 0; i < len; i += sizeof(struct iwinfo_country_entry))
 653         {
 654                 c = (struct iwinfo_country_entry *) &buf[i];
 655
 656                 if (c->iso3166 == iso3166)
 657                         return c->ccode;
 658         }
 659
 660         return NULL;
 661 }
 662
 663 static void print_countrylist(const struct iwinfo_ops *iw, const char *ifname)
 664 {
 665         int len;
 666         char buf[IWINFO_BUFSIZE];
 667         char *ccode;
 668         char curcode[3];
 669         const struct iwinfo_iso3166_label *l;
 670
 671         if (iw->countrylist(ifname, buf, &len))
 672         {
 673                 printf("No country code information available\n");
 674                 return;
 675         }
 676
 677         if (iw->country(ifname, curcode))
 678                 memset(curcode, 0, sizeof(curcode));
 679
 680         for (l = IWINFO_ISO3166_NAMES; l->iso3166; l++)
 681         {
 682                 if ((ccode = lookup_country(buf, len, l->iso3166)) != NULL)
 683                 {
 684                         printf("%s %4s  %c%c\n",
 685                                 strncmp(ccode, curcode, 2) ? " " : "*",
 686                                 ccode, (l->iso3166 / 256), (l->iso3166 % 256));
 687                 }
 688         }
 689 }
 690
 691
 692 int main(int argc, char **argv)
 693 {
 694         int i;
 695         const struct iwinfo_ops *iw;
 696
 697         if (argc < 3)
 698         {
 699                 fprintf(stderr,
 700                         "Usage:\n"
 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"
 707                 );
 708
 709                 return 1;
 710         }
 711
 712         iw = iwinfo_backend(argv[1]);
 713
 714         if (!iw)
 715         {
 716                 fprintf(stderr, "No such wireless device: %s\n", argv[1]);
 717                 return 1;
 718         }
 719
 720         for (i = 2; i < argc; i++)
 721         {
 722                 switch(argv[i][0])
 723                 {
 724                 case 'i':
 725                         print_info(iw, argv[1]);
 726                         break;
 727
 728                 case 's':
 729                         print_scanlist(iw, argv[1]);
 730                         break;
 731
 732                 case 't':
 733                         print_txpwrlist(iw, argv[1]);
 734                         break;
 735
 736                 case 'f':
 737                         print_freqlist(iw, argv[1]);
 738                         break;
 739
 740                 case 'a':
 741                         print_assoclist(iw, argv[1]);
 742                         break;
 743
 744                 case 'c':
 745                         print_countrylist(iw, argv[1]);
 746                         break;
 747
 748                 default:
 749                         fprintf(stderr, "Unknown command: %s\n", argv[i]);
 750                         return 1;
 751                 }
 752         }
 753
 754         iwinfo_finish();
 755
 756         return 0;
 757 }