1 .\" Guus Sliepen - 2001
2 .\" Completed and fixed up by Jean Tourrilhes - 2002-2003
5 .TH IWGETID 8 "02 December 2003" "wireless-tools" "Linux Programmer's Manual"
10 iwgetid \- Report ESSID, NWID or AP/Cell Address of wireless network
15 .BI "iwgetid " [interface] " [--raw] [--scheme] [--ap] [--freq]"
17 .BI " [--mode] [--protocol] [--channel]
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
27 .BR iwconfig ", but " iwgetid
28 is easier to integrate in various scripts.
34 of the device, and if the device doesn't have any ESSID it will print
38 The default formatting output is pretty-print.
45 This option disables pretty-printing of the information. This options
46 is orthogonal to the other options (except
48 so with the appropriate combination of options you can print the raw
49 ESSID, AP Address or Mode.
51 This format is ideal when storing the result of iwgetid as a
56 scripts or to pass the result as an argument on the command line of
60 This option is similar to the previous one, it disables
61 pretty-printing of the information and remove all characters that are
62 not alphanumerics (like space, punctuation and control characters).
64 The resulting output is a valid Pcmcia scheme identifier (that may be
65 used as an argument of the command
66 .BR "cardctl scheme" ).
67 This format is also ideal when using the result of iwgetid as a
72 scripts, or as a file name.
75 Display the MAC address of the Wireless
85 used by the interface.
90 used by the interface. The channel is determined using the current
91 frequency and the frequency list provided by the interface.
101 of the interface. This allow to identify all the cards that are
102 compatible with each other and accept the same type of
105 This can also be used to
106 .I check Wireless Extension support
107 on the interface, as this is the only attribute that all drivers
108 supporting Wireless Extension are mandated to support.