Date: Wed, 8 May 2002 03:30:03 -0700 (PDT) From: Peter Pentchev <roam@ringlet.net> To: freebsd-doc@FreeBSD.org Subject: Re: docs/37839: Improve man page for quotactl(2) Message-ID: <200205081030.g48AU3k69254@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/37839; it has been noted by GNATS. From: Peter Pentchev <roam@ringlet.net> To: "Michael R. Wayne" <wayne@staff.msen.com> Cc: bug-followup@FreeBSD.org Subject: Re: docs/37839: Improve man page for quotactl(2) Date: Wed, 8 May 2002 13:21:04 +0300 On Tue, May 07, 2002 at 10:46:20AM -0700, Michael R. Wayne wrote: > > >Number: 37839 > >Category: docs > >Synopsis: Improve man page for quotactl(2) > >Originator: Michael R. Wayne > >Description: > The documentation for quotactl is not specific enough to avoid confusion. > This became clear when quotas inadvertently became disabled on a filesystem > and quotactl failed with EINVAL. Several people on -hackers had speculations, > none were accurate. > The current man page states > Cmd or the command type is invalid > But this does not accurately reflect the code. > >How-To-Repeat: > See above. > >Fix: > Apply the following 1 line patch: > > *** /usr/src/lib/libc/sysquotactl.2.ORIG Tue May 7 13:41:19 2002 > --- /usr/src/lib/libc/sysquotactl.2 Tue May 7 13:41:39 2002 > *************** > *** 166,171 **** > --- 166,172 ---- > .It Bq Er EINVAL > .Fa Cmd > or the command type is invalid. > + Q_GETQUOTA returns EINVAL if quotas are not currently enabled for this filesystem. > .It Bq Er EACCES > In > .Dv Q_QUOTAON , How about the attached little improvement to the mark-up? Other than that, your wording sounds right to me. G'luck, Peter -- Peter Pentchev roam@ringlet.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 The rest of this sentence is written in Thailand, on Index: src/lib/libc/sys/quotactl.2 =================================================================== RCS file: /home/ncvs/src/lib/libc/sys/quotactl.2,v retrieving revision 1.17 diff -u -r1.17 quotactl.2 --- src/lib/libc/sys/quotactl.2 1 Oct 2001 16:09:02 -0000 1.17 +++ src/lib/libc/sys/quotactl.2 8 May 2002 10:17:23 -0000 @@ -166,6 +166,10 @@ .It Bq Er EINVAL .Fa Cmd or the command type is invalid. +.Dv Q_GETQUOTA +returns +.Er EINVAL +if quotas are not currently enabled for this filesystem. .It Bq Er EACCES In .Dv Q_QUOTAON , To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200205081030.g48AU3k69254>