mbox_client_peek_data(9)

🌸 NAME 🌸

okay so bestie, welcome to mbox_client_peek_data(9) from the Kernel API Manual 💅 this is literally the way for a client driver to pull data that the controller received from the remote. no cap, it's a whole lil helper. 🫶

✨ SYNOPSIS ✨

bool mbox_client_peek_data (struct mbox_chan *chan );

🎀 ARGUMENTS 🎀

• chan — Mailbox channel assigned to this client. 💌

🦋 DESCRIPTION 🦋

It's a lil poke to the controller driver for any received data — like, hey, got anything? 👀 The actual data gets passed onto the client via mbox_chan_received_data.

The call can be made from atomic context, so the controller's implementation of peek_data must not sleep. fr fr, that part is serious — no napping in atomic context, bestie. 😭

🌈 RETURN 🌈

• True — if controller has, and is going to push after this, some data. ✨
• False — if controller doesn't have any data to be read. 🙈

👑 SEE ALSO 👑

Kernel file ./drivers/mailbox/mailbox.c is right there, and these are the related besties:

• mbox_chan_received_data(9)
• mbox_chan_txdone(9)
• mbox_client_txdone(9)
• mbox_chan_tx_slots_available(9)
• mbox_send_message(9)
• mbox_flush(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)

📬 source/version: ./drivers/mailbox · date: October 2026 · page: mbox_client_peek_data(9) — bye bestie, go peek that data! 💖💅