209 lines
5.7 KiB
Groff
209 lines
5.7 KiB
Groff
.\" $NetBSD: iwn.4,v 1.12 2014/03/18 18:20:39 riastradh Exp $
|
|
.\"
|
|
.\" Copyright (c) 2007,2008
|
|
.\" Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
.\"
|
|
.Dd February 25, 2012
|
|
.Dt IWN 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm iwn
|
|
.Nd Intel Wireless 4965AGN and 5100AGN IEEE 802.11 driver
|
|
.Sh SYNOPSIS
|
|
.Cd "iwn* at pci? dev ? function ?"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
driver provides support for
|
|
.Tn Intel
|
|
Wireless WiFi Link 4965AGN and 5100AGN Mini PCI Express network adapters.
|
|
.Pp
|
|
By default, the
|
|
.Nm
|
|
driver configures the adapter for BSS operation (aka infrastructure mode).
|
|
This mode requires the use of an access point.
|
|
.Pp
|
|
For more information on configuring this device, see
|
|
.Xr ifconfig 8 .
|
|
.Sh CONFIGURATION
|
|
The
|
|
.Nm
|
|
driver can be configured at runtime with
|
|
.Xr ifconfig 8
|
|
using the following parameters:
|
|
.Bl -tag -width Ds
|
|
.It Cm bssid Ar bssid
|
|
Set the desired BSSID.
|
|
.It Fl bssid
|
|
Unset the desired BSSID.
|
|
The interface will automatically select a BSSID in this mode, which is
|
|
the default.
|
|
.It Cm chan Ar n
|
|
Set the channel (radio frequency) to be used by the driver based on
|
|
the given channel ID
|
|
.Ar n .
|
|
.It Fl chan
|
|
Unset the desired channel to be used by the driver.
|
|
The driver will automatically select a channel in this mode, which is
|
|
the default.
|
|
.It Cm media Ar media
|
|
The
|
|
.Nm
|
|
driver supports the following
|
|
.Ar media
|
|
types:
|
|
.Pp
|
|
.Bl -tag -width autoselect -compact
|
|
.It Cm autoselect
|
|
Enable autoselection of the media type and options.
|
|
.El
|
|
.It Cm mediaopt Ar opts
|
|
The
|
|
.Nm
|
|
driver supports the following media options:
|
|
.Pp
|
|
.Bl -tag -width monitor -compact
|
|
.It Cm monitor
|
|
Select monitor mode.
|
|
.El
|
|
.It Fl mediaopt Ar opts
|
|
Disable the specified media options on the driver and return it to the
|
|
default mode of operation (BSS).
|
|
.It Cm mode Ar mode
|
|
The
|
|
.Nm
|
|
driver supports the following modes:
|
|
.Pp
|
|
.Bl -tag -width 11b -compact
|
|
.It Cm 11a
|
|
Force 802.11a operation.
|
|
.It Cm 11b
|
|
Force 802.11b operation.
|
|
.It Cm 11g
|
|
Force 802.11g operation.
|
|
.El
|
|
.It Cm nwid Ar id
|
|
Set the network ID.
|
|
The
|
|
.Ar id
|
|
can either be any text string up to 32 characters in length,
|
|
or a series of hexadecimal digits up to 64 digits.
|
|
An empty
|
|
.Ar id
|
|
string allows the interface to connect to any available access points.
|
|
By default the
|
|
.Nm
|
|
driver uses an empty string.
|
|
Note that network ID is synonymous with Extended Service Set ID (ESSID).
|
|
.It Cm nwkey Ar key
|
|
Enable WEP encryption using the specified
|
|
.Ar key .
|
|
The
|
|
.Ar key
|
|
can either be a string, a series of hexadecimal digits (preceded by
|
|
.Sq 0x ) ,
|
|
or a set of keys of the form
|
|
.Dq n:k1,k2,k3,k4 ,
|
|
where
|
|
.Sq n
|
|
specifies which of the keys will be used for transmitted packets,
|
|
and the four keys,
|
|
.Dq k1
|
|
through
|
|
.Dq k4 ,
|
|
are configured as WEP keys.
|
|
If a set of keys is specified, a comma
|
|
.Pq Sq \&,
|
|
within the key must be escaped with a backslash.
|
|
Note that if multiple keys are used, their order must be the same within
|
|
the network.
|
|
.Nm
|
|
is capable of using both 40-bit (5 characters or 10 hexadecimal digits)
|
|
or 104-bit (13 characters or 26 hexadecimal digits) keys.
|
|
.It Fl nwkey
|
|
Disable WEP encryption.
|
|
This is the default mode of operation.
|
|
.El
|
|
.Sh EXAMPLES
|
|
The following
|
|
.\" .Xr hostname.if 5 ,
|
|
example configures iwn0 to join whatever network is available on boot,
|
|
using WEP key
|
|
.Dq 0x1deadbeef1 ,
|
|
channel 11, obtaining an IP address using DHCP:
|
|
.Bd -literal -offset indent
|
|
dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11
|
|
.Ed
|
|
.Pp
|
|
Configure iwn0 for WEP, using hex key
|
|
.Dq 0x1deadbeef1 :
|
|
.Bd -literal -offset indent
|
|
# ifconfig iwn0 nwkey 0x1deadbeef1
|
|
.Ed
|
|
.Pp
|
|
Return iwn0 to its default settings:
|
|
.Bd -literal -offset indent
|
|
# ifconfig iwn0 -bssid -chan media autoselect \e
|
|
nwid "" -nwkey
|
|
.Ed
|
|
.Pp
|
|
Join an existing BSS network,
|
|
.Dq my_net :
|
|
.Bd -literal -offset indent
|
|
# ifconfig iwn0 192.168.1.1 netmask 0xffffff00 nwid my_net
|
|
.Ed
|
|
.Sh DIAGNOSTICS
|
|
.Bl -diag
|
|
.It "iwn%d: device timeout"
|
|
A frame dispatched to the hardware for transmission did not complete in time.
|
|
The driver will reset the hardware.
|
|
This should not happen.
|
|
.It "iwn%d: fatal firmware error"
|
|
For some reason, the firmware crashed.
|
|
The driver will reset the hardware.
|
|
This should not happen.
|
|
.It "iwn%d: radio is disabled by hardware switch"
|
|
The radio transmitter is off and thus no packet can go out.
|
|
The driver will reset the hardware.
|
|
Make sure the laptop radio switch is on.
|
|
.It "iwn%d: error %d, could not read firmware %s"
|
|
For some reason, the driver was unable to read the firmware image from the
|
|
filesystem.
|
|
The file might be missing or corrupted.
|
|
.It "iwn%d: could not get firmware handle %s"
|
|
.It "iwn%d: could not read firmware"
|
|
The driver was unable to find the file with the proper firmware image.
|
|
It should be located in
|
|
.Pa /libdata/firmware/if_iwn .
|
|
.It "iwn%d: firmware file too short: %d bytes"
|
|
The firmware image is corrupted and can't be loaded into the adapter.
|
|
.It "iwn%d: could not load firmware"
|
|
An attempt to load the firmware into the adapter failed.
|
|
The driver will reset the hardware.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr arp 4 ,
|
|
.Xr ifmedia 4 ,
|
|
.Xr intro 4 ,
|
|
.Xr netintro 4 ,
|
|
.Xr pci 4 ,
|
|
.\" .Xr hostname.if 5 ,
|
|
.Xr ifconfig 8
|
|
.Sh AUTHORS
|
|
The
|
|
.Nm
|
|
driver and this man page were written by
|
|
.An Damien Bergamini Aq Mt damien.bergamini@free.fr .
|