summaryrefslogtreecommitdiff
path: root/share/man/man4
diff options
context:
space:
mode:
authorMarcus Glocker <mglocker@cvs.openbsd.org>2007-04-05 16:25:26 +0000
committerMarcus Glocker <mglocker@cvs.openbsd.org>2007-04-05 16:25:26 +0000
commite3a017b4b7d56ce099f4d8d35709274aa9fceafc (patch)
treede2675a70c0ce76a1e77964cb71eebbc2fc7f7c3 /share/man/man4
parentb379106f42e39d77dcc563db6fbc48b4e47d06d5 (diff)
After been attacked by Michael Buesch <mb@bu3sch.de> because we initially
were using some of their routines in the bcw driver, I decided to stop working on it. To avoid any further license chit chat I plain drop the driver.
Diffstat (limited to 'share/man/man4')
-rw-r--r--share/man/man4/bcw.4311
1 files changed, 0 insertions, 311 deletions
diff --git a/share/man/man4/bcw.4 b/share/man/man4/bcw.4
deleted file mode 100644
index 9c1046cbf84..00000000000
--- a/share/man/man4/bcw.4
+++ /dev/null
@@ -1,311 +0,0 @@
-.\" $OpenBSD: bcw.4,v 1.8 2007/01/06 18:39:15 mglocker Exp $
-.\"
-.\" Copyright (c) 2006 Marcus Glocker.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in
-.\" the documentation and/or other materials provided with the
-.\" distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
-.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
-.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
-.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
-.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.Dd November 17, 2006
-.Os
-.Dt BCW 4
-.Sh NAME
-.Nm bcw
-.Nd Broadcom IEEE 802.11b/g wireless network device
-.Sh SYNOPSIS
-.Cd "bcw* at cardbus?"
-.Cd "bcw* at pci?"
-.Sh DESCRIPTION
-The
-.Nm
-driver provides support for Broadcom BCM43xx based
-PCI/Cardbus network adapters.
-.Pp
-These are the modes the
-.Nm
-driver can operate in:
-.Bl -tag -width "IBSS-masterXX"
-.It BSS mode
-Also known as
-.Em infrastructure
-mode, this is used when associating with an access point, through
-which all traffic passes.
-This mode is the default.
-.\" .It IBSS mode
-.\" Also known as
-.\" .Em IEEE ad-hoc
-.\" mode or
-.\" .Em peer-to-peer
-.\" mode.
-.\" This is the standardized method of operating without an access point.
-.\" Stations associate with a service set.
-.\" However, actual connections between stations are peer-to-peer.
-.\" .It Host AP
-.\" In this mode the driver acts as an access point (base station)
-.\" for other cards.
-.\" .It monitor mode
-.\" In this mode the driver is able to receive packets without
-.\" associating with an access point.
-.\" This disables the internal receive filter and enables the card to
-.\" capture packets from networks which it wouldn't normally have access to,
-.\" or to scan for access points.
-.El
-.Pp
-.\" .Nm
-.\" supports hardware WEP.
-.\" Wired Equivalent Privacy (WEP) is the de facto encryption standard
-.\" for wireless networks.
-.\" It can be typically configured in one of three modes:
-.\" no encryption; 40-bit encryption; or 104-bit encryption.
-.\" Unfortunately, due to serious weaknesses in WEP protocol
-.\" it is strongly recommended that it not be used as the
-.\" sole mechanism to secure wireless communication.
-.\" WEP is not enabled by default.
-.\" .Pp
-The transmit speed is user-selectable or can be adapted automatically by the
-driver depending on the received signal strength and on the number of hardware
-transmission retries.
-See
-.Xr rssadapt 9
-for more information.
-.Sh CONFIGURATION
-The
-.Nm
-driver can be configured at runtime with
-.Xr ifconfig 8
-or on boot with
-.Xr hostname.if 5
-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.
-.It Cm DS1
-Set 802.11b DS 1Mbps operation.
-.It Cm DS2
-Set 802.11b DS 2Mbps operation.
-.It Cm DS5
-Set 802.11b DS 5.5Mbps operation.
-.It Cm DS11
-Set 802.11b DS 11Mbps operation.
-.It Cm OFDM6
-Set 802.11g OFDM 6Mbps operation.
-.It Cm OFDM9
-Set 802.11g OFDM 9Mbps operation.
-.It Cm OFDM12
-Set 802.11g OFDM 12Mbps operation.
-.It Cm OFDM18
-Set 802.11g OFDM 18Mbps operation.
-.It Cm OFDM24
-Set 802.11g OFDM 24Mbps operation.
-.It Cm OFDM36
-Set 802.11g OFDM 36Mbps operation.
-.It Cm OFDM48
-Set 802.11g OFDM 48Mbps operation.
-.It Cm OFDM54
-Set 802.11g OFDM 54Mbps operation.
-.El
-.It Cm mediaopt Ar opts
-The
-.Nm
-driver supports the following media options:
-.Pp
-.Bl -tag -width monitor -compact
-.It Cm hostap
-Select Host AP operation.
-.It Cm ibss
-Select IBSS operation.
-.\".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 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 Fl nwid
-Set the network ID to the empty string to allow the interface to connect
-to any available access point.
-.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 FILES
-The driver needs a firmware file which is loaded when an interface is
-brought up:
-.Pp
-.Bl -tag -width Ds -offset indent -compact
-.It Pa /etc/firmware/bcw-bcm43xx
-.El
-.\".Pp
-.\"These firmware files are not free because Marvell refuses
-.\"to grant distribution rights.
-.\"As a result, even though
-.\".Ox
-.\"includes the driver, the firmware files cannot be included and
-.\"users have to download these files on their own.
-.Pp
-A prepackaged version of the firmware, designed to be used with
-.Xr pkg_add 1 ,
-can be found at:
-.Bd -literal -offset indent
-http://www.nazgul.ch/bcw/bcw-firmware-1.3.tgz
-.Ed
-.Sh HARDWARE
-The following cards are among those supported by the
-.Nm
-driver:
-.Pp
-.Bl -column -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g" -offset 6n
-.Em "Card Chip Bus Standard"
-? BCM4318 PCI b/g
-? BCM4306 PCI b/g
-.El
-.Sh EXAMPLES
-The following
-.Xr hostname.if 5
-example configures bcw0 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
-The following
-.Xr hostname.if 5
-example creates a host-based access point on boot:
-.Bd -literal -offset indent
-inet 192.168.1.1 255.255.255.0 NONE media autoselect \e
- mediaopt hostap nwid my_net chan 11
-.Ed
-.Pp
-Configure bcw0 for WEP, using hex key
-.Dq 0x1deadbeef1 :
-.Bd -literal -offset indent
-# ifconfig bcw0 nwkey 0x1deadbeef1
-.Ed
-.Pp
-Return bcw0 to its default settings:
-.Bd -literal -offset indent
-# ifconfig bcw0 -bssid -chan media autoselect \e
- nwid "" -nwkey
-.Ed
-.Pp
-Join an existing BSS network,
-.Dq my_net :
-.Bd -literal -offset indent
-# ifconfig bcw0 192.168.1.1 netmask 0xffffff00 nwid my_net
-.Ed
-.Sh SEE ALSO
-.Xr arp 4 ,
-.Xr cardbus 4 ,
-.Xr ifmedia 4 ,
-.Xr intro 4 ,
-.Xr netintro 4 ,
-.Xr pci 4 ,
-.Xr hostname.if 5 ,
-.Xr hostapd 8 ,
-.Xr ifconfig 8
-.Sh HISTORY
-The
-.Nm
-driver first appeared in
-.Ox 4.1 .
-.Sh AUTHORS
-.An -nosplit
-The
-.Nm
-driver was originally written by
-.An Cliff Wright
-and then rewritten for IEEE 802.11
-by
-.An Jon Simola .