1.\" $NetBSD: malo.4,v 1.7 2015/10/07 00:44:25 snj Exp $ 2.\" $OpenBSD: malo.4,v 1.35 2010/11/01 17:59:09 jmc Exp $ 3.\" 4.\" Copyright (c) 2006 Theo de Raadt. 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.\" 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in 14.\" the documentation and/or other materials provided with the 15.\" distribution. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 18.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 19.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 20.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 21.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 22.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, 23.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 24.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 25.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 26.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 27.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" 30.Dd July 30, 2012 31.Dt MALO 4 32.Os 33.Sh NAME 34.Nm malo 35.Nd Marvell Libertas IEEE 802.11b/g wireless network device 36.Sh SYNOPSIS 37.Cd "malo* at pci?" 38.Sh DESCRIPTION 39The 40.Nm 41driver provides support for Marvell Libertas 88W8335/88W8310/88W8385 based 42PCI network adapters. 43The second generation 88W8335/88W8310 chipsets support 802.11b/g. 44.Pp 45These are the modes the 46.Nm 47driver can operate in: 48.Bl -tag -width "IBSS-masterXX" 49.It BSS mode 50Also known as 51.Em infrastructure 52mode, this is used when associating with an access point, through 53which all traffic passes. 54This mode is the default. 55.\" .It IBSS mode 56.\" Also known as 57.\" .Em IEEE ad-hoc 58.\" mode or 59.\" .Em peer-to-peer 60.\" mode. 61.\" This is the standardized method of operating without an access point. 62.\" Stations associate with a service set. 63.\" However, actual connections between stations are peer-to-peer. 64.\" .It Host AP 65.\" In this mode the driver acts as an access point (base station) 66.\" for other cards. 67.It monitor mode 68In this mode the driver is able to receive packets without 69associating with an access point. 70This disables the internal receive filter and enables the card to 71capture packets from networks which it wouldn't normally have access to, 72or to scan for access points. 73.El 74.Pp 75The 76.Nm 77driver can be configured to use 78Wired Equivalent Privacy (WEP) or 79Wi-Fi Protected Access (WPA-PSK and WPA2-PSK). 80WPA is the de facto encryption standard for wireless networks. 81It is strongly recommended that WEP 82not be used as the sole mechanism 83to secure wireless communication, 84due to serious weaknesses in it. 85The 86.Nm 87driver relies on the software 802.11 stack for both encryption and decryption 88of data frames. 89.Pp 90The 91.Nm 92driver can be configured at runtime with 93.Xr ifconfig 8 94or on boot with 95.Xr ifconfig.if 5 . 96.Sh FILES 97The driver needs a set of firmware files which are loaded when 98an interface is brought up: 99.Pp 100.Bl -tag -width Ds -offset indent -compact 101.It Pa /libdata/firmware/malo/malo8335-h 102.It Pa /libdata/firmware/malo/malo8335-m 103.It Pa /libdata/firmware/malo/malo8338 104.It Pa /libdata/firmware/malo/malo8385-h 105.It Pa /libdata/firmware/malo/malo8385-m 106.El 107.Pp 108These firmware files are not free because Marvell refuses 109to grant distribution rights. 110As a result, even though 111.Ox 112includes the driver, the firmware files cannot be included and 113users have to download these files on their own. 114.Pp 115A prepackaged version of the firmware, designed to be used with 116.Xr pkg_add 1 , 117can be found at: 118.Bd -literal -offset 3n 119http://www.nazgul.ch/malo/malo-firmware-1.4.tgz 120.Ed 121.Sh HARDWARE 122The following cards are among those supported by the 123.Nm 124driver: 125.Pp 126.Bl -column -offset 6n -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g" 127.It Em Card Ta Em Chip Ta Em Bus Ta Em Standard 128.It Netgear WG311v3 Ta 88W8335 Ta PCI Ta b/g 129.It Tenda TWL542P Ta 88W8335 Ta PCI Ta b/g 130.El 131.Sh EXAMPLES 132The following 133.Xr ifconfig.if 5 134example configures malo0 to join whatever network is available on boot, 135using WEP key 136.Dq 0x1deadbeef1 , 137channel 11, obtaining an IP address using DHCP: 138.Bd -literal -offset indent 139dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11 140.Ed 141.Pp 142.\"The following 143.\".Xr ifconfig.if 5 144.\"example creates a host-based access point on boot: 145.\".Bd -literal -offset indent 146.\"inet 192.168.1.1 255.255.255.0 NONE media autoselect \e 147.\" mediaopt hostap nwid my_net chan 11 148.\".Ed 149.\".Pp 150Join an existing BSS network, 151.Dq my_net : 152.Bd -literal -offset indent 153# ifconfig malo0 192.168.1.1 netmask 0xffffff00 nwid my_net 154.Ed 155.Sh NOTES 156Contrary to the driver on 157.Ox , 158this driver currently does not work on PCMCIA/CARDBUS. 159.Sh SEE ALSO 160.Xr arp 4 , 161.Xr ifmedia 4 , 162.Xr intro 4 , 163.Xr netintro 4 , 164.Xr pci 4 , 165.Xr ifconfig.if 5 , 166.Xr hostapd 8 , 167.Xr ifconfig 8 168.Sh AUTHORS 169.An -nosplit 170The 171.Nm 172driver was first written by 173.An Claudio Jeker Aq Mt claudio@openbsd.org 174and 175.An Marcus Glocker Aq Mt mglocker@openbsd.org 176and appeared first in 177.Ox 4.1 . 178.Nx 179porting was done by 180.An Arnaud Degroote Aq Mt degroote@NetBSD.org . 181