driver-api/dmaengine/client.rst

8           ``Documentation/crypto/async-tx-api.rst``
11 Below is a guide to device driver writers on how to use the Slave-DMA API of the
19 - Allocate a DMA slave channel
21 - Set slave and controller specific parameters
23 - Get a descriptor for transaction
25 - Submit the transaction
27 - Issue pending requests and wait for callback notification
40    .. code-block:: c
56    DMA direction, DMA addresses, bus widths, DMA burst lengths etc
66    .. code-block:: c
79   DMA-engine are:
81   - slave_sg: DMA a list of scatter gather buffers from/to a peripheral
83   - dma_cyclic: Perform a cyclic DMA operation from/to a peripheral till the
86   - interleaved_dma: This is common to Slave as well as M2M clients. For slave
93   A non-NULL return of this transfer API represents a "descriptor" for
98   .. code-block:: c
121   .. code-block:: c
123      nr_sg = dma_map_sg(chan->device->dev, sgl, sg_len);
165   .. code-block:: c
184   .. code-block:: c
194   .. code-block:: c
203     - DMA_MEM_TO_DEV / DEV_MEM_TO_MEM:
211     - DMA_DEV_TO_MEM:
222     - DMA_MEM_TO_DEV / DEV_MEM_TO_MEM:
232     - DMA_DEV_TO_MEM:
246      Mixed use of DESC_METADATA_CLIENT / DESC_METADATA_ENGINE is not allowed,
256    .. code-block:: c
285    .. code-block:: c
290 ------------
294    .. code-block:: c
321    .. code-block:: c
329    .. code-block:: c
338    .. code-block:: c
360    .. code-block:: c