Mali Valhall Android DDK r36p0 KMD

Provenance: 9f72c118d9 (ipdelivery/EAC/v_r36p0)
  VX504X08X-BU-00000-r36p0-01eac0 - Valhall Android DDK
  VX504X08X-BU-60000-r36p0-01eac0 - Valhall Android Document Bundle
  VX504X08X-DC-11001-r36p0-01eac0 - Valhall Android DDK Software Errata
  VX504X08X-SW-99006-r36p0-01eac0 - Valhall Android Renderscript AOSP parts

Signed-off-by: Siddharth Kapoor <ksiddharth@google.com>
Change-Id: I4a63b707fedc68d7b7d046596c7098da47a139cb

1 files changed, 18 insertions, 13 deletions

diff --git a/mali_kbase/mali_kbase_debug_job_fault.h b/mali_kbase/mali_kbase_debug_job_fault.h
index 39aeed0..059d9c4 100644
--- a/mali_kbase/mali_kbase_debug_job_fault.h
+++ b/mali_kbase/mali_kbase_debug_job_fault.h
@@ -1,7 +1,7 @@
 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
 /*
  *
- * (C) COPYRIGHT 2012-2016, 2018, 2020-2021 ARM Limited. All rights reserved.
+ * (C) COPYRIGHT 2012-2016, 2018, 2020-2022 ARM Limited. All rights reserved.
  *
  * This program is free software and is provided to you under the terms of the
  * GNU General Public License version 2 as published by the Free Software
@@ -53,7 +53,7 @@ void kbase_debug_job_fault_dev_term(struct kbase_device *kbdev);
  * kbase_debug_job_fault_context_init - Initialize the relevant
  *		data structure per context
  * @kctx: KBase context pointer
- * @return 0 on success
+ * Return: 0 on success
  */
 int kbase_debug_job_fault_context_init(struct kbase_context *kctx);
 
@@ -68,39 +68,42 @@ void kbase_debug_job_fault_context_term(struct kbase_context *kctx);
  * kbase_debug_job_fault_kctx_unblock - Unblock the atoms blocked on job fault
  *					dumping on context termination.
  *
+ * @kctx: KBase context pointer
+ *
  * This function is called during context termination to unblock the atom for
  * which the job fault occurred and also the atoms following it. This is needed
  * otherwise the wait for zero jobs could timeout (leading to an assertion
  * failure, kernel panic in debug builds) in the pathological case where
  * although the thread/daemon capturing the job fault events is running,
  * but for some reasons has stopped consuming the events.
- *
- * @kctx: KBase context pointer
  */
 void kbase_debug_job_fault_kctx_unblock(struct kbase_context *kctx);
 
 /**
  * kbase_debug_job_fault_process - Process the failed job.
- *      It will send a event and wake up the job fault waiting queue
- *      Then create a work queue to wait for job dump finish
- *      This function should be called in the interrupt handler and before
- *      jd_done that make sure the jd_done_worker will be delayed until the
- *      job dump finish
+ *
  * @katom: The failed atom pointer
  * @completion_code: the job status
- * @return true if dump is going on
+ *
+ * It will send a event and wake up the job fault waiting queue
+ * Then create a work queue to wait for job dump finish
+ * This function should be called in the interrupt handler and before
+ * jd_done that make sure the jd_done_worker will be delayed until the
+ * job dump finish
+ *
+ * Return: true if dump is going on
  */
 bool kbase_debug_job_fault_process(struct kbase_jd_atom *katom,
 		u32 completion_code);
 
-
 /**
  * kbase_debug_job_fault_reg_snapshot_init - Set the interested registers
  *      address during the job fault process, the relevant registers will
  *      be saved when a job fault happen
  * @kctx: KBase context pointer
  * @reg_range: Maximum register address space
- * @return true if initializing successfully
+ *
+ * Return: true if initializing successfully
  */
 bool kbase_debug_job_fault_reg_snapshot_init(struct kbase_context *kctx,
 		int reg_range);
@@ -108,8 +111,10 @@ bool kbase_debug_job_fault_reg_snapshot_init(struct kbase_context *kctx,
 /**
  * kbase_job_fault_get_reg_snapshot - Read the interested registers for
  *      failed job dump
+ *
  * @kctx: KBase context pointer
- * @return true if getting registers successfully
+ *
+ * Return: true if getting registers successfully
  */
 bool kbase_job_fault_get_reg_snapshot(struct kbase_context *kctx);