ethtool: Expand documentation of struct ethtool_perm_addr
authorBen Hutchings <ben@decadent.org.uk>
Wed, 12 Feb 2014 22:14:48 +0000 (22:14 +0000)
committerDavid S. Miller <davem@davemloft.net>
Wed, 12 Feb 2014 22:33:03 +0000 (17:33 -0500)
Signed-off-by: Ben Hutchings <ben@decadent.org.uk>
Signed-off-by: David S. Miller <davem@davemloft.net>
include/uapi/linux/ethtool.h

index e96aec0bf7c118dc89d6a25a811483c58c643072..79be416f03e63f7ba214f381cc355ef95c9cde4b 100644 (file)
@@ -614,8 +614,19 @@ struct ethtool_stats {
        __u64   data[0];
 };
 
+/**
+ * struct ethtool_perm_addr - permanent hardware address
+ * @cmd: Command number = %ETHTOOL_GPERMADDR
+ * @size: On entry, the size of the buffer.  On return, the size of the
+ *     address.  The command fails if the buffer is too small.
+ * @data: Buffer for the address
+ *
+ * Users must allocate the buffer immediately following this structure.
+ * A buffer size of %MAX_ADDR_LEN should be sufficient for any address
+ * type.
+ */
 struct ethtool_perm_addr {
-       __u32   cmd;            /* ETHTOOL_GPERMADDR */
+       __u32   cmd;
        __u32   size;
        __u8    data[0];
 };