From root@phallus.wzff.de  Mon Nov  7 18:53:53 2011
Return-Path: <root@phallus.wzff.de>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id E71531065672
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  7 Nov 2011 18:53:53 +0000 (UTC)
	(envelope-from root@phallus.wzff.de)
Received: from wzff.de (phallus.wzff.de [176.9.47.245])
	by mx1.freebsd.org (Postfix) with ESMTP id 7C1518FC18
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  7 Nov 2011 18:53:51 +0000 (UTC)
Received: from phallus.wzff.de ([127.0.1.1])
	by wzff.de (8.14.4/8.14.4) with ESMTP id pA7H9alY025857
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 7 Nov 2011 17:09:36 GMT
	(envelope-from root@phallus.wzff.de)
Received: (from root@localhost)
	by phallus.wzff.de (8.14.5/8.14.5/Submit) id pA7H9afH025856;
	Mon, 7 Nov 2011 17:09:36 GMT
	(envelope-from root)
Message-Id: <201111071709.pA7H9afH025856@phallus.wzff.de>
Date: Mon, 7 Nov 2011 17:09:36 GMT
From: moritz@wzff.de
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Improve wording in rc.conf(5) regarding network-interfaces.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         162354
>Category:       docs
>Synopsis:       Improve wording in rc.conf(5) regarding network-interfaces.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Nov 07 19:00:22 UTC 2011
>Closed-Date:    
>Last-Modified:  Tue Sep 17 20:30:00 UTC 2013
>Originator:     Moritz Wilhelmy
>Release:        FreeBSD 9.0-RC1 amd64
>Organization:
>Environment:
>Description:
	According to rc.conf(5), ifconfig_<interface>_alias<n> is deprecated,
	because it fails if <n> is not continuously increasing (i.e. if a number is
	missing, the rc-scripts abort the search for bigger values of <n>.)
	It isn't specified what should be used instead; I guessed
	ipv4_addrs_<interface>, but Marco Steinbach brought
	/etc/start_if.<interface> to my attention, which is mentioned in the same
	paragraph. This is confusing. Could someone please clarify which one of
	these is supposed to be used in place of the deprecated
	ifconfig_<interface>_alias<n>, especially since ipv4_addrs_<interface> seems
	not to have an equivalent ipv6_* variable?
>How-To-Repeat:
>Fix:
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Fri Dec 9 02:40:38 UTC 2011 
Responsible-Changed-Why:  
I'll look into this. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=162354 

From: Moritz Wilhelmy <moritz@barfooze.de>
To: bug-followup@FreeBSD.org, freebsd-doc@FreeBSD.org
Cc:  
Subject: Re: docs/162354: Improve wording in rc.conf(5) regarding
 network-interfaces.
Date: Sat, 31 Aug 2013 17:20:41 +0200

 Any updates on this? I think it's still there.

From: John Baldwin <jhb@freebsd.org>
To: freebsd-doc@freebsd.org
Cc: moritz@wzff.de,
 FreeBSD-gnats-submit@freebsd.org,
 Hiroki Sato <hrs@freebsd.org>
Subject: Re: docs/162354: Improve wording in rc.conf(5) regarding network-interfaces.
Date: Tue, 3 Sep 2013 14:26:34 -0400

 I don't think ifconfig_IF_aliasN is depreated, though you can now use
 ifconfig_IF_aliases as an alternate.  Also, both ifconfig_IF_aliases
 and ifconfig_IF_aliasN handle both IPv4 and IPv6.  See this commit for more
 details:
 
 http://svnweb.freebsd.org/base?view=revision&revision=252015
 
 -- 
 John Baldwin

From: Hiroki Sato <hrs@FreeBSD.org>
To: moritz@wzff.de
Cc: freebsd-doc@FreeBSD.org, jhb@FreeBSD.org, FreeBSD-gnats-submit@FreeBSD.org,
        hrs@FreeBSD.org
Subject: Re: docs/162354: Improve wording in rc.conf(5) regarding
 network-interfaces.
Date: Wed, 04 Sep 2013 13:22:35 +0900 (JST)

 ----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)----

From: Moritz Wilhelmy <moritz@wzff.de>
To: freebsd-doc@FreeBSD.org, jhb@FreeBSD.org,
	FreeBSD-gnats-submit@FreeBSD.org, hrs@FreeBSD.org
Cc:  
Subject: Re: docs/162354: Improve wording in rc.conf(5) regarding
 network-interfaces.
Date: Wed, 4 Sep 2013 09:49:43 +0200

 On Wed, Sep 04, 2013 at 13:22:35 +0900, Hiroki Sato wrote:
 > John Baldwin <jhb@freebsd.org> wrote
 >   in <201309031426.34775.jhb@freebsd.org>:
 > 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
 
 Thanks. Having both IPv6 and IPv4 in the same place with the ability to
 just configure an entire subnet sounds like a sane decision.
 
 >  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?
 
 I think it is. Thank you!
 I see the changes are already in 9.2 so I'm happy for now :)
 
 Moritz

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/162354: commit references a PR
Date: Tue, 17 Sep 2013 20:20:12 +0000 (UTC)

 Author: hrs
 Date: Tue Sep 17 20:20:04 2013
 New Revision: 255652
 URL: http://svnweb.freebsd.org/changeset/base/255652
 
 Log:
   Remove description "ifconfig_IF_aliasN is deprecated".  While this
   sentence was added in 2005, many users still need it.
   
   Approved by:	re (gjb)
   PR:		docs/162354
 
 Modified:
   head/share/man/man5/rc.conf.5
 
 Modified: head/share/man/man5/rc.conf.5
 ==============================================================================
 --- head/share/man/man5/rc.conf.5	Tue Sep 17 20:09:25 2013	(r255651)
 +++ head/share/man/man5/rc.conf.5	Tue Sep 17 20:20:04 2013	(r255652)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd July 22, 2013
 +.Dd September 10, 2013
  .Dt RC.CONF 5
  .Os
  .Sh NAME
 @@ -1192,10 +1192,8 @@ be added since the search would
  stop with the missing
  .Dq Li alias3
  entry.
 -Due to this difficult to manage behavior, the
 -.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 -form is deprecated.
 -There is
 +Because of this difficult to manage behavior,
 +there is
  .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _aliases
  variable, which has the same functionality as
  .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
