1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Firmware-Assisted Dump support on POWERVM platform.
4 *
5 * Copyright 2011, Mahesh Salgaonkar, IBM Corporation.
6 * Copyright 2019, Hari Bathini, IBM Corporation.
7 */
8
9#ifndef _PSERIES_RTAS_FADUMP_H
10#define _PSERIES_RTAS_FADUMP_H
11
12/*
13 * On some Power systems where RMO is 128MB, it still requires minimum of
14 * 256MB for kernel to boot successfully. When kdump infrastructure is
15 * configured to save vmcore over network, we run into OOM issue while
16 * loading modules related to network setup. Hence we need additional 64M
17 * of memory to avoid OOM issue.
18 */
19#define RTAS_FADUMP_MIN_BOOT_MEM ((0x1UL << 28) + (0x1UL << 26))
20
21/* Firmware provided dump sections */
22#define RTAS_FADUMP_CPU_STATE_DATA 0x0001
23#define RTAS_FADUMP_HPTE_REGION 0x0002
24#define RTAS_FADUMP_REAL_MODE_REGION 0x0011
25
26/* Dump request flag */
27#define RTAS_FADUMP_REQUEST_FLAG 0x00000001
28
29/* Dump status flag */
30#define RTAS_FADUMP_ERROR_FLAG 0x2000
31
32/* Kernel Dump section info */
33struct rtas_fadump_section {
34 __be32 request_flag;
35 __be16 source_data_type;
36 __be16 error_flags;
37 __be64 source_address;
38 __be64 source_len;
39 __be64 bytes_dumped;
40 __be64 destination_address;
41};
42
43/* ibm,configure-kernel-dump header. */
44struct rtas_fadump_section_header {
45 __be32 dump_format_version;
46 __be16 dump_num_sections;
47 __be16 dump_status_flag;
48 __be32 offset_first_dump_section;
49
50 /* Fields for disk dump option. */
51 __be32 dd_block_size;
52 __be64 dd_block_offset;
53 __be64 dd_num_blocks;
54 __be32 dd_offset_disk_path;
55
56 /* Maximum time allowed to prevent an automatic dump-reboot. */
57 __be32 max_time_auto;
58};
59
60/*
61 * Firmware Assisted dump memory structure. This structure is required for
62 * registering future kernel dump with power firmware through rtas call.
63 *
64 * No disk dump option. Hence disk dump path string section is not included.
65 */
66struct rtas_fadump_mem_struct {
67 struct rtas_fadump_section_header header;
68
69 /* Kernel dump sections */
70 struct rtas_fadump_section cpu_state_data;
71 struct rtas_fadump_section hpte_region;
72
73 /*
74 * TODO: Extend multiple boot memory regions support in the kernel
75 * for this platform.
76 */
77 struct rtas_fadump_section rmr_region;
78};
79
80/*
81 * The firmware-assisted dump format.
82 *
83 * The register save area is an area in the partition's memory used to preserve
84 * the register contents (CPU state data) for the active CPUs during a firmware
85 * assisted dump. The dump format contains register save area header followed
86 * by register entries. Each list of registers for a CPU starts with "CPUSTRT"
87 * and ends with "CPUEND".
88 */
89
90/* Register save area header. */
91struct rtas_fadump_reg_save_area_header {
92 __be64 magic_number;
93 __be32 version;
94 __be32 num_cpu_offset;
95};
96
97/* Register entry. */
98struct rtas_fadump_reg_entry {
99 __be64 reg_id;
100 __be64 reg_value;
101};
102
103/* Utility macros */
104#define RTAS_FADUMP_SKIP_TO_NEXT_CPU(reg_entry) \
105({ \
106 while (be64_to_cpu(reg_entry->reg_id) != \
107 fadump_str_to_u64("CPUEND")) \
108 reg_entry++; \
109 reg_entry++; \
110})
111
112#define RTAS_FADUMP_CPU_ID_MASK ((1UL << 32) - 1)
113
114#endif /* _PSERIES_RTAS_FADUMP_H */
115

source code of linux/arch/powerpc/platforms/pseries/rtas-fadump.h