git: 67d77afb0dde - main - ifconfig.8: Do not use ``'' for quoting
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 30 Mar 2022 13:01:34 UTC
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