diff --git a/share/man/man4/mtw.4 b/share/man/man4/mtw.4 --- a/share/man/man4/mtw.4 +++ b/share/man/man4/mtw.4 @@ -24,23 +24,42 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd Feb 03, 2025 +.Dd May 3, 2025 .Dt MTW 4 .Os .Sh NAME .Nm if_mtw -.Nd "Mediatek MT7601U" +.Nd Mediatek MT7601U wireless network driver +.Sh SYNOPSIS +The driver will auto-load without any user interaction using +.Xr devmatch 8 +if enabled in +.Xr rc.conf 5 . +.Pp +Only if auto-loading is explicitly disabled, place the following +lines in +.Xr rc.conf 5 +to manually load the driver as a module at boot time: +.Bd -literal -offset indent +kld_list="${kld_list} if_mtw" .Ed +.Pp +It is discouraged to load the driver from +.Xr loader 8 . .Sh DESCRIPTION -This module provides support for Mediatek MT7601U with the firmware from net/wifi-firmware-mtw-kmod - +The +.Nm +driver provides support for USB wireless network devices based on +the Mediatek MT7601U chipset. +The driver requires vendor firmware, which is provided by the +net/wifi-firmware-mtw-kmod port. .Sh HARDWARE The .Nm -driver supports Mediatek MT7601U -based USB wireless network adapters including (but not all of them tested): +driver supports USB wireless network adapters based on the Mediatek +MT7601U including (but not all of them tested): .Pp -.Bl -column -compact +.Bl -bullet -compact .It ASUS USB-N10 v2 .It @@ -63,12 +82,15 @@ .Sh BUGS The .Nm -only works in station mode and monitor mode. The firmware does not always reinitialize when reloading the module, or when rebooting, without first unplugging the device. -.Sh History -The mtw driver first appeared in OpenBSD 7.1. The mtw driver was ported to FreeBSD in FreeBSD 15.0. +driver only works in station mode and monitor mode. +The firmware does not always reinitialize when reloading the module, or +when rebooting, without first unplugging the device. +.Sh HISTORY +The mtw driver first appeared in OpenBSD 7.1. +It was ported to FreeBSD in FreeBSD 15.0. .Sh AUTHORS .An -nosplit The mtw driver was written by .An James Hastings Aq Mt hastings@openbsd.org -ported to FreeBSD by -.An Jesper Schmitz Mouridsen Aq Mt jsm@FreeBSD.org +and was ported to FreeBSD by +.An Jesper Schmitz Mouridsen Aq Mt jsm@FreeBSD.org .