Date: Sun, 10 Aug 1997 03:52:45 GMT From: doogie@anet-stl.com To: FreeBSD-gnats-submit@FreeBSD.ORG Subject: docs/4261: quotactl manpage is misleading; correct bad references Message-ID: <199708100352.DAA26899@forbidden-donut.anet-stl.com> Resent-Message-ID: <199708100900.CAA11640@hub.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 4261
>Category: docs
>Synopsis: quotactl manpage is misleading; correct bad references
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-bugs
>State: open
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sun Aug 10 02:00:08 PDT 1997
>Last-Modified:
>Originator: doogie@anet-stl.com
>Organization:
ANET St. Louis
>Release: FreeBSD 3.0-CURRENT i386
>Environment:
The quotactl() function call appeared in 4.3BSD-Reno.
>Description:
The quotactl manpage is misleading about what to supply for a second
argument. It lists several possible arguments but mentions only very
vaguely that these may need to be combined using the QCMD macro in
/usr/include/ufs/ufs/quota.h, with USRQUOTA or GRPQUOTA.
Also it references <ufs/quota.h> in a few places, when it should mention
<ufs/ufs/quota.h>.
>How-To-Repeat:
Try to code something using quotactl based on the manpage. Ugh.
>Fix:
Include something like this on the manpage:
"The Q_GETQUOTA, Q_SETQUOTA and Q_SETUSE commands must be used in
conjunction with the QCMD macro and the definitions USRQUOTA and GRPQUOTA
(defined in <ufs/ufs/quota.h>) to specify operations involving user and
group quotas, respectively. See ufs/ufs/quota.h for details.
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199708100352.DAA26899>