From: Joonwon Kang Date: Tue, 21 Apr 2026 10:46:51 +0000 (+0000) Subject: mailbox: Clarify multi-thread is not supported in blocking mode X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=c96c8a7404ef8ce434ffd0f07b00e1a493fff42d;p=thirdparty%2Fkernel%2Flinux.git mailbox: Clarify multi-thread is not supported in blocking mode Unlike in non-blocking mode, multi-thread has not been supported in blocking mode. This commit is to prevent clients from having wrong assumption by explicitly specifying this fact to the API doc. Signed-off-by: Joonwon Kang Signed-off-by: Jassi Brar --- diff --git a/drivers/mailbox/mailbox.c b/drivers/mailbox/mailbox.c index bbc9fd75a95f7..b00f7a32e8661 100644 --- a/drivers/mailbox/mailbox.c +++ b/drivers/mailbox/mailbox.c @@ -258,6 +258,10 @@ EXPORT_SYMBOL_GPL(mbox_chan_tx_slots_available); * over the chan, i.e, tx_done() is made. * This function could be called from atomic context as it simply * queues the data and returns a token against the request. + * In blocking mode, it is caller's responsibility to serialize threads' + * access to a channel if multi-threads are to send messages through the + * same channel, i.e. caller should not call this function until any + * previous call returns. * * Return: Non-negative integer for successful submission (non-blocking mode) * or transmission over chan (blocking mode).