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 June 24, 2015
  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 line 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 firmware to be loaded before it will work.
  73 The
  74 .Pa ports/net/malo-firmware-kmod
  75 port needs to be installed before
  76 .Xr ifconfig 8
  77 will work.
  78 .Sh HARDWARE
  79 The following cards are among those supported by the
  80 .Nm
  81 driver:
  82 .Bl -column "Netgear WG311v3" "88W8335" "PCI" "b/g"
  83 .Em "Card" Ta Em "Chip" Ta Em "Bus" Ta Em "Standard"
  84 .It "Netgear WG311v3" Ta "88W8335" Ta "PCI" Ta "b/g"
  85 .It "Tenda TWL542P" Ta "88W8335" Ta "PCI" Ta "b/g"
  86 .It "U-Khan UW-2054i" Ta "88W8335" Ta "PCI" Ta "b/g"
  87 .El
  88 .Sh EXAMPLES
  89 Join an existing BSS network (i.e., connect to an access point):
  90 .Bd -literal -offset indent
  91 ifconfig wlan create wlandev malo0 inet 192.168.0.20 \e
  92     netmask 0xffffff00
  93 .Ed
  94 .Pp
  95 Join a specific BSS network with network name
  96 .Dq Li my_net :
  97 .Pp
  98 .Dl "ifconfig wlan create wlandev malo0 ssid my_net up"
  99 .Pp
 100 Join a specific BSS network with 64-bit WEP encryption:
 101 .Bd -literal -offset indent
 102 ifconfig wlan create wlandev malo0 ssid my_net \e
 103         wepmode on wepkey 0x1234567890 weptxkey 1 up
 104 .Ed
 105 .Sh SEE ALSO
 106 .Xr cardbus 4 ,
 107 .Xr pci 4 ,
 108 .Xr wlan 4 ,
 109 .Xr wlan_ccmp 4 ,
 110 .Xr wlan_tkip 4 ,
 111 .Xr wlan_wep 4 ,
 112 .Xr ifconfig 8 ,
 113 .Xr wpa_supplicant 8
 114 .Sh HISTORY
 115 The
 116 .Nm
 117 device driver first appeared in
 118 .Fx 7.1 .