Re: [Y2038] [PATCH v2 27/27] Documentation: document ioctl interfaces better

2019-12-19 Thread Arnd Bergmann
On Wed, Dec 18, 2019 at 11:45 PM Ben Hutchings wrote: > On Tue, 2019-12-17 at 23:17 +0100, Arnd Bergmann wrote: > > --- /dev/null > > +++ b/Documentation/core-api/ioctl.rst > > +``include/uapi/asm-generic/ioctl.h`` provides four macros for defining > > +ioctl commands that follow modern convention

Re: [Y2038] [PATCH v2 27/27] Documentation: document ioctl interfaces better

2019-12-18 Thread Ben Hutchings
On Tue, 2019-12-17 at 23:17 +0100, Arnd Bergmann wrote: [...] > --- /dev/null > +++ b/Documentation/core-api/ioctl.rst > @@ -0,0 +1,248 @@ > +== > +ioctl based interfaces > +== > + > +ioctl() is the most common way for applications to interface > +with device

[Y2038] [PATCH v2 27/27] Documentation: document ioctl interfaces better

2019-12-17 Thread Arnd Bergmann
Documentation/process/botching-up-ioctls.rst was orignally written as a blog post for DRM driver writers, so it it misses some points while going into a lot of detail on others. Try to provide a replacement that addresses typical issues across a wider range of subsystems, and follows the style of