xref: /freebsd/share/man/man4/malo.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
13c7e78d3SWeongyo Jeong.\"-
262486687SUlrich Spörlein.\" Copyright (c) 2008 Weongyo Jeong <weongyo@FreeBSD.org>
33c7e78d3SWeongyo Jeong.\" All rights reserved.
43c7e78d3SWeongyo Jeong.\""
53c7e78d3SWeongyo Jeong.\" Redistribution and use in source and binary forms, with or without
63c7e78d3SWeongyo Jeong.\" modification, are permitted provided that the following conditions
73c7e78d3SWeongyo Jeong.\" are met:
83c7e78d3SWeongyo Jeong.\" 1. Redistributions of source code must retain the above copyright
93c7e78d3SWeongyo Jeong.\"    notice, this list of conditions and the following disclaimer,
103c7e78d3SWeongyo Jeong.\"    without modification.
113c7e78d3SWeongyo Jeong.\" 2. Redistributions in binary form must reproduce at minimum a disclaimer
123c7e78d3SWeongyo Jeong.\"    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
133c7e78d3SWeongyo Jeong.\"    redistribution must be conditioned upon including a substantially
143c7e78d3SWeongyo Jeong.\"    similar Disclaimer requirement for further binary redistribution.
153c7e78d3SWeongyo Jeong.\" 3. Neither the names of the above-listed copyright holders nor the names
163c7e78d3SWeongyo Jeong.\"    of any contributors may be used to endorse or promote products derived
173c7e78d3SWeongyo Jeong.\"    from this software without specific prior written permission.
183c7e78d3SWeongyo Jeong.\"
193c7e78d3SWeongyo Jeong.\" NO WARRANTY
203c7e78d3SWeongyo Jeong.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
213c7e78d3SWeongyo Jeong.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
223c7e78d3SWeongyo Jeong.\" LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
233c7e78d3SWeongyo Jeong.\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
243c7e78d3SWeongyo Jeong.\" THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
253c7e78d3SWeongyo Jeong.\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
263c7e78d3SWeongyo Jeong.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
273c7e78d3SWeongyo Jeong.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
283c7e78d3SWeongyo Jeong.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
293c7e78d3SWeongyo Jeong.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
303c7e78d3SWeongyo Jeong.\" THE POSSIBILITY OF SUCH DAMAGES.
313c7e78d3SWeongyo Jeong.\"/
32*2907b9f4SKevin Lo.Dd June 24, 2015
333c7e78d3SWeongyo Jeong.Dt MALO 4
343c7e78d3SWeongyo Jeong.Os
353c7e78d3SWeongyo Jeong.Sh NAME
363c7e78d3SWeongyo Jeong.Nm malo
379c8408a4SChristian Brueffer.Nd "Marvell Libertas IEEE 802.11b/g wireless network driver"
383c7e78d3SWeongyo Jeong.Sh SYNOPSIS
393c7e78d3SWeongyo JeongTo compile this driver into the kernel,
403c7e78d3SWeongyo Jeongplace the following lines in your
413c7e78d3SWeongyo Jeongkernel configuration file:
423c7e78d3SWeongyo Jeong.Bd -ragged -offset indent
433c7e78d3SWeongyo Jeong.Cd "device malo"
443c7e78d3SWeongyo Jeong.Cd "device pci"
453c7e78d3SWeongyo Jeong.Cd "device wlan"
463c7e78d3SWeongyo Jeong.Cd "device firmware"
473c7e78d3SWeongyo Jeong.Ed
483c7e78d3SWeongyo Jeong.Pp
493c7e78d3SWeongyo JeongAlternatively, to load the driver as a
50c1bf690eSGavin Atkinsonmodule at boot time, place the following line in
513c7e78d3SWeongyo Jeong.Xr loader.conf 5 :
523c7e78d3SWeongyo Jeong.Bd -literal -offset indent
533c7e78d3SWeongyo Jeongif_malo_load="YES"
543c7e78d3SWeongyo Jeong.Ed
553c7e78d3SWeongyo Jeong.Sh DESCRIPTION
563c7e78d3SWeongyo JeongThe
573c7e78d3SWeongyo Jeong.Nm
583c7e78d3SWeongyo Jeongdriver provides support for Marvell Libertas 88W8335 based PCI
59b032f27cSSam Lefflerand Cardbus network adapters.
603c7e78d3SWeongyo Jeong.Nm
61b032f27cSSam Lefflersupports
6255f2aa74SWeongyo Jeong.Cm station
63b032f27cSSam Lefflerand
64b032f27cSSam Leffler.Cm monitor
65b032f27cSSam Lefflermode operation.
66b032f27cSSam LefflerOnly one virtual interface may be configured at any time.
67b032f27cSSam LefflerFor more information on configuring this device, see
68b032f27cSSam Leffler.Xr ifconfig 8 .
693c7e78d3SWeongyo Jeong.Pp
70*2907b9f4SKevin LoThis driver requires firmware to be loaded before it will work.
71*2907b9f4SKevin LoThe
72*2907b9f4SKevin Lo.Pa ports/net/malo-firmware-kmod
73*2907b9f4SKevin Loport needs to be installed before
74*2907b9f4SKevin Lo.Xr ifconfig 8
75*2907b9f4SKevin Lowill work.
763c7e78d3SWeongyo Jeong.Sh HARDWARE
773c7e78d3SWeongyo JeongThe following cards are among those supported by the
783c7e78d3SWeongyo Jeong.Nm
793c7e78d3SWeongyo Jeongdriver:
80748611c9SJoel Dahl.Bl -column "Netgear WG311v3" "88W8335" "PCI" "b/g"
81748611c9SJoel Dahl.Em "Card" Ta Em "Chip" Ta Em "Bus" Ta Em "Standard"
82748611c9SJoel Dahl.It "Netgear WG311v3" Ta "88W8335" Ta "PCI" Ta "b/g"
83748611c9SJoel Dahl.It "Tenda TWL542P" Ta "88W8335" Ta "PCI" Ta "b/g"
84748611c9SJoel Dahl.It "U-Khan UW-2054i" Ta "88W8335" Ta "PCI" Ta "b/g"
853c7e78d3SWeongyo Jeong.El
863c7e78d3SWeongyo Jeong.Sh EXAMPLES
879c8408a4SChristian BruefferJoin an existing BSS network (i.e., connect to an access point):
88b032f27cSSam Leffler.Bd -literal -offset indent
8955f2aa74SWeongyo Jeongifconfig wlan create wlandev malo0 inet 192.168.0.20 \e
90b032f27cSSam Leffler    netmask 0xffffff00
91b032f27cSSam Leffler.Ed
923c7e78d3SWeongyo Jeong.Pp
933c7e78d3SWeongyo JeongJoin a specific BSS network with network name
943c7e78d3SWeongyo Jeong.Dq Li my_net :
953c7e78d3SWeongyo Jeong.Pp
9655f2aa74SWeongyo Jeong.Dl "ifconfig wlan create wlandev malo0 ssid my_net up"
973c7e78d3SWeongyo Jeong.Pp
98b032f27cSSam LefflerJoin a specific BSS network with 64-bit WEP encryption:
993c7e78d3SWeongyo Jeong.Bd -literal -offset indent
10055f2aa74SWeongyo Jeongifconfig wlan create wlandev malo0 ssid my_net \e
101b032f27cSSam Leffler	wepmode on wepkey 0x1234567890 weptxkey 1 up
102b032f27cSSam Leffler.Ed
1033c7e78d3SWeongyo Jeong.Sh SEE ALSO
104fc68e8cbSChristian Brueffer.Xr cardbus 4 ,
1053c7e78d3SWeongyo Jeong.Xr pci 4 ,
1063c7e78d3SWeongyo Jeong.Xr wlan 4 ,
107b032f27cSSam Leffler.Xr wlan_ccmp 4 ,
108b032f27cSSam Leffler.Xr wlan_tkip 4 ,
109b032f27cSSam Leffler.Xr wlan_wep 4 ,
110b032f27cSSam Leffler.Xr ifconfig 8 ,
111fc68e8cbSChristian Brueffer.Xr wpa_supplicant 8
1123c7e78d3SWeongyo Jeong.Sh HISTORY
1133c7e78d3SWeongyo JeongThe
1143c7e78d3SWeongyo Jeong.Nm
1153c7e78d3SWeongyo Jeongdevice driver first appeared in
116e575f1bfSWeongyo Jeong.Fx 7.1 .
117