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 April 13, 2008
  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 be installed before it will work.
  75 The firmware files are not publicly available.
  76 A package of the firmware which can be installed via
  77 .Xr pkg_add 1
  78 with:
  79 .Bd -literal -offset indent
  80 http://weongyo.org/project/malo/malo-firmware-1.4.tar.gz
  81 .Ed
  82 .Sh HARDWARE
  83 The following cards are among those supported by the
  84 .Nm
  85 driver:
  86 .Pp
  87 .Bl -column -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g" -offset 6n
  88 .Em "Card       Chip    Bus     Standard"
  89 Netgear WG311v3 88W8335 PCI     b/g
  90 Tenda TWL542P   88W8335 PCI     b/g
  91 U-Khan UW-2054i 88W8335 PCI     b/g
  92 .El
  93 .Sh EXAMPLES
  94 Join an existing BSS network (i.e., connect to an access point):
  95 .Pp
  96 .Bd -literal -offset indent
  97 ifconfig wlan create wlandev malo0 inet 192.168.0.20 \e
  98     netmask 0xffffff00
  99 .Ed
 100 .Pp
 101 Join a specific BSS network with network name
 102 .Dq Li my_net :
 103 .Pp
 104 .Dl "ifconfig wlan create wlandev malo0 ssid my_net up"
 105 .Pp
 106 Join a specific BSS network with 64-bit WEP encryption:
 107 .Bd -literal -offset indent
 108 ifconfig wlan create wlandev malo0 ssid my_net \e
 109         wepmode on wepkey 0x1234567890 weptxkey 1 up
 110 .Ed
 111 .Sh SEE ALSO
 112 .Xr cardbus 4 ,
 113 .Xr pci 4 ,
 114 .Xr wlan 4 ,
 115 .Xr wlan_ccmp 4 ,
 116 .Xr wlan_tkip 4 ,
 117 .Xr wlan_wep 4 ,
 118 .Xr ifconfig 8 ,
 119 .Xr wpa_supplicant 8
 120 .Sh HISTORY
 121 The
 122 .Nm
 123 device driver first appeared in
 124 .Fx 8.0 .