diff options
Diffstat (limited to 'static/freebsd/man4/linuxkpi_wlan.4 3.html')
| -rw-r--r-- | static/freebsd/man4/linuxkpi_wlan.4 3.html | 112 |
1 files changed, 112 insertions, 0 deletions
diff --git a/static/freebsd/man4/linuxkpi_wlan.4 3.html b/static/freebsd/man4/linuxkpi_wlan.4 3.html new file mode 100644 index 00000000..7650ae28 --- /dev/null +++ b/static/freebsd/man4/linuxkpi_wlan.4 3.html @@ -0,0 +1,112 @@ +<table class="head"> + <tr> + <td class="head-ltitle">LINUXKPI_WLAN(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">LINUXKPI_WLAN(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">linuxkpi_wlan</code> — + <span class="Nd">LinuxKPI 802.11 support</span></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">linuxkpi_wlan</code> kernel module provides + an 802.11 compat layer to translate between Linux 802.11 drivers and the + native net8011 wireless stack. It currently supports + <a class="permalink" href="#mac80211"><i class="Em" id="mac80211">mac80211</i></a> + based drivers. Parts of the + <a class="permalink" href="#cfg80211"><i class="Em" id="cfg80211">cfg80211</i></a> + exist but there is no code for net80211 to drive it.</p> +<p class="Pp" id="wlanmode"><code class="Nm">linuxkpi_wlan</code> currently + supports the following + <a class="permalink" href="#wlanmode"><i class="Em">wlanmode</i></a> + operating modes:</p> +<dl class="Bl-tag Bl-compact"> + <dt id="sta"><a class="permalink" href="#sta"><code class="Cm">sta</code></a></dt> + <dd>client station in an infrastructure bss (IBSS).</dd> +</dl> +<p class="Pp">Compat code for 802.11n (HT) and 802.11ac (VHT) is implemented but + support may vary for different drivers due to different KPI usage.</p> +<p class="Pp">Crypto support for hardware acceleration needs to be enabled using + the <var class="Va">compat.linuxkpi.80211.hw_crypto</var> tunable. The + following cipher suites are supported:</p> +<dl class="Bl-tag Bl-compact"> + <dt id="tkip"><a class="permalink" href="#tkip"><code class="Cm">tkip</code></a></dt> + <dd>Support for <a class="Xr">wlan_tkip(4)</a> has to be manually enabled + using the <var class="Va">compat.linuxkpi.80211.tkip</var> tunable.</dd> + <dt id="ccmp"><a class="permalink" href="#ccmp"><code class="Cm">ccmp</code></a></dt> + <dd>Support for <a class="Xr">wlan_ccmp(4)</a> is available.</dd> + <dt id="gcmp"><a class="permalink" href="#gcmp"><code class="Cm">gcmp</code></a></dt> + <dd>Support for <a class="Xr">wlan_gcmp(4)</a> is available.</dd> +</dl> +Further cipher suites will be implemented as soon as + <a class="Xr">net80211(4)</a> grows support. While it would be possible to + implement <a class="Xr">wlan_wep(4)</a> support, it was decided not to do so + given <a class="permalink" href="#Wired"><i class="Em" id="Wired">Wired + Equivalent Privacy (WEP)</i></a> has been deprecated since 2004. +<p class="Pp">The list of supported drivers includes + <a class="Xr">iwlwifi(4)</a>, <a class="Xr">rtw88(4)</a>, and + <a class="Xr">rtw89(4)</a>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SYSCTL_VARIABLES_AND_LOADER_TUNABLES"><a class="permalink" href="#SYSCTL_VARIABLES_AND_LOADER_TUNABLES">SYSCTL + VARIABLES AND LOADER TUNABLES</a></h1> +<p class="Pp">The <code class="Nm">linuxkpi_wlan</code> module supports the + following <a class="Xr">loader(8)</a> tunable and read-only + <a class="Xr">sysctl(8)</a> variables:</p> +<dl class="Bl-tag"> + <dt id="compat.linuxkpi.80211.hw_crypto"><var class="Va">compat.linuxkpi.80211.hw_crypto</var></dt> + <dd>Turn on hardware crypto offload support. Default + ‘<code class="Li">0</code>’.</dd> + <dt id="compat.linuxkpi.80211.tkip"><var class="Va">compat.linuxkpi.80211.tkip</var></dt> + <dd>Turn on support for <a class="Xr">wlan_tkip(4)</a> offloading. Default + ‘<code class="Li">0</code>’.</dd> +</dl> +<p class="Pp">The <code class="Nm">linuxkpi_wlan</code> module supports the + following <a class="Xr">sysctl(8)</a> variables:</p> +<dl class="Bl-tag"> + <dt id="compat.linuxkpi.80211.debug"><var class="Va">compat.linuxkpi.80211.debug</var></dt> + <dd>If the kernel is compiled with <code class="Dv">IEEE80211_DEBUG</code> or + <code class="Dv">LINUXKPI_DEBUG_80211</code> is manually enabled, the + sysctl is a bitmask to turn on individual debug messages. See + <span class="Pa">sys/compat/linuxkpi/common/src/linux_80211.h</span> for + details.</dd> + <dt id="compat.linuxkpi.80211.IF.dump_stas"><var class="Va">compat.linuxkpi.80211.IF.dump_stas</var></dt> + <dd>Print statistics for a given, associated <a class="Xr">wlan(4)</a> + interface; typically IF would be + <a class="permalink" href="#wlan0"><i class="Em" id="wlan0">wlan0</i></a>.</dd> + <dt id="compat.linuxkpi.80211.IF.dump_stas_queues"><var class="Va">compat.linuxkpi.80211.IF.dump_stas_queues</var></dt> + <dd>Like <var class="Va">compat.linuxkpi.80211.IF.dump_stas</var> but also + print queue statistics. This sysctl is ‘hidden’ and normally + only needed for debugging purposes.</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">iwlwifi(4)</a>, <a class="Xr">linuxkpi(4)</a>, + <a class="Xr">rtw88(4)</a>, <a class="Xr">rtw89(4)</a>, + <a class="Xr">wlan(4)</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">linuxkpi_wlan</code> module first appeared in + <span class="Ux">FreeBSD 13.1</span>. Support for IEEE 802.11n and 802.11ac + in <code class="Nm">linuxkpi_wlan</code> first appeared in + <span class="Ux">FreeBSD 14.3</span>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> +<p class="Pp">LinuxKPI 802.11 support was developed by <span class="An">Bjoern + A. Zeeb</span> under sponsorship from the FreeBSD Foundation.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">December 28, 2025</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |