ENUM DRM_CONNECTOR_STATUS(9)

💅 enum drm_connector_status(9) — the Kernel API Manual, but make it cute 🎀

okay so bestie, welcome to the enum drm_connector_status(9) page — yes that's the manual name, we're not copying the whole header line, we're folding it in like a little name tag 🫶. This is the kernel API manual page for the enum that answers the eternal question: is the monitor plugged in or not.

---

✨ NAME ✨

enum drm_connector_status — literally the status for a &drm_connector. that's it. that's the whole vibe check 💅

---

🌸 SYNOPSIS 🌸

enum drm_connector_status {
    connector_status_connected ,
    connector_status_disconnected ,
    connector_status_unknown

};

look at her. three little constants, all main character energy. let's meet them 👑

Constants

• connector_status_connected — okay so this one is definitely connected to a sink device and can be enabled. no cap, it's slaying, it's giving "yes bestie plug it in" 🔥
• connector_status_disconnected — the connector isn't connected to a sink device which can autodetect. for digital outputs like DP or HDMI (which can be reliably probed) this means there's really nothing there. and ngl, it's driver-dependent whether a connector with this status can be lit up or not — so like, maybe? but don't count on it 😭
• connector_status_unknown — the connector's status could not be reliably detected. this happens when probing would either cause flicker (like load-detection when the connector is in use), or when a hardware resource isn't available (like when load-detection needs a free CRTC). it should be possible to light up the connector with one of the listed fallback modes. for default configuration, userspace should only try to light up connectors with unknown status when there's no connector with connector_status_connected. periodt 💀

---

🦋 Description 🦋

This enum is used to track the connector status. and here's the iconic part: there are no separate #defines for the uapi! not one. zero. none. the enum is the whole moment 💖

---

🌈 SEE ALSO 🌈

Kernel file ./include/drm/drm_connector.h enum — like, the source of truth, iykyk.

• drm_connector_registration_state(9)
• enum drm_connector_tv_mode(9)
• struct drm_scrambling(9)
• struct drm_hdmi_dsc_cap(9)
• struct drm_hdmi_info(9)
• enum drm_link_status(9)
• enum drm_panel_orientation(9)
• enum drm_hdmi_broadcast_rgb(9)
• struct drm_monitor_range_info(9)
• struct drm_luminance_range_info(9)
• enum drm_privacy_screen_status(9)
• enum drm_colorspace(9)
• enum drm_output_color_format(9)
• enum drm_connector_color_format(9)
• enum drm_bus_flags(9)
• struct drm_amd_vsdb_info(9)
• struct drm_display_info(9)
• struct drm_connector_tv_margins(9)
• struct drm_tv_connector_state(9)
• struct drm_connector_hdmi_infoframe(9)
• struct drm_connector_state(9)
• struct drm_connector_cec_funcs(9)
• struct drm_connector_infoframe_funcs(9)
• struct drm_connector_hdmi_funcs(9)
• struct drm_connector_funcs(9)
• struct drm_cmdline_mode(9)
• struct drm_connector_hdmi_audio(9)
• struct drm_connector_cec(9)
• struct drm_connector(9)
• drm_connector_lookup(9)
• drm_connector_get(9)
• drm_connector_put(9)
• drm_connector_is_unregistered(9)
• struct drm_tile_group(9)
• struct drm_connector_list_iter(9)
• drm_for_each_connector_iter(9)
• drm_connector_for_each_possible_encoder(9)

---

and that's the whole page bestie 🫶 — brought to you straight from the ./include/drm source, dated October 2026, under the header enum drm_connector_status(9). go forth and probe responsibly, mwah 💖✨