STRUCT MEI_CL(9)

struct mei_cl(9) 💅✨

okay bestie, welcome to the Kernel API Manual glow-up for struct mei_cl — the me client host representation carried in file->private_data. Yes, it’s giving kernel-internals main character energy, and we’re getting into every single field. no skipping. periodt. 🎀

💖 NAME 💖

struct mei_cl — the me client host representation carried in file->private_data. That’s the whole vibe: it’s the client-side host representation, and it lives in file->private_data. 🫶

✨ SYNOPSIS ✨

struct mei_cl {
    struct list_head link;
    struct mei_device *dev;
    enum file_state state;
    wait_queue_head_t tx_wait;
    wait_queue_head_t rx_wait;
    wait_queue_head_t wait;
    wait_queue_head_t ev_wait;
    struct fasync_struct *ev_async;
    int status;
    struct mei_me_client *me_cl;
    const struct file *fp;
    u8 host_client_id;
    struct list_head vtag_map;
    u8 tx_flow_ctrl_creds;
    u8 rx_flow_ctrl_creds;
    u8 timer_count;
    u8 notify_en;
    u8 notify_ev;
    u8 tx_cb_queued;
    enum mei_file_transaction_states writing_state;
    struct list_head rd_pending;
    spinlock_t rd_completed_lock;
    struct list_head rd_completed;
    struct mei_dma_data dma;
    u8 dma_mapped;
    struct mei_cl_device *cldev;
};

🌸 Members 🌸

• link — the link in the clients list. iconic little list glue. 🔗
• dev — the mei parent device. the parent-device realness. 👑
• state — file operation state. where the file-op of it all is at. ✨
• tx_wait — wait queue for tx completion. yes, wait queue, for tx completion. 💤
• rx_wait — wait queue for rx completion. matching wait queue, matching completion. 🫶
• wait — wait queue for management operation. management-operation wait queue, fr fr. 🧚
• ev_wait — notification wait queue. the notification wait queue. 🌸
• ev_async — event async notification. async event notification, no cap. ⚡
• status — connection status. connection status check, bestie. 🩷
• me_cl — fw client connected. the connected fw client. 🔥
• fp — file associated with client. the file associated with the client. 📁
• host_client_id — host id. literally the host id. 🪪
• vtag_map — vtag map. that’s the vtag map. 🗺️
• tx_flow_ctrl_creds — transmit flow credentials. transmit flow creds, periodt. 📤
• rx_flow_ctrl_creds — receive flow credentials. receive flow creds, matching energy. 📥
• timer_count — watchdog timer for operation completion. watchdog timer for operation completion, very “the clock is ticking” of it all. ⏰
• notify_en — notification - enabled/disabled. notification enabled/disabled, iykyk. 🔔
• notify_ev — pending notification event. the pending notification event. 📬
• tx_cb_queued — number of tx callbacks in queue. the number of tx callbacks in queue. 🧮
• writing_state — state of the tx. state of the tx, keeping it real. ✍️
• rd_pending — pending read credits. pending read credits, bestie. 🎟️
• rd_completed_lock — protects rd_completed queue. this lock is literally protecting the rd_completed queue. 💅
• rd_completed — completed read. completed read, slay. ✅
• dma — dma settings. dma settings, the configuration of it all. 🛠️
• dma_mapped — dma buffer is currently mapped. yes: the dma buffer is currently mapped. 🗺️
• cldev — device on the mei client bus. device on the mei client bus, periodt. 🚌

👀 SEE ALSO 👀

go peek at the kernel file ./drivers/misc/mei/mei_dev.h and these besties too — they’re all linked in the lore:

• enum mei_dev_pxp_mode(9)
• enum mei_dev_reset_to_pxp(9)
• enum mei_cb_file_ops(9)
• enum mei_cl_io_mode(9)
• struct mei_dma_dscr(9)
• struct mei_me_client(9)
• struct mei_cl_cb(9)
• struct mei_cl_vtag(9)
• struct mei_hw_ops(9)
• enum mei_pg_event(9)
• enum mei_pg_state(9)
• struct mei_fw_version(9)
• enum mei_dev_kind(9)
• struct mei_device(9)
• mei_data2slots(9)
• mei_hbm2slots(9)
• mei_slots2data(9)
• mei_fw_status_str(9)
• kind_is_gsc(9)
• kind_is_gscfi(9)

mwah 💋 — this kernel-api cutie lives in ./drivers/misc/mei, dated October 2026, and it’s literally struct mei_cl(9). take care of her! 💖🌷✨