From nobody Wed Jun 29 08:19:10 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 4C71E8A715C; Wed, 29 Jun 2022 08:19:11 +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 4LXvWL2vQCz4kD0; Wed, 29 Jun 2022 08:19:10 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490750; 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=mcXp0sgQK+1tWWJ2kZ4p79tzznMcwP2ea7bMtmZYUWM=; b=dtf7MPi2hyhrzyaK2C2VSz583LdTCWMlzKc+nzUle0qEM1LYHfLud8i6MOqmBDdCSimsjf YcNed5+4vnTbwX3sg09U2362wSe/hOleqodjU5RgWI0HYMabgVz9tew5gjtIEhfJbJ2pax MUSMoMFGZbkWwzNkcggdrAsGngVyBMySDYrMMeZCuhZJY8Tq/n275EwoKF9ZGkWOV0AG90 feIlcADKV+cXTRZB4rFFn2sxE+Mt9F1B8Etz0VwRGb/74sy9Vij3yJUWshWEYGQOfh+PLr MQyA5CdMmWw4QwY28wvkKerrDmEt94RijJObbI+WUT84Zt/c/qPwyvBNj/ka8w== 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 41EC06117; Wed, 29 Jun 2022 08:19:10 +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 25T8JA47004923; Wed, 29 Jun 2022 08:19:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 25T8JA9G004922; Wed, 29 Jun 2022 08:19:10 GMT (envelope-from git) Date: Wed, 29 Jun 2022 08:19:10 GMT Message-Id: <202206290819.25T8JA9G004922@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: 7a219d5ceacd - stable/13 - ifconfig.8: Move options sections to the top 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: 7a219d5ceacd1a0762e51478681480b02b9a2680 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490750; 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=mcXp0sgQK+1tWWJ2kZ4p79tzznMcwP2ea7bMtmZYUWM=; b=H/GFsf+R5dTo/RkvfT1CDyH30RkBbOejOPBgSyOJxvpM1wLFrEmLMj1OMsl9OW5RvJ/+pD 0eFnAMxcvFX5ha3TWcfBXqyBVB6+2NQ/b4PA1pdpXyRoKduMD+nykdvoGi4wozsptTCJeu jk9eSMVaacofDRCikSNy+OL2Wj8/y0vFf7jiXaEagIFp4VEOfk+0eVoHuFcNBQK7VsdxRL OdzqlbLWCLsS2QRNAab7XFz9y852rWcpB2xaMqbgZaQTa5CBybB8fwCOCGfvMiZ1hIC0aw YQ5ZBsxtoShDAKHLpKPzxwaCcgXlSXEoWLF6AUBcvVLze1Bqxy8zOcMk3n8evQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1656490750; a=rsa-sha256; cv=none; b=GyIWMwDEvzfaWmRivXSkdFknsK5Dv3lruq/dHBHP8JaZVrUjGX4Ynu7FVBAPjyVmPec6Wa bkPiV6ct6EISBtAM4gWvAM3RMdWqcmqignCSydpzWP+psj5McxwS9sYVmx7gHONgg2jyXS E/QYdrGze+JUDN4RcRYGoirbZ2yoJk/Vs+6wxH0+vAH1ffUIRNt6dpryOdiAKALZVGBK0k GNdwO2J2k11HbMP66vB39No2BYatYa6vc2CgdfG25LK3q+EXb70IDuwICPCy1p87g/DJWk rkPi/zA2feckq09OhgjnnbGilwy2OIbc6029SxNh22w1cweY94hS9hKfLwfJnQ== 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=7a219d5ceacd1a0762e51478681480b02b9a2680 commit 7a219d5ceacd1a0762e51478681480b02b9a2680 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-30 09:36:23 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-06-29 08:05:31 +0000 ifconfig.8: Move options sections to the top In order to clean up the layout of the manual page, let's keep parameters in the end of the DESCRIPTION section. This patch does not change any content, it's meant to only move the content around before refactoring. MFC after: 2 weeks (cherry picked from commit f15eed7c2aeea3667ec73f10c78df8de76d319d5) --- sbin/ifconfig/ifconfig.8 | 192 +++++++++++++++++++++++------------------------ 1 file changed, 96 insertions(+), 96 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index d5d5c1c2dfb9..9260a8c508d3 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -268,6 +268,102 @@ prefixlen 64 .El .El .Pp +The +.Nm +utility displays the current configuration for a network interface +when no optional parameters are supplied. +If a protocol family is specified, +.Nm +will report only the details specific to that protocol family. +.Pp +If the +.Fl m +flag is passed before an interface name, +.Nm +will display the capability list and all +of the supported media for the specified interface. +If +.Fl L +flag is supplied, address lifetime is displayed for IPv6 addresses, +as time offset string. +.Pp +Optionally, the +.Fl a +flag may be used instead of an interface name. +This flag instructs +.Nm +to display information about all interfaces in the system. +The +.Fl d +flag limits this to interfaces that are down, +.Fl u +limits this to interfaces that are up, +.Fl g +limits this to members of the specified group of interfaces, and +.Fl G +excludes members of the specified group from the list. +Both +.Fl g +and +.Fl G +flags may be specified to apply both conditions. +Only one option +.Fl g +should be specified as later override previous ones +(same for +.Fl G ) . +.Sy groupname +may contain shell patterns in which case it should be quoted. +When no arguments are given, +.Fl a +is implied. +.Pp +The +.Fl l +flag may be used to list all available interfaces on the system, with +no other additional information. +If an +.Ar address_family +is specified, only interfaces of that type will be listed. +.Fl l Dq ether +will list only Ethernet adapters, excluding the loopback interface. +Use of this flag is mutually exclusive +with all other flags and commands, except for +.Fl d +(only list interfaces that are down) +and +.Fl u +(only list interfaces that are up). +.Pp +The +.Fl v +flag may be used to get more verbose status for an interface. +.Pp +The +.Fl C +flag may be used to list all of the interface cloners available on +the system, with no additional information. +Use of this flag is mutually exclusive with all other flags and commands. +.Pp +The +.Fl k +flag causes keying information for the interface, if available, to be +printed. +For example, the values of 802.11 WEP keys and +.Xr carp 4 +passphrases will be printed, if accessible to the current user. +This information is not printed by default, as it may be considered +sensitive. +.Pp +If the network interface driver is not present in the kernel then +.Nm +will attempt to load it. +The +.Fl n +flag disables this behavior. +.Pp +Only the super-user may modify the configuration of a network interface. +.Pp The following parameters may be set with .Nm : .Bl -tag -width indent @@ -2911,102 +3007,6 @@ Set the authentication key to .It Cm state Ar MASTER|BACKUP Forcibly change state of a given vhid. .El -.Pp -The -.Nm -utility displays the current configuration for a network interface -when no optional parameters are supplied. -If a protocol family is specified, -.Nm -will report only the details specific to that protocol family. -.Pp -If the -.Fl m -flag is passed before an interface name, -.Nm -will display the capability list and all -of the supported media for the specified interface. -If -.Fl L -flag is supplied, address lifetime is displayed for IPv6 addresses, -as time offset string. -.Pp -Optionally, the -.Fl a -flag may be used instead of an interface name. -This flag instructs -.Nm -to display information about all interfaces in the system. -The -.Fl d -flag limits this to interfaces that are down, -.Fl u -limits this to interfaces that are up, -.Fl g -limits this to members of the specified group of interfaces, and -.Fl G -excludes members of the specified group from the list. -Both -.Fl g -and -.Fl G -flags may be specified to apply both conditions. -Only one option -.Fl g -should be specified as later override previous ones -(same for -.Fl G ) . -.Sy groupname -may contain shell patterns in which case it should be quoted. -When no arguments are given, -.Fl a -is implied. -.Pp -The -.Fl l -flag may be used to list all available interfaces on the system, with -no other additional information. -If an -.Ar address_family -is specified, only interfaces of that type will be listed. -.Fl l Dq ether -will list only Ethernet adapters, excluding the loopback interface. -Use of this flag is mutually exclusive -with all other flags and commands, except for -.Fl d -(only list interfaces that are down) -and -.Fl u -(only list interfaces that are up). -.Pp -The -.Fl v -flag may be used to get more verbose status for an interface. -.Pp -The -.Fl C -flag may be used to list all of the interface cloners available on -the system, with no additional information. -Use of this flag is mutually exclusive with all other flags and commands. -.Pp -The -.Fl k -flag causes keying information for the interface, if available, to be -printed. -For example, the values of 802.11 WEP keys and -.Xr carp 4 -passphrases will be printed, if accessible to the current user. -This information is not printed by default, as it may be considered -sensitive. -.Pp -If the network interface driver is not present in the kernel then -.Nm -will attempt to load it. -The -.Fl n -flag disables this behavior. -.Pp -Only the super-user may modify the configuration of a network interface. .Sh EXAMPLES Assign the IPv4 address .Li 192.0.2.10 ,