Attachment #35523 for bug #57327

View | Details | Raw Unified | Return to bug 57327
Collapse All | Expand All




.Os
.Sh NAME
.Nm wicontrol
.Nd configure Lucent, Intersil, & Atheros wireless devices
.Sh SYNOPSIS
.Nm
.Op Fl i
.Ar iface Op Fl o
.Nm
.Op Fl i
.Ar iface Fl l
(dump associated stations)
.Nm
.Op Fl i
.Ar iface Fl L
(list avail access points)
.Nm
.Op Fl i
.Ar iface Fl t Ar tx_rate
.Nm
.Op Fl i

.Op Fl i
.Ar iface Fl C
(display signal cache)
.Nm
.Op Fl i
.Ar iface Fl L
(list avail access points)
.Nm
.Op Fl i
.Ar iface Fl l
(dump associated stations)
.Sh DESCRIPTION
The
.Nm
utility controls the operation of Lucent, Intersil, & Atheros-based wireless
networking devices via
.Xr wi 4
or
.Xr ath 4
driver.
.Pp
You should not use this program to configure IEEE 802.11 paramters.
Use
.Xr ifconfig 8
instead to do those tasks (ie: set SSID, WEP key, etc).
.Pp
The
.Nm
utility can also be used to view the current settings of these parameters,
dump out the values of the card's statistics counters, list assoicated
stations (in HostAP mode), and scan for available access points.
.Pp
The
.Ar iface
argument given to
.Nm
should be the logical interface name associated with the Lucent, Intersil, 
& Atheros device
.Li ( wi0 , wi1 , ath0 ,
etc.).
If none is specified then
.Dq Li wi0

The options are as follows:
.Bl -tag -width indent
.It Oo Fl i Oc Ar iface Op Fl o
Display the current settings of the specified wireless interface.
This retrieves the current card settings from the driver and prints them
out.
Using the additional

Encryption keys are only displayed if
.Nm
is run as root.
.It Oo Fl i Oc Ar iface Op Fl l
Dump a list of connected stations (in HostAP mode).
.It Oo Fl i Oc Ar iface Op Fl L
Dump a list of available access points in tabular format.
.Bl -column ".Em TX\ rate" ".Em NIC\ speed" -offset indent  
.Em "Key	Value"
.It Cm SSID Ta "Network name/service set identifier"
.It Cm BSSID Ta "Broadcast network identifier"
.It Cm Chan Ta "Channel"
.It Cm SN S N Ta "Signal noise ratio, signal, & noise"
.It Cm Intrvl Ta "Beacon interval"
.It Cm Capinfo Ta "AP capabilities"
.El
.Pp
.It Oo Fl i Oc Ar iface Fl a Ar access_point_density
Specify the
access point density

The default is 100.
.El
.Sh SEE ALSO
.Xr ath 4 ,
.Xr awi 4 ,
.Xr ipsec 4 ,
.Xr wi 4 ,

Lines 892-897 Link Here

(-)wicontrol.c (+1 lines)
892	fprintf(stderr, "usage: %s -i iface\n", p);	892	fprintf(stderr, "usage: %s -i iface\n", p);
893	fprintf(stderr, "\t%s -i iface -o\n", p);	893	fprintf(stderr, "\t%s -i iface -o\n", p);
894	fprintf(stderr, "\t%s -i iface -l\n", p);	894	fprintf(stderr, "\t%s -i iface -l\n", p);
		895	fprintf(stderr, "\t%s -i iface -L\n", p);
895	fprintf(stderr, "\t%s -i iface -t tx rate\n", p);	896	fprintf(stderr, "\t%s -i iface -t tx rate\n", p);
896	fprintf(stderr, "\t%s -i iface -n network name\n", p);	897	fprintf(stderr, "\t%s -i iface -n network name\n", p);
897	fprintf(stderr, "\t%s -i iface -s station name\n", p);	898	fprintf(stderr, "\t%s -i iface -s station name\n", p);

Return to bug 57327

Lines 35-47 Link Here

(-)wicontrol.8 (-18 / +36 lines)
35	.Os	35	.Os
36	.Sh NAME	36	.Sh NAME
37	.Nm wicontrol	37	.Nm wicontrol
38	.Nd configure WaveLAN/IEEE devices	38	.Nd configure Lucent, Intersil, & Atheros wireless devices
39	.Sh SYNOPSIS	39	.Sh SYNOPSIS
40	.Nm	40	.Nm
41	.Op Fl i	41	.Op Fl i
42	.Ar iface Op Fl o	42	.Ar iface Op Fl o
43	.Nm	43	.Nm
44	.Op Fl i	44	.Op Fl i
		45	.Ar iface Fl l
		46	(dump associated stations)
		47	.Nm
		48	.Op Fl i
		49	.Ar iface Fl L
		50	(list avail access points)
		51	.Nm
		52	.Op Fl i
45	.Ar iface Fl t Ar tx_rate	53	.Ar iface Fl t Ar tx_rate
46	.Nm	54	.Nm
47	.Op Fl i	55	.Op Fl i
Lines 97-135 Link Here
97	.Op Fl i	105	.Op Fl i
98	.Ar iface Fl C	106	.Ar iface Fl C
99	(display signal cache)	107	(display signal cache)
100	.Nm
101	.Op Fl i
102	.Ar iface Fl L
103	(list avail access points)
104	.Nm
105	.Op Fl i
106	.Ar iface Fl l
107	(dump associated stations)
108	.Sh DESCRIPTION	108	.Sh DESCRIPTION
109	The	109	The
110	.Nm	110	.Nm
111	utility controls the operation of WaveLAN/IEEE wireless networking	111	utility controls the operation of Lucent, Intersil, & Atheros-based wireless
112	devices via the	112	networking devices via
113	.Xr wi 4	113	.Xr wi 4
		114	or
		115	.Xr ath 4
114	driver.	116	driver.
115	.Pp	117	.Pp
116	You should not use this program to configure IEEE 802.11 paramters.	118	You should not use this program to configure IEEE 802.11 paramters.
117	Use	119	Use
118	.Xr ifconfig 8	120	.Xr ifconfig 8
119	instead to do those tasks.	121	instead to do those tasks (ie: set SSID, WEP key, etc).
120	.Pp	122	.Pp
121	The	123	The
122	.Nm	124	.Nm
123	utility can also be used to view the current settings of these parameters	125	utility can also be used to view the current settings of these parameters,
124	and to dump out the values of the card's statistics counters.	126	dump out the values of the card's statistics counters, list assoicated
		127	stations (in HostAP mode), and scan for available access points.
125	.Pp	128	.Pp
126	The	129	The
127	.Ar iface	130	.Ar iface
128	argument given to	131	argument given to
129	.Nm	132	.Nm
130	should be the logical interface name associated with the WaveLAN/IEEE	133	should be the logical interface name associated with the Lucent, Intersil,
131	device	134	& Atheros device
132	.Li ( wi0 , wi1 ,	135	.Li ( wi0 , wi1 , ath0 ,
133	etc.).	136	etc.).
134	If none is specified then	137	If none is specified then
135	.Dq Li wi0	138	.Dq Li wi0
Lines 138-144 Link Here
138	The options are as follows:	141	The options are as follows:
139	.Bl -tag -width indent	142	.Bl -tag -width indent
140	.It Oo Fl i Oc Ar iface Op Fl o	143	.It Oo Fl i Oc Ar iface Op Fl o
141	Display the current settings of the specified WaveLAN/IEEE interface.	144	Display the current settings of the specified wireless interface.
142	This retrieves the current card settings from the driver and prints them	145	This retrieves the current card settings from the driver and prints them
143	out.	146	out.
144	Using the additional	147	Using the additional
Lines 149-154 Link Here
149	Encryption keys are only displayed if	152	Encryption keys are only displayed if
150	.Nm	153	.Nm
151	is run as root.	154	is run as root.
		155	.It Oo Fl i Oc Ar iface Op Fl l
		156	Dump a list of connected stations (in HostAP mode).
		157	.It Oo Fl i Oc Ar iface Op Fl L
		158	Dump a list of available access points in tabular format.
		159	.Bl -column ".Em TX\ rate" ".Em NIC\ speed" -offset indent
		160	.Em "Key Value"
		161	.It Cm SSID Ta "Network name/service set identifier"
		162	.It Cm BSSID Ta "Broadcast network identifier"
		163	.It Cm Chan Ta "Channel"
		164	.It Cm SN S N Ta "Signal noise ratio, signal, & noise"
		165	.It Cm Intrvl Ta "Beacon interval"
		166	.It Cm Capinfo Ta "AP capabilities"
		167	.El
		168	.Pp
152	.It Oo Fl i Oc Ar iface Fl a Ar access_point_density	169	.It Oo Fl i Oc Ar iface Fl a Ar access_point_density
153	Specify the	170	Specify the
154	access point density	171	access point density
Lines 520-525 Link Here
520	The default is 100.	537	The default is 100.
521	.El	538	.El
522	.Sh SEE ALSO	539	.Sh SEE ALSO
		540	.Xr ath 4 ,
523	.Xr awi 4 ,	541	.Xr awi 4 ,
524	.Xr ipsec 4 ,	542	.Xr ipsec 4 ,
525	.Xr wi 4 ,	543	.Xr wi 4 ,