Date: Fri, 6 Aug 2004 12:50:18 GMT From: Peter Pentchev <roam@ringlet.net> To: freebsd-doc@FreeBSD.org Subject: Re: docs/68746: Virtual hosts documentaion doesn't make clear issues with netmask on adding aliases. Message-ID: <200408061250.i76CoICu093376@freefall.freebsd.org>
index | next in thread | raw e-mail
The following reply was made to PR docs/68746; it has been noted by GNATS. From: Peter Pentchev <roam@ringlet.net> To: Dave Duchscher <daved@tamu.edu> Cc: bug-followup@FreeBSD.org Subject: Re: docs/68746: Virtual hosts documentaion doesn't make clear issues with netmask on adding aliases. Date: Fri, 6 Aug 2004 15:46:38 +0300 On Wed, Jul 07, 2004 at 01:27:16AM +0000, Dave Duchscher wrote: > > >Number: 68746 > >Category: docs > >Synopsis: Virtual hosts documentaion doesn't make clear issues with netmask on adding aliases. [snip] > >Description: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-virtual-hosts.html > > IMHO, this document does make clear the subtle issues with netmasks when > setting up aliases. As you know, aliases on the same network as the > primary interface need a netmask of 255.255.255.255. The first alias on > a different network needs the correct netmask. Additional aliases need to > have 255.255.255.255. IMHO, I think this document should cover these > subtle issues with netmasks in more detail. What do people think about the following patch? G'luck, Peter Index: doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v retrieving revision 1.163 diff -u -r1.163 chapter.sgml --- doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml 5 Aug 2004 10:04:29 -0000 1.163 +++ doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml 6 Aug 2004 12:29:18 -0000 @@ -1137,7 +1137,9 @@ fortunately quite simple. For a given interface, there must be one address which correctly represents the network's netmask. Any other addresses which fall within this network must have a - netmask of all <literal>1</literal>s.</para> + netmask of all <literal>1</literal>s (expressed as either + <literal>255.255.255.255</literal> or <literal>0xffffffff</literal>). + </para> <para>For example, consider the case where the <devicename>fxp0</devicename> interface is @@ -1148,7 +1150,15 @@ We want the system to appear at <hostid role="ipaddr">10.1.1.1</hostid> through <hostid role="ipaddr">10.1.1.5</hostid> and at <hostid role="ipaddr">202.0.75.17</hostid> through - <hostid role="ipaddr">202.0.75.20</hostid>.</para> + <hostid role="ipaddr">202.0.75.20</hostid>. As noted above, only the + first address in a given network range (in this case, + <hostid role="ipaddr">10.0.1.1</hostid> and + <hostid role="ipaddr">202.0.75.17</hostid>) should have a real + netmask; all the rest (<hostid role="ipaddr">10.1.1.2</hostid> + through <hostid role="ipaddr">10.1.1.5</hostid> and + <hostid role="ipaddr">202.0.75.18</hostid> through + <hostid role="ipaddr">202.0.75.20</hostid>) must be configured with a + netmask of <literal>255.255.255.255</literal>.</para> <para>The following entries configure the adapter correctly for this arrangement:</para> -- Peter Pentchev roam@ringlet.net roam@cnsys.bg roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 .siht ekil ti gnidaer eb d'uoy ,werbeH ni erew ecnetnes siht fIhome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200408061250.i76CoICu093376>