wireless_tools/iwgetid.8

   1 .\" Guus Sliepen - 2001
   2 .\" Completed and fixed up by Jean Tourrilhes - 2002
   3 .\" iwgetid.8
   4 .\"
   5 .TH IWGETID 8 "7 August 2001" "net-tools" "Linux Programmer's Manual"
   6 .\"
   7 .\" NAME part
   8 .\"
   9 .SH NAME
  10 iwgetid \- Report ESSID, NWID or AP/Cell Address of wireless network
  11 .\"
  12 .\" SYNOPSIS part
  13 .\"
  14 .SH SYNOPSIS
  15 .BI "iwgetid " [interface] " [--scheme] [--ap]"
  16 .br
  17 .\"
  18 .\" DESCRIPTION part
  19 .\"
  20 .SH DESCRIPTION
  21 .B iwgetid
  22 is used to find out the NWID, ESSID or AP/Cell Address of the wireless
  23 network that is currently used. The information reported is the same
  24 as the one shown by
  25 .BR iwconfig ", but " iwgetid
  26 is easier to integrate in various scripts.
  27 .br
  28 By default,
  29 .B iwgetid
  30 will print the
  31 .I ESSID
  32 of the device, and if the device doesn't have any ESSID it will print
  33 its
  34 .IR NWID .
  35 .\"
  36 .\" OPTIONS part
  37 .\"
  38 .SH OPTIONS
  39 .TP
  40 .B --scheme
  41 This option disables pretty-printing of the information, only the raw
  42 ESSID (or NWID, or AP Address) is printed. Also, characters that are
  43 not alphanumerics (like space, punctuation and control characters) are
  44 skipped.
  45 .br
  46 The resulting output is a valid Pcmcia scheme identifier (that may be used as an argument of the command
  47 .BR "cardctl scheme" ).
  48 This format is also ideal when using the result of iwgetid as a
  49 variable in
  50 .I Shell
  51 or
  52 .I Perl
  53 scripts.
  54 .TP
  55 .B --ap
  56 Display the MAC address of the Wireless
  57 .I Access Point
  58 or the
  59 .IR Cell .
  60 .\"
  61 .\" SEE ALSO part
  62 .\"
  63 .SH SEE ALSO
  64 .BR iwconfig (8),
  65 .BR ifconfig (8),
  66 .BR iwspy (8),
  67 .BR iwpriv (8).