net/ethtool/module.c
Source file repositories/reference/linux-study-clean/net/ethtool/module.c
File Facts
- System
- Linux kernel
- Corpus path
net/ethtool/module.c- Extension
.c- Size
- 14805 bytes
- Lines
- 567
- Domain
- Networking Core
- Bucket
- Sockets, Protocols, Packet Path, And Network Policy
- Inferred role
- Networking Core: implementation source
- Status
- source implementation candidate
Why This File Exists
Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/ethtool.hlinux/firmware.hlinux/sfp.hnet/devlink.hnet/netdev_lock.hbitset.hcommon.hmodule_fw.hnetlink.h
Detected Declarations
struct module_req_infostruct module_reply_datafunction module_get_power_modefunction module_prepare_datafunction module_reply_sizefunction module_fill_replyfunction ethnl_set_module_validatefunction ethnl_set_modulefunction module_flash_fw_work_list_addfunction module_flash_fw_work_list_delfunction module_flash_fw_workfunction module_flash_fw_work_initfunction ethnl_module_fw_flash_sock_destroyfunction module_flash_fw_schedulefunction module_flash_fwfunction ethnl_module_fw_flash_validatefunction ethnl_act_module_fw_flashfunction ethnl_module_fw_flash_ntf_put_errfunction ethnl_module_fw_flash_ntffunction ethnl_module_fw_flash_ntf_errfunction ethnl_module_fw_flash_ntf_startfunction ethnl_module_fw_flash_ntf_completefunction ethnl_module_fw_flash_ntf_in_progress
Annotated Snippet
struct module_req_info {
struct ethnl_req_info base;
};
struct module_reply_data {
struct ethnl_reply_data base;
struct ethtool_module_power_mode_params power;
};
#define MODULE_REPDATA(__reply_base) \
container_of(__reply_base, struct module_reply_data, base)
/* MODULE_GET */
const struct nla_policy ethnl_module_get_policy[ETHTOOL_A_MODULE_HEADER + 1] = {
[ETHTOOL_A_MODULE_HEADER] = NLA_POLICY_NESTED(ethnl_header_policy),
};
static int module_get_power_mode(struct net_device *dev,
struct module_reply_data *data,
struct netlink_ext_ack *extack)
{
const struct ethtool_ops *ops = dev->ethtool_ops;
if (!ops->get_module_power_mode)
return 0;
if (dev->ethtool->module_fw_flash_in_progress) {
NL_SET_ERR_MSG(extack,
"Module firmware flashing is in progress");
return -EBUSY;
}
return ops->get_module_power_mode(dev, &data->power, extack);
}
static int module_prepare_data(const struct ethnl_req_info *req_base,
struct ethnl_reply_data *reply_base,
const struct genl_info *info)
{
struct module_reply_data *data = MODULE_REPDATA(reply_base);
struct net_device *dev = reply_base->dev;
int ret;
ret = ethnl_ops_begin(dev);
if (ret < 0)
return ret;
ret = module_get_power_mode(dev, data, info->extack);
if (ret < 0)
goto out_complete;
out_complete:
ethnl_ops_complete(dev);
return ret;
}
static int module_reply_size(const struct ethnl_req_info *req_base,
const struct ethnl_reply_data *reply_base)
{
struct module_reply_data *data = MODULE_REPDATA(reply_base);
int len = 0;
if (data->power.policy)
len += nla_total_size(sizeof(u8)); /* _MODULE_POWER_MODE_POLICY */
if (data->power.mode)
len += nla_total_size(sizeof(u8)); /* _MODULE_POWER_MODE */
return len;
}
static int module_fill_reply(struct sk_buff *skb,
const struct ethnl_req_info *req_base,
const struct ethnl_reply_data *reply_base)
{
const struct module_reply_data *data = MODULE_REPDATA(reply_base);
if (data->power.policy &&
nla_put_u8(skb, ETHTOOL_A_MODULE_POWER_MODE_POLICY,
data->power.policy))
return -EMSGSIZE;
if (data->power.mode &&
nla_put_u8(skb, ETHTOOL_A_MODULE_POWER_MODE, data->power.mode))
return -EMSGSIZE;
return 0;
}
Annotation
- Immediate include surface: `linux/ethtool.h`, `linux/firmware.h`, `linux/sfp.h`, `net/devlink.h`, `net/netdev_lock.h`, `bitset.h`, `common.h`, `module_fw.h`.
- Detected declarations: `struct module_req_info`, `struct module_reply_data`, `function module_get_power_mode`, `function module_prepare_data`, `function module_reply_size`, `function module_fill_reply`, `function ethnl_set_module_validate`, `function ethnl_set_module`, `function module_flash_fw_work_list_add`, `function module_flash_fw_work_list_del`.
- Atlas domain: Networking Core / Sockets, Protocols, Packet Path, And Network Policy.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.