From nobody Wed Mar 30 13:01:21 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 DA0081A41889; Wed, 30 Mar 2022 13:01:21 +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 4KT64x471Nz4ZQn; Wed, 30 Mar 2022 13:01:21 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645281; 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=d8e2Bne6o88b9a0YVSDh+AFJz1Ce+qe6LBurUs2vVJQ=; b=gH9dydulB/SfmfqYxN3I1Tn0HOMYuOaXA+g+Jwq0jE34F4NXU3Ks+XUgDo/4I78B+3EZ7n TM1a+VRP/JRdQtZSbdAdgvey5MwUWxlQXMo11njllgewp/+pvZ62ui8Jkn0DGFsddaAlXm XXy+Ic8FX+64QDxcqLP/9XzmBp4A5fmHYoBq9Zyi/AyU/4dQOsYiTvKSSia47FsyJRTzFy pXlioQ0H3mWi7C+kz5380MOG4sxjWoe2hKxmIciF/xviff/9zii0Q4USELLKrMlFI9ZuFl rS+ma+jbWYP/e7cF4X6lTxMszsWaOQMe3bMtKzWtEKe2RKY7Ew3QKnEZjvC26g== 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 4F96A13649; Wed, 30 Mar 2022 13:01: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 22UD1LdM098546; Wed, 30 Mar 2022 13:01:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22UD1Ldw098545; Wed, 30 Mar 2022 13:01:21 GMT (envelope-from git) Date: Wed, 30 Mar 2022 13:01:21 GMT Message-Id: <202203301301.22UD1Ldw098545@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: f15eed7c2aee - main - ifconfig.8: Move options sections to the top 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: f15eed7c2aeea3667ec73f10c78df8de76d319d5 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645281; 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=d8e2Bne6o88b9a0YVSDh+AFJz1Ce+qe6LBurUs2vVJQ=; b=N8qctCyoVD3N5q1dBsUBIW0LZnRGSND61dB4fxvhEpTyoI83Jsk8k2aZQBkqP/mzpm5txH lmW/XKnbSyuBBVSz6ct7Cdj24OvwSdd3TagdC2RJjVQ6j1FDmjeh7OkraF6fQf3zNOI3Op ctC7tFvLYdwCJe28jAsyQKUl5w5RxeDnZZ5ZwNsMqxn0ZtT/KyNm7B50XQCkyJeM6JDpU+ v6dowIe159cVOUQ+s5iBEikFvlLn8djlvrrLrf42+NNnzsGDAhCgFRaBeZrFMTwW8mPmyk UgGl53G7Sk6kHf1QIiCQ8xkthW5H6FCnDzmVD3CT3AVi9uRtAp2gICOblEuItA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648645281; a=rsa-sha256; cv=none; b=c541r7Djgt4M3bI7UPhRKzmFPn6f/SUgv5KJMW7G146xht+w7O9Nx6fkubWr8ba5T0YKzy nsVrkuI7aS+g6Z6sWu3rRF9ZhE66sZ/pb4FcZiqyzW0aDkVfvP+9g1szim6oisnnjet6rc NDrXf28kmgsM3GFrhNZY+Ux3QE9r/6628g5Ic5wehSeTiSr5MnMp+QBY+nsNqC15+X8DAL 1LNAXbKP5jkIZSQqBTPgdxujHt+BNCE89C4o9O88LcW+IPmbgpj5UKsIbe3zhvPA+LeiPc JpKS+McStLa1p0aUR6JpV98YHAg+6TV6HlXaJs2Jbe6/35IHJB09HytM1uQYoQ== 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=f15eed7c2aeea3667ec73f10c78df8de76d319d5 commit f15eed7c2aeea3667ec73f10c78df8de76d319d5 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-30 09:36:23 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-03-30 12:58:32 +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 --- 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 7e2cdbe8a2ca..b7c1c1153364 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 ,