Date: Wed, 04 Sep 2013 13:22:35 +0900 (JST) From: Hiroki Sato <hrs@FreeBSD.org> To: moritz@wzff.de Cc: freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/162354: Improve wording in rc.conf(5) regarding network-interfaces. Message-ID: <20130904.132235.1295886508382839266.hrs@allbsd.org> In-Reply-To: <201309031426.34775.jhb@freebsd.org> References: <201111071709.pA7H9afH025856@phallus.wzff.de> <201309031426.34775.jhb@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
----Security_Multipart(Wed_Sep__4_13_22_35_2013_678)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit John Baldwin <jhb@freebsd.org> 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_<interface>_alias<n> is deprecated, jh> > because it fails if <n> is not continuously increasing (i.e. if a number jh> is jh> > missing, the rc-scripts abort the search for bigger values of <n>.) jh> > It isn't specified what should be used instead; I guessed jh> > ipv4_addrs_<interface>, but Marco Steinbach brought jh> > /etc/start_if.<interface> 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_<interface>_alias<n>, especially since ipv4_addrs_<interface> 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)----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130904.132235.1295886508382839266.hrs>