From nobody Tue Apr 12 14:36:18 2022 X-Original-To: dev-commits-src-branches@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 2C8B01A8C764; Tue, 12 Apr 2022 14:36:19 +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 4Kd7ZW0kynz3PyZ; Tue, 12 Apr 2022 14:36:19 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649774179; 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=v2YyD/6HeZaDzEbNBj19qjuP7kK+7mnwT5e2E8LbOnI=; b=Xus08ppoLfb1xpw4NT8lzFM3sqcVfcTzKVNKbtUj+iyil63gkV7SaoqJx5zUOXeF3JOsX0 q7ESnJ0EZxtAv6Dt6Aad79y8Y3za1jsqZVXxB7J9iB27uw6jP9Ol4nY0iEXdrYBGw0LsX3 8ui2xsZ3horrl1zPNfnLq4wBzejVis0sdSvFT9a6TMaBCelEi5p6ZQ3U48QZuyy06F1qkO tLFqJSx2bH5NjsDL/1205vPlrxNhRWXCrmBfNmrOu1dlOh8qfs+qNIyMH726Z9XlBtZf/w DTsk+6GPft9ZyiJyZuk4tRJRB91enDMMaeQxjFQFK9zfSmwnLUuziLqQRmO7Sw== 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 EE72218EFF; Tue, 12 Apr 2022 14:36:18 +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 23CEaIlZ038789; Tue, 12 Apr 2022 14:36:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 23CEaIbu038788; Tue, 12 Apr 2022 14:36:18 GMT (envelope-from git) Date: Tue, 12 Apr 2022 14:36:18 GMT Message-Id: <202204121436.23CEaIbu038788@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: a197457157c1 - stable/13 - ifconfig.8: Add capability codes descriptions from handbook List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@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/13 X-Git-Reftype: branch X-Git-Commit: a197457157c170fa10df193c377cd6f8ffbc27e0 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649774179; 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=v2YyD/6HeZaDzEbNBj19qjuP7kK+7mnwT5e2E8LbOnI=; b=Ef2tjGh54wKrRwoPj5dJxTsAqgFmDxHj/Ups7AtJY+ov9H7IXyGFPpG3mhlysrIjdDmc7e XHzocjrVTa0q6TjgTvx/l4n/wmni2uDBOm8WHXa/1/cxc3E7sIy8qfO9c781luPGwjnrB6 N+bk9tOrUzMNgxraO+8bNdFJ+BGStoJbYSfdd0sjVJ7uKfLK9iDy0wVUoGqrBkeAiMFBd+ q9OVR3Z4npg68eNUroI9s8PeI8E+6ztFTIbkM1P28NTV/cph0hDX9lTPtOPI7fXlJ24zoz Lt1kH1rtZrTHCouTH3/ZJ/7xNI0sSbCWmnr7/uy48yTD0j35qAnLOuBkVDgKWQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649774179; a=rsa-sha256; cv=none; b=kcBiUNb5bUVSg7T46sCt22he7BgWr+dMI7e30WYrOSY9lJ2YIC6xBvPm4SwzUypSyOoBVQ 8FjU3G0QLpg5kmuaCD/Ws9Z6vJuVJU3EfrvSgvrVlw2FsGG9owv0/PwqMTVakfhVvqvoWZ UHgkAMETaiIhgZJKZQrtGYnwlXQzP/prdHuS/3mBtN3Hw/EniIWe8/5WFUp579eyu/iXz5 xwqmddsG5q7TpwPTPQyqo5Zdnc+ekQv1rHBQngrNryR5pu67dnP4L2G3gB1OxA+43NiCip Oo5k+bUsuqkb/HgkFuyDS2IJeYdvPPYdagF05z83GGQtmSmJlF0vf5a0UKuy9g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=a197457157c170fa10df193c377cd6f8ffbc27e0 commit a197457157c170fa10df193c377cd6f8ffbc27e0 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:35:49 +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 1a3da4ee417e..9f04ddc3c719 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 @@ -1516,7 +1516,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. @@ -1528,21 +1528,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