1.\" $OpenBSD: malo.4,v 1.45 2014/02/15 20:28:19 tedu Exp $ 2.\" 3.\" Copyright (c) 2006 Theo de Raadt. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in 13.\" the documentation and/or other materials provided with the 14.\" distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 19.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 20.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 21.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, 22.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 23.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 24.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 25.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 26.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" 29.Dd $Mdocdate: February 15 2014 $ 30.Dt MALO 4 31.Os 32.Sh NAME 33.Nm malo 34.Nd Marvell Libertas IEEE 802.11b/g wireless network device 35.Sh SYNOPSIS 36.Cd "malo* at cardbus?" 37.Cd "malo* at pci?" 38.Cd "malo* at pcmcia?" 39.Sh DESCRIPTION 40The 41.Nm 42driver provides support for Marvell Libertas 88W8335/88W8310/88W8385 based 43PCI/CardBus/PCMCIA network adapters. 44The second generation 88W8335/88W8310 chipsets support 802.11b/g. 45.Pp 46These are the modes the 47.Nm 48driver can operate in: 49.Bl -tag -width "IBSS-masterXX" 50.It BSS mode 51Also known as 52.Em infrastructure 53mode, this is used when associating with an access point, through 54which all traffic passes. 55This mode is the default. 56.It monitor mode 57In this mode the driver is able to receive packets without 58associating with an access point. 59This disables the internal receive filter and enables the card to 60capture packets from networks which it wouldn't normally have access to, 61or to scan for access points. 62.El 63.Pp 64The 65.Nm 66driver can be configured to use 67Wired Equivalent Privacy (WEP) or 68Wi-Fi Protected Access (WPA-PSK and WPA2-PSK). 69WPA is the current encryption standard for wireless networks. 70It is strongly recommended that WEP 71not be used as the sole mechanism 72to secure wireless communication, 73due to serious weaknesses in it. 74The 75.Nm 76driver relies on the software 802.11 stack for both encryption and decryption 77of data frames. 78.Pp 79The 80.Nm 81driver can be configured at runtime with 82.Xr ifconfig 8 83or on boot with 84.Xr hostname.if 5 . 85.Sh FILES 86The driver needs a set of firmware files which are loaded when 87an interface is brought up: 88.Pp 89.Bl -tag -width Ds -offset indent -compact 90.It Pa /etc/firmware/malo8335-h 91.It Pa /etc/firmware/malo8335-m 92.It Pa /etc/firmware/malo8338 93.It Pa /etc/firmware/malo8385-h 94.It Pa /etc/firmware/malo8385-m 95.El 96.Pp 97These firmware files are not free because Marvell refuses 98to grant distribution rights. 99As a result, even though 100.Ox 101includes the driver, the firmware files cannot be included and 102users have to download these files on their own. 103.Pp 104A prepackaged version of the firmware can be installed using 105.Xr fw_update 1 . 106.Sh HARDWARE 107The following cards are among those supported by the 108.Nm 109driver: 110.Bl -column "I-O DATA WN-G54/CF" "88W8385" "CardBus" "Standard" -offset 6n 111.It Em Card Ta Em Chip Ta Em Bus Ta Em Standard 112.It "Ambicom WL54CF" Ta 88W8385 Ta PCMCIA Ta b/g 113.It "I-O DATA WN-G54/CF" Ta 88W8385 Ta PCMCIA Ta b/g 114.It "Netgear WG511v2" Ta 88W8310 Ta CardBus Ta b/g 115.It "Netgear WG311v3" Ta 88W8335 Ta PCI Ta b/g 116.It "SparkLAN WCFM-100" Ta 88W8385 Ta PCMCIA Ta b/g 117.It "Tenda TWL541C" Ta 88W8310 Ta CardBus Ta b/g 118.It "Tenda TWL542P" Ta 88W8335 Ta PCI Ta b/g 119.El 120.Sh EXAMPLES 121The following example scans for available networks: 122.Pp 123.Dl # ifconfig malo0 scan 124.Pp 125The following 126.Xr hostname.if 5 127example configures malo0 to join network 128.Dq mynwid , 129using WPA key 130.Dq mywpakey , 131obtaining an IP address using DHCP: 132.Bd -literal -offset indent 133nwid mynwid 134wpakey mywpakey 135dhcp 136.Ed 137.Sh SEE ALSO 138.Xr arp 4 , 139.Xr cardbus 4 , 140.Xr ifmedia 4 , 141.Xr intro 4 , 142.Xr netintro 4 , 143.Xr pci 4 , 144.Xr hostname.if 5 , 145.Xr hostapd 8 , 146.Xr ifconfig 8 147.Sh HISTORY 148The 149.Nm 150driver first appeared in 151.Ox 4.1 . 152.Sh AUTHORS 153.An -nosplit 154The 155.Nm 156driver was written by 157.An Claudio Jeker 158and 159.An Marcus Glocker . 160.Sh CAVEATS 161WPA encryption is not supported for PCMCIA devices. 162