From nobody Thu Sep 28 10:04:05 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Rx8Fy08trz4vpH2 for ; Thu, 28 Sep 2023 10:04:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Rx8Fx6ls4z4bpr; Thu, 28 Sep 2023 10:04:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1695895445; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=2PcDImLJO6KXcKJVQhsO3hrzBN3kFzviEn04XkSdNV8=; b=UmjjCnfRggpRW1ydBqdEbvovOJBr33lusp9gyT2kpjhRoXU+9FmHyifHT5ReZiv7PksdOV +EoeVeXOXrx/quYKXkdxFsMbeWhjtlavL46P2VCG0iMNvre3ty4fWN1NYMZoKWOckb5ElW VGlpD6TVIGO6Q2+1x65wa1vGXXQm61COG1SW+lVlC2khD4hCiN6j1DMifHg4ulpNEcX9VM guE7M8RKDeHKucFe3PJYdOSDzHvQEcTaEhJDYKU2TwNe9BTgi6flT0tzxERDbJcTXntSHm 0dNXbRRs1NG0X5VRU2/iEglINLH4NCZfhZqu8FaL82UsoqXw07PTfkfyCCCnbw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1695895445; a=rsa-sha256; cv=none; b=VsOACTBU8UvHJFAmwQMa0C/Say8PNk7/O/+zYSfKzfe2f4FAvukqFfQltLvbK6dcMNPdx8 pvK7Pb0RFi2mCt+pnfpZ5b529479FxNzMZoTe5+eZNG9ai0vV+bOpIN2qyOlaLfWhHOq3K S5Yexm62GND5OmqkiiTI5d1Okbev6iujMPAdsywds04BHBtr+SdUK/UUVjckYX5wBgBkkM TEmONBuV3LxMSQGEvfQqggjI+GZvVgjM+uLpMZNL/chtcApSpPD8cmlVVDV3FF3C7kH9wf 36qln63B2hxcoTuJzIYMBmwlr08NH9ebJ7hEfFvYXWx7bmuyImZA/t5AKk1N2w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1695895445; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=2PcDImLJO6KXcKJVQhsO3hrzBN3kFzviEn04XkSdNV8=; b=uNWMuemvJesahEFEaSMxSW0yu/YV90l+3WVsT2C6Q4wQH74RHiP4Sw+DXOYkr9O/RNNGRv Z3MpBFAoa3aQ6tDRxux0Y2QsPOllgMp9wTUHhl07LCHkHAOeianA5hdZzEPZOdbJkXMHFx hYwf4aAPZGsrLxYe0QeWYv298auKifT4D/Bj1siqgGUPsTnrXuwjH/+eIZ8FwVDm5mKxN7 P9jJTtzzx0xuuEYBe7LmIDUvZfU4b30MM2IW+XUw8PvsjDnzzak1TsGul6nNquUtyn+4e0 psupR99xZrqR4XGkjzFOYWHYw0csZ0VI0YgdiCBn2IyOforQ7S61Kf+4sWYndQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Rx8Fx5qPqz3Bp; Thu, 28 Sep 2023 10:04:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 38SA45pK039386; Thu, 28 Sep 2023 10:04:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 38SA45l0039383; Thu, 28 Sep 2023 10:04:05 GMT (envelope-from git) Date: Thu, 28 Sep 2023 10:04:05 GMT Message-Id: <202309281004.38SA45l0039383@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: a33f54518f - main - Website - Status: Add wifibox report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a33f54518f68fd3fbfa12dbade470e0ba4cdd272 Auto-Submitted: auto-generated 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 AuthorDate: 2023-09-28 10:03:11 +0000 Commit: Sergio Carlavilla Delgado 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 + +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.