firewire: cdev: add_descriptor documentation fix
PATCH 1/1 firewire: cdev: add_descriptor documentation fix
struct fw_cdev_add_descriptor.length is in quadlets, not in bytes. Also remove any doubts about the endianess of descriptor data.
Signed-off-by Stefan Richter <[email protected]>
--- include/linux/firewire-cdev.h | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
include/linux/firewire-cdev.h +3 -1
@@ -369,42 +369,44 @@ struct fw_cdev_deallocate {* * Initiate a bus reset for the bus this device is on. The bus reset can be * either the original (long) bus reset or the arbitrated (short) bus reset * introduced in 1394a-2000. */ struct fw_cdev_initiate_bus_reset {__u32 type;/* FW_CDEV_SHORT_RESET or FW_CDEV_LONG_RESET */ };/** * struct fw_cdev_add_descriptor - Add contents to the local node's config ROM * @immediate: If non-zero, immediate key to insert before pointer * @key: Upper 8 bits of root directory pointer * @data: Userspace pointer to contents of descriptor block -* @length: Length of descriptor block data, in bytes +* @length: Length of descriptor block data, in quadlets * @handle: Handle to the descriptor, written by the kernel * * Add a descriptor block and optionally a preceding immediate key to the local * node's configuration ROM. * * The @key field specifies the upper 8 bits of the descriptor root directory * pointer and the @data and @length fields specify the contents. The @key * should be of the form 0xXX000000. The offset part of the root directory entry * will be filled in by the kernel. * * If not 0, the @immediate field specifies an immediate key which will be * inserted before the root directory pointer. * +* @immediate, @key, and @data array elements are CPU-endian quadlets. +* * If successful, the kernel adds the descriptor and writes back a handle to the * kernel-side object to be used for later removal of the descriptor block and * immediate key. * * This ioctl affects the configuration ROMs of all local nodes. * The ioctl only succeeds on device files which represent a local node. */ struct fw_cdev_add_descriptor {__u32 immediate;__u32 key;__u64 data;__u32 length;__u32 handle; };
Signature · 3 lines
Stefan Richter -=====-==-=- ---= ==--- http://arcgraph.de/sr/