STRUCT MBOX_CHAN(9)

struct mbox_chan(9)

okay bestie, welcome to the Kernel API Manual page for struct mbox_chan — the s/w side of a communication chan, and it is literally giving kernel-core cutie energy. 🎀 This struct is the kernel API's whole vibe for representing a communication channel, and we are gonna roll call every single member. no cap. ✨

🌸 NAME 🌸

struct mbox_chan — s/w representation of a communication chan 💖

✨ SYNOPSIS ✨

       struct mbox_chan {
           struct mbox_controller *mbox;
           unsigned txdone_method;
           struct mbox_client *cl;
           struct completion tx_complete;
           int tx_status;
           void *active_req;
           unsigned msg_count, msg_free;
           void *msg_data[MBOX_TX_QUEUE_LEN];
           spinlock_t lock;
           void *con_priv;
        };

🎀 Members 🎀

okay so this struct is lowkey a whole lineup of fields, and every one has a job. let's go, bestie:

• mbox — Pointer to the parent/provider of this channel. Like, who owns this chan? this pointer knows. 👑
• txdone_method — Way to detect TXDone chosen by the API. That's the API's chosen TXDone-detection method. 🔥
• cl — Pointer to the current owner of this channel. The current main character, basically. 💅
• tx_complete — Transmission completion. The transmission-completion field, periodt. ✨
• tx_status — Transmission status. The receipts on the transmission. 🧾
• active_req — Currently active request hook. The request hook that's active right now. 🦋
• msg_count — No. of mssg currently queued. Count 'em, bestie. 🍓
• msg_free — Index of next available mssg slot. The next free mssg slot index. 🎀
• msg_data — Hook for data packet. Data packet hook, slay. 💜
• lock — Serialise access to the channel. Keeps access to the channel serialised. 🔒
• con_priv — Hook for controller driver to attach private data. Controller driver's private-data hook. 🙈

🌈 SEE ALSO 🌈

• Kernel file ./include/linux/mailbox_controller.h struct
• mbox_chan_ops(9), struct mbox_controller(9)

🫶 that's the whole struct, bestie. source/version path: ./include/linux; date: October 2026 — struct mbox_chan(9) signing off! periodt. 💅