Re: quotactl(2) (was: [PATCH v2] man/man2: introduce man page for file_getattr/file_setattr syscalls)

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 1899 bytes --]

Hey Darrick,

> Date: 2026-09-15 11:10:47-0700
> From: "Darrick J. Wong" <djwong@kernel.org>
>
> On Fri, Sep 11, 2026 at 12:38:23AM +0200, Alejandro Colomar wrote:
> > [CC trimmed]
> > 
> > Hi Darrick,
> > 
> > > > Date: 2026-09-10 09:44:28-0700
> > > > From: "Darrick J. Wong" <djwong@kernel.org>
> > > >
> > > > quotactl (and xattrs) have a similar weird history of originating in XFS
> > > > and later getting yanked into the vfs.  Every time I have to go look up
> > > > the quota syscalls I just get a headache. :/
> > 
> > I have recently worked on having quotactl(2) split into more organized
> > manual pages.  This has been part of the man-pages-6.19 release.
> > Have you had a look at these manual pages after that change?  Did the
> > headache experience improve (or worsen) after this change?
> > 
> > Michael's man7.org already includes the latest version:
> > <https://www.man7.org/linux/man-pages/man2/quotactl.2.html>
> > 
> > I'd welcome feedback, and any improvements or suggestions to improve
> > the pages.
> 
> Oh hey, that /is/ a lot better!

Thanks!!  Michael didn't like these splitting changes at first (I don't
know if I've convinced him yet), but it's good to see users that like
the change.  :-)

> The only addition I can think of is that QUOTAOFF generally isn't
> supported anymore.

Oh, thanks!  I can add a note that it's deprecated.  If you want to add
a more specific note saying it fails for new kernels, I'd need some
information for preparing a patch:

-  Is it reporting an error?
-  If so, which error?
-  Which kernel version dropped support?
-  You said 'generally'.  In which cases is it still supported?
-  Any other ideas about it?

> Thanks for breaking up that big messy manpage. :)

Thank you for liking it!  :)


Have a lovely night!
Alex

> 
> --D

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]