cvs commit: doc/en_US.ISO8859-1/books/handbook/install chapter.sgml

[Kevin Oberman]

> Date: Tue, 5 Dec 2006 18:12:14 +0200
> From: Giorgos Keramidas <keramida at freebsd.org>
> Sender: owner-cvs-all at freebsd.org
> 
> 
> --VrqPEDrXMn8OVzN4
> Content-Type: text/plain; charset=us-ascii
> Content-Disposition: inline
> 
> On 2006-12-05 13:53, Dmitry Morozovsky <marck at rinet.ru> wrote:
> > On Mon, 4 Dec 2006, Doug Barton wrote:
> > DB> >   Log:
> > DB> >   A class C network for 192.168.0.0/24 includes the address
> > DB> >   range 192.168.0.0-192.168.0.255, not 192.168.0.0-192.168.255.255
> > DB> >
> > DB> >   Submitted by:   Tom Van Looy <tom at ctors.net>
> > DB>
> > DB> In an ideal world, all references to Class [ABC] networks would
> > DB> disappear from our docs, and be replaced by their CIDR equivalents.
> >
> > There are suprisingly small number of such places.  What do you think about the
> > patch attached?
> 
> I'm not sure I like the appearance of "/24" in flowing text, but the
> patch builds fine.
> 
> > Index: books/handbook/ppp-and-slip/chapter.sgml
> > ===================================================================
> > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
> > retrieving revision 1.173
> > diff -u -r1.173 chapter.sgml
> > --- books/handbook/ppp-and-slip/chapter.sgml	30 May 2006 23:08:24 -0000	1.173
> > +++ books/handbook/ppp-and-slip/chapter.sgml	5 Dec 2006 10:53:35 -0000
> > @@ -760,7 +760,7 @@
> >
> >  	    <para>For example, if you have three dialup customers,
> >  	      <username>fred</username>, <username>sam</username>, and
> > -	      <username>mary</username>, that you route class C networks
> > +	      <username>mary</username>, that you route /24 CIDR networks
> >  	      for, you would type the following:</para>
> >
> >  	    <screen>&prompt.root; <userinput>ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-fred</userinput>
> > @@ -827,7 +827,7 @@
> >  	      should also contain routing information for each static
> >  	      IP user if required.  The line below would add a route
> >  	      for the <hostid role="ipaddr">203.14.101.0</hostid>
> > -	      class C via the client's ppp link.</para>
> > +	      /24 CIDR network via the client's ppp link.</para>
> >
> >  	    <programlisting>fred:
> >    add 203.14.101.0 netmask 255.255.255.0 HISADDR
> 
> Is there any way we can rephrase this to avoid having to use /24 in the
> middle of a sentence.  How do the documentation texts of Cisco and other
> networking-related companies, which have a lot of texts about CIDR
> address ranges, deal with this?

CIDR format is specified as address/length, so 128.0.0.0/18 is the only
sanctioned way to specify this per RFCs. The fact that Cisco routers
still require the crufty masks and wildcard bits not withstanding.

Juniper routers use only proper CIDR syntax.

FreeBSD will accept either for IPv4 (ifconfig(8)).

In the world of IPv6, only CIDR notation is used, even by Cisco.

We really should only be used CIDR notation unless we are explaining the
legacy use of masks. Class A/B/C has been obsolete for almost a decade
and really, really should go away.
-- 
R. Kevin Oberman, Network Engineer
Energy Sciences Network (ESnet)
Ernest O. Lawrence Berkeley National Laboratory (Berkeley Lab)
E-mail: oberman at es.net			Phone: +1 510 486-8634
Key fingerprint:059B 2DDF 031C 9BA3 14A4  EADA 927D EBB3 987B 3751
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 224 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-doc/attachments/20061205/4d632325/attachment.pgp