From nobody Tue Mar 04 23:31:15 2025 X-Original-To: dev-commits-src-main@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 4Z6sPv69lMz5nwwL; Tue, 04 Mar 2025 23:31:15 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Z6sPv40r2z3NPk; Tue, 04 Mar 2025 23:31:15 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1741131075; 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=JNnR4qHXCV0WVs9+PE8wD8g+CFsX7LuzjkzFiNo/2Co=; b=P+5hFC2lfDixYiQGnXW4BYxB6rt/HzGtly2Fa0E4TS4VoKq7PM+lvQxwwAqWXeaKQs8ifL h68xhZUFIjI48c0gnxH5xVinro4dCyi229KOH1TKGwxgd34K37s2wyjvZsyp/jkmfidH9+ +ylPi1KQn02cEEHs7iFazlMPepe9TbW7u59Kz4Hiw6KmREUfwrsxHFCj7CKq3O7A/U7VAC eEBFNlKhcELxr8CfubdI3T253i2wvcP77/D6kt5o5H5oxYZzZkyXjwfE3PaK7yyKXmkNxO /ZEOv7aTjZs4UE7GlRVI54GIq0jl3JJZweMvehwEkPXNXiJ8XQh0i0P3RQOFhA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1741131075; a=rsa-sha256; cv=none; b=Ulf5KMNtJ0c+RzAwuHoejKnYPa21SPVRpBD0EPGb9r9fn4iLq126FBmI5KO7edbbgqtb5B ETwuCnzL0SKUmUeyfCwZMOZGsNFAR85ge/EV0oFfbnslT3JjHVaNNrqfj67E+5yl9DncUL t9H7S28zsVTF7B6MdnI8BvMNCGPzh5ZLgbUyMkFLEfTHWg1RIIFfLcb4XaPiKqGtXZDDre ix5QlWL4iSNj91oQwEgVoa5t3svjsm5r3zStC8uPHt7ryf38EV61Zhw65KVcBVS6ZK+B7a rJ7E31+NWcExLyZY9rhqyf/Xbtax2Nv57N4CNdSWffV/FIvL4L7ZUeYLMUXvaw== 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=1741131075; 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=JNnR4qHXCV0WVs9+PE8wD8g+CFsX7LuzjkzFiNo/2Co=; b=K/OC5dPmdiGBTcmBqFv6hD4+v4Dw3MK1oSywGtJAdGzata+QET+KcLzJwXA2Fo5P1MQ1g+ bHV6W+I/lJwt21ka9IzWGwtp5HU9ZOz+1o4EQpUHZKZh76nQ19SBSlimyttZI5XjExyQhd fJrmLtfn2IPeVHbWyr/2XSTjpHmyvGuamvoF/kxxRrpzx9er6TC7pdhd4MH4Q7ObGmq1UP LGXepnU5uQe1pxiU9aoSTZE+pP3hbtEewcY4K3xDplheYRFDx0YftzblxM4wwFNjH2VXuw yztG9a6auqebEdldlB0Kha12LsKdmsFgXZtH0JXN5T/pnPZtAfRmKLliHL7MeA== 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 4Z6sPv3J2VzgBR; Tue, 04 Mar 2025 23:31:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 524NVFqM022416; Tue, 4 Mar 2025 23:31:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 524NVF1W022413; Tue, 4 Mar 2025 23:31:15 GMT (envelope-from git) Date: Tue, 4 Mar 2025 23:31:15 GMT Message-Id: <202503042331.524NVF1W022413@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: "Bjoern A. Zeeb" Subject: git: eaf3ac81cf12 - main - wlanstats: add man page List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bz X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: eaf3ac81cf12bbaecb1d6bce3a8bcdef5b9c0ffc Auto-Submitted: auto-generated The branch main has been updated by bz: URL: https://cgit.FreeBSD.org/src/commit/?id=eaf3ac81cf12bbaecb1d6bce3a8bcdef5b9c0ffc commit eaf3ac81cf12bbaecb1d6bce3a8bcdef5b9c0ffc Author: Bjoern A. Zeeb AuthorDate: 2025-02-28 23:45:44 +0000 Commit: Bjoern A. Zeeb CommitDate: 2025-03-04 23:30:12 +0000 wlanstats: add man page After two decades in tools add a basic man page to wlanstats now that it is in usr.sbin. Most users will likely ever only run it without arguments. Sponsored by: The FreeBSD Foundation MFC after: 3 days X-MFC with: 61ce422531805 Reviewed by: adrian, ziaee Differential Revision: https://reviews.freebsd.org/D49186 --- usr.sbin/wlanstats/Makefile | 2 +- usr.sbin/wlanstats/wlanstats.8 | 67 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+), 1 deletion(-) diff --git a/usr.sbin/wlanstats/Makefile b/usr.sbin/wlanstats/Makefile index 60c56d24700b..574a9c27137f 100644 --- a/usr.sbin/wlanstats/Makefile +++ b/usr.sbin/wlanstats/Makefile @@ -1,7 +1,7 @@ .include PROG= wlanstats -MAN= +MAN= wlanstats.8 CFLAGS= -I${SRCTOP}/lib/libbsdstat LIBADD= bsdstat diff --git a/usr.sbin/wlanstats/wlanstats.8 b/usr.sbin/wlanstats/wlanstats.8 new file mode 100644 index 000000000000..e032835bac43 --- /dev/null +++ b/usr.sbin/wlanstats/wlanstats.8 @@ -0,0 +1,67 @@ +.\" +.\" Copyright (c) 2025 The FreeBSD Foundation +.\" +.\" This documentation was written by Björn Zeeb under sponsorship from +.\" the FreeBSD Foundation. +.\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" +.Dd February 20, 2025 +.Dt WLANSTATS 8 +.Os +.Sh NAME +.Nm wlanstats +.Nd query 802.11 wireless network statistics +.Sh SYNOPSIS +.Nm +.\" .Op Fl a +.Op Fl h +.Op Fl i Ar ifnet +.Op Fl l +.Op Fl m Ar station MAC address +.Op Fl o Ar fmt +.Op interval +.Sh DESCRIPTION +The +.Nm +command is a tool to query 802.11 statistics for +.Xr wlan 4 +interface. +Running +.Nm +without any options will display the current statistics +for the +.Em wlan0 +network interface. +.Pp +The following options are available: +.Bl -tag -width indent +.It Fl h +Print usage and exit. +.It Fl i Ar ifnet +Report information for the specified +.Ar ifnet +instead of the default +.Em wlan0 . +.It Fl l +List all fields names and their descriptions. +.It Fl m Ar station MAC address +Request information for the station specified by the given +.Ar MAC address. +.It Fl o Ar fmt +Set format of fields to query. +This can be either on of the pre-defined tags: +.Em default , +.Em ampdu , or +.Em amsdu +or a comma separated list of field names without space. +.El +.Pp +.Sh SEE ALSO +.Xr ifconfig 8 , +.Xr wlandebug 8 +.Pp +The +.Pa /usr/src/tools/tools/net80211 +directory contains more utilities that might be relevant to debug wireless +issues.