xref: /linux/drivers/gpu/drm/amd/amdgpu/amdgpu_dev_coredump.h (revision fab183d632628381b466a41479489541ac0e29a0)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright 2024 Advanced Micro Devices, Inc.
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the "Software"),
7  * to deal in the Software without restriction, including without limitation
8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9  * and/or sell copies of the Software, and to permit persons to whom the
10  * Software is furnished to do so, subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be included in
13  * all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
19  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21  * OTHER DEALINGS IN THE SOFTWARE.
22  *
23  */
24 
25 #ifndef __AMDGPU_DEV_COREDUMP_H__
26 #define __AMDGPU_DEV_COREDUMP_H__
27 
28 #include "amdgpu.h"
29 
30 #ifdef CONFIG_DEV_COREDUMP
31 
32 #define AMDGPU_COREDUMP_VERSION "1"
33 
34 struct amdgpu_coredump_ring {
35 	u64				rptr;
36 	u64				wptr;
37 	u32				*ring_dw;
38 	u32				ring_index;
39 };
40 
41 struct amdgpu_coredump_ib_info {
42 	uint64_t			gpu_addr;
43 	u32				ib_size_dw;
44 };
45 
46 struct amdgpu_coredump_info {
47 	struct amdgpu_device            *adev;
48 	struct amdgpu_task_info         reset_task_info;
49 	struct timespec64               reset_time;
50 
51 	bool                            skip_vram_check;
52 	bool                            reset_vram_lost;
53 	struct amdgpu_ring              *ring;
54 
55 	struct amdgpu_coredump_ring	*rings;
56 	u32				num_rings;
57 
58 	/* Readable form of coredevdump, generate once to speed up
59 	 * reading it (see drm_coredump_printer's documentation).
60 	 */
61 	ssize_t				formatted_size;
62 	char				*formatted;
63 
64 	unsigned int			pasid;
65 	unsigned int			vmid;
66 	int				num_ibs;
67 	struct amdgpu_coredump_ib_info	ibs[] __counted_by(num_ibs);
68 };
69 #endif
70 
71 void amdgpu_coredump(struct amdgpu_device *adev, bool skip_vram_check,
72 		     bool vram_lost, struct amdgpu_job *job);
73 void amdgpu_coredump_init(struct amdgpu_device *adev);
74 void amdgpu_coredump_fini(struct amdgpu_device *adev);
75 #endif
76