tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/*
2 * Firmware Assisted dump header file.
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
17 *
18 * Copyright 2011 IBM Corporation
19 * Author: Mahesh Salgaonkar <mahesh@linux.vnet.ibm.com>
20 */
21
22#ifndef __PPC64_FA_DUMP_H__
23#define __PPC64_FA_DUMP_H__
24
25#ifdef CONFIG_FA_DUMP
26
27/*
28 * The RMA region will be saved for later dumping when kernel crashes.
29 * RMA is Real Mode Area, the first block of logical memory address owned
30 * by logical partition, containing the storage that may be accessed with
31 * translate off.
32 */
33#define RMA_START 0x0
34#define RMA_END (ppc64_rma_size)
35
36/*
37 * On some Power systems where RMO is 128MB, it still requires minimum of
38 * 256MB for kernel to boot successfully. When kdump infrastructure is
39 * configured to save vmcore over network, we run into OOM issue while
40 * loading modules related to network setup. Hence we need aditional 64M
41 * of memory to avoid OOM issue.
42 */
43#define MIN_BOOT_MEM (((RMA_END < (0x1UL << 28)) ? (0x1UL << 28) : RMA_END) \
44 + (0x1UL << 26))
45
46#define memblock_num_regions(memblock_type) (memblock.memblock_type.cnt)
47
48/* Firmware provided dump sections */
49#define FADUMP_CPU_STATE_DATA 0x0001
50#define FADUMP_HPTE_REGION 0x0002
51#define FADUMP_REAL_MODE_REGION 0x0011
52
53/* Dump request flag */
54#define FADUMP_REQUEST_FLAG 0x00000001
55
56/* FAD commands */
57#define FADUMP_REGISTER 1
58#define FADUMP_UNREGISTER 2
59#define FADUMP_INVALIDATE 3
60
61/* Dump status flag */
62#define FADUMP_ERROR_FLAG 0x2000
63
64#define FADUMP_CPU_ID_MASK ((1UL << 32) - 1)
65
66#define CPU_UNKNOWN (~((u32)0))
67
68/* Utility macros */
69#define SKIP_TO_NEXT_CPU(reg_entry) \
70({ \
71 while (be64_to_cpu(reg_entry->reg_id) != REG_ID("CPUEND")) \
72 reg_entry++; \
73 reg_entry++; \
74})
75
76extern int crashing_cpu;
77
78/* Kernel Dump section info */
79struct fadump_section {
80 __be32 request_flag;
81 __be16 source_data_type;
82 __be16 error_flags;
83 __be64 source_address;
84 __be64 source_len;
85 __be64 bytes_dumped;
86 __be64 destination_address;
87};
88
89/* ibm,configure-kernel-dump header. */
90struct fadump_section_header {
91 __be32 dump_format_version;
92 __be16 dump_num_sections;
93 __be16 dump_status_flag;
94 __be32 offset_first_dump_section;
95
96 /* Fields for disk dump option. */
97 __be32 dd_block_size;
98 __be64 dd_block_offset;
99 __be64 dd_num_blocks;
100 __be32 dd_offset_disk_path;
101
102 /* Maximum time allowed to prevent an automatic dump-reboot. */
103 __be32 max_time_auto;
104};
105
106/*
107 * Firmware Assisted dump memory structure. This structure is required for
108 * registering future kernel dump with power firmware through rtas call.
109 *
110 * No disk dump option. Hence disk dump path string section is not included.
111 */
112struct fadump_mem_struct {
113 struct fadump_section_header header;
114
115 /* Kernel dump sections */
116 struct fadump_section cpu_state_data;
117 struct fadump_section hpte_region;
118 struct fadump_section rmr_region;
119};
120
121/* Firmware-assisted dump configuration details. */
122struct fw_dump {
123 unsigned long cpu_state_data_size;
124 unsigned long hpte_region_size;
125 unsigned long boot_memory_size;
126 unsigned long reserve_dump_area_start;
127 unsigned long reserve_dump_area_size;
128 /* cmd line option during boot */
129 unsigned long reserve_bootvar;
130
131 unsigned long fadumphdr_addr;
132 unsigned long cpu_notes_buf;
133 unsigned long cpu_notes_buf_size;
134
135 int ibm_configure_kernel_dump;
136
137 unsigned long fadump_enabled:1;
138 unsigned long fadump_supported:1;
139 unsigned long dump_active:1;
140 unsigned long dump_registered:1;
141};
142
143/*
144 * Copy the ascii values for first 8 characters from a string into u64
145 * variable at their respective indexes.
146 * e.g.
147 * The string "FADMPINF" will be converted into 0x4641444d50494e46
148 */
149static inline u64 str_to_u64(const char *str)
150{
151 u64 val = 0;
152 int i;
153
154 for (i = 0; i < sizeof(val); i++)
155 val = (*str) ? (val << 8) | *str++ : val << 8;
156 return val;
157}
158#define STR_TO_HEX(x) str_to_u64(x)
159#define REG_ID(x) str_to_u64(x)
160
161#define FADUMP_CRASH_INFO_MAGIC STR_TO_HEX("FADMPINF")
162#define REGSAVE_AREA_MAGIC STR_TO_HEX("REGSAVE")
163
164/* The firmware-assisted dump format.
165 *
166 * The register save area is an area in the partition's memory used to preserve
167 * the register contents (CPU state data) for the active CPUs during a firmware
168 * assisted dump. The dump format contains register save area header followed
169 * by register entries. Each list of registers for a CPU starts with
170 * "CPUSTRT" and ends with "CPUEND".
171 */
172
173/* Register save area header. */
174struct fadump_reg_save_area_header {
175 __be64 magic_number;
176 __be32 version;
177 __be32 num_cpu_offset;
178};
179
180/* Register entry. */
181struct fadump_reg_entry {
182 __be64 reg_id;
183 __be64 reg_value;
184};
185
186/* fadump crash info structure */
187struct fadump_crash_info_header {
188 u64 magic_number;
189 u64 elfcorehdr_addr;
190 u32 crashing_cpu;
191 struct pt_regs regs;
192 struct cpumask online_mask;
193};
194
195/* Crash memory ranges */
196#define INIT_CRASHMEM_RANGES (INIT_MEMBLOCK_REGIONS + 2)
197
198struct fad_crash_memory_ranges {
199 unsigned long long base;
200 unsigned long long size;
201};
202
203extern int early_init_dt_scan_fw_dump(unsigned long node,
204 const char *uname, int depth, void *data);
205extern int fadump_reserve_mem(void);
206extern int setup_fadump(void);
207extern int is_fadump_active(void);
208extern void crash_fadump(struct pt_regs *, const char *);
209extern void fadump_cleanup(void);
210
211#else /* CONFIG_FA_DUMP */
212static inline int is_fadump_active(void) { return 0; }
213static inline void crash_fadump(struct pt_regs *regs, const char *str) { }
214#endif
215#endif