ENUM ETHTOOL_PODL_PSE_PW_D_STATUS(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’– NAME πŸ’–

okay so bestie, the page you're looking at is enum ethtoo..._pw_d_status(9) β€” yes, the title is literally cropped like that in the header, it's giving "my name didn't fit in the tab bar" 😭 β€” and it lives in the Kernel API Manual. Don't let the truncated name scare you, it's just enum ethtool_podl_pse_pw_d_status being shy.

This whole icon is about the power detection status of the PoDL PSE. And because standards people love a citation, the official reference is IEEE 802.3-2018 30.15.1.1.3 aPoDLPSEPowerDetectionStatus: β€” yes with the colon, that's how they wrote it, periodt.

So basically: PoDL PSE (Power over Data Lines, Power Sourcing Equipment) has ~vibes~, and this enum is the vibe check. Each constant is one possible mood. Let's get into it. πŸ’…


✨ SYNOPSIS ✨

Here's the whole enum, exactly as it lives in the source β€” don't retype it, copy it, that's the rule:

enum ethtool_podl_pse_pw_d_status {
    ETHTOOL_PODL_PSE_PW_D_STATUS_UNKNOWN ,
    ETHTOOL_PODL_PSE_PW_D_STATUS_DISABLED ,
    ETHTOOL_PODL_PSE_PW_D_STATUS_SEARCHING ,
    ETHTOOL_PODL_PSE_PW_D_STATUS_DELIVERING ,
    ETHTOOL_PODL_PSE_PW_D_STATUS_SLEEP ,
    ETHTOOL_PODL_PSE_PW_D_STATUS_IDLE ,
    ETHTOOL_PODL_PSE_PW_D_STATUS_ERROR

};

(yes there's a stray space before those commas and a lil blank line before the closing brace β€” that's the original, we do not touch, we do not fix, we respect the author's choices 🫢)


πŸŽ€ Constants πŸŽ€

Seven constants, seven moods, one enum. Each one comes with the exact wording from the spec, so you can quote it back at people and look iconic. 🌸

  • ETHTOOL_PODL_PSE_PW_D_STATUS_UNKNOWN β€” the "we have literally no idea" state. The original page's entire description for this one is just PoDL PSE β€” that's it, that's the whole thing, no extra lore, ngl. Not me expecting more 😭
  • ETHTOOL_PODL_PSE_PW_D_STATUS_DISABLED β€” the PSE is switched off, bestie, it's not doing the thing. Straight from the spec: "The enumeration β€œdisabled” is asserted true when the PoDL PSE state diagram variable mr_pse_enable is false"
  • ETHTOOL_PODL_PSE_PW_D_STATUS_SEARCHING β€” it's out here looking for a device to power, main character energy, actively on the hunt. Spec says: "The enumeration β€œsearching” is asserted true when either of the PSE state diagram variables pi_detecting or pi_classifying is true."
  • ETHTOOL_PODL_PSE_PW_D_STATUS_DELIVERING β€” okay we're actually sending power now, ate. Spec says: "The enumeration β€œdeliveringPower” is asserted true when the PoDL PSE state diagram variable pi_powered is true."
  • ETHTOOL_PODL_PSE_PW_D_STATUS_SLEEP β€” it's napping 😴. Spec says: "The enumeration β€œsleep” is asserted true when the PoDL PSE state diagram variable pi_sleeping is true."
  • ETHTOOL_PODL_PSE_PW_D_STATUS_IDLE β€” chilling, pre-biased, but not sleeping, that's the combo. Spec says: "The enumeration β€œidle” is asserted true when the logical combination of the PoDL PSE state diagram variables pi_prebiased*!pi_sleeping is true." (yes that's a * and a ! in there, it's a logical combo, leave it alone 🧚)
  • ETHTOOL_PODL_PSE_PW_D_STATUS_ERROR β€” something went wrong, the overload's been held down. Spec says: "The enumeration β€œerror” is asserted true when the PoDL PSE state diagram variable overload_held is true."
The descriptions above are quoted word-for-word from the page, so if the spec words it weird, that's on the spec, not on us. 🫢

🌈 SEE ALSO 🌈

okay bestie, buckle up, this list is long β€” it's the entire ethtool cinematic universe, all of it, every single one, in order. πŸ’€

  • Kernel file ./include/uapi/linux/ethtool.h β€” that's where the family lives
  • 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_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_dump(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)

Like I said. The whole universe. 🌌


and that's the page, bestie! this lil masterpiece comes from ./include/uapi/linux and it's dated October 2026, with the manual name being that iconic-but-truncated enum ethtoo..._pw_d_status(9) from the Kernel API Manual. go forth and identify your PoDL PSE's emotional state with confidence πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from