Merge from vendor branch INTEL_ACPICA:
[dragonfly.git] / usr.sbin / ipwcontrol / ipwcontrol.8
1 .\" Copyright (c) 2004, 2005
2 .\"     Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\"    notice unmodified, this list of conditions, and the following
9 .\"    disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\"    notice, this list of conditions and the following disclaimer in the
12 .\"    documentation and/or other materials provided with the distribution.
13 .\"
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 .\" SUCH DAMAGE.
25 .\"
26 .\" $Id: ipwcontrol.8,v 1.1.2.1 2005/01/13 20:01:05 damien Exp $
27 .\" $DragonFly: src/usr.sbin/ipwcontrol/Attic/ipwcontrol.8,v 1.1 2005/03/06 18:25:14 dillon Exp $
28 .\"
29 .Dd September 4, 2004
30 .Os
31 .Dt IPWCONTROL 8
32 .Sh NAME
33 .Nm ipwcontrol
34 .Nd configure Intel PRO/Wireless 2100 network adapter
35 .Sh SYNOPSIS
36 .Nm
37 .Op Fl i
38 .Ar iface
39 .Nm
40 .Op Fl i
41 .Ar iface Fl f Ar firmware
42 .Nm
43 .Op Fl i
44 .Ar iface Fl k
45 .Nm
46 .Op Fl i
47 .Ar iface Fl r
48 .Sh DESCRIPTION
49 The
50 .Nm
51 utility controls the operation of Intel PRO/Wireless 2100 networking
52 devices via
53 .Xr ipw 4
54 driver.
55 .Pp
56 You should not use this program to configure IEEE 802.11 parameters.
57 Use
58 .Xr ifconfig 8
59 instead.
60 .Sh OPTIONS
61 The options are as follows:
62 .Bl -tag -width indent
63 .It Oo Fl i Oc Ar iface
64 Display adapter's internal statistics.
65 .It Oo Fl i Oc Ar iface Fl f Ar firmware
66 Download firmware binary image
67 .Ar firmware
68 to the driver.
69 .It Oo Fl i Oc Ar iface Fl k
70 Kill (remove) the firmware and reset the adapter.
71 .It Oo Fl i Oc Ar iface Fl r
72 Display the radio switch state (on or off).
73 .El
74 .Sh FILES
75 The firmware is not shipped with
76 .Fx ;
77 install the
78 .Pa ipw-firmware
79 package.
80 The original archive is available from Intel at:
81 .Pa http://ipw2100.sourceforge.net/firmware.php?fid=3 .
82 .Pp
83 .Bl -tag -width ipw2100-1.2-i.fw -compact
84 .It Pa ipw2100-1.2.fw
85 BSS mode (connection to an access point) firmware
86 .It Pa ipw2100-1.2-i.fw
87 IBSS mode (point-to-point connection) firmware
88 .It Pa ipw2100-1.2-p.fw
89 Monitor mode firmware
90 .El
91 .Sh SEE ALSO
92 .Xr ipw 4 ,
93 .Xr ifconfig 8
94 .Sh AUTHORS
95 The
96 .Nm
97 utility and this man page were written by
98 .An Damien Bergamini Aq damien.bergamini@free.fr .