1.\"- 2.\" Copyright (c) 2008 Weongyo Jeong <weongyo@FreeBSD.org> 3.\" All rights reserved. 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.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer, 10.\" without modification. 11.\" 2. Redistributions in binary form must reproduce at minimum a disclaimer 12.\" similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any 13.\" redistribution must be conditioned upon including a substantially 14.\" similar Disclaimer requirement for further binary redistribution. 15.\" 3. Neither the names of the above-listed copyright holders nor the names 16.\" of any contributors may be used to endorse or promote products derived 17.\" from this software without specific prior written permission. 18.\" 19.\" NO WARRANTY 20.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 21.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22.\" LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY 23.\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 24.\" THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, 25.\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 26.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 27.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 28.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 30.\" THE POSSIBILITY OF SUCH DAMAGES. 31.\" 32.\" $FreeBSD$ 33.\"/ 34.Dd September 20, 2014 35.Dt MALO 4 36.Os 37.Sh NAME 38.Nm malo 39.Nd "Marvell Libertas IEEE 802.11b/g wireless network driver" 40.Sh SYNOPSIS 41To compile this driver into the kernel, 42place the following lines in your 43kernel configuration file: 44.Bd -ragged -offset indent 45.Cd "device malo" 46.Cd "device pci" 47.Cd "device wlan" 48.Cd "device firmware" 49.Ed 50.Pp 51Alternatively, to load the driver as a 52module at boot time, place the following line in 53.Xr loader.conf 5 : 54.Bd -literal -offset indent 55if_malo_load="YES" 56.Ed 57.Sh DESCRIPTION 58The 59.Nm 60driver provides support for Marvell Libertas 88W8335 based PCI 61and Cardbus network adapters. 62.Nm 63supports 64.Cm station 65and 66.Cm monitor 67mode operation. 68Only one virtual interface may be configured at any time. 69For more information on configuring this device, see 70.Xr ifconfig 8 . 71.Pp 72This driver requires the 73.Nm malofw 74firmware kernel module be installed before it will work. 75The firmware files are not publicly available. 76A port of the firmware can be found at: 77.Bd -literal -offset indent 78http://weongyo.org/project/malo/malo-firmware-1.4.tar.gz 79.Ed 80.Pp 81The firmware kernel module can be installed by extracting 82the archive and running 83.Ql make install clean 84in the 85.Pa malo-firmware-1.4 86directory. 87.Pp 88To load the 89.Nm malofw 90firmware kernel module at boot time, place the following 91line in 92.Xr loader.conf 5 : 93.Bd -literal -offset indent 94malofw_load="YES" 95.Ed 96.Sh HARDWARE 97The following cards are among those supported by the 98.Nm 99driver: 100.Bl -column "Netgear WG311v3" "88W8335" "PCI" "b/g" 101.Em "Card" Ta Em "Chip" Ta Em "Bus" Ta Em "Standard" 102.It "Netgear WG311v3" Ta "88W8335" Ta "PCI" Ta "b/g" 103.It "Tenda TWL542P" Ta "88W8335" Ta "PCI" Ta "b/g" 104.It "U-Khan UW-2054i" Ta "88W8335" Ta "PCI" Ta "b/g" 105.El 106.Sh EXAMPLES 107Join an existing BSS network (i.e., connect to an access point): 108.Bd -literal -offset indent 109ifconfig wlan create wlandev malo0 inet 192.168.0.20 \e 110 netmask 0xffffff00 111.Ed 112.Pp 113Join a specific BSS network with network name 114.Dq Li my_net : 115.Pp 116.Dl "ifconfig wlan create wlandev malo0 ssid my_net up" 117.Pp 118Join a specific BSS network with 64-bit WEP encryption: 119.Bd -literal -offset indent 120ifconfig wlan create wlandev malo0 ssid my_net \e 121 wepmode on wepkey 0x1234567890 weptxkey 1 up 122.Ed 123.Sh SEE ALSO 124.Xr cardbus 4 , 125.Xr pci 4 , 126.Xr wlan 4 , 127.Xr wlan_ccmp 4 , 128.Xr wlan_tkip 4 , 129.Xr wlan_wep 4 , 130.Xr ifconfig 8 , 131.Xr wpa_supplicant 8 132.Sh HISTORY 133The 134.Nm 135device driver first appeared in 136.Fx 7.1 . 137