Sorry, but I call BS. Before that documentation was added there were multiple comments that the kernel documentation was only the header and that that was incomplete. Those comments were correct - we hadn't seriously expected that so many people would have an interest in writing directly to the ioctls, so documenting them was a lower priority than writing a library that used them.And yes, I'd seen the GPIO Character Device Userspace API kernel docs -- which is why I made the comment that you essentially have to read linux/gpio.h -- the web page is essentially the exact same information included in the header -- just with html formatting. Though the kernel page does have a few expanded definition if you follow the inline links. The kernel docs and the header are about the total of the info you will find.
The headers describe the data types, but they do not describe how the ioctls are to be used. At all. The documentation references the types in the header, cos surprise surprise, those are the types that the ioctls use. I didn't have to include the HTML form of the header types in the docs, but then the reader would've had to manually dig out the header to see what the documentation was referring to. As then there would be complaints about that - and rightfully so.
There really is no pleasing people, particularly Pi users.
Statistics: Posted by warthog618 — Wed May 08, 2024 2:27 am