STRUCT ETHTOOL_DUMP(9)

✨ struct ethtool_dump — the Kernel API Manual era ✨

okay so bestie, welcome to struct ethtool_dump(9) 💖 this is the kernel API manual, and this lil struct is literally the whole personality of retrieving and setting device dumps. no cap.

---

🌸 NAME 🌸

struct ethtool_dump — genuinely just here to retrieve and set device dumps, that's the whole job, periodt.

---

🦋 SYNOPSIS 🦋

struct ethtool_dump {
    __u32 cmd;
    __u32 version;
    __u32 flag;
    __u32 len;
    __u8 data[];
 };

look at her. iconic. five members and a flexible array, she's giving main character energy fr fr 💅

---

🎀 Members 🎀

• cmd — the command number, bestie. it's one of ETHTOOL_GET_DUMP_FLAG, ETHTOOL_GET_DUMP_DATA, or ETHTOOL_SET_DUMP. that's the whole vibe check for what this struct is doing rn.
• version — the FW version of the dump, and it's the driver who fills this one in. not you. don't touch. 🙈
• flag — a driver dependent flag for the dump setting. here's the tea: the driver fills it in during get, and ethtool fills it in for the set operation. and if firmware dump is disabled? flag must be initialized by the macro ETH_FW_DUMP_DISABLE value. that's not optional, that's the rule. 🔥
• len — the length of the dump data. on entry to ETHTOOL_GET_DUMP_DATA it's used as the length of the user buffer, and for the ETHTOOL_GET_DUMP_FLAG command it gets returned as the dump length by the driver. same field, two lil jobs, multitasking queen 👑
• data — the actual data collected for the get dump data operation. the payload, the moment, the reason we're all here 🍓

---

🌈 SEE ALSO 🌈

it's giving "linked list of every ethtool friend she knows", and honestly? obsessed. here's the full squad, no one gets left behind 🫶

Kernel file ./include/uapi/linux/ethtool.h

struct ethtool_cmd(9), struct ethtool_drvinfo(9), struct ethtool_wolinfo(9), struct ethtool_regs(9), struct ethtool_eeprom(9), struct ethtool_eee(9), struct ethtool_modinfo(9), struct ethtool_coalesce(9), struct ethtool_ringparam(9), struct ethtool_channels(9), struct ethtool_pauseparam(9), enum ethtool_stringset(9), enum ethtool_mac_stats_src(9), enum ethtool_module_power_mode_policy(9), enum ethtool_module_power_mode(9), enum ethtool_c33_pse_ext_state(9), enum ethtool_c33_pse_ext_substate_mr_mps_valid(9), enum ethtool_c33_pse_ext_substate_error_condition(9), enum ethtool_c33_pse_ext_substate_mr_pse_enable(9), enum ethtool_c33_pse_ext_substate_option_detect_ted(9), enum ethtool_c33_pse_ext_substate_option_vport_lim(9), enum ethtool_c33_pse_ext_substate_ovld_detected(9), enum ethtool_c33_pse_ext_substate_power_not_available(9), enum ethtool_c33_pse_ext_substate_short_detected(9), enum ethtool_pse_types(9), enum ethtool_c33_pse_admin_state(9), enum ethtool_c33_pse_pw_d_status(9), enum ethtool_podl_pse_admin_state(9), enum ethtool_podl_pse_pw_d_status(9), enum ethtool_mm_verify_status(9), enum ethtool_module_fw_flash_status(9), struct ethtool_gstrings(9), struct ethtool_sset_info(9), enum ethtool_test_flags(9), struct ethtool_test(9), struct ethtool_stats(9), struct ethtool_perm_addr(9), struct ethtool_tcpip4_spec(9), struct ethtool_ah_espip4_spec(9), struct ethtool_usrip4_spec(9), struct ethtool_tcpip6_spec(9), struct ethtool_ah_espip6_spec(9), struct ethtool_usrip6_spec(9), struct ethtool_flow_ext(9), struct ethtool_rx_flow_spec(9), struct ethtool_rxnfc(9), struct ethtool_rxfh_indir(9), struct ethtool_rxfh(9), struct ethtool_rx_ntuple_flow_spec(9), struct ethtool_rx_ntuple(9), struct ethtool_get_features_block(9), struct ethtool_gfeatures(9), struct ethtool_set_features_block(9), struct ethtool_sfeatures(9), struct ethtool_ts_info(9), struct ethtool_per_queue_op(9), struct ethtool_fecparam(9), enum ethtool_fec_config_bits(9), struct ethtool_link_settings(9), enum phy_upstream(9)

---

ngl bestie, that's a lot of friends. but she keeps every single one in the group chat, and that's why we love her 💜

---

anyway, that's the page!! and before you go — this whole thing lives in ./include/uapi/linux, and it was dated October 2026. slay, see you in the next manpage, mwah 😭💖👑