Bug 394031 - Ambiguous text in tune2fs man page
Summary: Ambiguous text in tune2fs man page
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Fedora
Classification: Fedora
Component: e2fsprogs
Version: 8
Hardware: i386
OS: Linux
low
low
Target Milestone: ---
Assignee: Oliver Falk
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2007-11-21 12:10 UTC by Fred New
Modified: 2007-11-30 22:12 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2007-11-21 12:37:28 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

Description Fred New 2007-11-21 12:10:13 UTC
Description of problem:

Near the top of the man page, we see the following text:

"-c max-mount-counts
       Adjust the number of mounts after which the filesystem  will  be
       checked  by e2fsck(8).  If max-mount-counts is 0 or -1, the num-
       ber of times the filesystem is mounted will  be  disregarded  by
       e2fsck(8) and the kernel."

If my max-mount-counts is 0 or -1, will the system check my filesystem at the
next boot, or not?  Is there a default action defined for when e2fsck and the
kernel disregard the number of filesystem mounts?


Version-Release number of selected component (if applicable):
e2fsprogs-1.40.2-10.fc8  (But I see similar text on RHEL systems.)

Comment 1 Oliver Falk 2007-11-21 12:37:28 UTC
(In reply to comment #0)
> Description of problem:
> 
> Near the top of the man page, we see the following text:
> 
> "-c max-mount-counts
>        Adjust the number of mounts after which the filesystem  will  be
>        checked  by e2fsck(8).  If max-mount-counts is 0 or -1, the num-
>        ber of times the filesystem is mounted will  be  disregarded  by
>        e2fsck(8) and the kernel."
> 
> If my max-mount-counts is 0 or -1, will the system check my filesystem at the
> next boot, or not?  Is there a default action defined for when e2fsck and the
> kernel disregard the number of filesystem mounts?

Well, you should have better asked that on the m/l instead of opening bz. However.

I've never used -1, but for 0 I know, the mount-count is ignored and the system
will never do a fsck - if the system is shut down cleanly. If the system
crashes, that's a total other story...

However. If you want to force a filesystem check at some reboot, you usually
should touch /forcefsck. I never used that but I guess it will work... :-)

Comment 2 Fred New 2007-11-21 12:56:41 UTC
The idea here was to get the text fixed, not to just get the answer to my
questions.  Although, filing this bug in the upstream bugzilla might have been
more useful.

Comment 3 Oliver Falk 2007-11-21 13:12:57 UTC
Of course. If you want such a change, you better file a bug upstream. Although I
think the man-page is quite clear...

Comment 4 Fred New 2007-11-21 13:48:47 UTC
Yes, I see what the man page means now.  For me it is unclear because when I use
"dumpe2fs -h /dev/...", I see

<snip>
Mount count:              10
Maximum mount count:      -1
<snip>

To me, the tune2fs man page says that it will disregard the 10 (mount count) and
substitute something like -99999 or 99999.  But what it really means is that
"the mount count test won't be used to determine whether e2fsck will be run."

Comment 5 Oliver Falk 2007-11-21 16:09:02 UTC
Yes. That does it mean. :-)


Note You need to log in before you can comment on or make changes to this bug.