1IWGETID(8) Linux Programmer's Manual IWGETID(8)
2
3
4
6 iwgetid - Report ESSID, NWID or AP/Cell Address of wireless network
7
9 iwgetid [interface] [--raw] [--scheme] [--ap] [--freq]
10 [--mode] [--protocol] [--channel]
11
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
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
61 iwconfig(8), ifconfig(8), iwspy(8), iwpriv(8).
62
63
64
65wireless-tools 02 December 2003 IWGETID(8)