Package: debian-reference
Version: 2.46
Severity: normal

Hello Osamu,

In your very excellent manual here:

  
http://www.debian.org/doc/manuals/debian-reference/ch05.en.html#_the_network_interface_with_the_static_ip

The examples for setting up static address assignments include a
'broadcast' statement in addition to the 'netmask' statement.  The
example is great but could be improved by removing the broadcast
statement since it can be calculated from the netmask.

In the example you include the following:

  allow-hotplug eth0
  iface eth0 inet static
    address 192.168.11.100
    netmask 255.255.255.0
    broadcast 192.168.11.255
    gateway 192.168.11.1
    dns-domain lan
    dns-nameservers 192.168.11.1

1. I see that you have included the broadcast address statement in
   addition to the netmask statement.  I used to do that too because
   the ifupdown examples included the broadcast statement.  Since
   ifupdown's examples had them I used them.  But needing to manually
   calculate the broadcast address was always a drudgery.  But if the
   tool needed it then I was going to do it.  I thought the tool
   needed it because it was provided in the examples.

   But it has come to my attention that these are not needed.  It was
   only an example.  I had been calculating the broadcast address
   manually all along and it is not needed.  Reference this bug report
   for ifupdown where the broadcast statements have been removed from
   the examples included with ifupdown.

     http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=630551

   For this reason I think it would improve the documentation if the
   broadcast statements were removed from the examples in the Debian
   Reference too.

2. The example domain used is "lan".  That is a perfectly fine local
   private domain name.  But I am not sure it is illustrative of the
   general case very well.  I feel more uncertain proposing this.  But
   would "example.com" be a better choice there?  Here I sneak this
   second issue into the same bug report because it is in the same
   area, is very small, and if you disagree it is fine with me if the
   current text is left remaining.  But I can still mention it in
   passing as a possible improvement in that area.

Thank you again for maintaining the Debian Reference manual!  It is a
very useful reference.

Bob



-- 
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]

Reply via email to