From nobody Wed Mar 30 13:01:33 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 97A461A42057; Wed, 30 Mar 2022 13:01:35 +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 4KT65B3Xmzz4Zcr; Wed, 30 Mar 2022 13:01:34 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645294; 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=KEMjEWlMQhFw6KALo9k+UjTJtEc6BR3AckTpBgfkEok=; b=CFWRG9VIg56BcMekyEGId8m3zsbUetYmIGYklidvebE2NGBZGYsq+Et5yjmxSKBEmGVw08 9SEk9ZLHh0vD0M02sLjehU4F/VCpSwqGQ0ms6k+1PzTVQHo24vn4wGBvNyQ1rO5cgI2T5v wprjlvB8kHds0PN/sRXWfJ3SDSu0jFh7GBsnqJPUUMQmx3lnW8x9onW3BsXUUAreSiYKTF 46qQrdXvztJqv82JNlXLSw4uFh6XuR309Owv3X1n4h2cEo9wzTH/yShxrTwUn/0NhB3FuH ugJdXjWw/26oDHAZ+rCOpz9mQzwoRwhrF3Q/4ok06MB4PcKwPuTbD4n92Cn2rw== 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 E0B261364C; Wed, 30 Mar 2022 13:01:33 +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 22UD1X1c098823; Wed, 30 Mar 2022 13:01:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22UD1X3m098822; Wed, 30 Mar 2022 13:01:33 GMT (envelope-from git) Date: Wed, 30 Mar 2022 13:01:33 GMT Message-Id: <202203301301.22UD1X3m098822@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: ce0384637376 - main - ifconfig.8: Clean up the channel parameter description 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: ce0384637376fcb1c3d399989f2bb4cb2d9dd05e Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645294; 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=KEMjEWlMQhFw6KALo9k+UjTJtEc6BR3AckTpBgfkEok=; b=jRJA2x8LrEu5x1spYrustv2bWhle0ZUXyvZC5kP3zx/hpm0EUxBjQ3j+jwfVLIPnvVer/F nyUADz72SmEoHyoD6qjjpxTA+drPDwhN5UZAqj6C5FGuVQViPvwYRW7t5CIR1RJzTj3wqw IV0ZXpXjnmfhEqK4jRhgmgGTfAZqhnWBJ9aeN/TrMQKHHp/pb26V9901R57DnEsZxt3KSO 28mJJzHzpN96/c8LOZtLNDVDIrygypRGzvQ7+c3jogPf6gQrGuB6MknwB06nyliLasiiwB rsriAEfO99nE+LZcnfqMho6YHywNJEumgq4QqZ0OpBPmnULB/u6R30zcYtB22A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648645294; a=rsa-sha256; cv=none; b=Y5/zoEu/ejEF8O+6n5/tI+q9wyRQarSkPiR1I3Yy0wJIxubkyeZF8uG5uerEY2Y7/PCRCz qzZFaAcgWR3xNhSKdiZCh/vENTT4CPOtKNTHDipM8cNGmy4YrXwkQx38d6lmymQzrtKkWR fZoA2cb+lRisrcIr4/QLgxlmilL/yE87BrGK7l0ST3s6jGV5mIeUhnLPXJr6WFVOgwHQaq 0+G6nUuHlExAJwNL9SQXVPFsnfqb6Bdv7Z5huaHhePTHijpWTPxmv0ECGgwBxe2RqKfefW bjPj10iLFUwnPruk84a+mtewdLdSXTDhH1T3Kuy0I9ZIMLInN5fg6UJ9cz0Scw== 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=ce0384637376fcb1c3d399989f2bb4cb2d9dd05e commit ce0384637376fcb1c3d399989f2bb4cb2d9dd05e Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-30 12:24:23 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-03-30 12:58:38 +0000 ifconfig.8: Clean up the channel parameter description MFC after: 2 weeks --- 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 af8eb9941fbe..2158eb3e6c8e 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