Commit d2c4b444 authored by Michal Kubecek's avatar Michal Kubecek Committed by David S. Miller

ethtool: fix kernel-doc descriptions

Fix missing or incorrect function argument and struct member descriptions.
Signed-off-by: default avatarMichal Kubecek <mkubecek@suse.cz>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent 82bc2e4a
...@@ -134,11 +134,12 @@ int ethnl_fill_reply_header(struct sk_buff *skb, struct net_device *dev, ...@@ -134,11 +134,12 @@ int ethnl_fill_reply_header(struct sk_buff *skb, struct net_device *dev,
/** /**
* ethnl_reply_init() - Create skb for a reply and fill device identification * ethnl_reply_init() - Create skb for a reply and fill device identification
* @payload: payload length (without netlink and genetlink header) * @payload: payload length (without netlink and genetlink header)
* @dev: device the reply is about (may be null) * @dev: device the reply is about (may be null)
* @cmd: ETHTOOL_MSG_* message type for reply * @cmd: ETHTOOL_MSG_* message type for reply
* @info: genetlink info of the received packet we respond to * @hdr_attrtype: attribute type for common header
* @ehdrp: place to store payload pointer returned by genlmsg_new() * @info: genetlink info of the received packet we respond to
* @ehdrp: place to store payload pointer returned by genlmsg_new()
* *
* Return: pointer to allocated skb on success, NULL on error * Return: pointer to allocated skb on success, NULL on error
*/ */
...@@ -188,10 +189,11 @@ static int ethnl_multicast(struct sk_buff *skb, struct net_device *dev) ...@@ -188,10 +189,11 @@ static int ethnl_multicast(struct sk_buff *skb, struct net_device *dev)
/** /**
* struct ethnl_dump_ctx - context structure for generic dumpit() callback * struct ethnl_dump_ctx - context structure for generic dumpit() callback
* @ops: request ops of currently processed message type * @ops: request ops of currently processed message type
* @req_info: parsed request header of processed request * @req_info: parsed request header of processed request
* @pos_hash: saved iteration position - hashbucket * @reply_data: data needed to compose the reply
* @pos_idx: saved iteration position - index * @pos_hash: saved iteration position - hashbucket
* @pos_idx: saved iteration position - index
* *
* These parameters are kept in struct netlink_callback as context preserved * These parameters are kept in struct netlink_callback as context preserved
* between iterations. They are initialized by ethnl_default_start() and used * between iterations. They are initialized by ethnl_default_start() and used
...@@ -268,9 +270,9 @@ static int ethnl_default_parse(struct ethnl_req_info *req_info, ...@@ -268,9 +270,9 @@ static int ethnl_default_parse(struct ethnl_req_info *req_info,
/** /**
* ethnl_init_reply_data() - Initialize reply data for GET request * ethnl_init_reply_data() - Initialize reply data for GET request
* @req_info: pointer to embedded struct ethnl_req_info * @reply_data: pointer to embedded struct ethnl_reply_data
* @ops: instance of struct ethnl_request_ops describing the layout * @ops: instance of struct ethnl_request_ops describing the layout
* @dev: network device to initialize the reply for * @dev: network device to initialize the reply for
* *
* Fills the reply data part with zeros and sets the dev member. Must be called * Fills the reply data part with zeros and sets the dev member. Must be called
* before calling the ->fill_reply() callback (for each iteration when handling * before calling the ->fill_reply() callback (for each iteration when handling
......
...@@ -85,6 +85,7 @@ get_stringset_policy[ETHTOOL_A_STRINGSET_MAX + 1] = { ...@@ -85,6 +85,7 @@ get_stringset_policy[ETHTOOL_A_STRINGSET_MAX + 1] = {
/** /**
* strset_include() - test if a string set should be included in reply * strset_include() - test if a string set should be included in reply
* @info: parsed client request
* @data: pointer to request data structure * @data: pointer to request data structure
* @id: id of string set to check (ETH_SS_* constants) * @id: id of string set to check (ETH_SS_* constants)
*/ */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment