github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-11-06 21:58:01 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

dmaengine: add dmaengine_desc_set_callback() helper

Browse Source 
Add a dmaengine_desc_set_callback() inline helper that sets the
callback, callback_result, and callback_param fields of a
dma_async_tx_descriptor together in a single call.

Using this helper instead of open-coding the three field assignments
ensures all three related fields are always updated consistently and
makes call sites more readable.

Signed-off-by: Frank Li <Frank.Li@nxp.com>
Link: https://patch.msgid.link/20261002195410.213610-1-Frank.Li@oss.nxp.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>
This commit is contained in:
Frank Li 2026-10-02 15:54:09 -04:00 committed by Vinod Koul
parent 61527d7e69
commit 562b6ed45d
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
include/linux/dmaengine.h
View File

@ -2060,6 +2060,31 @@ static inline int dmaengine_desc_free(struct dma_async_tx_descriptor *desc)
return desc->desc_free(desc);
}
/**
* dmaengine_desc_set_callback - set the callback, callback_result and
* parameter on a descriptor
* @tx: the descriptor to set the callback on
* @cb: the plain completion callback, or NULL
* @cb_result: the result-bearing completion callback, or NULL
* @cb_param: the parameter to pass to the callback
*
* Sets the completion callbacks and their shared parameter on a DMA
* transaction descriptor. Use this helper instead of assigning the fields
* directly to ensure all three related fields are updated consistently.
* Only one of @cb and @cb_result should be non-NULL; if both are provided
* @cb_result takes precedence in drivers that support it.
*/
static inline void
dmaengine_desc_set_callback(struct dma_async_tx_descriptor *tx,
dma_async_tx_callback cb,
dma_async_tx_callback_result cb_result,
void *cb_param)
{
tx->callback = cb;
tx->callback_result = cb_result;
tx->callback_param = cb_param;
}
/* --- DMA device --- */
int dma_async_device_register(struct dma_device *device);