From owner-freebsd-doc@FreeBSD.ORG Wed Sep 4 04:23:42 2013 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 33C6C446; Wed, 4 Sep 2013 04:23:42 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper.allbsd.org [IPv6:2001:2f0:104:e001::32]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id E3DFF2907; Wed, 4 Sep 2013 04:23:40 +0000 (UTC) Received: from alph.d.allbsd.org (p2049-ipbf1102funabasi.chiba.ocn.ne.jp [122.26.101.49]) (authenticated bits=128) by mail.allbsd.org (8.14.5/8.14.5) with ESMTP id r844NMZT049446 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 4 Sep 2013 13:23:32 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [IPv6:::1]) (authenticated bits=0) by alph.d.allbsd.org (8.14.5/8.14.5) with ESMTP id r844NKoU035510; Wed, 4 Sep 2013 13:23:22 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Wed, 04 Sep 2013 13:22:35 +0900 (JST) Message-Id: <20130904.132235.1295886508382839266.hrs@allbsd.org> To: moritz@wzff.de Subject: Re: docs/162354: Improve wording in rc.conf(5) regarding network-interfaces. From: Hiroki Sato In-Reply-To: <201309031426.34775.jhb@freebsd.org> References: <201111071709.pA7H9afH025856@phallus.wzff.de> <201309031426.34775.jhb@freebsd.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.5 on Emacs 24.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Wed_Sep__4_13_22_35_2013_678)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97.4 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (mail.allbsd.org [133.31.130.32]); Wed, 04 Sep 2013 13:23:33 +0900 (JST) X-Spam-Status: No, score=-90.4 required=13.0 tests=CONTENT_TYPE_PRESENT, DIRECTOCNDYN,DYN_PBL,QENCPTR1,RCVD_IN_PBL,SPF_SOFTFAIL,USER_IN_WHITELIST autolearn=no version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on gatekeeper.allbsd.org Cc: freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 04 Sep 2013 04:23:42 -0000 ----Security_Multipart(Wed_Sep__4_13_22_35_2013_678)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit John Baldwin wrote in <201309031426.34775.jhb@freebsd.org>: jh> On Monday, November 07, 2011 12:09:36 pm moritz@wzff.de wrote: jh> > jh> > >Number: 162354 jh> > >Category: docs jh> > >Synopsis: Improve wording in rc.conf(5) regarding network-interfaces. jh> > >Confidential: no jh> > >Severity: non-critical jh> > >Priority: low jh> > >Responsible: freebsd-doc jh> > >State: open jh> > >Quarter: jh> > >Keywords: jh> > >Date-Required: jh> > >Class: doc-bug jh> > >Submitter-Id: current-users jh> > >Arrival-Date: Mon Nov 07 19:00:22 UTC 2011 jh> > >Closed-Date: jh> > >Last-Modified: jh> > >Originator: Moritz Wilhelmy jh> > >Release: FreeBSD 9.0-RC1 amd64 jh> > >Organization: jh> > >Environment: jh> > >Description: jh> > According to rc.conf(5), ifconfig__alias is deprecated, jh> > because it fails if is not continuously increasing (i.e. if a number jh> is jh> > missing, the rc-scripts abort the search for bigger values of .) jh> > It isn't specified what should be used instead; I guessed jh> > ipv4_addrs_, but Marco Steinbach brought jh> > /etc/start_if. to my attention, which is mentioned in the same jh> > paragraph. This is confusing. Could someone please clarify which one of jh> > these is supposed to be used in place of the deprecated jh> > ifconfig__alias, especially since ipv4_addrs_ jh> seems jh> > not to have an equivalent ipv6_* variable? jh> jh> I don't think ifconfig_IF_aliasN is depreated, though you can now use jh> ifconfig_IF_aliases as an alternate. Also, both ifconfig_IF_aliases jh> and ifconfig_IF_aliasN handle both IPv4 and IPv6. See this commit for more jh> details: jh> jh> http://svnweb.freebsd.org/base?view=revision&revision=252015 The sentence "Due to this difficult to manage behavior, the ifconfig_IF_aliasN form is deprecated." was added back in 2005, when ipv4_addrs_IF was added. I guess it was considered that ipv4_addrs_IF was the replacement of ifconfig_IF_aliasN. I refactored it in a AF-independent manner and used ifconfig_IF_aliases as the successor, but I did not change that part in rc.conf(5) manual page. I think we can think both ifconfig_IF_aliasN and ifconfig_IF_aliases are currently supported. There is no immediate plan to remove ifconfig_IF_aliasN, at least. Is it reasonable to remove the sentence? -- Hiroki ----Security_Multipart(Wed_Sep__4_13_22_35_2013_678)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.13 (FreeBSD) iEYEABECAAYFAlImtYsACgkQTyzT2CeTzy0JigCfSMqqWcktXh/veI5I+tCRqLdv abEAnR2kjJIV0Bq4WbnwN8iXywWsrQZh =KGVH -----END PGP SIGNATURE----- ----Security_Multipart(Wed_Sep__4_13_22_35_2013_678)----