From owner-freebsd-questions Fri Apr 20 22:41:42 2001 Delivered-To: freebsd-questions@freebsd.org Received: from linif.org (www.linif.org [204.228.204.28]) by hub.freebsd.org (Postfix) with SMTP id 151CE37B423 for ; Fri, 20 Apr 2001 22:41:25 -0700 (PDT) (envelope-from dotslash@linif.org) Received: (qmail 8646 invoked from network); 21 Apr 2001 05:41:13 -0000 Received: from unknown (HELO cpu563) (195.229.53.55) by www.linif.org with SMTP; 21 Apr 2001 05:41:13 -0000 Message-ID: <010601c0ca25$879c44e0$2903010a@atg.altayer.com> From: "dotslash" To: , "Greg Lehey" References: <20010421000204.7BB2E37B43E@hub.freebsd.org> Subject: Re: "The Complete FreeBSD", third edition: errata and addenda Date: Sat, 21 Apr 2001 09:08:40 +0400 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.50.4522.1200 X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4522.1200 Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG i keep seeing this book as one of the recommended books aside from the handbook but there are no sample chapters nor table of contents from which one can have an idea what is covered. is this book only basic fbsd or will it be usable for intermediate fbsd users? ----- Original Message ----- From: "Greg Lehey" To: Sent: Saturday, April 21, 2001 4:02 AM Subject: "The Complete FreeBSD", third edition: errata and addenda > > > > > > > > > Errata and addenda for the Complete FreeBSD, third edition > > > > > Last revision: 2 August 1999 > > The trouble with books is that you can't update them the way you can a web page > or any other online documentation. The result is that most leading edge > computer books are out of date almost before they are printed. Unfortunately, > ``The Complete FreeBSD'', published by Walnut Creek, is no exception. In- > evitably, a number of bugs and changes have surfaced. > > The following is a list of modifications which go beyond simple typos. They > relate to the third edition, formatted on 17 May 1999. You'll find this > information on page iv (the page before the beginning of the Table of > Contents). See the end of this document for instructions on how to find the > errata for an older version. > > You can get the current document in four forms: > > o A PostScript version, suitable for printing out, at > ftp://ftp.lemis.com/pub/cfbsd/errata-3.ps. See page 302 of the third edition > to find out how to print out PostScript. If at all possible, please take > this document: it's closest to the original text. > > Be careful selecting this file with a web browser: it is often impossible to > reload the document, and you may see a previously cached version. > > o An enhanced ASCII version at ftp://ftp.lemis.com/pub/cfbsd/errata-3.txt. When > viewed with more or less, this version will show some highlighting and > underlining. It's not suitable for direct viewing. > > o An ASCII-only version at ftp://ftp.lemis.com/pub/cfbsd/errata-3.ascii. This > version is posted every week to the FreeBSD-questions mailing list. Only > take this version if you have real problems with PostScript: I can't be sure > that the lack of different fonts won't confuse the meaning. > > o A web version at http://www.lemis.com/errata-3.html. > > All these modifications have been applied to the ongoing source text of the > book, so if you buy a later edition, they will be in it as well. If you find a > > Page 1 > > > > > > > The Complete FreeBSD > > > bug or a suspected bug in the book, please contact me at > > Page ii > _______ > > The instructions on page ii (opposite the title page) tell you to look at > ftp://ftp.lemis.com/pub/cfbsd/errata-2 for the errata list. That's wrong. > Look at this list. > > Pages 190 and 191 > _________________ > > The description is not very clear about which text appears when booting from > floppy for initial install, and which appears when booting normally. The > procedure is very similar, but there are some differences. Add the following > text after the heading Boot messages: > > You'll boot your system in at least two different ways: initially you'll boot > from floppy or CD-ROM in order to install the system. Later, after the system > is installed, you'll boot from hard disk. The procedure is almost identical, > so we'll look at both versions in the following examples. > > Replace the text from the middle of page 191 with: > > If you're booting from 1.44 MB floppies, you will then see: > > Please insert MFS root floppy and press enter: > > When you insert the MFS root floppy and press Enter, you see more twirling > batons, then the UserConfig screen appears. > > UserConfig: Modifying the boot configuration > ____________________________________________ > > After the kernel has been loaded, the following screen will appear if you are > installing the system, or if you have requested it with the -c option to the > boot loader: > > Page 206 > ________ > > The bottom two lines on this page should be in bold constant font, indicating > that this is input for your /etc/rc.config file > > > Page 2 > > > > > > > Errata and addenda for the Complete FreeBSD, third edition > > > nfs_client_enable="YES" # This host is an NFS client (or NO). > nfs_server_enable="YES" # This host is an NFS server (or NO). > > > Page 265 > ________ > > The example on the second half of the page refers to the old SCSI driver. The > scsi program is no longer available in FreeBSD 3.x. Instead, use the > camcontrol program. Replace the text with:. > > Modern disks make provisions for recovering from such errors by allocating an > alternate sector for the data. IDE drives do this automatically, but with SCSI > drives you have the option of enabling or disabling reallocation. Usually it > is turned on when you buy them, but occasionally it is not. When installing a > new disk, you should check that the parameters ARRE (Auto Read Reallocation > Enable) and AWRE (Auto Write Reallocation Enable) are turned on. For example, > to check and set the values for disk da1, you would enter: > > # camcontrol modepage da1 -m 1 -e -P 3 > # scsi -f /dev/rda1c -m 1 -e -P 3 > > This command will start up your favourite editor (either the one specified in > the EDITOR environment variable, or vi by default) with the following data: > > AWRE (Auto Write Reallocation Enbld): 0 > ARRE (Auto Read Reallocation Enbld): 1 > TB (Transfer Block): 0 > RC (Read Continuous): 0 > EER (Enable Early Recovery): 0 > PER (Post Error): 0 > DTE (Disable Transfer on Error): 0 > DCR (Disable Correction): 0 > Read Retry Count: 16 > Correction Span: 41 > Head Offset Count: 0 > Data Strobe Offset Count: 0 > Write Retry Count: 16 > Recovery Time Limit: 0 > > The values for AWRE and ARRE should both be 1. If they aren't, as in this > case, where AWRE is 0, change the data with the editor, save it, and exit. The > camcontrol program will write the data back to the disk and enable the option. > > > Page 3 > > > > > > > The Complete FreeBSD > > > Page 331 > ________ > > The description of the config refers to the SCSI drive sd0. This is the old > name; in FreeBSD version 3, SCSI drives are called da, so this reference should > be da0. > > Thanks to Francisco Reyes for pointing out this > problem. > > Page 362 > ________ > > Replace the text at the top of the page with: > > Next, change to the build directory and build the kernel: > > # cd ../../compile/FREEBIE > # make depend > # make > > The make depend is needed even if the directory has just been created: > apart from creating dependency information, it also creates some files > needed for the build. > Thanks to Mark Ovens for drawing this to my attention, > and to Francisco Reyes and Bill Fumerola > for pointing out that it still wasn't fixed in the > third edition. > > Page 409 > ________ > > The information on setting the default routers specified the wrong end of the > PPP links in some places. It should always be the ``far'' end of the link. > Replace the second example on page 409, and the text following it, with this > text: > > defaultrouter="139.130.136.129" # Set to default gateway (or NO). > static_routes="" # Set to static route list (or leave empty). > gateway_enable="YES" # Set to YES if this host will be a gateway. > > This is the normal way to set the default route on a point-to-point interface. > In fact, for PPP you don't need to specify the default address: the PPP > packages will set it for you when the link comes up. This makes it possible to > > Page 4 > > > > > > > Errata and addenda for the Complete FreeBSD, third edition > > > set default routes when you're forced to use dynamic IP addresses, where you > don't know the address at this point. We'll see how PPP does this on page 446. > > In the first example on page 410, the sixth example on page 412 and the second > example on page 413, replace the defaultrouter definition with: > > > defaultrouter="139.130.237.65" # Set to default gateway (or NO). > > > Thanks to Andreas Longwitz for pointing out this error. > > Getting errata for older editions of the book > _____________________________________________ > > There have been a total of five different versions of ``The Complete FreeBSD''. > The most accurate way to distinguish them is by the format date, which you'll > find at the bottom of page iv (the page before the beginning of the Table of > Contents) in all versions of the book. > > 1. The first was titled ``Installing and running FreeBSD'', and was formatted > on 24 February 1996. No errata list exists for this book. > > 2. For the first edition (19 July 1996), get ftp://ftp.lemis.com/pub/cfbsd/er- > rata-1. This same file is also available via the web link > http://www.lemis.com/errata-1. I am no longer updating this errata list. > > 3. The list for the second edition (16 December 1997) is available in four > forms: > > o A PostScript version, suitable for printing out, at > ftp://ftp.lemis.com/pub/cfbsd/errata-2.ps. See page 222 of the second > edition to find out how to print out PostScript. If at all possible, > please take this document: it's closest to the original text. > > Be careful selecting this file with a web browser: it is often impossible > to reload the document, and you may see a previously cached version. > > o An enhanced ASCII version at ftp://ftp.lemis.com/pub/cfbsd/errata-2.txt. > When viewed with more or less, this version will show some highlighting and > underlining. It's not suitable for direct viewing. > > o An ASCII-only version at ftp://ftp.lemis.com/pub/cfbsd/errata-2.ascii. This > version is posted every week to the FreeBSD-questions mailing list. Only > > Page 5 > > > > > > > Getting errata for older editions of the book > > > take this version if you have real problems with PostScript: I can't be > sure that the lack of different fonts won't confuse the meaning. > > o A web version at http://www.lemis.com/errata-2.html. > > 4. The revised second edition was formatted on 11 February 1999. As the name > suggests, it's not a complete new edition: in fact, only three chapters are > different: > > o The chapter ``Setting up X11'' has been brought up to date. > > o Appendix D (``Contents of the Ports Collection'') has been replaced by two > appendixes, ``Errata and Addenda'' (the errata list up to date at the time) > and ``FreeBSD 3.0'', which describes the differences between FreeBSD 2.x > and FreeBSD 3.x. > > There is no separate errata list for this book. Refer to the second edition > errata list. > > 5. The current, third edition, formatted on 17 May 1999. This is the correct > list for this edition. > > > > > > > > > > > > > > > > > > > > > > > > > Page 6 > > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-questions" in the body of the message To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message