Bug 79117 - errors in quotacheck man page
errors in quotacheck man page
Product: Red Hat Linux
Classification: Retired
Component: quota (Show other bugs)
i386 Linux
medium Severity low
: ---
: ---
Assigned To: Steve Dickson
Brock Organ
Depends On:
  Show dependency treegraph
Reported: 2002-12-05 17:51 EST by Chris Ricker
Modified: 2007-04-18 12:48 EDT (History)
3 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2005-05-09 11:48:39 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description Chris Ricker 2002-12-05 17:51:28 EST
The quotacheck.8 man page states:

quotacheck  expects  each filesystem  to  be  checked to have quota files named
[a]quota.user and [a]quota.group located at the root of the associated
filesystem.  If  a file is not present, quotacheck will create it.

This is incorrect. To create the new quotafiles, you have to use the -c option
with quotacheck:

quotacheck -c /home

for example

The documentation of the -c option in the man page states that

       -c     Don't  read  existing  quota  files. Just perform a new scan and
              save it to disk.  quotacheck also skips scanning  of  old  quota
              files when they are not found.

Some place in that man page, it really needs to point out that creation of quota
files is done by quotacheck -c
Comment 1 Johan Leckstrom 2002-12-13 18:41:39 EST
The Redhat manual should also be changed.
"Red Hat Linux 8.0: The Official Red Hat Linux System Administration Primer"
Comment 2 Chris Negus 2003-01-17 05:02:30 EST
checkquota -c seems to only create the aquota.user file and not the aquota.group
file. If you run "quotacheck -vg /home" to scan the partition, you get the error
message "quotacheck: Cannot get quotafile name for /dev/hd??"." It works just to
touch an aquota.group file, but you still get an error message the first time
you run checkquota -vg to scan the partition for disk usage.
Comment 3 Scott R. Godin 2003-02-09 10:42:11 EST
Additionally, at the top of the quotacheck(8) man page, there is this thoroughly
ambiguous sentence: 

    "It  is strongly recommended to run quotacheck with quotas turned off on for
the filesystem."

Well, which is it? off or on? :) 

Comment 4 Chris Ricker 2005-05-09 11:48:15 EDT
This more or less is all good now. quotacheck /foo creates /foo/aquota.user
automagically, and quotacheck -g /foo creates /foo/aquota.group. Comment #3
fixed as well

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