iwgetid(8)



IWGETID(8)                 Linux Programmer's Manual                IWGETID(8)

NAME
       iwgetid - Report ESSID, NWID or AP/Cell Address of wireless network

SYNOPSIS
       iwgetid [interface] [--raw] [--scheme] [--ap] [--freq]
                          [--mode] [--protocol] [--channel]

DESCRIPTION
       iwgetid  is  used to find out the NWID, ESSID or AP/Cell Address of the
       wireless network that is currently used. The  information  reported  is
       the  same  as the one shown by iwconfig, but iwgetid is easier to inte-
       grate in various scripts.
       By default, iwgetid will print the ESSID of the device, and if the  de-
       vice doesn't have any ESSID it will print its NWID.
       The default formatting output is pretty-print.

OPTIONS
       --raw  This  option  disables  pretty-printing of the information. This
              option is orthogonal to the other options (except --scheme),  so
              with  the  appropriate  combination of options you can print the
              raw ESSID, AP Address or Mode.
              This format is ideal when storing the result  of  iwgetid  as  a
              variable  in  Shell  or Perl scripts or to pass the result as an
              argument on the command line of iwconfig.

       --scheme
              This option is similar to the previous one, it disables  pretty-
              printing  of the information and removes all characters that are
              not alphanumerics (like space, punctuation and  control  charac-
              ters).
              The  resulting  output is a valid Pcmcia scheme identifier (that
              may be used as an argument of the command cardctl scheme).  This
              format  is  also ideal when using the result of iwgetid as a se-
              lector in Shell or Perl scripts, or as a file name.

       --ap   Display the MAC address of the  Wireless  Access  Point  or  the
              Cell.

       --freq Display the current frequency or channel used by the interface.

       --channel
              Display  the  current channel used by the interface. The channel
              is determined using the current frequency and the frequency list
              provided by the interface.

       --mode Display the current mode of the interface.

       --protocol
              Display the protocol name of the interface. This allows to iden-
              tify all the cards that are compatible with each other  and  ac-
              cept the same type of configuration.
              This can also be used to check Wireless Extension support on the
              interface, as this is the only attribute that all  drivers  sup-
              porting Wireless Extension are mandated to support.

SEE ALSO
       iwconfig(8), ifconfig(8), iwspy(8), iwpriv(8).

wireless-tools                 02 December 2003                     IWGETID(8)

Man(1) output converted with man2html
list of all man pages