Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 3 Jul 1999 01:36:14 -0700 (PDT)
From:      <grog@FreeBSD.org>
To:        FreeBSD-questions@FreeBSD.org
Subject:   "The Complete FreeBSD", third edition: errata and addenda
Message-ID:  <199907030836.BAA51116@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help








          Errata and addenda for the Complete FreeBSD, third edition




                          Last revision: 3 July 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 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-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 <grog@FreeBSD.org.>

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


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
    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.



Page 4






                     Errata and addenda for the Complete FreeBSD, third edition


  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 5





To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-questions" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199907030836.BAA51116>