From nobody Wed Jun 29 08:19:14 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 595EA8A7473; Wed, 29 Jun 2022 08:19:16 +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 4LXvWR11Hyz4k7k; Wed, 29 Jun 2022 08:19:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490755; 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=ghlb2DjWT5g/BVMnLJa9hyfdqkLjbRxoE5s/EfOZQTU=; b=BtRUGtyCf1nRzJFVQ0s/NzL+W0v7XJ27dfSk5EuH/M1hucPbxZPQ6/m6OFzEnaRa5I14GO w5i1sq0Xv5wo4pibl0c3ACTlw8RjVmj2zOLbFLCOblAiCV3rCEoE1CsBN7HHYYC3q4OI0g NeosDjxkJyEOBZKUVaTRQHfZO7msJyg81aQP+ozGC5VuAy1HOUiM8G7CfCAcieSew5GpTL rQlkcbH2pQcuiXmpR7Ap3894YukvKyE8Jl2f1TAqKPUdX/dA2HI0xzh+jqL8Zv9SkFjuKX 3VAy98rtxRrr20dSQewO4iGDM36f7W2OXm32V+3DYD9sAf2rCK0Hc/RpW6rA+g== 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 BA6BE5DE4; Wed, 29 Jun 2022 08:19:14 +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 25T8JEWV005024; Wed, 29 Jun 2022 08:19:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 25T8JE4N005023; Wed, 29 Jun 2022 08:19:14 GMT (envelope-from git) Date: Wed, 29 Jun 2022 08:19:14 GMT Message-Id: <202206290819.25T8JE4N005023@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: 3087eb52222c - stable/13 - ifconfig.8: Clean up documentation of -a, -d, and -u 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: 3087eb52222c386c355cd5d17c5803c235cd0200 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656490755; 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=ghlb2DjWT5g/BVMnLJa9hyfdqkLjbRxoE5s/EfOZQTU=; b=gAXlGuKA1N+9SMhxWILtdYBMffbSh7YaueEty5ILUoprVPbl5OF54lccUsymBPukmyIO9c 8PpjNuqDNmuL/gE/+LorhtjPphMnlGniNUobPCUeFkmOSYX9MVhCvPYAQHJ+FLLKxfK4Hx xG9vGiZ+isSg64mq7DKHBrMNA6SsvLaGUMyrpkrBwCfcm6afbjyf6Mkd7oy1uQ8rMDZs4h SZmkKq0dT0h+HCDk95WIfiZ8CBt0Vt5ORNZA9PlrUem0ArZNuSMFfGMSJ4R9ERYHgyhskN jo59BHEP4Z7VYgD26irFWpA5EyqhJML28opdP25BnnEn+M2w0wmGTiKzdKJSvw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1656490755; a=rsa-sha256; cv=none; b=qhhqN0cfSGf3DG53eEhewhQov9aglGtLzWgiNqGhPANphKNPOJxPG/k3bGe7eVWpusXzkD iemPEJb/4ssZnTqHl2mlyi4+/cd0VR6Cd9JT1Y/6rkArcmGVLXua+M08hA8kBnPeNlZdVx vfGkakxdS6dQD7gVTNGvgu1SHZOj2F9Gp3KK9s61scDhiXeIF4peTchrpYq3S6EGRhIap3 dQtCsGcAd9R5nt4qYyO6f05oVOi2r0jjN/3w2/87x9jGZC/ghBE+VQbJOFDyjKrFUNzYuz sdgZr/5zbafcHx12QX742qMQFvq+s+3EcnppYJCJMoNvPiplzmY9z8Apu10MTQ== 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=3087eb52222c386c355cd5d17c5803c235cd0200 commit 3087eb52222c386c355cd5d17c5803c235cd0200 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-30 10:54:20 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-06-29 08:06:20 +0000 ifconfig.8: Clean up documentation of -a, -d, and -u MFC after: 2 weeks (cherry picked from commit 0625c313913b59f17aba11f77ef30032f68ed089) --- sbin/ifconfig/ifconfig.8 | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 805474c85276..35d9771e0491 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -82,6 +82,16 @@ or other operating parameters. .Pp The following options are available: .Bl -tag -width indent +.It Fl a +Display information about all interfaces in the system. +.Pp +The +.Fl a +flag may be used instead of the +.Ar interface +argument. +.It Fl d +Display only the interfaces that are down. .It Fl f Xo .Ar type Ns Cm \&: Ns Ar format Ns .Op Cm \&, Ns Ar type Ns Cm \&: Ns Ar format Ar ... @@ -178,6 +188,8 @@ Display address lifetime for IPv6 addresses as time offset string. .It Fl m Display the capability list and all of the supported media for the specified interface. +.It Fl u +Display only the interfaces that are up. .It Ar address For the DARPA-Internet family, the address is either a host name present in the host name data @@ -289,17 +301,6 @@ If a protocol family is specified, .Nm will report only the details specific to that protocol family. .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