From cjc@earthlink.net  Wed Nov 28 23:52:25 2001
Return-Path: <cjc@earthlink.net>
Received: from snipe.prod.itd.earthlink.net (snipe.mail.pas.earthlink.net [207.217.120.62])
	by hub.freebsd.org (Postfix) with ESMTP id 3030237B41F
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 28 Nov 2001 23:52:21 -0800 (PST)
Received: from dialup-209.247.138.241.dial1.sanjose1.level3.net ([209.247.138.241] helo=blossom.cjclark.org)
	by snipe.prod.itd.earthlink.net with esmtp (Exim 3.33 #1)
	id 169LzY-00043k-00
	for FreeBSD-gnats-submit@freebsd.org; Wed, 28 Nov 2001 23:52:20 -0800
Received: (from cjc@localhost)
	by blossom.cjclark.org (8.11.6/8.11.3) id fAT7qJd06994;
	Wed, 28 Nov 2001 23:52:19 -0800 (PST)
	(envelope-from cjc)
Message-Id: <200111290752.fAT7qJd06994@blossom.cjclark.org>
Date: Wed, 28 Nov 2001 23:52:19 -0800 (PST)
From: "Crist J. Clark" <cristjc@earthlink.net>
Reply-To: "Crist J. Clark" <cjc@freebsd.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Bad ifconfig(8) alias advice in FAQ 10.9
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         32373
>Category:       docs
>Synopsis:       Bad ifconfig(8) alias advice in FAQ 10.9
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 29 00:00:02 PST 2001
>Closed-Date:    Mon Feb 18 16:23:38 PST 2002
>Last-Modified:  Mon Feb 18 16:26:08 PST 2002
>Originator:     Crist J. Clark
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
>Environment:
System: FreeBSD blossom.cjclark.org 4.4-STABLE FreeBSD 4.4-STABLE #0: Wed Nov 7 14:50:28 PST 2001 cjc@blossom.cjclark.org:/usr/obj/export/stable/src/sys/BLOSSOM i386
	
>Description:
	The FAQ says,

  10.9. How can I setup Ethernet aliases?

  Add netmask 0xffffffff to your ifconfig(8) command-line like the following:

    # ifconfig ed0 alias 204.141.95.2 netmask 0xffffffff

This is incorrect. You use a netmask of 0xffffffff for aliases which
exist on the same logical network as a previously configured address
on the same logical network. The ifconfig(8) manpage gets it right,

     alias   Establish an additional network address for this interface.  This
             is sometimes useful when changing network numbers, and one wishes
             to accept packets addressed to the old interface.  If the address
             is on the same subnet as the first network address for this
             interface, a netmask of 0xffffffff has to be specified.

>How-To-Repeat:
	http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/networking.html#ETHERNET-ALIASES

>Fix:
>Release-Note:
>Audit-Trail:

From: Ceri <setantae@submonkey.net>
To: "Crist J. Clark" <cjc@earthlink.net>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/32373: Bad ifconfig(8) alias advice in FAQ 10.9
Date: Thu, 29 Nov 2001 13:25:15 +0000

 How about this patch ?
 
 Ceri
 
 --- doc/en_US.ISO8859-1/books/faq/book.sgml.old Thu Nov 29 13:18:34 2001
 +++ doc/en_US.ISO8859-1/books/faq/book.sgml     Thu Nov 29 13:23:36 2001
 @@ -8802,10 +8802,15 @@
            <para>How can I setup Ethernet aliases?</para>
          </question><answer>
 
 -          <para>Add <literal>netmask 0xffffffff</literal> to your
 -            &man.ifconfig.8; command-line like the following:</para>
 +          <para>If the alias is on the same subnet as the first address, then add
 +          <literal>netmask 0xffffffff</literal> to your &man.ifconfig.8; command-line
 +          like the following:</para>
 
 -          <screen>&prompt.root; <userinput>ifconfig ed0 alias 204.141.95.2 netmask 0xffffffff</userinput></screen>
 +          <screen>&prompt.root; <userinput>ifconfig ed0 alias 10.20.30.40 netmask 0xffffffff</userinput></screen>
 +
 +         <para>Otherwise, just specify the network address and netmask as usual:</para>
 +
 +         <screen>&prompt.root; <userinput>ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00</userinput</screen>
          </answer>
        </qandaentry>
 

From: Peter Pentchev <roam@ringlet.net>
To: Ceri <setantae@submonkey.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/32373: Bad ifconfig(8) alias advice in FAQ 10.9
Date: Thu, 29 Nov 2001 15:41:01 +0200

 On Thu, Nov 29, 2001 at 05:30:01AM -0800, Ceri wrote:
 > The following reply was made to PR docs/32373; it has been noted by GNATS.
 > 
 >  How about this patch ?
 >  
 >  Ceri
 >  
 >  --- doc/en_US.ISO8859-1/books/faq/book.sgml.old Thu Nov 29 13:18:34 2001
 >  +++ doc/en_US.ISO8859-1/books/faq/book.sgml     Thu Nov 29 13:23:36 2001
 >  @@ -8802,10 +8802,15 @@
 >             <para>How can I setup Ethernet aliases?</para>
 >           </question><answer>
 >  
 >  -          <para>Add <literal>netmask 0xffffffff</literal> to your
 >  -            &man.ifconfig.8; command-line like the following:</para>
 >  +          <para>If the alias is on the same subnet as the first address, then add
 
 Maybe "..as an address already configured on the interface"?
 It is quite possible (and quite common) to configure an Ethernet
 interface with several different addresses on several different subnets.
 
 G'luck,
 Peter
 
 -- 
 I am not the subject of this sentence.

From: Ceri <setantae@submonkey.net>
To: Peter Pentchev <roam@ringlet.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/32373: Bad ifconfig(8) alias advice in FAQ 10.9
Date: Thu, 29 Nov 2001 14:05:42 +0000

 > 
 > Maybe "..as an address already configured on the interface"?
 > It is quite possible (and quite common) to configure an Ethernet
 > interface with several different addresses on several different subnets.
 
 Fair point.
 This one ?
 
 Ceri
 
 --- doc/en_US.ISO8859-1/books/faq/book.sgml.old Thu Nov 29 13:18:34 2001
 +++ doc/en_US.ISO8859-1/books/faq/book.sgml     Thu Nov 29 14:03:37 2001
 @@ -8802,10 +8802,15 @@
            <para>How can I setup Ethernet aliases?</para>
          </question><answer>
 
 -          <para>Add <literal>netmask 0xffffffff</literal> to your
 -            &man.ifconfig.8; command-line like the following:</para>
 +          <para>If the alias is on the same subnet as an address already configured on
 +          the interface, then add <literal>netmask 0xffffffff</literal> to your
 +          &man.ifconfig.8; command-line, as in the following:</para>
 
 -          <screen>&prompt.root; <userinput>ifconfig ed0 alias 204.141.95.2 netmask 0xffffffff</userinput></screen>
 +          <screen>&prompt.root; <userinput>ifconfig ed0 alias 10.20.30.40 netmask 0xffffffff</userinput></screen>
 +
 +         <para>Otherwise, just specify the network address and netmask as usual:</para>
 +
 +         <screen>&prompt.root; <userinput>ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00</userinput</screen>
          </answer>
        </qandaentry>
 

From: Ceri <setantae@submonkey.net>
To: "Bruce A. Mah" <bmah@FreeBSD.ORG>
Cc: Ruslan Ermilov <ru@FreeBSD.ORG>, freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/32373: Bad ifconfig(8) alias advice in FAQ 10.9
Date: Thu, 29 Nov 2001 16:18:15 +0000

 On Thu, Nov 29, 2001 at 07:37:05AM -0800, Bruce A. Mah wrote:
 > If memory serves me right, Ruslan Ermilov wrote:
 > 
 > > Newer ifconfig(8) supports the address/bits syntax.  :-)
 > 
 > You're quite right, but using the "netmask" keyword in the example will
 > ensure that it still works for older versions.  Maybe use the newer 
 > syntax as an alternative?  (I'm not sure whether or not it's worth the 
 > extra space.)
 
 Hmm, I'm not sure that it is (we're not supposed to be duplicating the
 manpages).
 
 Could do with a few more opinions if anybody has them ?
 
 Ceri
 
 -- 
 keep a mild groove on

From: swear@blarg.net (Gary W. Swearingen)
To: "Crist J. Clark" <cjc@earthlink.net>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/32373: Bad ifconfig(8) alias advice in FAQ 10.9
Date: 29 Nov 2001 12:24:29 -0800

 > >Description:
 > 	The FAQ says,
 > 
 >   10.9. How can I setup Ethernet aliases?
 
 Slip in a change of the noun "setup" to the verb "set up"?

From: Ceri Davies <setantae@submonkey.net>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/32373: Bad ifconfig(8) alias advice in FAQ 10.9
Date: Tue, 18 Dec 2001 14:19:29 +0000

 Here you go then:
 
 --- doc/en_US.ISO8859-1/books/faq/book.sgml.orig        Thu Dec 13 13:49:57 2001
 +++ doc/en_US.ISO8859-1/books/faq/book.sgml     Tue Dec 18 14:17:06 2001
 @@ -8926,13 +8926,18 @@
 
        <qandaentry>
          <question id="ethernet-aliases">
 -          <para>How can I setup Ethernet aliases?</para>
 +          <para>How can I set up Ethernet aliases?</para>
          </question><answer>
 
 -          <para>Add <literal>netmask 0xffffffff</literal> to your
 -            &man.ifconfig.8; command-line like the following:</para>
 +          <para>If the alias is on the same subnet as an address already configured on
 +          the interface, then add <literal>netmask 0xffffffff</literal> to your
 +          &man.ifconfig.8; command-line, as in the following:</para>
 
 -          <screen>&prompt.root; <userinput>ifconfig ed0 alias 204.141.95.2 netmask 0xffffffff</userinput></screen>
 +          <screen>&prompt.root; <userinput>ifconfig ed0 alias 10.20.30.40 netmask 0xffffffff</userinput></screen>
 +
 +         <para>Otherwise, just specify the network address and netmask as usual:</para>
 +
 +         <screen>&prompt.root; <userinput>ifconfig ed0 alias 172.16.141.5 netmask 0xffffff00</userinput</screen>
          </answer>
        </qandaentry>
State-Changed-From-To: open->closed 
State-Changed-By: cjc 
State-Changed-When: Mon Feb 18 16:23:38 PST 2002 
State-Changed-Why:  
This had sat around long enough. Going through PR's I had submitted. 
Committed Ceri's last suggestion in the audit trail with one minor 
change. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32373 
>Unformatted:
