From nobody Wed Mar 30 13:01:34 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 A06171A4213E; Wed, 30 Mar 2022 13:01:36 +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 4KT65D0YZ0z4ZPw; Wed, 30 Mar 2022 13:01:35 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645296; 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=fbZLExaNZe72f/xKQ+bY4XDPw86ZA9BCUBV3rK86kZU=; b=xwhqiovV7g6PPfuRkVUOtgVaM6XU5GIk6Pz/IHWdscp6oO49mLwn4ch8qGv/kKiR8vbmaO eCkj6ZJ18cZkkfg9uWk5RnlGGDmLudAdwrWd7RRFbirJVWwM/Eaa9rh3lmT1hXcTunhzGl 7+QXqFtO3+AGSOqjPWFwaZeL9E7KG/mGG/RGJKYXSCUMLja/TfrkexMCKmluhLjz1nxg/s dFicDBWhpJXx2nxAKnniEDTvdm0okb2kKWZzOp1VNoiWCDlcLYuz32WJwXCyol69tm3Qe2 k2/xOXKq9AuiVT3WTA7ifsQ4DOEQF3qerxS88hPjIszwQ0Mfip7XONt1a5lCnQ== 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 10E8C1364D; Wed, 30 Mar 2022 13:01:35 +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 22UD1YWG098847; Wed, 30 Mar 2022 13:01:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22UD1Y31098846; Wed, 30 Mar 2022 13:01:34 GMT (envelope-from git) Date: Wed, 30 Mar 2022 13:01:34 GMT Message-Id: <202203301301.22UD1Y31098846@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: 67d77afb0dde - main - ifconfig.8: Do not use ``'' for quoting 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/main X-Git-Reftype: branch X-Git-Commit: 67d77afb0dde9aa627635a0c4e28a8fa5a64db6c Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645296; 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=fbZLExaNZe72f/xKQ+bY4XDPw86ZA9BCUBV3rK86kZU=; b=f5qriYYM83p9loq0BWug8l1E5DgEyW1kkf8axYhAdVdvBaq5y0qJHboL5NjHGESe6wLkhb TrpiCDWoqkvvpJlr6olCrveGwUPjSKIKFViotytewrjCQu6GBbihO9QcTYRFL1icrejpVE zsPuJPatWBXvNr0p0hCrnDCIKznX/D7AluSIBRFZFI/UXq0KcXg12wZsfnV2tzVsd41Lwb LAUhy4XUSbDX7WBFm31uSXhn39WWAIHkbAAh7DqTO0/WxYONfk1lDFUvqtEb1EUXJO3JzR oUS6ZHGfeCpOsnRIn36dmA6ex3t+mq+O0Uz7d4A7LITBFit6ERk3Xsu0JNnm0Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648645296; a=rsa-sha256; cv=none; b=pPjzJ9lYbLVygNEJVFOgB4Zq7gU/b/hhVPJaKzow9/JNPYuHkvdhBPlAzNLuVUGdX0Lv4F kC9eYjhGKDs1R+lrUAMtVAeJIvuhak5Ui+55A7UlOUhuqkxjGbQxWNiWTa27QPO7Dz+lnV 7/qJ1jgR0M1CgxdNx7x9uOYP3RV1hId5zJ0n7HXvzBBjz4YSYpZPp5gSgUKFx7dOX6bDFP MwxEcmxOU4yRph4e9fw2u/tyZBPq9F5GYJdCfK0cwRDX9wZqDa4kM0DNPHgbEiYafv7s7Z /fMkMaoLR4WYRuxohgS8Wj2HLOyzIUz2sdVaQwKzJq5JFy9VjDEZsRCK/F1OFw== 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=67d77afb0dde9aa627635a0c4e28a8fa5a64db6c commit 67d77afb0dde9aa627635a0c4e28a8fa5a64db6c Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-30 12:28:09 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-03-30 12:58:38 +0000 ifconfig.8: Do not use ``'' for quoting MFC after: 2 weeks --- sbin/ifconfig/ifconfig.8 | 39 ++++++++++++++++++++++++++++----------- 1 file changed, 28 insertions(+), 11 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 2158eb3e6c8e..b005373babb5 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -661,7 +661,9 @@ There are three types of packets that may wake a system: ucast (directed solely to the machine's mac address), mcast (directed to a broadcast or multicast address), or -magic (unicast or multicast frames with a ``magic contents''). +magic +.Po unicast or multicast frames with a +.Dq magic contents Pc . Not all devices support WOL, those that do indicate the mechanisms they support in their capabilities. .Cm wol @@ -1000,7 +1002,8 @@ the device (if supported). .It Cm wdslegacy Mark a .Cm wds -device as operating in ``legacy mode''. +device as operating in +.Dq legacy mode . Legacy .Cm wds devices have a fixed peer relationship and do not, for example, roam @@ -1310,7 +1313,9 @@ e.g., "ES" and "Spain". The set of country codes are taken from .Pa /etc/regdomain.xml and can also -be viewed with the ``list countries'' request. +be viewed with the +.Cm list countries +request. Note that not all devices support changing the country code from a default setting; typically stored in EEPROM. See also @@ -1417,7 +1422,8 @@ The value should be less than beacon interval. Enable the use of Atheros Dynamic Turbo mode when communicating with another Dynamic Turbo-capable station. Dynamic Turbo mode is an Atheros-specific mechanism by which -stations switch between normal 802.11 operation and a ``boosted'' +stations switch between normal 802.11 operation and a +.Dq boosted mode in which a 40MHz wide channel is used for communication. Stations using Dynamic Turbo mode operate boosted only when the channel is free of non-dturbo stations; when a non-dturbo station @@ -1442,7 +1448,9 @@ DWDS extends the normal WDS mechanism by leveraging existing security protocols and eliminating static binding. .Pp When DWDS is enabled on an access point 4-address frames received from -an authorized station will generate a ``DWDS discovery'' event to user +an authorized station will generate a +.Dq DWDS discovery +event to user applications. This event should be used to create a WDS interface that is bound to the remote station (and usually plumbed into a bridge). @@ -1508,7 +1516,9 @@ To disable use of HT20 (e.g., to force only HT40 use) use To disable use of HT40 use .Fl ht40 . .Pp -HT configuration is used to ``auto promote'' operation +HT configuration is used to +.Dq auto promote +operation when several choices are available. For example, if a station associates to an 11n-capable access point it controls whether the station uses legacy operation, HT20, or HT40. @@ -1529,7 +1539,8 @@ for old devices are different. When compatibility support is enabled both standard and compatible data will be provided. Stations that associate using the compatibility mechanisms are flagged -in ``list sta''. +in +.Cm list sta . To disable compatibility support use .Fl htcompat . .It Cm htprotmode Ar technique @@ -1548,7 +1559,8 @@ access point (default). When operating as an access point the 802.11 layer monitors the activity of each associated station. When a station is inactive for 5 minutes it will send several -``probe frames'' to see if the station is still present. +.Dq probe frames +to see if the station is still present. If no response is received then the station is deauthenticated. Applications that prefer to handle this work can disable this facility by using @@ -1848,7 +1860,9 @@ can be used on a channel are defined by this setting. Regdomain codes (SKU's) are taken from .Pa /etc/regdomain.xml and can also -be viewed with the ``list countries'' request. +be viewed with the +.Cm list countries +request. Note that not all devices support changing the regdomain from a default setting; typically stored in EEPROM. See also @@ -2262,7 +2276,9 @@ The Mesh ID is a string up to 32 characters in length. A mesh interface must have a Mesh Identifier specified to reach an operational state. .It Cm meshttl Ar ttl -Set the desired ``time to live'' for mesh forwarded packets; +Set the desired +.Dq time to live +for mesh forwarded packets; this is the number of hops a packet may be forwarded before it is discarded. The default setting for @@ -2301,7 +2317,8 @@ The only available protocol at the moment is called (Hybrid Wireless Mesh Protocol). The mesh interface will restart after changing this setting. .It Cm hwmprootmode Ar mode -Stations on a mesh network can operate as ``root nodes.'' +Stations on a mesh network can operate as +.Dq root nodes . Root nodes try to find paths to all mesh nodes and advertise themselves regularly. When there is a root mesh node on a network, other mesh nodes can setup