hc
2023-12-06 08f87f769b595151be1afeff53e144f543faa614
kernel/drivers/gpu/arm/bifrost/arbiter/mali_kbase_arbiter_pm.h
....@@ -1,7 +1,7 @@
11 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
22 /*
33 *
4
- * (C) COPYRIGHT 2019-2021 ARM Limited. All rights reserved.
4
+ * (C) COPYRIGHT 2019-2022 ARM Limited. All rights reserved.
55 *
66 * This program is free software and is provided to you under the terms of the
77 * GNU General Public License version 2 as published by the Free Software
....@@ -20,8 +20,7 @@
2020 */
2121
2222 /**
23
- * @file
24
- * Mali arbiter power manager state machine and APIs
23
+ * DOC: Mali arbiter power manager state machine and APIs
2524 */
2625
2726 #ifndef _MALI_KBASE_ARBITER_PM_H_
....@@ -102,12 +101,15 @@
102101 * @kbdev: The kbase device structure for the device (must be a valid pointer)
103102 *
104103 * Install interrupts and set the interrupt_install flag to true.
104
+ *
105
+ * Return: 0 if success, or a Linux error code
105106 */
106107 int kbase_arbiter_pm_install_interrupts(struct kbase_device *kbdev);
107108
108109 /**
109110 * kbase_arbiter_pm_vm_event() - Dispatch VM event to the state machine
110111 * @kbdev: The kbase device structure for the device (must be a valid pointer)
112
+ * @event: The event to dispatch
111113 *
112114 * The state machine function. Receives events and transitions states
113115 * according the event received and the current state