diff options
author | Ben Hutchings <ben@decadent.org.uk> | 2014-02-12 22:14:13 +0000 |
---|---|---|
committer | David S. Miller <davem@davemloft.net> | 2014-02-12 17:33:02 -0500 |
commit | 09fb8bb068c86ff6b79dd7d4cb8f706bedf86d73 (patch) | |
tree | bc64c0aefb0aa8fdca2ec67c442fd333b5ae6bf7 /include/uapi/linux/ethtool.h | |
parent | 02d59f3fdb6a5d77a12549482811d404842e2c95 (diff) | |
download | op-kernel-dev-09fb8bb068c86ff6b79dd7d4cb8f706bedf86d73.zip op-kernel-dev-09fb8bb068c86ff6b79dd7d4cb8f706bedf86d73.tar.gz |
ethtool: Expand documentation of struct ethtool_regs
Signed-off-by: Ben Hutchings <ben@decadent.org.uk>
Signed-off-by: David S. Miller <davem@davemloft.net>
Diffstat (limited to 'include/uapi/linux/ethtool.h')
-rw-r--r-- | include/uapi/linux/ethtool.h | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/include/uapi/linux/ethtool.h b/include/uapi/linux/ethtool.h index 15a42de..441bd31 100644 --- a/include/uapi/linux/ethtool.h +++ b/include/uapi/linux/ethtool.h @@ -209,11 +209,25 @@ struct ethtool_value { __u32 data; }; -/* for passing big chunks of data */ +/** + * struct ethtool_regs - hardware register dump + * @cmd: Command number = %ETHTOOL_GREGS + * @version: Dump format version. This is driver-specific and may + * distinguish different chips/revisions. Drivers must use new + * version numbers whenever the dump format changes in an + * incompatible way. + * @len: On entry, the real length of @data. On return, the number of + * bytes used. + * @data: Buffer for the register dump + * + * Users should use %ETHTOOL_GDRVINFO to find the maximum length of + * a register dump for the interface. They must allocate the buffer + * immediately following this structure. + */ struct ethtool_regs { __u32 cmd; - __u32 version; /* driver-specific, indicates different chips/revs */ - __u32 len; /* bytes */ + __u32 version; + __u32 len; __u8 data[0]; }; |