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

[bugzilla-noreply]

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

--- Comment #2 from Norman Gray  ---
(by 'this call', I mean a call to quotatcl with cmd=Q_GETQUOTA)

-- 
You are receiving this mail because:
You are the assignee for the bug.

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

[bugzilla-noreply]

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

Norman Gray  changed:

   What|Removed |Added

Product|Documentation   |Base System
  Component|Manual Pages|kern
Version|Latest  |14.0-RELEASE

--- Comment #1 from Norman Gray  ---
On reflection, and after failing to uncover any information on this on forums
or lists, I'm proposing changing this to be a 'base system' bug rather than
'merely' a documentation bug.

On the grounds that if something isn't documented, then it doesn't really
exist, if it's not knowable what the units are, in the response to the
quotactl(2) call, then one can claim that this call produces no information,
and thus in a sense does not work.

-- 
You are receiving this mail because:
You are the assignee for the bug.

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

[bugzilla-noreply]

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: b...@freebsd.org
  Reporter: g...@nxg.name
CC: d...@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 the assignee for the bug.