share/man/man4/malo.4

   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 October 21, 2009
  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
  41 To compile this driver into the kernel,
  42 place the following lines in your
  43 kernel 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
  51 Alternatively, to load the driver as a
  52 module at boot time, place the following lines in
  53 .Xr loader.conf 5 :
  54 .Bd -literal -offset indent
  55 if_malo_load="YES"
  56 .Ed
  57 .Sh DESCRIPTION
  58 The
  59 .Nm
  60 driver provides support for Marvell Libertas 88W8335 based PCI
  61 and Cardbus network adapters.
  62 .Nm
  63 supports
  64 .Cm station
  65 and
  66 .Cm monitor
  67 mode operation.
  68 Only one virtual interface may be configured at any time.
  69 For more information on configuring this device, see
  70 .Xr ifconfig 8 .
  71 .Pp
  72 This driver requires the
  73 .Nm malofw
  74 firmware kernel module be installed before it will work.
  75 The firmware files are not publicly available.
  76 A port of the firmware can be found at:
  77 .Bd -literal -offset indent
  78 http://weongyo.org/project/malo/malo-firmware-1.4.tar.gz
  79 .Ed
  80 .Pp
  81 The firmware kernel module can be installed by extracting
  82 the archive and running
  83 .Ql make install clean
  84 in the
  85 .Pa malo-firmware-1.4
  86 directory.
  87 .Sh HARDWARE
  88 The following cards are among those supported by the
  89 .Nm
  90 driver:
  91 .Bl -column "Netgear WG311v3" "88W8335" "PCI" "b/g"
  92 .Em "Card" Ta Em "Chip" Ta Em "Bus" Ta Em "Standard"
  93 .It "Netgear WG311v3" Ta "88W8335" Ta "PCI" Ta "b/g"
  94 .It "Tenda TWL542P" Ta "88W8335" Ta "PCI" Ta "b/g"
  95 .It "U-Khan UW-2054i" Ta "88W8335" Ta "PCI" Ta "b/g"
  96 .El
  97 .Sh EXAMPLES
  98 Join an existing BSS network (i.e., connect to an access point):
  99 .Bd -literal -offset indent
 100 ifconfig wlan create wlandev malo0 inet 192.168.0.20 \e
 101     netmask 0xffffff00
 102 .Ed
 103 .Pp
 104 Join a specific BSS network with network name
 105 .Dq Li my_net :
 106 .Pp
 107 .Dl "ifconfig wlan create wlandev malo0 ssid my_net up"
 108 .Pp
 109 Join a specific BSS network with 64-bit WEP encryption:
 110 .Bd -literal -offset indent
 111 ifconfig wlan create wlandev malo0 ssid my_net \e
 112         wepmode on wepkey 0x1234567890 weptxkey 1 up
 113 .Ed
 114 .Sh SEE ALSO
 115 .Xr cardbus 4 ,
 116 .Xr pci 4 ,
 117 .Xr wlan 4 ,
 118 .Xr wlan_ccmp 4 ,
 119 .Xr wlan_tkip 4 ,
 120 .Xr wlan_wep 4 ,
 121 .Xr ifconfig 8 ,
 122 .Xr wpa_supplicant 8
 123 .Sh HISTORY
 124 The
 125 .Nm
 126 device driver first appeared in
 127 .Fx 7.1 .