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] [--freq] [--mode]"
  16 .br
  17 .BI "                   [--protocol]
  18 .br
  19 .\"
  20 .\" DESCRIPTION part
  21 .\"
  22 .SH DESCRIPTION
  23 .B iwgetid
  24 is used to find out the NWID, ESSID or AP/Cell Address of the wireless
  25 network that is currently used. The information reported is the same
  26 as the one shown by
  27 .BR iwconfig ", but " iwgetid
  28 is easier to integrate in various scripts.
  29 .br
  30 By default,
  31 .B iwgetid
  32 will print the
  33 .I ESSID
  34 of the device, and if the device doesn't have any ESSID it will print
  35 its
  36 .IR NWID .
  37 .\"
  38 .\" OPTIONS part
  39 .\"
  40 .SH OPTIONS
  41 .TP
  42 .B --scheme
  43 This option disables pretty-printing of the information, only the raw
  44 ESSID (or NWID, or AP Address) is printed. Also, characters that are
  45 not alphanumerics (like space, punctuation and control characters) are
  46 skipped.
  47 .br
  48 The resulting output is a valid Pcmcia scheme identifier (that may be
  49 used as an argument of the command
  50 .BR "cardctl scheme" ).
  51 This format is also ideal when using the result of iwgetid as a
  52 variable in
  53 .I Shell
  54 or
  55 .I Perl
  56 scripts.
  57 .TP
  58 .B --ap
  59 Display the MAC address of the Wireless
  60 .I Access Point
  61 or the
  62 .IR Cell .
  63 .TP
  64 .B --freq
  65 Display the current
  66 .I frequency
  67 or
  68 .I channel
  69 used by the interface.
  70 .TP
  71 .B --mode
  72 Display the current
  73 .I mode
  74 of the interface.
  75 .TP
  76 .B --protocol
  77 Display the
  78 .I protocol name
  79 of the interface. This allow to identify all the cards that are
  80 compatible with each other and accept the same type of
  81 configuration.
  82 .br
  83 This can also be used to
  84 .I check Wireless Extension support
  85 on the interface, as this is the only attribute that all drivers
  86 supporting Wireless Extension are mandated to support.
  87 .\"
  88 .\" SEE ALSO part
  89 .\"
  90 .SH SEE ALSO
  91 .BR iwconfig (8),
  92 .BR ifconfig (8),
  93 .BR iwspy (8),
  94 .BR iwpriv (8).