Date: Sun, 6 Jan 2002 05:10:02 -0800 (PST) From: Giorgos Keramidas <charon@labs.gr> To: freebsd-doc@freebsd.org Subject: Re: docs/33043: Minor changes to Chapter 3 of the handbook. Message-ID: <200201061310.g06DA2V12308@freefall.freebsd.org>
index | next in thread | raw e-mail
The following reply was made to PR docs/33043; it has been noted by GNATS.
From: Giorgos Keramidas <charon@labs.gr>
To: Ashley Penney <ashp@unloved.org>
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 @@
> <varlistentry>
> <term><literal>dumpfreq</literal></term>
>
> - <listitem><para>The number of days the filesystem should be
> - dumped, and <literal>passno</literal> is the pass number
> - during which the filesystem is checked during the boot
> - sequence.</para>
> + <listitem><para>This is used by dump to determine which
> + filesystems require dumping. If the field is missing,
> + a value of zero is assumed.</para>
> + </listitem>
> + </varlistentry>
> +
> + <varlistentry>
> + <term><literal>passno</literal></term>
> +
> + <listitem><para>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:
<listitem>
<para>This determines the order in which filesystems should
be checked. Filesystems that should be skipped should
have their <literal>passno</literal> set to zero. The
root filesystem (which needs to be checked before
everything else) should have it's
<literal>passno</literal> set to one, and other
filesystems' <literal>passno</literal> should be set to
values greater than one. If more than one filesystems
have the same <literal>passno</literal> then &man.fsck.8;
will attempt to check filesystems in parallel if
possible.</para>
</listitem>
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
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200201061310.g06DA2V12308>