xref: /netbsd-src/usr.sbin/iwictl/iwictl.8 (revision f81322cf185a4db50f71fcf7701f20198272620e)
1.\" $NetBSD: iwictl.8,v 1.7 2005/06/26 13:12:07 wiz Exp $
2.\"
3.\" Copyright (c) 2004, 2005
4.\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice unmodified, this list of conditions, and the following
11.\"    disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.Dd June 20, 2005
29.Os
30.Dt IWICTL 8
31.Sh NAME
32.Nm iwictl
33.Nd configure Intel(R) PRO/Wireless 2200BG/2915ABG network adapters
34.Sh SYNOPSIS
35.Nm
36.Op Fl i
37.Ar iface
38.Nm
39.Op Fl i
40.Ar iface Fl d Ar directory
41.Op Fl m Ar bss|ibss|monitor
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
49The
50.Nm
51utility controls the operation of Intel(R) PRO/Wireless 2200BG/2915ABG
52networking devices via the
53.Xr iwi 4
54driver.
55.Pp
56You should not use this program to configure IEEE 802.11 parameters.
57Use
58.Xr ifconfig 8
59instead.
60.Sh OPTIONS
61The options are as follows:
62.Bl -tag -width indent
63.It Fl i Ar iface
64Displays adapter's internal statistics.
65.It Fl i Ar iface Fl d Ar directory Oo Fl m Ar bss|ibss|monitor Oc
66Download firmware binary image to the adapter.
67The image is read from the
68.Ar directory
69directory.
70By default, the firmware binary image for BSS (aka infrastructure
71mode) mode is downloaded unless the
72.Fl m
73flag is given.
74Firmware binary images can be found in the
75.Pa pkgsrc/sysutils/iwi-firmware
76package.
77.It Fl i Ar iface Fl k
78Kill the firmware and reset the adapter.
79.It Fl i Ar iface Fl r
80Displays the radio transmitter state (on or off).
81.El
82.Sh SEE ALSO
83.Xr iwi 4 ,
84.Xr ifconfig 8
85.Pa pkgsrc/sysutils/iwi-firmware
86.Sh AUTHORS
87The
88.Nm
89utility and this man page were written by
90.An Damien Bergamini Aq damien.bergamini@free.fr .
91.Sh CAVEATS
92Monitor mode requires firmware version 1.0.4 (included in the
93.Pa pkgsrc/sysutils/iwi-firmware
94package version 2.3) or newer.
95