Add a BUGS section that shows that ids that appear to be

negative are now ignored by the quota system and that extremely
large ids may make quotacheck run for a very long time.

Also mention that "options QUOTA" is required for the kernel
to provide quota support.

1 files changed, 12 insertions, 0 deletions

diff --git a/sbin/quotacheck/quotacheck.8 b/sbin/quotacheck/quotacheck.8
index 28ed80b..eed8dbf 100644
--- a/sbin/quotacheck/quotacheck.8
+++ b/sbin/quotacheck/quotacheck.8
@@ -137,6 +137,8 @@ with the variable
 .Ar enable_quotas
 in
 .Pa /etc/rc.conf .
+The kernel must also be built with 
+.Cd "options QUOTA" .
 .Pp
 The
 .Nm
@@ -159,6 +161,7 @@ default file systems
 .Xr quota 1 ,
 .Xr quotactl 2 ,
 .Xr fstab 5 ,
+.Xr rc.conf 5 ,
 .Xr edquota 8 ,
 .Xr fsck 8 ,
 .Xr quotaon 8 ,
@@ -168,3 +171,12 @@ The
 .Nm
 utility appeared in
 .Bx 4.2 .
+.Sh BUGS
+The quota system will ignore UIDs or GIDs that would be negative
+when evaluated as a signed value.
+Typically those types of ids can appear in the file system from NFS
+mounts or archive files from other operating systems.
+Extremely large UIDs or GIDs will cause
+.Nm
+to run for an unreasonable amount of time and also produce extremely
+large quota data files.