From 3f998c74f5829f14017ca7b61b8eb98aee6e1d23 Mon Sep 17 00:00:00 2001 From: Thomas Fleury Date: Wed, 18 Sep 2019 08:39:12 -0400 Subject: [PATCH] gpu: nvgpu: add doxygen for nvgpu_fifo_sw_quiesce Add documentation for nvgpu_fifo_sw_quiesce. Jira NVGPU-2428 Change-Id: I44f5bd5fad258c3c31622f53364aa276bfe6235b Signed-off-by: Thomas Fleury Reviewed-on: https://git-master.nvidia.com/r/2200648 Reviewed-by: Automatic_Commit_Validation_User GVS: Gerrit_Virtual_Submit Reviewed-by: Philip Elcan Reviewed-by: Debarshi Dutta Reviewed-by: Deepak Nibade Reviewed-by: mobile promotions Tested-by: mobile promotions --- drivers/gpu/nvgpu/include/nvgpu/fifo.h | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/drivers/gpu/nvgpu/include/nvgpu/fifo.h b/drivers/gpu/nvgpu/include/nvgpu/fifo.h index f2e2e9518..efe37b77c 100644 --- a/drivers/gpu/nvgpu/include/nvgpu/fifo.h +++ b/drivers/gpu/nvgpu/include/nvgpu/fifo.h @@ -475,7 +475,23 @@ const char *nvgpu_fifo_decode_pbdma_ch_eng_status(u32 index); * FIFO interrupts. */ int nvgpu_fifo_suspend(struct gk20a *g); + #ifndef CONFIG_NVGPU_RECOVERY +/** + * @brief Emergency quiescing of FIFO. + * + * @param g[in] The GPU driver struct. + * + * Gracefully put FIFO into a non-functioning state to ensure that no corrupted + * work is completed because of the fault. This is because the freedom + * from interference may not always be shown between the faulted and + * the non-faulted TSG contexts. + * - Disable all runlists + * - Preempt all runlists + * - Quiesce all channels + * + * @see nvgpu_channel_sw_quiesce + */ void nvgpu_fifo_sw_quiesce(struct gk20a *g); #endif