From nobody Wed Jun 29 08:19:21 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 4E9DA8A79BB; 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 4LXvWZ1Yprz4k8D; Wed, 29 Jun 2022 08:19:21 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490762; 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=aI6S50SBA9zgPpue7Clp2EeLw+iOu2N9+w+BJRWQqMg=; b=xv6WQqDRU9yN8QbpCid/RtIwicANRtn4p+ERQ9tYOlqawSQJoqBHQpvypxw30/tWTmG/WH /0D4AfusKiW/i1pYyXQzm4I3zehkc8OZnZ3blOOf0pLZEKMlUUUeMxm+k6W9Hd5uvhWu6R VfFtIYR65N6trW9/0c6VjykBXp3uh0MzFhA+2Nj2f1ppXlxQk7gz6TCa8+1UuPyoAp8QQ4 DarUN14ojBy7zI1YUuWJhI2BZyVJBRPzuh8xJs5jIRXP63eQDhOQ0nzbTdvIc4FhFoN1du Pb1LcP1nORtW53K0fckN2R+gSBXHXWJ2oqyfXXfwwiQElwuooTkpc2KxtNIuPA== 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 8DEA960CC; Wed, 29 Jun 2022 08:19:21 +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 25T8JLWE005174; Wed, 29 Jun 2022 08:19:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 25T8JLPo005173; Wed, 29 Jun 2022 08:19:21 GMT (envelope-from git) Date: Wed, 29 Jun 2022 08:19:21 GMT Message-Id: <202206290819.25T8JLPo005173@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: da24248e8738 - stable/13 - ifconfig.8: Add section headers to the parameters section 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: da24248e8738e9f10bc97a2c01f4828b80003ece Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490762; 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=aI6S50SBA9zgPpue7Clp2EeLw+iOu2N9+w+BJRWQqMg=; b=IJUFeT2NMz27oGc1daaiczmyTb2hqoi7yqYOhkAi++VWVU3Vgn7VXINxaZ4+c2zyKnMEaR ZPQMKtHWgMZzFyVWJnUAta/wVzVeGq4AmY5kHXUOBgik1NrDoSLnvM9z0TgYph9W2fW704 OdzVrqmwIsqKcw+KeGRu3wqnXi0b0zCNNo8gLxIxKp6PR6JN5tV3S4XuFbRA5QuHfSVm6j Y5XTirB7hQG2zzmZNI8Qkh/1Msmsm5vWLaDo/YhYrJtwxx1IyetL8BecEfGL0ix/vr3bzR /NnvaDFX8sLRxhNzMEcjFtRknQQeobOIHdTU18LjRtWUUR+D5i67vyE4WBUKcQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1656490762; a=rsa-sha256; cv=none; b=t3yaGKBYA6JQPdlL9Thf4kG9uNBgjnTtYylV2Z4nKl+1MVwwZqqRaXhtHWDx8KCA015AS/ NjqeSvGlvX6JemcEjE33eGErYB4QBk6PePo3eP688ztyV1rdnrMa8jwD5uW1FmN0iupjy+ 7pBaMb1At0vx1Am1FZ9Gv4VJFodt2vZDCJsShwCH5P942xWeJoLiM2mSPVpmCj2WJOReA5 myJ4E6bTpBISHF4p74oV+JjrCraXrGbt9deIPvaWmsbtmiRL9xIEdJMyG/IqNhAsa5y/bN hmR0kDLjDEnv72EMLqwfKi245oRiLLGWA5QXAQ1kb6iTf7kFMePfbaDK+HsQkA== 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=da24248e8738e9f10bc97a2c01f4828b80003ece commit da24248e8738e9f10bc97a2c01f4828b80003ece Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-30 12:05:45 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-06-29 08:09:17 +0000 ifconfig.8: Add section headers to the parameters section MFC after: 2 weeks (cherry picked from commit 0e2045b294c2f716e58cf087aa4cf87c2bde9d64) --- sbin/ifconfig/ifconfig.8 | 36 +++++++++++++++++++----------------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 3cf9364a0fc0..31f20024dd21 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -364,8 +364,10 @@ When no arguments are given, is implied. .Pp Only the super-user may modify the configuration of a network interface. -.Pp -The following parameters may be set with +.Sh PARAMETERS +The following +.Ar parameter Ns s +may be set with .Nm : .Bl -tag -width indent .It Cm add @@ -839,7 +841,7 @@ It happens automatically when setting the first address on an interface. If the interface was reset when previously marked down, the hardware will be re-initialized. .El -.Pp +.Ss ICMPv6 Neighbor Discovery Protocol Parameters The following parameters are for ICMPv6 Neighbor Discovery Protocol. Note that the address family keyword .Dq Li inet6 @@ -921,7 +923,7 @@ Set a flag to disable Duplicate Address Detection. Clear a flag .Cm no_dad . .El -.Pp +.Ss IPv6 Parameters The following parameters are specific for IPv6 addresses. Note that the address family keyword .Dq Li inet6 @@ -946,7 +948,7 @@ Clear a flag .It Cm vltime Ar n Set valid lifetime for the address. .El -.Pp +.Ss IEEE 802.11 Wireless Interfaces Cloning Parameters The following parameters are specific to cloning IEEE 802.11 wireless interfaces with the .Cm create @@ -1024,7 +1026,7 @@ be transmitted; this can be useful when creating a WDS configuration but .Cm wds interfaces can only be created as companions to an access point. .El -.Pp +.Ss Cloned IEEE 802.11 Wireless Interface Parameters The following parameters are specific to IEEE 802.11 wireless interfaces cloned with a .Cm create @@ -2183,7 +2185,7 @@ Note that WPS support requires a WPS-capable supplicant. To disable this function use .Fl wps . .El -.Pp +.Ss MAC-Based Access Control List Parameters The following parameters support an optional access control list feature available with some adapters when operating in ap mode; see .Xr wlan_acl 4 . @@ -2221,7 +2223,7 @@ program be configured to do the right thing as it handles the RADIUS processing (and marks stations as authorized). .El -.Pp +.Ss Mesh Mode Wireless Interface Parameters The following parameters are related to a wireless interface operating in mesh mode: .Bl -tag -width indent @@ -2306,7 +2308,7 @@ The default setting for .Cm hwmpmaxhops is 31. .El -.Pp +.Ss Compatibility Parameters The following parameters are for compatibility with other systems: .Bl -tag -width indent .It Cm nwid Ar ssid @@ -2363,7 +2365,7 @@ Included for .Nx compatibility. .El -.Pp +.Ss Bridge Interface Parameters The following parameters are specific to bridge interfaces: .Bl -tag -width indent .It Cm addm Ar interface @@ -2568,7 +2570,7 @@ source addresses are dropped until an existing host cache entry expires or is removed. Set to 0 to disable. .El -.Pp +.Ss Link Aggregation and Link Failover Parameters The following parameters are specific to lagg interfaces: .Bl -tag -width indent .It Cm laggtype Ar type @@ -2678,7 +2680,7 @@ Disable lacp strict compliance on the interface. Configure a stride for an interface in round-robin mode. The default stride is 1. .El -.Pp +.Ss Generic IP Tunnel Parameters The following parameters apply to IP tunnel interfaces, .Xr gif 4 : .Bl -tag -width indent @@ -2728,7 +2730,7 @@ This is for backward compatibility with Clear a flag .Cm send_rev_ethip_ver . .El -.Pp +.Ss GRE Tunnel Parameters The following parameters apply to GRE tunnel interfaces, .Xr gre 4 : .Bl -tag -width indent @@ -2755,7 +2757,7 @@ Note that .Xr gre 4 will always accept GRE packets with invalid or absent keys. This command will result in a four byte MTU reduction on the interface. .El -.Pp +.Ss Packet Filter State Table Sychronisation Parameters The following parameters are specific to .Xr pfsync 4 interfaces: @@ -2783,7 +2785,7 @@ acknowledged that the associated state has been inserted. Do not defer the first packet in a state. This is the default. .El -.Pp +.Ss VLAN Parameters The following parameters are specific to .Xr vlan 4 interfaces: @@ -2895,7 +2897,7 @@ The .Ar iface argument is useless and hence deprecated. .El -.Pp +.Ss Virtual eXtensible LAN Parameters The following parameters are used to configure .Xr vxlan 4 interfaces. @@ -2965,7 +2967,7 @@ Delete all dynamically-learned addresses from the forwarding table. .It Cm vxlanflushall Delete all addresses, including static addresses, from the forwarding table. .El -.Pp +.Ss CARP Parameters The following parameters are used to configure .Xr carp 4 protocol on an interface: