.\" Guus Sliepen - 2001
.\" Completed and fixed up by Jean Tourrilhes - 2002
.\" iwgetid.8
.\"
.TH IWGETID 8 "7 August 2001" "net-tools" "Linux Programmer's Manual"
.\"
.\" NAME part
.\"
.SH NAME
iwgetid \- Report ESSID, NWID or AP/Cell Address of wireless network
.\"
.\" SYNOPSIS part
.\"
.SH SYNOPSIS
.BI "iwgetid " [interface] " [--scheme] [--ap] [--freq] [--mode]"
.br
.BI "                   [--protocol]
.br
.\"
.\" DESCRIPTION part
.\"
.SH DESCRIPTION
.B 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
.BR iwconfig ", but " iwgetid
is easier to integrate in various scripts.
.br
By default,
.B iwgetid
will print the
.I ESSID
of the device, and if the device doesn't have any ESSID it will print
its
.IR NWID .
.\"
.\" OPTIONS part
.\"
.SH OPTIONS
.TP
.B --scheme
This option disables pretty-printing of the information, only the raw
ESSID (or NWID, or AP Address) is printed. Also, characters that are
not alphanumerics (like space, punctuation and control characters) are
skipped.
.br
The resulting output is a valid Pcmcia scheme identifier (that may be
used as an argument of the command
.BR "cardctl scheme" ).
This format is also ideal when using the result of iwgetid as a
variable in
.I Shell
or
.I Perl
scripts.
.TP
.B --ap
Display the MAC address of the Wireless
.I Access Point
or the
.IR Cell .
.TP
.B --freq
Display the current
.I frequency
or
.I channel
used by the interface.
.TP
.B --mode
Display the current
.I mode
of the interface.
.TP
.B --protocol
Display the
.I protocol name
of the interface. This allow to identify all the cards that are
compatible with each other and accept the same type of
configuration.
.br
This can also be used to
.I check Wireless Extension support
on the interface, as this is the only attribute that all drivers
supporting Wireless Extension are mandated to support.
.\"
.\" SEE ALSO part
.\"
.SH SEE ALSO
.BR iwconfig (8),
.BR ifconfig (8),
.BR iwspy (8),
.BR iwpriv (8).