doc: ioctl: Add some clarifications to botching-up-ioctls
authorLaura Abbott <labbott@redhat.com>
Fri, 2 Sep 2016 22:42:24 +0000 (15:42 -0700)
committerJonathan Corbet <corbet@lwn.net>
Tue, 6 Sep 2016 12:00:22 +0000 (06:00 -0600)
commitc6517b78153a1ffb401d8c3ec329effd3ee19036
tree598ddd92e822e0734348d4d74dca2073182f82d3
parent951499710be258b85c135ee1f7ebe5f7a4b7ac91
doc: ioctl: Add some clarifications to botching-up-ioctls

- The guide currently says to pad the structure to a multiple of
  64-bits. This is not necessary in cases where the structure contains
  no 64-bit types. Clarify this concept to avoid unnecessary padding.
- When using __u64 to hold user pointers, blindly trying to do a cast to
  a void __user * may generate a warning on 32-bit systems about a cast
  from an integer to a pointer of different size. There is a macro to
  deal with this which hides an ugly double cast. Add a reference to
  this macro.

Signed-off-by: Laura Abbott <labbott@redhat.com>
Acked-by: Arnd Bergmann <arnd@arndb.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/ioctl/botching-up-ioctls.txt