/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
/*
|
*
|
* (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
|
* Foundation, and any use by you of this program is subject to the terms
|
* of such GNU license.
|
*
|
* This program is distributed in the hope that it will be useful,
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
* GNU General Public License for more details.
|
*
|
* You should have received a copy of the GNU General Public License
|
* along with this program; if not, you can access it online at
|
* http://www.gnu.org/licenses/gpl-2.0.html.
|
*
|
*/
|
|
#ifndef _KBASE_DEBUG_JOB_FAULT_H
|
#define _KBASE_DEBUG_JOB_FAULT_H
|
|
#include <linux/debugfs.h>
|
#include <linux/seq_file.h>
|
|
#define REGISTER_DUMP_TERMINATION_FLAG 0xFFFFFFFF
|
|
/**
|
* kbase_debug_job_fault_dev_init - Create the fault event wait queue
|
* per device and initialize the required lists.
|
* @kbdev: Device pointer
|
*
|
* Return: Zero on success or a negative error code.
|
*/
|
int kbase_debug_job_fault_dev_init(struct kbase_device *kbdev);
|
|
/**
|
* kbase_debug_job_fault_debugfs_init - Initialize job fault debug sysfs
|
* @kbdev: Device pointer
|
*/
|
void kbase_debug_job_fault_debugfs_init(struct kbase_device *kbdev);
|
|
/**
|
* kbase_debug_job_fault_dev_term - Clean up resources created in
|
* kbase_debug_job_fault_dev_init.
|
* @kbdev: Device pointer
|
*/
|
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
|
*/
|
int kbase_debug_job_fault_context_init(struct kbase_context *kctx);
|
|
/**
|
* kbase_debug_job_fault_context_term - Release the relevant
|
* resource per context
|
* @kctx: KBase context pointer
|
*/
|
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.
|
*/
|
void kbase_debug_job_fault_kctx_unblock(struct kbase_context *kctx);
|
|
/**
|
* kbase_debug_job_fault_process - Process the failed job.
|
*
|
* @katom: The failed atom pointer
|
* @completion_code: the job status
|
*
|
* 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
|
*/
|
bool kbase_debug_job_fault_reg_snapshot_init(struct kbase_context *kctx,
|
int reg_range);
|
|
/**
|
* kbase_job_fault_get_reg_snapshot - Read the interested registers for
|
* failed job dump
|
*
|
* @kctx: KBase context pointer
|
*
|
* Return: true if getting registers successfully
|
*/
|
bool kbase_job_fault_get_reg_snapshot(struct kbase_context *kctx);
|
|
#endif /*_KBASE_DEBUG_JOB_FAULT_H*/
|
