summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/rum.4 3.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man4/rum.4 3.html')
-rw-r--r--static/freebsd/man4/rum.4 3.html281
1 files changed, 281 insertions, 0 deletions
diff --git a/static/freebsd/man4/rum.4 3.html b/static/freebsd/man4/rum.4 3.html
new file mode 100644
index 00000000..f35c192b
--- /dev/null
+++ b/static/freebsd/man4/rum.4 3.html
@@ -0,0 +1,281 @@
+<table class="head">
+ <tr>
+ <td class="head-ltitle">RUM(4)</td>
+ <td class="head-vol">Device Drivers Manual</td>
+ <td class="head-rtitle">RUM(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">rum</code> &#x2014; <span class="Nd">Ralink
+ Technology USB IEEE 802.11a/b/g wireless network driver</span></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<p class="Pp">To compile this driver into the kernel, place the following lines
+ in your kernel configuration file:</p>
+<div class="Bd Pp Bd-indent"><code class="Cd">device ehci</code>
+<br/>
+<code class="Cd">device uhci</code>
+<br/>
+<code class="Cd">device ohci</code>
+<br/>
+<code class="Cd">device usb</code>
+<br/>
+<code class="Cd">device rum</code>
+<br/>
+<code class="Cd">device wlan</code>
+<br/>
+<code class="Cd">device wlan_amrr</code></div>
+<p class="Pp">Alternatively, to load the driver as a module at boot time, place
+ the following line in <a class="Xr">loader.conf(5)</a>:</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>if_rum_load=&quot;YES&quot;</pre>
+</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<p class="Pp">The <code class="Nm">rum</code> driver supports USB 2.0 and PCI
+ Express Mini Card wireless adapters based on the Ralink RT2501USB and
+ RT2601USB chipsets.</p>
+<p class="Pp">Ralink PCI Express Mini Card adapters show up as normal USB 2.0
+ devices and are thus handled by the <code class="Nm">rum</code> driver.</p>
+<p class="Pp">The RT2501USB chipset is the second generation of 802.11a/b/g
+ adapters from Ralink. It consists of two integrated chips, an RT2571W
+ MAC/BBP and an RT2528 or RT5226 radio transceiver.</p>
+<p class="Pp">The RT2601USB chipset consists of two integrated chips, an RT2671
+ MAC/BBP and an RT2527 or RT5225 radio transceiver. This chipset uses the
+ MIMO (multiple-input multiple-output) technology with multiple antennas to
+ extend the operating range of the adapter and to achieve higher
+ throughput.</p>
+<p class="Pp">All chips have hardware support for WEP, AES-CCM, TKIP, and
+ Michael cryptographic operations.</p>
+<p class="Pp"><code class="Nm">rum</code> supports
+ <code class="Cm">station</code>, <code class="Cm">adhoc</code>,
+ <code class="Cm">adhoc-demo</code>, <code class="Cm">hostap</code>, and
+ <code class="Cm">monitor</code> mode operation. Only one virtual interface
+ may be configured at any time. For more information on configuring this
+ device, see <a class="Xr">ifconfig(8)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
+<p class="Pp">The <code class="Nm">rum</code> driver supports USB 2.0 wireless
+ adapters based on the Ralink RT2501USB and RT2601USB chipsets,
+ including:</p>
+<p class="Pp"></p>
+<table class="Bl-column Bl-compact">
+ <tr id="Card">
+ <td><a class="permalink" href="#Card"><i class="Em">Card</i></a></td>
+ <td><a class="permalink" href="#Bus"><i class="Em" id="Bus">Bus</i></a></td>
+ </tr>
+ <tr>
+ <td>3Com Aolynk WUB320g</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Abocom WUG2700 Ta</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Airlink101 AWLL5025</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>ASUS WL-167g ver 2</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Belkin F5D7050 ver 3</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Belkin F5D9050 ver 3</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Buffalo WLI-U2-SG54HP</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Buffalo WLI-U2-SG54HG</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Buffalo WLI-U2-G54HP</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Buffalo WLI-UC-G</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>CNet CWD-854 ver F</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Conceptronic C54RU ver 2</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Corega CG-WLUSB2GO</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>D-Link DWA-110</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>D-Link DWA-111</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>D-Link DWL-G122 rev C1</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>D-Link WUA-1340</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Digitus DN-7003GR</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Edimax EW-7318USG</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Gigabyte GN-WB01GS</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Gigabyte GN-WI05GS</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Hawking HWUG1</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Hawking HWU54DM</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Hercules HWGUSB2-54-LB</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Hercules HWGUSB2-54V2-AP</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>LevelOne WNC-0301USB v3</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Linksys WUSB54G rev C</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Linksys WUSB54GR</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Planex GW-US54HP</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Planex GW-US54Mini2</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Planex GW-USMM</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Senao NUB-3701</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Sitecom WL-113 ver 2</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Sitecom WL-172</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>Sweex LW053</td>
+ <td>USB</td>
+ </tr>
+ <tr>
+ <td>TP-LINK TL-WN321G v1/v2/v3</td>
+ <td>USB</td>
+ </tr>
+</table>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
+<p class="Pp">Join an existing BSS network (i.e., connect to an access
+ point):</p>
+<p class="Pp"></p>
+<div class="Bd Bd-indent"><code class="Li">ifconfig wlan create wlandev rum0
+ inet 192.0.2.20/24</code></div>
+<p class="Pp">Join a specific BSS network with network name
+ <var class="Ar">my_net</var>:</p>
+<p class="Pp"></p>
+<div class="Bd Bd-indent"><code class="Li">ifconfig wlan create wlandev rum0
+ ssid my_net up</code></div>
+<p class="Pp">Join a specific BSS network with 64-bit WEP encryption:</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>ifconfig wlan create wlandev rum0 ssid my_net \
+ wepmode on wepkey 0x1234567890 weptxkey 1 up</pre>
+</div>
+<p class="Pp">Join a specific BSS network with 128-bit WEP encryption:</p>
+<div class="Bd Pp Bd-indent Li">
+<pre>ifconfig wlan create wlandev rum0 wlanmode adhoc ssid my_net \
+ wepmode on wepkey 0x01020304050607080910111213 weptxkey 1</pre>
+</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
+<dl class="Bl-diag">
+ <dt>rum%d: could not load 8051 microcode</dt>
+ <dd>An error occurred while attempting to upload the microcode to the onboard
+ 8051 microcontroller unit. The driver will reset the hardware. This should
+ not happen.</dd>
+</dl>
+</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">intro(4)</a>, <a class="Xr">netintro(4)</a>,
+ <a class="Xr">usb(4)</a>, <a class="Xr">wlan(4)</a>,
+ <a class="Xr">wlan_amrr(4)</a>, <a class="Xr">wlan_ccmp(4)</a>,
+ <a class="Xr">wlan_tkip(4)</a>, <a class="Xr">wlan_wep(4)</a>,
+ <a class="Xr">wlan_xauth(4)</a>, <a class="Xr">networking(7)</a>,
+ <a class="Xr">hostapd(8)</a>, <a class="Xr">ifconfig(8)</a>,
+ <a class="Xr">wpa_supplicant(8)</a></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<p class="Pp">The <code class="Nm">rum</code> driver first appeared in
+ <span class="Ux">OpenBSD 4.0</span> and <span class="Ux">FreeBSD
+ 7.0</span>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
+<p class="Pp">The original <code class="Nm">rum</code> driver was written by
+ <span class="An">Niall O'Higgins</span>
+ &lt;<a class="Mt" href="mailto:niallo@openbsd.org">niallo@openbsd.org</a>&gt;
+ and <span class="An">Damien Bergamini</span>
+ &lt;<a class="Mt" href="mailto:damien@openbsd.org">damien@openbsd.org</a>&gt;.</p>
+</section>
+</div>
+<table class="foot">
+ <tr>
+ <td class="foot-date">November 10, 2024</td>
+ <td class="foot-os">FreeBSD 15.0</td>
+ </tr>
+</table>