summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/malo.4 4.html
blob: d638d29c399372283849881de6fd44b85dc373c9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
<table class="head">
  <tr>
    <td class="head-ltitle">MALO(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">MALO(4)</td>
  </tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">malo</code> &#x2014; <span class="Nd">Marvell
    Libertas IEEE 802.11b/g wireless network device</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">malo* at pci?</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">malo</code> driver provides support for
    Marvell Libertas 88W8335/88W8310/88W8385 based PCI network adapters. The
    second generation 88W8335/88W8310 chipsets support 802.11b/g.</p>
<p class="Pp">These are the modes the <code class="Nm">malo</code> driver can
    operate in:</p>
<dl class="Bl-tag">
  <dt id="infrastructure">BSS mode</dt>
  <dd>Also known as
      <a class="permalink" href="#infrastructure"><i class="Em">infrastructure</i></a>
      mode, this is used when associating with an access point, through which
      all traffic passes. This mode is the default.</dd>
  <dt>monitor mode</dt>
  <dd>In this mode the driver is able to receive packets without associating
      with an access point. This disables the internal receive filter and
      enables the card to capture packets from networks which it wouldn't
      normally have access to, or to scan for access points.</dd>
</dl>
<p class="Pp">The <code class="Nm">malo</code> driver can be configured to use
    Wired Equivalent Privacy (WEP) or Wi-Fi Protected Access (WPA-PSK and
    WPA2-PSK). WPA is the de facto encryption standard for wireless networks. It
    is strongly recommended that WEP not be used as the sole mechanism to secure
    wireless communication, due to serious weaknesses in it. The
    <code class="Nm">malo</code> driver relies on the software 802.11 stack for
    both encryption and decryption of data frames.</p>
<p class="Pp">The <code class="Nm">malo</code> driver can be configured at
    runtime with <a class="Xr">ifconfig(8)</a> or on boot with
    <a class="Xr">ifconfig.if(5)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<p class="Pp">The driver needs a set of firmware files which are loaded when an
    interface is brought up:</p>
<p class="Pp"></p>
<div class="Bd-indent">
<dl class="Bl-tag Bl-compact">
  <dt><span class="Pa">/libdata/firmware/malo/malo8335-h</span></dt>
  <dd style="width: auto;">&#x00A0;</dd>
  <dt><span class="Pa">/libdata/firmware/malo/malo8335-m</span></dt>
  <dd style="width: auto;">&#x00A0;</dd>
  <dt><span class="Pa">/libdata/firmware/malo/malo8338</span></dt>
  <dd style="width: auto;">&#x00A0;</dd>
  <dt><span class="Pa">/libdata/firmware/malo/malo8385-h</span></dt>
  <dd style="width: auto;">&#x00A0;</dd>
  <dt><span class="Pa">/libdata/firmware/malo/malo8385-m</span></dt>
  <dd style="width: auto;">&#x00A0;</dd>
</dl>
</div>
<p class="Pp">These firmware files are not free because Marvell refuses to grant
    distribution rights. As a result, even though
    <span class="Ux">OpenBSD</span> includes the driver, the firmware files
    cannot be included and users have to download these files on their own.</p>
<p class="Pp">A prepackaged version of the firmware, designed to be used with
    <a class="Xr">pkg_add(1)</a>, can be found at:</p>
<div class="Bd Pp Bd-indent Li">
<pre>http://www.nazgul.ch/malo/malo-firmware-1.4.tgz</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The following cards are among those supported by the
    <code class="Nm">malo</code> driver:</p>
<p class="Pp"></p>
<table class="Bl-column Bd-indent Bl-compact">
  <tr id="Card">
    <td><a class="permalink" href="#Card"><i class="Em">Card</i></a></td>
    <td><a class="permalink" href="#Chip"><i class="Em" id="Chip">Chip</i></a></td>
    <td><a class="permalink" href="#Bus"><i class="Em" id="Bus">Bus</i></a></td>
    <td><a class="permalink" href="#Standard"><i class="Em" id="Standard">Standard</i></a></td>
  </tr>
  <tr>
    <td>Netgear WG311v3</td>
    <td>88W8335</td>
    <td>PCI</td>
    <td>b/g</td>
  </tr>
  <tr>
    <td>Tenda TWL542P</td>
    <td>88W8335</td>
    <td>PCI</td>
    <td>b/g</td>
  </tr>
</table>
</section>
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">The following <a class="Xr">ifconfig.if(5)</a> example configures
    malo0 to join whatever network is available on boot, using WEP key
    &#x201C;0x1deadbeef1&#x201D;, channel 11, obtaining an IP address using
    DHCP:</p>
<div class="Bd Pp Bd-indent Li">
<pre>dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11</pre>
</div>
<p class="Pp">Join an existing BSS network, &#x201C;my_net&#x201D;:</p>
<div class="Bd Pp Bd-indent Li">
<pre># ifconfig malo0 192.168.1.1 netmask 0xffffff00 nwid my_net</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="NOTES"><a class="permalink" href="#NOTES">NOTES</a></h1>
<p class="Pp">Contrary to the driver on <span class="Ux">OpenBSD</span>, this
    driver currently does not work on PCMCIA/CARDBUS.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">arp(4)</a>, <a class="Xr">ifmedia(4)</a>,
    <a class="Xr">intro(4)</a>, <a class="Xr">netintro(4)</a>,
    <a class="Xr">pci(4)</a>, <a class="Xr">ifconfig.if(5)</a>,
    <a class="Xr">hostapd(8)</a>, <a class="Xr">ifconfig(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">malo</code> driver was first written by
    <span class="An">Claudio Jeker</span>
    &lt;<a class="Mt" href="mailto:claudio@openbsd.org">claudio@openbsd.org</a>&gt;
    and <span class="An">Marcus Glocker</span>
    &lt;<a class="Mt" href="mailto:mglocker@openbsd.org">mglocker@openbsd.org</a>&gt;
    and appeared first in <span class="Ux">OpenBSD 4.1</span>.
    <span class="Ux">NetBSD</span> porting was done by <span class="An">Arnaud
    Degroote</span>
    &lt;<a class="Mt" href="mailto:degroote@NetBSD.org">degroote@NetBSD.org</a>&gt;.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">July 30, 2012</td>
    <td class="foot-os">NetBSD 10.1</td>
  </tr>
</table>