From nobody Thu Mar 31 09:55:55 2022 X-Original-To: dev-commits-src-main@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 DB7811A4FD75; Thu, 31 Mar 2022 09:55:55 +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 4KTdwW5m23z4ttc; Thu, 31 Mar 2022 09:55:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648720555; 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=G8SXfk6Ykefi/H6+kLWkJ2HWM/VN7s/WSg/L11hu9RQ=; b=XYpUQK16ybRrAMIcFmc6NtozX6CVK32TZ9kuUW/fCh3T0Z5ONowZpvuzacYo6/YgF/sEVV NBRgOvFdmk4Z9uQYtPD10LctRG6RDmyxvVdcoKwS6kG9beBP3QTVcTsVzcnamzagmBpijG qOg3jdwzFQboVcblhfj82mPy0hvUZHU3x7uIe4UQxE2B5f389YgDCnP4JfoV4tcoTOVvjT jlT6Vi66UZDKxGYWpq595Za0t+77UHYcd463EL7JUvos+0emclXKofBo+YJIWgD28AVux1 pIoLI0ege/ii35knRZukcSxDHEH93GdRG7FYgnHmjrbJxwKtqKa3iCnfbd6zYw== 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 A5486255D4; Thu, 31 Mar 2022 09:55:55 +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 22V9ttG5095670; Thu, 31 Mar 2022 09:55:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22V9tti6095669; Thu, 31 Mar 2022 09:55:55 GMT (envelope-from git) Date: Thu, 31 Mar 2022 09:55:55 GMT Message-Id: <202203310955.22V9tti6095669@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: 19ac0bc5c139 - main - ifconfig.8: Simplify examples by using canonical parameters List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@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: 19ac0bc5c139cdd00b71e1774ef327fa79197c2a Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648720555; 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=G8SXfk6Ykefi/H6+kLWkJ2HWM/VN7s/WSg/L11hu9RQ=; b=TuzXUi0n79KZW+YsnGbMzIDhiZPRGMGb20XloDbf8iivjbtVZwXEIWkGOuRFnpAEgVupJC IrjOvWB0goOgsPuw1SHsLkmWe4DibKD2EcV3ogUStpW4k1Ty8HJQlh3m/B8EUizCPN9F1e aVwHdp8v/KaR0HedvLnP8FjlnEHl6tBCBtjJti5jB6OzcP9Ecf5jesJ23rPZoafPsSgoOZ zo8o7Vh+fOxjEBtc9PgZ+dCG7YC6iyrO1KQgvn1DHifGkhCMbYy/LUGy14P9MpN1l9UeQX /CmsLRAMK6FCn+SEqbgw//jhKA4QtuOehM2gsLjQNQjeK7RoWIgMp65tAY6rYQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648720555; a=rsa-sha256; cv=none; b=JjfT6wUAJjrKl4/VNPSI6KAWKf5dQIH/hl4HY4fqAz01pXrI2PlkLxgglXLaCh81bxZHiw ZKiX+eB47NreL5eP+s5lsIci4hEUPJ8Abf3Tt/gZ46fve58uvhzAv0ZoQMpt79mY/zTpdQ 6J111yoNW8rAxZpibjspCSppMrR/7n+if8/kNxe8GuhA1fE0+Arxrt1ZCBvINniq/ay9tT TxpqODc/36Sn2sXkFFJu5OcpsO8VjnVa7ADp5uuiJLFDRKmTmsxSpg3jgjOHraTPFruVrs VAnaP94ROKMTuGdIIhRudhLEXHBwsCZToHQiArEl0Foip6OJrLiQtwSgOjm3KQ== 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=19ac0bc5c139cdd00b71e1774ef327fa79197c2a commit 19ac0bc5c139cdd00b71e1774ef327fa79197c2a Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-03-31 09:54:06 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-03-31 09:54:06 +0000 ifconfig.8: Simplify examples by using canonical parameters Also, use Bd instead of Dl for multi line examples. MFC after: 2 weeks --- sbin/ifconfig/ifconfig.8 | 22 ++++++++-------------- 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 2125f5e33394..4d9fb461a4d6 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -3091,12 +3091,8 @@ Add the IPv4 address with the CIDR network prefix .Li /28 , to the interface -.Li em0 , -using -.Cm add -as a synonym for the canonical form of the option -.Cm alias : -.Dl # ifconfig em0 inet 192.0.2.45/28 add +.Li em0 : +.Dl # ifconfig em0 inet 192.0.2.45/28 alias .Pp Remove the IPv4 address .Li 192.0.2.45 @@ -3117,17 +3113,15 @@ Note that lower case hexadecimal IPv6 addresses are acceptable. Remove the IPv6 address added in the above example, using the .Li / -character as shorthand for the network prefix, -and using -.Cm delete -as a synonym for the canonical form of the option -.Fl alias : -.Dl # ifconfig em0 inet6 2001:db8:bdbd::123/48 delete +character as shorthand for the network prefix: +.Dl # ifconfig em0 inet6 2001:db8:bdbd::123/48 -alias .Pp Configure a single CARP redundant address on igb0, and then switch it to be master: -.Dl # ifconfig igb0 vhid 1 10.0.0.1/24 pass foobar up -.Dl # ifconfig igb0 vhid 1 state master +.Bd -literal -offset indent -compact +# ifconfig igb0 vhid 1 10.0.0.1/24 pass foobar up +# ifconfig igb0 vhid 1 state master +.Ed .Pp Configure the interface .Li xl0 ,