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
   9 #define CRASH_CORE_NOTE_NAME       "CORE"
  10 #define CRASH_CORE_NOTE_HEAD_BYTES ALIGN(sizeof(struct elf_note), 4)
  11 #define CRASH_CORE_NOTE_NAME_BYTES ALIGN(sizeof(CRASH_CORE_NOTE_NAME), 4)
  12 #define CRASH_CORE_NOTE_DESC_BYTES ALIGN(sizeof(struct elf_prstatus), 4)
  13
  14 /*
  15  * The per-cpu notes area is a list of notes terminated by a "NULL"
  16  * note header.  For kdump, the code in vmcore.c runs in the context
  17  * of the second kernel to combine them into one note.
  18  */
  19 #define CRASH_CORE_NOTE_BYTES      ((CRASH_CORE_NOTE_HEAD_BYTES * 2) +  \
  20                                      CRASH_CORE_NOTE_NAME_BYTES +       \
  21                                      CRASH_CORE_NOTE_DESC_BYTES)
  22
  23 #define VMCOREINFO_BYTES           PAGE_SIZE
  24 #define VMCOREINFO_NOTE_NAME       "VMCOREINFO"
  25 #define VMCOREINFO_NOTE_NAME_BYTES ALIGN(sizeof(VMCOREINFO_NOTE_NAME), 4)
  26 #define VMCOREINFO_NOTE_SIZE       ((CRASH_CORE_NOTE_HEAD_BYTES * 2) +  \
  27                                      VMCOREINFO_NOTE_NAME_BYTES +       \
  28                                      VMCOREINFO_BYTES)
  29
  30 typedef u32 note_buf_t[CRASH_CORE_NOTE_BYTES/4];
  31 /* Per cpu memory for storing cpu states in case of system crash. */
  32 extern note_buf_t __percpu *crash_notes;
  33
  34 void crash_update_vmcoreinfo_safecopy(void *ptr);
  35 void crash_save_vmcoreinfo(void);
  36 void arch_crash_save_vmcoreinfo(void);
  37 __printf(1, 2)
  38 void vmcoreinfo_append_str(const char *fmt, ...);
  39 phys_addr_t paddr_vmcoreinfo_note(void);
  40
  41 #define VMCOREINFO_OSRELEASE(value) \
  42         vmcoreinfo_append_str("OSRELEASE=%s\n", value)
  43 #define VMCOREINFO_BUILD_ID()                                           \
  44         ({                                                              \
  45                 static_assert(sizeof(vmlinux_build_id) == 20);          \
  46                 vmcoreinfo_append_str("BUILD-ID=%20phN\n", vmlinux_build_id); \
  47         })
  48
  49 #define VMCOREINFO_PAGESIZE(value) \
  50         vmcoreinfo_append_str("PAGESIZE=%ld\n", value)
  51 #define VMCOREINFO_SYMBOL(name) \
  52         vmcoreinfo_append_str("SYMBOL(%s)=%lx\n", #name, (unsigned long)&name)
  53 #define VMCOREINFO_SYMBOL_ARRAY(name) \
  54         vmcoreinfo_append_str("SYMBOL(%s)=%lx\n", #name, (unsigned long)name)
  55 #define VMCOREINFO_SIZE(name) \
  56         vmcoreinfo_append_str("SIZE(%s)=%lu\n", #name, \
  57                               (unsigned long)sizeof(name))
  58 #define VMCOREINFO_STRUCT_SIZE(name) \
  59         vmcoreinfo_append_str("SIZE(%s)=%lu\n", #name, \
  60                               (unsigned long)sizeof(struct name))
  61 #define VMCOREINFO_OFFSET(name, field) \
  62         vmcoreinfo_append_str("OFFSET(%s.%s)=%lu\n", #name, #field, \
  63                               (unsigned long)offsetof(struct name, field))
  64 #define VMCOREINFO_TYPE_OFFSET(name, field) \
  65         vmcoreinfo_append_str("OFFSET(%s.%s)=%lu\n", #name, #field, \
  66                               (unsigned long)offsetof(name, field))
  67 #define VMCOREINFO_LENGTH(name, value) \
  68         vmcoreinfo_append_str("LENGTH(%s)=%lu\n", #name, (unsigned long)value)
  69 #define VMCOREINFO_NUMBER(name) \
  70         vmcoreinfo_append_str("NUMBER(%s)=%ld\n", #name, (long)name)
  71 #define VMCOREINFO_CONFIG(name) \
  72         vmcoreinfo_append_str("CONFIG_%s=y\n", #name)
  73
  74 extern unsigned char *vmcoreinfo_data;
  75 extern size_t vmcoreinfo_size;
  76 extern u32 *vmcoreinfo_note;
  77
  78 Elf_Word *append_elf_note(Elf_Word *buf, char *name, unsigned int type,
  79                           void *data, size_t data_len);
  80 void final_note(Elf_Word *buf);
  81
  82 int __init parse_crashkernel(char *cmdline, unsigned long long system_ram,
  83                 unsigned long long *crash_size, unsigned long long *crash_base);
  84 int parse_crashkernel_high(char *cmdline, unsigned long long system_ram,
  85                 unsigned long long *crash_size, unsigned long long *crash_base);
  86 int parse_crashkernel_low(char *cmdline, unsigned long long system_ram,
  87                 unsigned long long *crash_size, unsigned long long *crash_base);
  88
  89 /* Alignment required for elf header segment */
  90 #define ELF_CORE_HEADER_ALIGN   4096
  91
  92 struct crash_mem {
  93         unsigned int max_nr_ranges;
  94         unsigned int nr_ranges;
  95         struct range ranges[];
  96 };
  97
  98 extern int crash_exclude_mem_range(struct crash_mem *mem,
  99                                    unsigned long long mstart,
 100                                    unsigned long long mend);
 101 extern int crash_prepare_elf64_headers(struct crash_mem *mem, int need_kernel_map,
 102                                        void **addr, unsigned long *sz);
 103
 104 struct kimage;
 105 struct kexec_segment;
 106
 107 #define KEXEC_CRASH_HP_NONE                     0
 108 #define KEXEC_CRASH_HP_ADD_CPU                  1
 109 #define KEXEC_CRASH_HP_REMOVE_CPU               2
 110 #define KEXEC_CRASH_HP_ADD_MEMORY               3
 111 #define KEXEC_CRASH_HP_REMOVE_MEMORY            4
 112 #define KEXEC_CRASH_HP_INVALID_CPU              -1U
 113
 114 #endif /* LINUX_CRASH_CORE_H */