From nobody Tue Apr 12 14:36:20 2022 X-Original-To: dev-commits-src-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 E80C61A8C6FA; Tue, 12 Apr 2022 14:36:20 +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 4Kd7ZX4ynBz3QHD; Tue, 12 Apr 2022 14:36:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649774180; 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=vNJDHuVJApaIjkq1FoZoeWo9RKrFQjJXgR7gKQJzzaY=; b=FA//1hDZeXwwpXgkiWZLBXxdp9p+uJqBxItA8V0LILblK6Yv91TsZvIHwjATSblVE05JaR xfeKVVEAz+htvVLSxPxDfB2d6O86DMTYl4oyWip+07VzVD1k7WygCRL+hLl4vHWpP2WoDo TIPfJsgeVKYGPY88Rhbi2TyJ+1jmTpEvIdKJMAapfVVdbmMd3U38pwsZQlDhMBmoseM/RT /zZh1Pej7pfP+eytfDRQlHvUdK3SWnbTg3vfIloHpjs7rKae6hixtNErmyk11hgaDmc7Fd lOSmUj1CUG6DEeYhkFgdJaUO3TaWqJ7HVsjVehd+c/Z7C+PZnCSnGyUJByst4Q== 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 6A8F718D68; Tue, 12 Apr 2022 14:36:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 23CEaK7F038913; Tue, 12 Apr 2022 14:36:20 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 23CEaKXH038912; Tue, 12 Apr 2022 14:36:20 GMT (envelope-from git) Date: Tue, 12 Apr 2022 14:36:20 GMT Message-Id: <202204121436.23CEaKXH038912@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 1bd6c85cf125 - stable/12 - ifconfig.8: Add capability codes descriptions from handbook List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/stable/12 X-Git-Reftype: branch X-Git-Commit: 1bd6c85cf125bf9256ec4fab77dcf8c42badbda8 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649774180; 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=vNJDHuVJApaIjkq1FoZoeWo9RKrFQjJXgR7gKQJzzaY=; b=teh0HyuHliaN5/FQ4tGGpa4k8CiKNn6f1UEG1Kynq1BBeTYKdK214SOtOksPNnkaX5bWDY HUVuF2fjB3QuN7kA+C5iKHzS+8aITKuJkzUeFzVnoiay4BLRKZJzQqibbe09Y7KQBWNVYN AiqpJp/RBpH4aVXE+DhBlOY2RjeSyTI6kiCj4vKGvV/Q7l7NEmdnVSdKuPytqph8zGujud ZDiXZZM2VwITjMzah0MFPzH/UrW+bH39SPOQ0kQk5EFSe09s4cEKgEOOqR8HfENANu7vOo ezxPOPvkwW2PiqEwT2qiVHR/jI+fRydcFqd+rxzzaJ2Ou/80b6RQ8NFoLE/b8g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649774180; a=rsa-sha256; cv=none; b=KqiPc4p2f40cR6cwNA8gZpkTyZL/HMbK3jVOb+8lEYryWf2tvfezAx2sVeX1ZQm/uybO5P YQ7r53GBuia4vaYNR1CMIQh+C1SyQlAVkIY6EqM41pmrOEJkMRu6/dzG/NYOw46oM25mkD K3dA2m0zBoXI6NEY+yB6RAMRD+SFSdGqUwf1FIhowBziBNd29HsjafN8EyrWpe0VPNsb4W 7BZwBqy9ntE4qzPFsuaIxMYL9pf+F+NufAJDTIbMAb7+vO+7N/1Lwg10Yg8NLNhIH+mLwy 34kqOQOgjZz4rH+MsPcoqtiNZCQncRd5KoQsedw4MrYcWEWP/f9Yj9Q3RsCYkQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=1bd6c85cf125bf9256ec4fab77dcf8c42badbda8 commit 1bd6c85cf125bf9256ec4fab77dcf8c42badbda8 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-29 11:11:46 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-04-12 14:36:13 +0000 ifconfig.8: Add capability codes descriptions from handbook We document capability codes (the CAPS field of "ifconfig wlan0 scan") in both ifconfig(8) and the handbook. The list is more complete in the manual page, while the descriptions of individual capabilities are more detailed in the handbook. In order to reduce content duplication and bit rot, let's move handbook's details to the manual page and reference the manual page whenever necessary. Reviewed by: debdrup Reviewed by: Pau Amma MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D34662 (cherry picked from commit 05621e0b2094d566aa39b82d01b4a6902a1b22b7) --- sbin/ifconfig/ifconfig.8 | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 3d70be7acde1..41b043db6e21 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -28,7 +28,7 @@ .\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 .\" $FreeBSD$ .\" -.Dd April 29, 2021 +.Dd March 29, 2022 .Dt IFCONFIG 8 .Os .Sh NAME @@ -1475,7 +1475,7 @@ with a .Cm scan request or through background scanning. Depending on the capabilities of the stations the following -flags can be included in the output: +flags (capability codes) can be included in the output: .Bl -tag -width 3n .It Li A Channel agility. @@ -1487,21 +1487,33 @@ Poll request capability. DSSS/OFDM capability. .It Li E Extended Service Set (ESS). +Indicates that the station is part of an infrastructure network +rather than an IBSS/ad-hoc network. .It Li I Independent Basic Service Set (IBSS). +Indicates that the station is part of an ad-hoc network +rather than an ESS network. .It Li P Privacy capability. -The station requires authentication. +The station requires authentication and encryption +for all data frames exchanged within the BSS using cryptographic means +such as WEP, TKIP, or AES-CCMP. .It Li R Robust Secure Network (RSN). .It Li S Short Preamble. -Indicates that the station is doing short preamble to optionally +Indicates that the network is using short preambles, +defined in 802.11b High Rate/DSSS PHY, +and utilizes a 56 bit sync field +rather than the 128 bit field used in long preamble mode. +Short preambles are used to optionally improve throughput performance with 802.11g and 802.11b. .It Li c Pollable capability. .It Li s Short slot time capability. +Indicates that the 802.11g network is using a short slot time +because there are no legacy (802.11b) stations present. .El .Pp By default interesting information elements captured from the neighboring