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