xref: /freebsd/share/man/man4/malo.4 (revision 2e3f49888ec8851bafb22011533217487764fdb0)
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.Dd June 24, 2015
33.Dt MALO 4
34.Os
35.Sh NAME
36.Nm malo
37.Nd "Marvell Libertas IEEE 802.11b/g wireless network driver"
38.Sh SYNOPSIS
39To compile this driver into the kernel,
40place the following lines in your
41kernel configuration file:
42.Bd -ragged -offset indent
43.Cd "device malo"
44.Cd "device pci"
45.Cd "device wlan"
46.Cd "device firmware"
47.Ed
48.Pp
49Alternatively, to load the driver as a
50module at boot time, place the following line in
51.Xr loader.conf 5 :
52.Bd -literal -offset indent
53if_malo_load="YES"
54.Ed
55.Sh DESCRIPTION
56The
57.Nm
58driver provides support for Marvell Libertas 88W8335 based PCI
59and Cardbus network adapters.
60.Nm
61supports
62.Cm station
63and
64.Cm monitor
65mode operation.
66Only one virtual interface may be configured at any time.
67For more information on configuring this device, see
68.Xr ifconfig 8 .
69.Pp
70This driver requires firmware to be loaded before it will work.
71The
72.Pa ports/net/malo-firmware-kmod
73port needs to be installed before
74.Xr ifconfig 8
75will work.
76.Sh HARDWARE
77The following cards are among those supported by the
78.Nm
79driver:
80.Bl -column "Netgear WG311v3" "88W8335" "PCI" "b/g"
81.Em "Card" Ta Em "Chip" Ta Em "Bus" Ta Em "Standard"
82.It "Netgear WG311v3" Ta "88W8335" Ta "PCI" Ta "b/g"
83.It "Tenda TWL542P" Ta "88W8335" Ta "PCI" Ta "b/g"
84.It "U-Khan UW-2054i" Ta "88W8335" Ta "PCI" Ta "b/g"
85.El
86.Sh EXAMPLES
87Join an existing BSS network (i.e., connect to an access point):
88.Bd -literal -offset indent
89ifconfig wlan create wlandev malo0 inet 192.168.0.20 \e
90    netmask 0xffffff00
91.Ed
92.Pp
93Join a specific BSS network with network name
94.Dq Li my_net :
95.Pp
96.Dl "ifconfig wlan create wlandev malo0 ssid my_net up"
97.Pp
98Join a specific BSS network with 64-bit WEP encryption:
99.Bd -literal -offset indent
100ifconfig wlan create wlandev malo0 ssid my_net \e
101	wepmode on wepkey 0x1234567890 weptxkey 1 up
102.Ed
103.Sh SEE ALSO
104.Xr cardbus 4 ,
105.Xr pci 4 ,
106.Xr wlan 4 ,
107.Xr wlan_ccmp 4 ,
108.Xr wlan_tkip 4 ,
109.Xr wlan_wep 4 ,
110.Xr ifconfig 8 ,
111.Xr wpa_supplicant 8
112.Sh HISTORY
113The
114.Nm
115device driver first appeared in
116.Fx 7.1 .
117