From owner-freebsd-doc Sun Jan 6 5:10: 8 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 54E0E37B402 for ; Sun, 6 Jan 2002 05:10:02 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g06DA2V12308; Sun, 6 Jan 2002 05:10:02 -0800 (PST) (envelope-from gnats) Date: Sun, 6 Jan 2002 05:10:02 -0800 (PST) Message-Id: <200201061310.g06DA2V12308@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Giorgos Keramidas Subject: Re: docs/33043: Minor changes to Chapter 3 of the handbook. Reply-To: Giorgos Keramidas Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/33043; it has been noted by GNATS. From: Giorgos Keramidas To: Ashley Penney Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/33043: Minor changes to Chapter 3 of the handbook. Date: Sun, 6 Jan 2002 03:19:08 +0200 On 2001-12-20 17:07:21, Ashley Penney wrote: > > I felt the documentation in 3.4.1 for the fstab fields wasn't as > complete towards the end as it should be, two entries were rolled > into one. > >Fix: > --- chapter.sgml.old Thu Dec 20 20:00:39 2001 > +++ chapter.sgml Thu Dec 20 20:06:14 2001 > @@ -535,10 +535,19 @@ > > dumpfreq > > - The number of days the filesystem should be > - dumped, and passno is the pass number > - during which the filesystem is checked during the boot > - sequence. > + This is used by dump to determine which > + filesystems require dumping. If the field is missing, > + a value of zero is assumed. > + > + > + > + > + passno > + > + This determines the order in which filesystems > + should be checked. The root filesystem should be set to one, > + other filesystems to two, and filesystems that should be > + skipped set to zero. I am still catching up with my mail, so if this has already been committed please pardon me. Ashley, this looks nice. Do you think we could add a bit to passno's description that would explain why the ``magical'' values of 1 and 2 should be used? Perhaps something like: This determines the order in which filesystems should be checked. Filesystems that should be skipped should have their passno set to zero. The root filesystem (which needs to be checked before everything else) should have it's passno set to one, and other filesystems' passno should be set to values greater than one. If more than one filesystems have the same passno then &man.fsck.8; will attempt to check filesystems in parallel if possible. Does this look any better, Ashley? Other suggestions anyone? -giorgos PS: I know that the manpage of fstab(5) uses the ``magical'' values of 1 and 2 too. A quick glance to the src/sbin/fsck sources and I see that there is nothing magical about 2. Perhaps we should also change fstab.5 to read "greater than one" instead of 2. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message