Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 12 Apr 2022 14:36:20 GMT
From:      Mateusz Piotrowski <0mp@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: 1bd6c85cf125 - stable/12 - ifconfig.8: Add capability codes descriptions from handbook
Message-ID:  <202204121436.23CEaKXH038912@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202204121436.23CEaKXH038912>