[Bug 279249] quotactl(2) out of date w.r.t. ZFS, and missing information

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=279249

            Bug ID: 279249
           Summary: quotactl(2) out of date w.r.t. ZFS, and missing
                    information
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: gray@nxg.name
                CC: doc@FreeBSD.org

The quotactl(2) manpage states bluntly that ‘Currently quotas are supported
only for the "ufs" file system.’ But (a) bug #234413 from 2019/12.0, states
that ‘ZFS implements quotactl(2) as of r336017; the man page needs to be
updated.’ Also (b) quotactl does seem to work when called on a ZFS filesystem.

Though it seems to work, does this work only by accident? (ie, is it going to
stop working unexpectedly?).  It would be good for the manpage to be explicit
about this.

Separately, the manpage doesn't give, or point to, relevant information on how
to interpret the results of the call.  I can call quotactl(2) on a ZFS
filesystem and it produces numbers, which quota.h tells me are in units of disk
blocks, and which are right if the block-size is 512B.  But I can find nothing,
neither in quotactl() nor in ufs/ufs/quota.h, which tells me that
unequivocally, and in a way which I'm confident will work on a pool with a
different ashift value.

-- 
You are receiving this mail because:
You are on the CC list for the bug.