OSDN Git Service

v24
[android-x86/external-wireless-tools.git] / wireless_tools / iwgetid.8
1 .\" Guus Sliepen - 2001
2 .\" Completed and fixed up by Jean Tourrilhes - 2002
3 .\" iwgetid.8
4 .\"
5 .TH IWGETID 8 "7 August 2001" "net-tools" "Linux Programmer's Manual"
6 .\"
7 .\" NAME part
8 .\"
9 .SH NAME
10 iwgetid \- Report ESSID, NWID or AP/Cell Address of wireless network
11 .\"
12 .\" SYNOPSIS part
13 .\"
14 .SH SYNOPSIS
15 .BI "iwgetid " [interface] " [--scheme] [--ap]"
16 .br
17 .\"
18 .\" DESCRIPTION part
19 .\"
20 .SH DESCRIPTION
21 .B iwgetid
22 is used to find out the NWID, ESSID or AP/Cell Address of the wireless
23 network that is currently used. The information reported is the same
24 as the one shown by
25 .BR iwconfig ", but " iwgetid
26 is easier to integrate in various scripts.
27 .br
28 By default,
29 .B iwgetid
30 will print the
31 .I ESSID
32 of the device, and if the device doesn't have any ESSID it will print
33 its
34 .IR NWID .
35 .\"
36 .\" OPTIONS part
37 .\"
38 .SH OPTIONS
39 .TP
40 .B --scheme
41 This option disables pretty-printing of the information, only the raw
42 ESSID (or NWID, or AP Address) is printed. Also, characters that are
43 not alphanumerics (like space, punctuation and control characters) are
44 skipped.
45 .br
46 The resulting output is a valid Pcmcia scheme identifier (that may be used as an argument of the command
47 .BR "cardctl scheme" ).
48 This format is also ideal when using the result of iwgetid as a
49 variable in
50 .I Shell
51 or
52 .I Perl
53 scripts.
54 .TP
55 .B --ap
56 Display the MAC address of the Wireless
57 .I Access Point
58 or the
59 .IR Cell .
60 .\"
61 .\" SEE ALSO part
62 .\"
63 .SH SEE ALSO
64 .BR iwconfig (8),
65 .BR ifconfig (8),
66 .BR iwspy (8),
67 .BR iwpriv (8).