From nobody Wed Jun 29 08:19:22 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 5A1408A7B8C; Wed, 29 Jun 2022 08:19:23 +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 4LXvWb0ZGKz4kH0; Wed, 29 Jun 2022 08:19:22 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490763; 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=gCiKskC0EMgNaMCzURIlfosLTNI1B+emJdysiRIUXaA=; b=NQppDXOZKrzV3Jmx0lWXODiRLWX0MB5sH9AfMjKWRpeeSXTylLo0TjcSBj3Syb+/RrQMx1 X+gxQuZ4mrWb29PryiLU03PesOgfY3jnEJ4VvWELXmstNw3hq6vj+UExKphmnU7W1f3DhC 2N1OLBVYUFfCUpHrxn55jal4lv0+zP2AovHA+RJwtAZd3nZVn3lzHctqE7h2fN2/DH83mx jSbaBavmEBPF8ZXbvplvp4N2laA77Fz+GjDsy0hljFkgdxw9tYkBol4cB3Ew4OgB7O4D3C WhQ6n9Wssh0NGPpDrLVwTp1AtQOhHTEWBpzAptHha3voRyzmJG9yl1AaVAUvFQ== 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 ABFEC5DE7; Wed, 29 Jun 2022 08:19:22 +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 25T8JM1w005204; Wed, 29 Jun 2022 08:19:22 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 25T8JMXA005203; Wed, 29 Jun 2022 08:19:22 GMT (envelope-from git) Date: Wed, 29 Jun 2022 08:19:22 GMT Message-Id: <202206290819.25T8JMXA005203@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: 8bc09bfe1715 - stable/13 - ifconfig.8: Clean up the channel parameter description 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: 8bc09bfe1715698bf662bdf19661f98ea28b299f Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490763; 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=gCiKskC0EMgNaMCzURIlfosLTNI1B+emJdysiRIUXaA=; b=IFCfBmvgJ7AL76UlFYBXu6yOwPORXsCShUxjeSOCm7yRChAXD2ZrRpMB+INRvx+9IxKzql OyxDZfdTfpS2qYbvW3mjov2dgnnmwHfe4tqyNJgPI1vlRBxW9xrASOOILI6cp9/VypI+Ml BitBv7T8OsJ/M5K9dHOlKXcFyKPFwYADlOTPhSvVw1l2T/gOibTcOmyd0i2ykxsd7v74UL nBUTYDjOOQq05Z65jIrB9PgCBOHvoFW3iIlDEIOvwoHXDAUhGuA1wOsuohbonZVBcJoUcp wB8iZiu7CAImFDn+q/IHtd9groT0ohw+dWWTGgiAmcAlt1R3yvfnC3AU26YxZw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1656490763; a=rsa-sha256; cv=none; b=F2vD+yWDVBSklxsRKuoKoCkTpAWlKCKTN0EE9Bivd8jKZpEzV1XZaL5uL8QsEGoRX3SEgF CgBPpMA9i3QQp9SiC4roSpD2OA2OxO/T1tkMdDhhgkxpc++Q+rGC+u8NIQ1E8lyBh5+TQC qbaDZQr3JX5UWqtQtIuqCtkW5kYAK+IzvDqsr7RkFRPb7VraNOqtQUchf/zjBtkazJcI7o Czl0H2MCTdPD6XuI8UUV1/+wra2uFhCGhNZfLNrv6/BbafW8yjCQRonqd/WgzWA7dBWMQE LnS19ENigCm9ws8i26zKnXjjClrZTlfqm1q286BP66Z90Rnw1l6Ej9hEabRivw== 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=8bc09bfe1715698bf662bdf19661f98ea28b299f commit 8bc09bfe1715698bf662bdf19661f98ea28b299f Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-30 12:24:23 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-06-29 08:09:20 +0000 ifconfig.8: Clean up the channel parameter description MFC after: 2 weeks (cherry picked from commit ce0384637376fcb1c3d399989f2bb4cb2d9dd05e) --- sbin/ifconfig/ifconfig.8 | 95 +++++++++++++++++++++++++++++++----------------- 1 file changed, 62 insertions(+), 33 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 31f20024dd21..fac95ed930ad 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -1220,9 +1220,9 @@ Channels range from 1 to 255, but the exact selection available depends on the region your adaptor was manufactured for. Setting the channel to -.Li any , +.Cm any , or -.Cm - +.Dq Cm - will clear any desired channel and, if the device is marked up, force a scan for a channel to operate on. Alternatively the frequency, in megahertz, may be specified @@ -1232,42 +1232,71 @@ When there are several ways to use a channel the channel number/frequency may be appended with attributes to clarify. For example, if a device is capable of operating on channel 6 with 802.11n and 802.11g then one can specify that g-only use -should be used by specifying ``6:g''. +should be used by specifying +.Cm 6:g . Similarly the channel width can be specified by appending it -with ``/''; e.g., ``6/40'' specifies a 40MHz wide channel, -These attributes can be combined as in: ``6:ht/40''. -The full set of flags specified following a ``:'' are: -.Cm a -(802.11a), -.Cm b -(802.11b), -.Cm d -(Atheros Dynamic Turbo mode), -.Cm g -(802.11g), -.Cm h -or +with +.Dq Cm \&/ ; +e.g., +.Cm 6/40 +specifies a 40MHz wide channel. +These attributes can be combined as in: +.Cm 6:ht/40 . +.Pp +The full set of flags specified following a +.Dq Cm \&: +are: +.Pp +.Bl -tag -compact +.It Cm a +802.11a +.It Cm b +802.11b +.It Cm d +Atheros Dynamic Turbo mode +.It Cm g +802.11g +.It Cm h +Same as .Cm n -(802.11n aka HT), -.Cm s -(Atheros Static Turbo mode), +.It Cm n +802.11n aka HT +.It Cm s +Atheros Static Turbo mode +.It Cm t +Atheros Dynamic Turbo mode, or appended to +.Cm st and -.Cm t -(Atheros Dynamic Turbo mode, or appended to ``st'' and ``dt''). -The full set of channel widths following a '/' are: -.Cm 5 -(5MHz aka quarter-rate channel), -.Cm 10 -(10MHz aka half-rate channel), -.Cm 20 -(20MHz mostly for use in specifying ht20), -and -.Cm 40 -(40MHz mostly for use in specifying ht40). +.Cm dt +.El +.Pp +The full set of channel widths following a +.Cm \&/ +are: +.Pp +.Bl -tag -compact +.It Cm 5 +5MHz aka quarter-rate channel +.It Cm 10 +10MHz aka half-rate channel +.It Cm 20 +20MHz mostly for use in specifying +.Cm ht20 +.It Cm 40 +40MHz mostly for use in specifying +.Cm ht40 +.El +.Pp In addition, a 40MHz HT channel specification may include the location -of the extension channel by appending ``+'' or ``-'' for above and below, -respectively; e.g., ``2437:ht/40+'' specifies 40MHz wide HT operation +of the extension channel by appending +.Dq Cm \&+ +or +.Dq Cm \&- +for above and below, +respectively; e.g., +.Cm 2437:ht/40+ +specifies 40MHz wide HT operation with the center channel at frequency 2437 and the extension channel above. .It Cm country Ar name Set the country code to use in calculating the regulatory constraints