mbox_flush(9)

💌 NAME

okay so this is mbox_flush(9) from the Kernel API Manual — it’s literally all about how to flush a mailbox channel 🦋✨

---

🎀 SYNOPSIS

int mbox_flush (struct mbox_chan *chan , unsigned long timeout );

---

✨ ARGUMENTS

• chan — the mailbox channel to flush 💅
• timeout — the time, in milliseconds, to allow the flush operation to succeed ⏱️🌸

---

🫶 DESCRIPTION

Mailbox controllers that need to work in atomic context can implement the ->flush callback to busy loop until a transmission has been completed. The implementation must call mbox_chan_txdone upon success. 🔥

Clients can call the mbox_flush function at any time after mbox_send_message to flush the transmission. After the function returns success, the mailbox transmission is guaranteed to have completed. periodt 💖

---

🌈 RETURN

0 on success, or a negative error code on failure. no cap 😭👑

---

🦋 SEE ALSO

Kernel file: ./drivers/mailbox/mailbox.c 📁

• mbox_chan_received_data(9)
• mbox_chan_txdone(9)
• mbox_client_txdone(9)
• mbox_client_peek_data(9)
• mbox_chan_tx_slots_available(9)
• mbox_send_message(9)
• mbox_bind_client(9)
• mbox_request_channel(9)
• mbox_free_channel(9)
• mbox_controller_register(9)
• mbox_controller_unregister(9)
• devm_mbox_controller_register(9)

---

xoxo bestie 💋 — this page lives in ./drivers/mailbox, dated October 2026 🎀💜