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 March 26, 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 wlan_load="YES"
  57 firmware_load="YES"
  58 .Ed
  59 .Pp
  60 In both cases, place the following line in
  61 .Xr loader.conf 5
  62 to load the firmware module:
  63 .Bd -literal -offset indent
  64 malofw_load="YES"
  65 .Ed
  66 .Sh DESCRIPTION
  67 The
  68 .Nm
  69 driver provides support for Marvell Libertas 88W8335 based PCI
  70 network adapters.
  71 .Pp
  72 This driver requires firmware to be loaded before it will work.
  73 These firmware files are from the
  74 .Ox
  75 .Nm
  76 driver.
  77 .Pp
  78 A package for the firmware which can be installed via
  79 .Xr pkg_add 1
  80 can be found at:
  81 .Bd -literal -offset indent
  82 http://weongyo.org/project/malo/malo-firmware-1.4.tar.gz
  83 .Ed
  84 .Pp
  85 This package must be installed before
  86 .Xr ifconfig 8
  87 will work.
  88 .Pp
  89 For more information on configuring this device, see
  90 .Xr ifconfig 8 .
  91 .Sh HARDWARE
  92 The following cards are among those supported by the
  93 .Nm
  94 driver:
  95 .Pp
  96 .Bl -column -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g" -offset 6n
  97 .Em "Card       Chip    Bus     Standard"
  98 Netgear WG311v3 88W8335 PCI     b/g
  99 Tenda TWL542P   88W8335 PCI     b/g
 100 U-Khan UW-2054i 88W8335 PCI     b/g
 101 .El
 102 .Sh EXAMPLES
 103 Join an existing BSS network (i.e., connect to an access point):
 104 .Pp
 105 .Dl "ifconfig malo0 inet 192.168.0.20 netmask 0xffffff00"
 106 .Pp
 107 Join a specific BSS network with network name
 108 .Dq Li my_net :
 109 .Pp
 110 .Dl "ifconfig malo0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net"
 111 .Pp
 112 Join a specific BSS network with WEP encryption:
 113 .Bd -literal -offset indent
 114 ifconfig malo0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
 115         wepmode on wepkey 0x8736639624
 116 .Ed
 117 .Sh SEE ALSO
 118 .Xr altq 4 ,
 119 .Xr arp 4 ,
 120 .Xr cardbus 4 ,
 121 .Xr netintro 4 ,
 122 .Xr pci 4 ,
 123 .Xr wlan 4 ,
 124 .Xr ifconfig 8
 125 .Sh HISTORY
 126 The
 127 .Nm
 128 device driver first appeared in
 129 .Fx 7.1 .