ENUM ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION(9)

📦 version 7.3.1, in nixpkgs unstable

💅 enum ethtool_c33_pse_ext_substate_error_condition(9) — from the Kernel API Manual, bestie 🫶

okay so this is a page straight out of the Kernel API Manual, and it's all about one enum, literally one, and it's the error-condition report card for your PSE. yes bestie, we're going deep into IEEE 802.3-2022 33.2.4.4 Variables territory. put your hair up, grab a strawberry drink 🍓, and let's go.

✨ NAME ✨

enum ethtool_c33_pse_ext_substate_error_condition — the error_condition states functions, fr fr. it lives in IEEE 802.3-2022 33.2.4.4 Variables and it's here to tell you exactly why your port is having a moment. 😭

🦋 SYNOPSIS 🦋

enum ethtool_c33_pse_ext_substate_error_condition {
    ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_NON_EXISTING_PORT ,
    ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_UNDEFINED_PORT ,
    ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_INTERNAL_HW_FAULT ,
ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_COMM_ERROR_AFTER_FORCE_ON
,
    ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_UNKNOWN_PORT_STATUS ,
    ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_HOST_CRASH_TURN_OFF ,
ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_HOST_CRASH_FORCE_SHUTDOWN
,
    ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_CONFIG_CHANGE ,
    ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_DETECTED_OVER_TEMP

};

like, that's the whole vibe of the enum, no notes. 💅

🎀 Constants 🎀

every single one of these is a constant in the enum and they are all, without exception, iconic little ways for your port to be going through it:

  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_NON_EXISTING_PORT — non-existing port number. the port? doesn't exist. she's a ghost. 👻
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_UNDEFINED_PORT — undefined port. no cap, we literally do not know her.
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_INTERNAL_HW_FAULT — internal hardware fault. the hardware is in her flop era 😭
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_COMM_ERROR_AFTER_FORCE_ON — communication error after force on. everything was fine, we forced it on, and then the talking stopped. 💀
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_UNKNOWN_PORT_STATUS — unknown port status. vibe check: failed. status: unknown.
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_HOST_CRASH_TURN_OFF — host crash turn off. the host crashed and honestly? she turned off about it.
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_HOST_CRASH_FORCE_SHUTDOWN — host crash force shutdown. same host crash energy, but make it a forced shutdown. no coming back from this one.
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_CONFIG_CHANGE — configuration change. she changed her config. it's giving new era, new me. ✨
  • ETHTOOL_C33_PSE_EXT_SUBSTATE_ERROR_CONDITION_DETECTED_OVER_TEMP — over temperature detected. she's hot. not in the cute way. 🔥

🌸 Description 🌸

okay so error_condition is a variable, and what it's doing is indicating the status of implementation-specific fault conditions, or optionally other system faults, that prevent the PSE from meeting the specifications in Table 33–11 — and that require the PSE not to source power. like, power off, bestie, it's for your own good.

these error conditions are, and I cannot stress this enough, different from the ones monitored by the state diagrams in Figure 33–10. different girlies, different diagrams, don't mix them up. 🙈

⭐ SEE ALSO ⭐

the whole entourage, in order, every single one of them, no gatekeeping:

  • 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_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_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)
bestie warning-ish: this is a kernel API page, not a tutorial. the facts above are the facts, so don't go inventing behaviour that isn't listed here. iykyk 🫶

okay that's the whole page, mwah 💖. it comes from ./include/uapi/linux, dated October 2026, and it goes out under the very dramatic title enum ethtoo...or_condition(9) — yes the title is literally truncated like that in the footer, and honestly? she ate. periodt. 👑

📦 where this page comes from