arch/powerpc/include/asm/fadump.h

   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 /* The upper limit percentage for user specified boot memory size (25%) */
  47 #define MAX_BOOT_MEM_RATIO                      4
  48
  49 #define memblock_num_regions(memblock_type)     (memblock.memblock_type.cnt)
  50
  51 /* Alignement per CMA requirement. */
  52 #define FADUMP_CMA_ALIGNMENT    (PAGE_SIZE <<                           \
  53                         max_t(unsigned long, MAX_ORDER - 1, pageblock_order))
  54
  55 /* Firmware provided dump sections */
  56 #define FADUMP_CPU_STATE_DATA   0x0001
  57 #define FADUMP_HPTE_REGION      0x0002
  58 #define FADUMP_REAL_MODE_REGION 0x0011
  59
  60 /* Dump request flag */
  61 #define FADUMP_REQUEST_FLAG     0x00000001
  62
  63 /* FAD commands */
  64 #define FADUMP_REGISTER         1
  65 #define FADUMP_UNREGISTER       2
  66 #define FADUMP_INVALIDATE       3
  67
  68 /* Dump status flag */
  69 #define FADUMP_ERROR_FLAG       0x2000
  70
  71 #define FADUMP_CPU_ID_MASK      ((1UL << 32) - 1)
  72
  73 #define CPU_UNKNOWN             (~((u32)0))
  74
  75 /* Utility macros */
  76 #define SKIP_TO_NEXT_CPU(reg_entry)                                     \
  77 ({                                                                      \
  78         while (be64_to_cpu(reg_entry->reg_id) != REG_ID("CPUEND"))      \
  79                 reg_entry++;                                            \
  80         reg_entry++;                                                    \
  81 })
  82
  83 extern int crashing_cpu;
  84
  85 /* Kernel Dump section info */
  86 struct fadump_section {
  87         __be32  request_flag;
  88         __be16  source_data_type;
  89         __be16  error_flags;
  90         __be64  source_address;
  91         __be64  source_len;
  92         __be64  bytes_dumped;
  93         __be64  destination_address;
  94 };
  95
  96 /* ibm,configure-kernel-dump header. */
  97 struct fadump_section_header {
  98         __be32  dump_format_version;
  99         __be16  dump_num_sections;
 100         __be16  dump_status_flag;
 101         __be32  offset_first_dump_section;
 102
 103         /* Fields for disk dump option. */
 104         __be32  dd_block_size;
 105         __be64  dd_block_offset;
 106         __be64  dd_num_blocks;
 107         __be32  dd_offset_disk_path;
 108
 109         /* Maximum time allowed to prevent an automatic dump-reboot. */
 110         __be32  max_time_auto;
 111 };
 112
 113 /*
 114  * Firmware Assisted dump memory structure. This structure is required for
 115  * registering future kernel dump with power firmware through rtas call.
 116  *
 117  * No disk dump option. Hence disk dump path string section is not included.
 118  */
 119 struct fadump_mem_struct {
 120         struct fadump_section_header    header;
 121
 122         /* Kernel dump sections */
 123         struct fadump_section           cpu_state_data;
 124         struct fadump_section           hpte_region;
 125         struct fadump_section           rmr_region;
 126 };
 127
 128 /* Firmware-assisted dump configuration details. */
 129 struct fw_dump {
 130         unsigned long   cpu_state_data_size;
 131         unsigned long   hpte_region_size;
 132         unsigned long   boot_memory_size;
 133         unsigned long   reserve_dump_area_start;
 134         unsigned long   reserve_dump_area_size;
 135         /* cmd line option during boot */
 136         unsigned long   reserve_bootvar;
 137
 138         unsigned long   fadumphdr_addr;
 139         unsigned long   cpu_notes_buf;
 140         unsigned long   cpu_notes_buf_size;
 141
 142         int             ibm_configure_kernel_dump;
 143
 144         unsigned long   fadump_enabled:1;
 145         unsigned long   fadump_supported:1;
 146         unsigned long   dump_active:1;
 147         unsigned long   dump_registered:1;
 148         unsigned long   nocma:1;
 149 };
 150
 151 /*
 152  * Copy the ascii values for first 8 characters from a string into u64
 153  * variable at their respective indexes.
 154  * e.g.
 155  *  The string "FADMPINF" will be converted into 0x4641444d50494e46
 156  */
 157 static inline u64 str_to_u64(const char *str)
 158 {
 159         u64 val = 0;
 160         int i;
 161
 162         for (i = 0; i < sizeof(val); i++)
 163                 val = (*str) ? (val << 8) | *str++ : val << 8;
 164         return val;
 165 }
 166 #define STR_TO_HEX(x)   str_to_u64(x)
 167 #define REG_ID(x)       str_to_u64(x)
 168
 169 #define FADUMP_CRASH_INFO_MAGIC         STR_TO_HEX("FADMPINF")
 170 #define REGSAVE_AREA_MAGIC              STR_TO_HEX("REGSAVE")
 171
 172 /* The firmware-assisted dump format.
 173  *
 174  * The register save area is an area in the partition's memory used to preserve
 175  * the register contents (CPU state data) for the active CPUs during a firmware
 176  * assisted dump. The dump format contains register save area header followed
 177  * by register entries. Each list of registers for a CPU starts with
 178  * "CPUSTRT" and ends with "CPUEND".
 179  */
 180
 181 /* Register save area header. */
 182 struct fadump_reg_save_area_header {
 183         __be64          magic_number;
 184         __be32          version;
 185         __be32          num_cpu_offset;
 186 };
 187
 188 /* Register entry. */
 189 struct fadump_reg_entry {
 190         __be64          reg_id;
 191         __be64          reg_value;
 192 };
 193
 194 /* fadump crash info structure */
 195 struct fadump_crash_info_header {
 196         u64             magic_number;
 197         u64             elfcorehdr_addr;
 198         u32             crashing_cpu;
 199         struct pt_regs  regs;
 200         struct cpumask  online_mask;
 201 };
 202
 203 struct fad_crash_memory_ranges {
 204         unsigned long long      base;
 205         unsigned long long      size;
 206 };
 207
 208 extern int is_fadump_memory_area(u64 addr, ulong size);
 209 extern int early_init_dt_scan_fw_dump(unsigned long node,
 210                 const char *uname, int depth, void *data);
 211 extern int fadump_reserve_mem(void);
 212 extern int setup_fadump(void);
 213 extern int is_fadump_active(void);
 214 extern int should_fadump_crash(void);
 215 extern void crash_fadump(struct pt_regs *, const char *);
 216 extern void fadump_cleanup(void);
 217
 218 #else   /* CONFIG_FA_DUMP */
 219 static inline int is_fadump_active(void) { return 0; }
 220 static inline int should_fadump_crash(void) { return 0; }
 221 static inline void crash_fadump(struct pt_regs *regs, const char *str) { }
 222 #endif
 223 #endif