include/linux/crash_core.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef LINUX_CRASH_CORE_H
   3 #define LINUX_CRASH_CORE_H
   4
   5 #include <linux/linkage.h>
   6 #include <linux/elfcore.h>
   7 #include <linux/elf.h>
   8 #ifdef CONFIG_ARCH_HAS_GENERIC_CRASHKERNEL_RESERVATION
   9 #include <asm/crash_core.h>
  10 #endif
  11
  12 /* Location of a reserved region to hold the crash kernel.
  13  */
  14 extern struct resource crashk_res;
  15 extern struct resource crashk_low_res;
  16
  17 #define CRASH_CORE_NOTE_NAME       "CORE"
  18 #define CRASH_CORE_NOTE_HEAD_BYTES ALIGN(sizeof(struct elf_note), 4)
  19 #define CRASH_CORE_NOTE_NAME_BYTES ALIGN(sizeof(CRASH_CORE_NOTE_NAME), 4)
  20 #define CRASH_CORE_NOTE_DESC_BYTES ALIGN(sizeof(struct elf_prstatus), 4)
  21
  22 /*
  23  * The per-cpu notes area is a list of notes terminated by a "NULL"
  24  * note header.  For kdump, the code in vmcore.c runs in the context
  25  * of the second kernel to combine them into one note.
  26  */
  27 #define CRASH_CORE_NOTE_BYTES      ((CRASH_CORE_NOTE_HEAD_BYTES * 2) +  \
  28                                      CRASH_CORE_NOTE_NAME_BYTES +       \
  29                                      CRASH_CORE_NOTE_DESC_BYTES)
  30
  31 #define VMCOREINFO_BYTES           PAGE_SIZE
  32 #define VMCOREINFO_NOTE_NAME       "VMCOREINFO"
  33 #define VMCOREINFO_NOTE_NAME_BYTES ALIGN(sizeof(VMCOREINFO_NOTE_NAME), 4)
  34 #define VMCOREINFO_NOTE_SIZE       ((CRASH_CORE_NOTE_HEAD_BYTES * 2) +  \
  35                                      VMCOREINFO_NOTE_NAME_BYTES +       \
  36                                      VMCOREINFO_BYTES)
  37
  38 typedef u32 note_buf_t[CRASH_CORE_NOTE_BYTES/4];
  39 /* Per cpu memory for storing cpu states in case of system crash. */
  40 extern note_buf_t __percpu *crash_notes;
  41
  42 void crash_update_vmcoreinfo_safecopy(void *ptr);
  43 void crash_save_vmcoreinfo(void);
  44 void arch_crash_save_vmcoreinfo(void);
  45 __printf(1, 2)
  46 void vmcoreinfo_append_str(const char *fmt, ...);
  47 phys_addr_t paddr_vmcoreinfo_note(void);
  48
  49 #define VMCOREINFO_OSRELEASE(value) \
  50         vmcoreinfo_append_str("OSRELEASE=%s\n", value)
  51 #define VMCOREINFO_BUILD_ID()                                           \
  52         ({                                                              \
  53                 static_assert(sizeof(vmlinux_build_id) == 20);          \
  54                 vmcoreinfo_append_str("BUILD-ID=%20phN\n", vmlinux_build_id); \
  55         })
  56
  57 #define VMCOREINFO_PAGESIZE(value) \
  58         vmcoreinfo_append_str("PAGESIZE=%ld\n", value)
  59 #define VMCOREINFO_SYMBOL(name) \
  60         vmcoreinfo_append_str("SYMBOL(%s)=%lx\n", #name, (unsigned long)&name)
  61 #define VMCOREINFO_SYMBOL_ARRAY(name) \
  62         vmcoreinfo_append_str("SYMBOL(%s)=%lx\n", #name, (unsigned long)name)
  63 #define VMCOREINFO_SIZE(name) \
  64         vmcoreinfo_append_str("SIZE(%s)=%lu\n", #name, \
  65                               (unsigned long)sizeof(name))
  66 #define VMCOREINFO_STRUCT_SIZE(name) \
  67         vmcoreinfo_append_str("SIZE(%s)=%lu\n", #name, \
  68                               (unsigned long)sizeof(struct name))
  69 #define VMCOREINFO_OFFSET(name, field) \
  70         vmcoreinfo_append_str("OFFSET(%s.%s)=%lu\n", #name, #field, \
  71                               (unsigned long)offsetof(struct name, field))
  72 #define VMCOREINFO_TYPE_OFFSET(name, field) \
  73         vmcoreinfo_append_str("OFFSET(%s.%s)=%lu\n", #name, #field, \
  74                               (unsigned long)offsetof(name, field))
  75 #define VMCOREINFO_LENGTH(name, value) \
  76         vmcoreinfo_append_str("LENGTH(%s)=%lu\n", #name, (unsigned long)value)
  77 #define VMCOREINFO_NUMBER(name) \
  78         vmcoreinfo_append_str("NUMBER(%s)=%ld\n", #name, (long)name)
  79 #define VMCOREINFO_CONFIG(name) \
  80         vmcoreinfo_append_str("CONFIG_%s=y\n", #name)
  81
  82 extern unsigned char *vmcoreinfo_data;
  83 extern size_t vmcoreinfo_size;
  84 extern u32 *vmcoreinfo_note;
  85
  86 Elf_Word *append_elf_note(Elf_Word *buf, char *name, unsigned int type,
  87                           void *data, size_t data_len);
  88 void final_note(Elf_Word *buf);
  89
  90 #ifdef CONFIG_ARCH_HAS_GENERIC_CRASHKERNEL_RESERVATION
  91 #ifndef DEFAULT_CRASH_KERNEL_LOW_SIZE
  92 #define DEFAULT_CRASH_KERNEL_LOW_SIZE  (128UL << 20)
  93 #endif
  94 #endif
  95
  96 int __init parse_crashkernel(char *cmdline, unsigned long long system_ram,
  97                 unsigned long long *crash_size, unsigned long long *crash_base,
  98                 unsigned long long *low_size, bool *high);
  99
 100 #ifdef CONFIG_ARCH_HAS_GENERIC_CRASHKERNEL_RESERVATION
 101 #ifndef DEFAULT_CRASH_KERNEL_LOW_SIZE
 102 #define DEFAULT_CRASH_KERNEL_LOW_SIZE   (128UL << 20)
 103 #endif
 104 #ifndef CRASH_ALIGN
 105 #define CRASH_ALIGN                     SZ_2M
 106 #endif
 107 #ifndef CRASH_ADDR_LOW_MAX
 108 #define CRASH_ADDR_LOW_MAX              SZ_4G
 109 #endif
 110 #ifndef CRASH_ADDR_HIGH_MAX
 111 #define CRASH_ADDR_HIGH_MAX             memblock_end_of_DRAM()
 112 #endif
 113
 114 void __init reserve_crashkernel_generic(char *cmdline,
 115                 unsigned long long crash_size,
 116                 unsigned long long crash_base,
 117                 unsigned long long crash_low_size,
 118                 bool high);
 119 #else
 120 static inline void __init reserve_crashkernel_generic(char *cmdline,
 121                 unsigned long long crash_size,
 122                 unsigned long long crash_base,
 123                 unsigned long long crash_low_size,
 124                 bool high)
 125 {}
 126 #endif
 127
 128 /* Alignment required for elf header segment */
 129 #define ELF_CORE_HEADER_ALIGN   4096
 130
 131 struct crash_mem {
 132         unsigned int max_nr_ranges;
 133         unsigned int nr_ranges;
 134         struct range ranges[] __counted_by(max_nr_ranges);
 135 };
 136
 137 extern int crash_exclude_mem_range(struct crash_mem *mem,
 138                                    unsigned long long mstart,
 139                                    unsigned long long mend);
 140 extern int crash_prepare_elf64_headers(struct crash_mem *mem, int need_kernel_map,
 141                                        void **addr, unsigned long *sz);
 142
 143 struct kimage;
 144 struct kexec_segment;
 145
 146 #define KEXEC_CRASH_HP_NONE                     0
 147 #define KEXEC_CRASH_HP_ADD_CPU                  1
 148 #define KEXEC_CRASH_HP_REMOVE_CPU               2
 149 #define KEXEC_CRASH_HP_ADD_MEMORY               3
 150 #define KEXEC_CRASH_HP_REMOVE_MEMORY            4
 151 #define KEXEC_CRASH_HP_INVALID_CPU              -1U
 152
 153 #endif /* LINUX_CRASH_CORE_H */