git: a33f54518f - main - Website - Status: Add wifibox report

From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Thu, 28 Sep 2023 10:04:05 UTC
The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=a33f54518f68fd3fbfa12dbade470e0ba4cdd272

commit a33f54518f68fd3fbfa12dbade470e0ba4cdd272
Author:     PÁLI Gábor János <pgj@FreeBSD.org>
AuthorDate: 2023-09-28 10:03:11 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-09-28 10:03:11 +0000

    Website - Status: Add wifibox report
    
    Approved by:    salvadore@
    Pull Request:   https://github.com/freebsd/freebsd-doc/pull/263
---
 .../en/status/report-2023-07-2023-09/wifibox.adoc  | 29 ++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/website/content/en/status/report-2023-07-2023-09/wifibox.adoc b/website/content/en/status/report-2023-07-2023-09/wifibox.adoc
new file mode 100644
index 0000000000..019230d01f
--- /dev/null
+++ b/website/content/en/status/report-2023-07-2023-09/wifibox.adoc
@@ -0,0 +1,29 @@
+=== Wifibox: Use Linux to drive your wireless card on FreeBSD
+
+Links: +
+link:https://github.com/pgj/freebsd-wifibox[Project GitHub Page] +
+link:https://cgit.freebsd.org/ports/tree/net/wifibox[net/wifibox port]
+
+Contact: PÁLI Gábor János <pali.gabor@gmail.com>
+
+Wifibox is an experimental project for exploring the ways of deploying a virtualized Linux guest to drive wireless networking cards on the FreeBSD host system.
+There have been guides to describe how to set this up manually, and Wifibox aims to implement those ideas as a single easy-to-use software package.
+
+* It uses man:bhyve[8] to run the embedded Linux system.
+This helps to achieve low resource footprint.
+It requires an x64 CPU with I/O MMU (AMD-Vi, Intel VT-d), ~150 MB physical memory, and some disk space available for the guest virtual disk image, which can be even ~30 MB only in certain cases.
+It works with FreeBSD 12 and later, some cards may require FreeBSD 13 though.
+* The guest is constructed using link:https://alpinelinux.org/[Alpine Linux], a security-oriented, lightweight distribution based on link:https://www.musl-libc.org/[musl libc] and link:https://busybox.net/[BusyBox], with some custom extensions and patches imported from link:https://archlinux.org/[Arch Linux] most notably.
+It is shipped with a number of diagnostic tools for better management of the hardware in use.
+The recent version features Linux 6.1, but Linux 6.5 is also available as an alternative.
+* Configuration files are shared with the host system.
+The guest uses man:wpa_supplicant[8] or man:hostapd[8] (depending on the configuration) so it is possible to import the host's man:wpa_supplicant.conf[5] or man:hostapd.conf[5] file without any changes.
+* When configured, man:wpa_supplicant[8] and man:hostapd[8] control sockets could be exposed by the guest, which enables use of related utilities directly from the host, such as man:wpa_cli[8] or man:wpa_gui[8] from the package:net/wpa_supplicant_gui[] package, or man:hostapd_cli[8].
+* Everything is shipped in a single package that can be easily installed and removed.
+This comes with an man:rc[8] system service that automatically launches the guest on boot and stops it on shutdown.
+* It can be configured to forward IPv6 traffic, which is currently an experimental option but turned on by default.
+
+Wifibox has been mainly tested with Intel chipsets, and it has shown great performance and stability.
+Therefore it might serve as an interim solution until the Intel Wireless support becomes mature enough.
+It was confirmed that Wifibox works with Atheros, Realtek, and Mediatek chipsets too, and feedback is more than welcome about others.
+Broadcom chips (that are often found in MacBook Pros) can also work, but there are known stability issues.