1IWGETID(8)                 Linux Programmer's Manual                IWGETID(8)
2
3
4

NAME

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

SYNOPSIS

9       iwgetid [interface] [--raw] [--scheme] [--ap] [--freq]
10                          [--mode] [--protocol] [--channel]
11

DESCRIPTION

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

OPTIONS

22       --raw  This  option  disables  pretty-printing of the information. This
23              option is orthogonal to the other options (except --scheme),  so
24              with  the  appropriate  combination of options you can print the
25              raw ESSID, AP Address or Mode.
26              This format is ideal when storing the result  of  iwgetid  as  a
27              variable  in  Shell  or Perl scripts or to pass the result as an
28              argument on the command line of iwconfig.
29
30       --scheme
31              This option is similar to the previous one, it disables  pretty-
32              printing  of the information and removes all characters that are
33              not alphanumerics (like space, punctuation and  control  charac‐
34              ters).
35              The  resulting  output is a valid Pcmcia scheme identifier (that
36              may be used as an argument of the command cardctl scheme).  This
37              format  is  also  ideal  when  using  the result of iwgetid as a
38              selector in Shell or Perl scripts, or as a file name.
39
40       --ap   Display the MAC address of the  Wireless  Access  Point  or  the
41              Cell.
42
43       --freq Display the current frequency or channel used by the interface.
44
45       --channel
46              Display  the  current channel used by the interface. The channel
47              is determined using the current frequency and the frequency list
48              provided by the interface.
49
50       --mode Display the current mode of the interface.
51
52       --protocol
53              Display the protocol name of the interface. This allows to iden‐
54              tify all the cards that  are  compatible  with  each  other  and
55              accept the same type of configuration.
56              This can also be used to check Wireless Extension support on the
57              interface, as this is the only attribute that all  drivers  sup‐
58              porting Wireless Extension are mandated to support.
59

SEE ALSO

61       iwconfig(8), ifconfig(8), iwspy(8), iwpriv(8).
62
63
64
65wireless-tools                 02 December 2003                     IWGETID(8)
Impressum