man-pages/man8/iwgetid.8.html
2021-03-31 01:06:50 +01:00

189 lines
3.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of IWGETID</TITLE>
</HEAD><BODY>
<H1>IWGETID</H1>
Section: Linux Programmer's Manual (8)<BR>Updated: 02 December 2003<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
iwgetid - Report ESSID, NWID or AP/Cell Address of wireless network
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>iwgetid </B><I>[interface]</I><B> [--raw] [--scheme] [--ap] [--freq]</B>
<BR>
<B> [--mode] [--protocol] [--channel]</B>
<BR>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>iwgetid</B>
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
<B>iwconfig</B>, but <B>iwgetid</B>
is easier to integrate in various scripts.
<BR>
By default,
<B>iwgetid</B>
will print the
<I>ESSID</I>
of the device, and if the device doesn't have any ESSID it will print
its
<I>NWID</I>.
<BR>
The default formatting output is pretty-print.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>--raw</B>
<DD>
This option disables pretty-printing of the information. This option
is orthogonal to the other options (except
<B>--scheme</B>),
so with the appropriate combination of options you can print the raw
ESSID, AP Address or Mode.
<BR>
This format is ideal when storing the result of iwgetid as a
variable in
<I>Shell</I>
or
<I>Perl</I>
scripts or to pass the result as an argument on the command line of
<B>iwconfig</B>.
<DT id="2"><B>--scheme</B>
<DD>
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 characters).
<BR>
The resulting output is a valid Pcmcia scheme identifier (that may be
used as an argument of the command
<B>cardctl scheme</B>).
This format is also ideal when using the result of iwgetid as a
selector in
<I>Shell</I>
or
<I>Perl</I>
scripts, or as a file name.
<DT id="3"><B>--ap</B>
<DD>
Display the MAC address of the Wireless
<I>Access Point</I>
or the
<I>Cell</I>.
<DT id="4"><B>--freq</B>
<DD>
Display the current
<I>frequency</I>
or
<I>channel</I>
used by the interface.
<DT id="5"><B>--channel</B>
<DD>
Display the current
<I>channel</I>
used by the interface. The channel is determined using the current
frequency and the frequency list provided by the interface.
<DT id="6"><B>--mode</B>
<DD>
Display the current
<I>mode</I>
of the interface.
<DT id="7"><B>--protocol</B>
<DD>
Display the
<I>protocol name</I>
of the interface. This allows 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</I>
on the interface, as this is the only attribute that all drivers
supporting Wireless Extension are mandated to support.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+iwconfig">iwconfig</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+ifconfig">ifconfig</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+iwspy">iwspy</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+iwpriv">iwpriv</A></B>(8).
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="8"><A HREF="#lbAB">NAME</A><DD>
<DT id="9"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="10"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="11"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="12"><A HREF="#lbAF">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:13 GMT, March 31, 2021
</BODY>
</HTML>