Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 85ed4f43 authored by Federico Vaga's avatar Federico Vaga Committed by Vinod Koul
Browse files

Documentation :dmaengine: clarify DMA desc. pointer after submission 



It clarifies that the DMA description pointer returned by
`dmaengine_prep_*` function should not be used after submission.

Signed-off-by: default avatarFederico Vaga <federico.vaga@cern.ch>
Signed-off-by: default avatarVinod Koul <vkoul@kernel.org>
parent b2971596

Documentation/driver-api/dmaengine/client.rst

+7 −0
Original line number Diff line number Diff line
@@ -168,6 +168,13 @@ The details of these operations are: 
   dmaengine_submit() will not start the DMA operation, it merely adds

   it to the pending queue. For this, see step 5, dma_async_issue_pending.



   .. note::



      After calling ``dmaengine_submit()`` the submitted transfer descriptor

      (``struct dma_async_tx_descriptor``) belongs to the DMA engine.

      Consequently, the client must consider invalid the pointer to that

      descriptor.



5. Issue pending DMA requests and wait for callback notification



   The transactions in the pending queue can be activated by calling the