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;
 395         if (iw->txpower(ifname, &pwr))
 396                 pwr = -1;
 397
 398         return format_txpower(pwr);
 399 }
 400
 401 static char * print_quality(const struct iwinfo_ops *iw, const char *ifname)
 402 {
 403         int qual;
 404         if (iw->quality(ifname, &qual))
 405                 qual = -1;
 406
 407         return format_quality(qual);
 408 }
 409
 410 static char * print_quality_max(const struct iwinfo_ops *iw, const char *ifname)
 411 {
 412         int qmax;
 413         if (iw->quality_max(ifname, &qmax))
 414                 qmax = -1;
 415
 416         return format_quality_max(qmax);
 417 }
 418
 419 static char * print_signal(const struct iwinfo_ops *iw, const char *ifname)
 420 {
 421         int sig;
 422         if (iw->signal(ifname, &sig))
 423                 sig = 0;
 424
 425         return format_signal(sig);
 426 }
 427
 428 static char * print_noise(const struct iwinfo_ops *iw, const char *ifname)
 429 {
 430         int noise;
 431         if (iw->noise(ifname, &noise))
 432                 noise = 0;
 433
 434         return format_noise(noise);
 435 }
 436
 437 static char * print_rate(const struct iwinfo_ops *iw, const char *ifname)
 438 {
 439         int rate;
 440         if (iw->bitrate(ifname, &rate))
 441                 rate = -1;
 442
 443         return format_rate(rate);
 444 }
 445
 446 static char * print_encryption(const struct iwinfo_ops *iw, const char *ifname)
 447 {
 448         struct iwinfo_crypto_entry c = { 0 };
 449         if (iw->encryption(ifname, (char *)&c))
 450                 return format_encryption(NULL);
 451
 452         return format_encryption(&c);
 453 }
 454
 455 static char * print_hwmodes(const struct iwinfo_ops *iw, const char *ifname)
 456 {
 457         int modes;
 458         if (iw->hwmodelist(ifname, &modes))
 459                 modes = -1;
 460
 461         return format_hwmodes(modes);
 462 }
 463
 464 static char * print_mbssid_supp(const struct iwinfo_ops *iw, const char *ifname)
 465 {
 466         int supp;
 467         static char buf[4];
 468
 469         if (iw->mbssid_support(ifname, &supp))
 470                 snprintf(buf, sizeof(buf), "no");
 471         else
 472                 snprintf(buf, sizeof(buf), "%s", supp ? "yes" : "no");
 473
 474         return buf;
 475 }
 476
 477
 478 static void print_info(const struct iwinfo_ops *iw, const char *ifname)
 479 {
 480         printf("%-9s ESSID: %s\n",
 481                 ifname,
 482                 print_ssid(iw, ifname));
 483         printf("          Access Point: %s\n",
 484                 print_bssid(iw, ifname));
 485         printf("          Mode: %s  Channel: %s (%s)\n",
 486                 print_mode(iw, ifname),
 487                 print_channel(iw, ifname),
 488                 print_frequency(iw, ifname));
 489         printf("          Tx-Power: %s  Link Quality: %s/%s\n",
 490                 print_txpower(iw, ifname),
 491                 print_quality(iw, ifname),
 492                 print_quality_max(iw, ifname));
 493         printf("          Signal: %s  Noise: %s\n",
 494                 print_signal(iw, ifname),
 495                 print_noise(iw, ifname));
 496         printf("          Bit Rate: %s\n",
 497                 print_rate(iw, ifname));
 498         printf("          Encryption: %s\n",
 499                 print_encryption(iw, ifname));
 500         printf("          Type: %s  HW Mode(s): %s\n",
 501                 print_type(iw, ifname),
 502                 print_hwmodes(iw, ifname));
 503         printf("          Hardware: %s [%s]\n",
 504                 print_hardware_id(iw, ifname),
 505                 print_hardware_name(iw, ifname));
 506         printf("          TX power offset: %s\n",
 507                 print_txpower_offset(iw, ifname));
 508         printf("          Frequency offset: %s\n",
 509                 print_frequency_offset(iw, ifname));
 510         printf("          Supports VAPs: %s\n",
 511                 print_mbssid_supp(iw, ifname));
 512 }
 513
 514
 515 static void print_scanlist(const struct iwinfo_ops *iw, const char *ifname)
 516 {
 517         int i, x, len;
 518         char buf[IWINFO_BUFSIZE];
 519         struct iwinfo_scanlist_entry *e;
 520
 521         if (iw->scanlist(ifname, buf, &len))
 522         {
 523                 printf("Scanning not possible\n\n");
 524                 return;
 525         }
 526         else if (len <= 0)
 527         {
 528                 printf("No scan results\n\n");
 529                 return;
 530         }
 531
 532         for (i = 0, x = 1; i < len; i += sizeof(struct iwinfo_scanlist_entry), x++)
 533         {
 534                 e = (struct iwinfo_scanlist_entry *) &buf[i];
 535
 536                 printf("Cell %02d - Address: %s\n",
 537                         x,
 538                         format_bssid(e->mac));
 539                 printf("          ESSID: %s\n",
 540                         format_ssid(e->ssid));
 541                 printf("          Mode: %s  Channel: %s\n",
 542                         e->mode ? (char *)e->mode : "unknown",
 543                         format_channel(e->channel));
 544                 printf("          Signal: %s  Quality: %s/%s\n",
 545                         format_signal(e->signal - 0x100),
 546                         format_quality(e->quality),
 547                         format_quality_max(e->quality_max));
 548                 printf("          Encryption: %s\n\n",
 549                         format_encryption(&e->crypto));
 550         }
 551 }
 552
 553
 554 static void print_txpwrlist(const struct iwinfo_ops *iw, const char *ifname)
 555 {
 556         int len, pwr, off, i;
 557         char buf[IWINFO_BUFSIZE];
 558         struct iwinfo_txpwrlist_entry *e;
 559
 560         if (iw->txpwrlist(ifname, buf, &len) || len <= 0)
 561         {
 562                 printf("No TX power information available\n");
 563                 return;
 564         }
 565
 566         if (iw->txpower(ifname, &pwr))
 567                 pwr = -1;
 568
 569         if (iw->txpower_offset(ifname, &off))
 570                 off = 0;
 571
 572         for (i = 0; i < len; i += sizeof(struct iwinfo_txpwrlist_entry))
 573         {
 574                 e = (struct iwinfo_txpwrlist_entry *) &buf[i];
 575
 576                 printf("%s%3d dBm (%4d mW)\n",
 577                         (pwr == e->dbm) ? "*" : " ",
 578                         e->dbm + off,
 579                         iwinfo_dbm2mw(e->dbm + off));
 580         }
 581 }
 582
 583
 584 static void print_freqlist(const struct iwinfo_ops *iw, const char *ifname)
 585 {
 586         int i, len, ch;
 587         char buf[IWINFO_BUFSIZE];
 588         struct iwinfo_freqlist_entry *e;
 589
 590         if (iw->freqlist(ifname, buf, &len) || len <= 0)
 591         {
 592                 printf("No frequency information available\n");
 593                 return;
 594         }
 595
 596         if (iw->channel(ifname, &ch))
 597                 ch = -1;
 598
 599         for (i = 0; i < len; i += sizeof(struct iwinfo_freqlist_entry))
 600         {
 601                 e = (struct iwinfo_freqlist_entry *) &buf[i];
 602
 603                 printf("%s %s (Channel %s)%s\n",
 604                         (ch == e->channel) ? "*" : " ",
 605                         format_frequency(e->mhz),
 606                         format_channel(e->channel),
 607                         e->restricted ? " [restricted]" : "");
 608         }
 609 }
 610
 611
 612 static void print_assoclist(const struct iwinfo_ops *iw, const char *ifname)
 613 {
 614         int i, len;
 615         char buf[IWINFO_BUFSIZE];
 616         struct iwinfo_assoclist_entry *e;
 617
 618         if (iw->assoclist(ifname, buf, &len))
 619         {
 620                 printf("No information available\n");
 621                 return;
 622         }
 623         else if (len <= 0)
 624         {
 625                 printf("No station connected\n");
 626                 return;
 627         }
 628
 629         for (i = 0; i < len; i += sizeof(struct iwinfo_assoclist_entry))
 630         {
 631                 e = (struct iwinfo_assoclist_entry *) &buf[i];
 632
 633                 printf("%s  %s / %s (SNR %d)\n",
 634                         format_bssid(e->mac),
 635                         format_signal(e->signal),
 636                         format_noise(e->noise),
 637                         (e->signal - e->noise));
 638         }
 639 }
 640
 641
 642 static char * lookup_country(char *buf, int len, int iso3166)
 643 {
 644         int i;
 645         struct iwinfo_country_entry *c;
 646
 647         for (i = 0; i < len; i += sizeof(struct iwinfo_country_entry))
 648         {
 649                 c = (struct iwinfo_country_entry *) &buf[i];
 650
 651                 if (c->iso3166 == iso3166)
 652                         return c->ccode;
 653         }
 654
 655         return NULL;
 656 }
 657
 658 static void print_countrylist(const struct iwinfo_ops *iw, const char *ifname)
 659 {
 660         int len;
 661         char buf[IWINFO_BUFSIZE];
 662         char *ccode;
 663         char curcode[3];
 664         const struct iwinfo_iso3166_label *l;
 665
 666         if (iw->countrylist(ifname, buf, &len))
 667         {
 668                 printf("No country code information available\n");
 669                 return;
 670         }
 671
 672         if (iw->country(ifname, curcode))
 673                 memset(curcode, 0, sizeof(curcode));
 674
 675         for (l = IWINFO_ISO3166_NAMES; l->iso3166; l++)
 676         {
 677                 if ((ccode = lookup_country(buf, len, l->iso3166)) != NULL)
 678                 {
 679                         printf("%s %4s  %c%c\n",
 680                                 strncmp(ccode, curcode, 2) ? " " : "*",
 681                                 ccode, (l->iso3166 / 256), (l->iso3166 % 256));
 682                 }
 683         }
 684 }
 685
 686
 687 int main(int argc, char **argv)
 688 {
 689         int i;
 690         const struct iwinfo_ops *iw;
 691
 692         if (argc < 3)
 693         {
 694                 fprintf(stderr,
 695                         "Usage:\n"
 696                         "       iwinfo <device> info\n"
 697                         "       iwinfo <device> scan\n"
 698                         "       iwinfo <device> txpowerlist\n"
 699                         "       iwinfo <device> freqlist\n"
 700                         "       iwinfo <device> assoclist\n"
 701                         "       iwinfo <device> countrylist\n"
 702                 );
 703
 704                 return 1;
 705         }
 706
 707         iw = iwinfo_backend(argv[1]);
 708
 709         if (!iw)
 710         {
 711                 fprintf(stderr, "No such wireless device: %s\n", argv[1]);
 712                 return 1;
 713         }
 714
 715         for (i = 2; i < argc; i++)
 716         {
 717                 switch(argv[i][0])
 718                 {
 719                 case 'i':
 720                         print_info(iw, argv[1]);
 721                         break;
 722
 723                 case 's':
 724                         print_scanlist(iw, argv[1]);
 725                         break;
 726
 727                 case 't':
 728                         print_txpwrlist(iw, argv[1]);
 729                         break;
 730
 731                 case 'f':
 732                         print_freqlist(iw, argv[1]);
 733                         break;
 734
 735                 case 'a':
 736                         print_assoclist(iw, argv[1]);
 737                         break;
 738
 739                 case 'c':
 740                         print_countrylist(iw, argv[1]);
 741                         break;
 742
 743                 default:
 744                         fprintf(stderr, "Unknown command: %s\n", argv[i]);
 745                         return 1;
 746                 }
 747         }
 748
 749         iwinfo_finish();
 750
 751         return 0;
 752 }