From nobody Tue Mar 29 11:12:57 2022 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 780F41A3528F; Tue, 29 Mar 2022 11:12:58 +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 4KSRkL1V8Kz4XRf; Tue, 29 Mar 2022 11:12:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648552378; 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=LJdgdXTckXXsx2b38so3IZBO6FVKx8h8WYCqY8Lg1Pk=; b=ZGlXDsvRiqT/tziH/QfhU7Rrzz5XNSAfqsrrKk3DZIPxqJ/DAwf/Tb9nZPVVVp/iaF5ZTl ae5RoklWTGIi+mEVSdeLMlgwwyONOz2BE+NksZBDQJ6sccHpM/L7p+CF9SCm1ae3921t1/ /zJmf6zSmJV2cO7pgZ0yeiiebo79SQlUxi+y86S/NOj7ahSM0ZlMI/b2sEMO5K5BnYccAl RYMfGfviuQkOtBYMzorG9reQzs/htGHpRHSKsis9kOvMMUSi0MzX1yoroplHytxqOqu9oW LQPoI8si7g3V2U0zGtTnrPDC1KDJR31SyK/ZlZWNEyr4E8nvhKCvCFlIGtOpLA== 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 96D3E1D4F8; Tue, 29 Mar 2022 11:12:57 +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 22TBCv9b092165; Tue, 29 Mar 2022 11:12:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22TBCvcJ092164; Tue, 29 Mar 2022 11:12:57 GMT (envelope-from git) Date: Tue, 29 Mar 2022 11:12:57 GMT Message-Id: <202203291112.22TBCvcJ092164@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 05621e0b2094 - main - ifconfig.8: Add capability codes descriptions from handbook 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: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@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/main X-Git-Reftype: branch X-Git-Commit: 05621e0b2094d566aa39b82d01b4a6902a1b22b7 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648552378; 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=LJdgdXTckXXsx2b38so3IZBO6FVKx8h8WYCqY8Lg1Pk=; b=cjR0izzHd5Z2fC4gv+eQHWxzYNd3yPwEqVx+A+HXP5tSrZAyV8zgj2SyJG+flXUyFLiDLA QuVZvCsl7t4Uywlykq/I31xLQVsYEiaqBRah+iQ/Q950y3KuOChgbxjutzo4FdjFWdxgj2 yQMkD7W6zi37xecAqmAvzkhuSra2kbYR+LZbmXBXTj4pEeTt+yUw17RlCIxS2S04M15huU R9kEb7KWS7/aHTDb8Nxe0JQ0kazglr0gEdZ6idvvEW6NEJcyRarPYVSDt6OB4htSog2zvU qVuQoF87FPkmA9sxvpkHt00Vhl6CAhUzvinarztg1lP2Lu5W5YatA5KJFlluiw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648552378; a=rsa-sha256; cv=none; b=p5jlcvu9gpU4HI+9fkT6aXtSNjlzomxhdfQY3edWbw+Y0ngrA8RjitWxoEmyc1xxNMq02X wFKVzcChBJgRwtrt4xn2urBDAOp6f4f9/QuNPELRe/YVKcp2vF7PI3Q3y79/UO0xqODvxo vJ3ZoYtYPq8h9MibcFsRrX97dZgckqsmNBRWB6Tubzc/QZvucc3/PFIDiMnfdIdn2iqIE4 er1iYpAdmVBaB/fbAY9xp0/pPNvef+K2Inwkd8HUSc2VxFyoEEFmFXWkWHOhs1+e696xtx 7ZC0XhWGEvym3btXZQtJCCtokZPcHptBdoxzRERhzrIaf+DNniiF6L1ZSyrhXw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=05621e0b2094d566aa39b82d01b4a6902a1b22b7 commit 05621e0b2094d566aa39b82d01b4a6902a1b22b7 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-29 11:11:46 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-03-29 11:12:32 +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 --- 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 621e22452c59..b741938cb93f 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 November 8, 2021 +.Dd March 29, 2022 .Dt IFCONFIG 8 .Os .Sh NAME @@ -1515,7 +1515,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. @@ -1527,21 +1527,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