From owner-cvs-doc@FreeBSD.ORG Tue Dec 5 20:37:40 2006 Return-Path: X-Original-To: cvs-doc@freebsd.org Delivered-To: cvs-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 0CA6116A412; Tue, 5 Dec 2006 20:37:40 +0000 (UTC) (envelope-from SRS0=84b39dd79b6912b603665567b1ac6a342764a380=175=es.net=oberman@es.net) Received: from postal2.es.net (postal2.es.net [198.128.3.206]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7175343CA5; Tue, 5 Dec 2006 20:36:58 +0000 (GMT) (envelope-from SRS0=84b39dd79b6912b603665567b1ac6a342764a380=175=es.net=oberman@es.net) Received: from ptavv.es.net (ptavv.es.net [198.128.4.29]) by postal2.es.net (Postal Node 2) with ESMTP (SSL) id JGQ90638; Tue, 05 Dec 2006 12:37:38 -0800 Received: from ptavv.es.net (localhost [127.0.0.1]) by ptavv.es.net (Tachyon Server) with ESMTP id 251FD45042; Tue, 5 Dec 2006 12:37:38 -0800 (PST) To: Giorgos Keramidas In-Reply-To: Your message of "Tue, 05 Dec 2006 18:12:14 +0200." <20061205161214.GB3357@kobe.laptop> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_1165351058_54673P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Tue, 05 Dec 2006 12:37:38 -0800 From: "Kevin Oberman" Message-Id: <20061205203738.251FD45042@ptavv.es.net> Cc: cvs-all@freebsd.org, Doug Barton , Dmitry Morozovsky , doc-committers@freebsd.org, cvs-doc@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/install chapter.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 05 Dec 2006 20:37:40 -0000 --==_Exmh_1165351058_54673P Content-Type: text/plain; charset=us-ascii Content-Disposition: inline > Date: Tue, 5 Dec 2006 18:12:14 +0200 > From: Giorgos Keramidas > Sender: owner-cvs-all@freebsd.org > > > --VrqPEDrXMn8OVzN4 > Content-Type: text/plain; charset=us-ascii > Content-Disposition: inline > > On 2006-12-05 13:53, Dmitry Morozovsky 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 > > 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 @@ > > > > For example, if you have three dialup customers, > > fred, sam, and > > - mary, that you route class C networks > > + mary, that you route /24 CIDR networks > > for, you would type the following: > > > > &prompt.root; ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-fred > > @@ -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 203.14.101.0 > > - class C via the client's ppp link. > > + /24 CIDR network via the client's ppp link. > > > > 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@es.net Phone: +1 510 486-8634 Key fingerprint:059B 2DDF 031C 9BA3 14A4 EADA 927D EBB3 987B 3751 --==_Exmh_1165351058_54673P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (FreeBSD) Comment: Exmh version 2.5 06/03/2002 iD8DBQFFddiSkn3rs5h7N1ERAj/vAJ0Y4oyWddOv06W1C1QqluEk7yBlUwCgtjR3 JQVMvxVOiXZ0t/njlSyWPeY= =Yg6N -----END PGP SIGNATURE----- --==_Exmh_1165351058_54673P--