kexec.h 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231
  1. #ifndef LINUX_KEXEC_H
  2. #define LINUX_KEXEC_H
  3. #ifdef CONFIG_KEXEC
  4. #include <linux/types.h>
  5. #include <linux/list.h>
  6. #include <linux/linkage.h>
  7. #include <linux/compat.h>
  8. #include <linux/ioport.h>
  9. #include <linux/elfcore.h>
  10. #include <linux/elf.h>
  11. #include <asm/kexec.h>
  12. /* Verify architecture specific macros are defined */
  13. #ifndef KEXEC_SOURCE_MEMORY_LIMIT
  14. #error KEXEC_SOURCE_MEMORY_LIMIT not defined
  15. #endif
  16. #ifndef KEXEC_DESTINATION_MEMORY_LIMIT
  17. #error KEXEC_DESTINATION_MEMORY_LIMIT not defined
  18. #endif
  19. #ifndef KEXEC_CONTROL_MEMORY_LIMIT
  20. #error KEXEC_CONTROL_MEMORY_LIMIT not defined
  21. #endif
  22. #ifndef KEXEC_CONTROL_PAGE_SIZE
  23. #error KEXEC_CONTROL_PAGE_SIZE not defined
  24. #endif
  25. #ifndef KEXEC_ARCH
  26. #error KEXEC_ARCH not defined
  27. #endif
  28. #ifndef KEXEC_CRASH_CONTROL_MEMORY_LIMIT
  29. #define KEXEC_CRASH_CONTROL_MEMORY_LIMIT KEXEC_CONTROL_MEMORY_LIMIT
  30. #endif
  31. #ifndef KEXEC_CRASH_MEM_ALIGN
  32. #define KEXEC_CRASH_MEM_ALIGN PAGE_SIZE
  33. #endif
  34. #define KEXEC_NOTE_HEAD_BYTES ALIGN(sizeof(struct elf_note), 4)
  35. #define KEXEC_CORE_NOTE_NAME "CORE"
  36. #define KEXEC_CORE_NOTE_NAME_BYTES ALIGN(sizeof(KEXEC_CORE_NOTE_NAME), 4)
  37. #define KEXEC_CORE_NOTE_DESC_BYTES ALIGN(sizeof(struct elf_prstatus), 4)
  38. /*
  39. * The per-cpu notes area is a list of notes terminated by a "NULL"
  40. * note header. For kdump, the code in vmcore.c runs in the context
  41. * of the second kernel to combine them into one note.
  42. */
  43. #ifndef KEXEC_NOTE_BYTES
  44. #define KEXEC_NOTE_BYTES ( (KEXEC_NOTE_HEAD_BYTES * 2) + \
  45. KEXEC_CORE_NOTE_NAME_BYTES + \
  46. KEXEC_CORE_NOTE_DESC_BYTES )
  47. #endif
  48. /*
  49. * This structure is used to hold the arguments that are used when loading
  50. * kernel binaries.
  51. */
  52. typedef unsigned long kimage_entry_t;
  53. #define IND_DESTINATION 0x1
  54. #define IND_INDIRECTION 0x2
  55. #define IND_DONE 0x4
  56. #define IND_SOURCE 0x8
  57. #define KEXEC_SEGMENT_MAX 16
  58. struct kexec_segment {
  59. void __user *buf;
  60. size_t bufsz;
  61. unsigned long mem; /* User space sees this as a (void *) ... */
  62. size_t memsz;
  63. };
  64. #ifdef CONFIG_COMPAT
  65. struct compat_kexec_segment {
  66. compat_uptr_t buf;
  67. compat_size_t bufsz;
  68. compat_ulong_t mem; /* User space sees this as a (void *) ... */
  69. compat_size_t memsz;
  70. };
  71. #endif
  72. struct kimage {
  73. kimage_entry_t head;
  74. kimage_entry_t *entry;
  75. kimage_entry_t *last_entry;
  76. unsigned long destination;
  77. unsigned long start;
  78. struct page *control_code_page;
  79. struct page *swap_page;
  80. unsigned long nr_segments;
  81. struct kexec_segment segment[KEXEC_SEGMENT_MAX];
  82. struct list_head control_pages;
  83. struct list_head dest_pages;
  84. struct list_head unuseable_pages;
  85. /* Address of next control page to allocate for crash kernels. */
  86. unsigned long control_page;
  87. /* Flags to indicate special processing */
  88. unsigned int type : 1;
  89. #define KEXEC_TYPE_DEFAULT 0
  90. #define KEXEC_TYPE_CRASH 1
  91. unsigned int preserve_context : 1;
  92. #ifdef ARCH_HAS_KIMAGE_ARCH
  93. struct kimage_arch arch;
  94. #endif
  95. };
  96. /* kexec interface functions */
  97. extern void machine_kexec(struct kimage *image);
  98. extern int machine_kexec_prepare(struct kimage *image);
  99. extern void machine_kexec_cleanup(struct kimage *image);
  100. extern asmlinkage long sys_kexec_load(unsigned long entry,
  101. unsigned long nr_segments,
  102. struct kexec_segment __user *segments,
  103. unsigned long flags);
  104. extern int kernel_kexec(void);
  105. #ifdef CONFIG_COMPAT
  106. extern asmlinkage long compat_sys_kexec_load(unsigned long entry,
  107. unsigned long nr_segments,
  108. struct compat_kexec_segment __user *segments,
  109. unsigned long flags);
  110. #endif
  111. extern struct page *kimage_alloc_control_pages(struct kimage *image,
  112. unsigned int order);
  113. extern void crash_kexec(struct pt_regs *);
  114. int kexec_should_crash(struct task_struct *);
  115. void crash_save_cpu(struct pt_regs *regs, int cpu);
  116. void crash_save_vmcoreinfo(void);
  117. void crash_map_reserved_pages(void);
  118. void crash_unmap_reserved_pages(void);
  119. void arch_crash_save_vmcoreinfo(void);
  120. __printf(1, 2)
  121. void vmcoreinfo_append_str(const char *fmt, ...);
  122. unsigned long paddr_vmcoreinfo_note(void);
  123. #define VMCOREINFO_OSRELEASE(value) \
  124. vmcoreinfo_append_str("OSRELEASE=%s\n", value)
  125. #define VMCOREINFO_PAGESIZE(value) \
  126. vmcoreinfo_append_str("PAGESIZE=%ld\n", value)
  127. #define VMCOREINFO_SYMBOL(name) \
  128. vmcoreinfo_append_str("SYMBOL(%s)=%lx\n", #name, (unsigned long)&name)
  129. #define VMCOREINFO_SIZE(name) \
  130. vmcoreinfo_append_str("SIZE(%s)=%lu\n", #name, \
  131. (unsigned long)sizeof(name))
  132. #define VMCOREINFO_STRUCT_SIZE(name) \
  133. vmcoreinfo_append_str("SIZE(%s)=%lu\n", #name, \
  134. (unsigned long)sizeof(struct name))
  135. #define VMCOREINFO_OFFSET(name, field) \
  136. vmcoreinfo_append_str("OFFSET(%s.%s)=%lu\n", #name, #field, \
  137. (unsigned long)offsetof(struct name, field))
  138. #define VMCOREINFO_LENGTH(name, value) \
  139. vmcoreinfo_append_str("LENGTH(%s)=%lu\n", #name, (unsigned long)value)
  140. #define VMCOREINFO_NUMBER(name) \
  141. vmcoreinfo_append_str("NUMBER(%s)=%ld\n", #name, (long)name)
  142. #define VMCOREINFO_CONFIG(name) \
  143. vmcoreinfo_append_str("CONFIG_%s=y\n", #name)
  144. extern struct kimage *kexec_image;
  145. extern struct kimage *kexec_crash_image;
  146. #ifndef kexec_flush_icache_page
  147. #define kexec_flush_icache_page(page)
  148. #endif
  149. #define KEXEC_ON_CRASH 0x00000001
  150. #define KEXEC_PRESERVE_CONTEXT 0x00000002
  151. #define KEXEC_ARCH_MASK 0xffff0000
  152. /* These values match the ELF architecture values.
  153. * Unless there is a good reason that should continue to be the case.
  154. */
  155. #define KEXEC_ARCH_DEFAULT ( 0 << 16)
  156. #define KEXEC_ARCH_386 ( 3 << 16)
  157. #define KEXEC_ARCH_X86_64 (62 << 16)
  158. #define KEXEC_ARCH_PPC (20 << 16)
  159. #define KEXEC_ARCH_PPC64 (21 << 16)
  160. #define KEXEC_ARCH_IA_64 (50 << 16)
  161. #define KEXEC_ARCH_ARM (40 << 16)
  162. #define KEXEC_ARCH_S390 (22 << 16)
  163. #define KEXEC_ARCH_SH (42 << 16)
  164. #define KEXEC_ARCH_MIPS_LE (10 << 16)
  165. #define KEXEC_ARCH_MIPS ( 8 << 16)
  166. /* List of defined/legal kexec flags */
  167. #ifndef CONFIG_KEXEC_JUMP
  168. #define KEXEC_FLAGS KEXEC_ON_CRASH
  169. #else
  170. #define KEXEC_FLAGS (KEXEC_ON_CRASH | KEXEC_PRESERVE_CONTEXT)
  171. #endif
  172. #define VMCOREINFO_BYTES (4096)
  173. #define VMCOREINFO_NOTE_NAME "VMCOREINFO"
  174. #define VMCOREINFO_NOTE_NAME_BYTES ALIGN(sizeof(VMCOREINFO_NOTE_NAME), 4)
  175. #define VMCOREINFO_NOTE_SIZE (KEXEC_NOTE_HEAD_BYTES*2 + VMCOREINFO_BYTES \
  176. + VMCOREINFO_NOTE_NAME_BYTES)
  177. /* Location of a reserved region to hold the crash kernel.
  178. */
  179. extern struct resource crashk_res;
  180. typedef u32 note_buf_t[KEXEC_NOTE_BYTES/4];
  181. extern note_buf_t __percpu *crash_notes;
  182. extern u32 vmcoreinfo_note[VMCOREINFO_NOTE_SIZE/4];
  183. extern size_t vmcoreinfo_size;
  184. extern size_t vmcoreinfo_max_size;
  185. int __init parse_crashkernel(char *cmdline, unsigned long long system_ram,
  186. unsigned long long *crash_size, unsigned long long *crash_base);
  187. int crash_shrink_memory(unsigned long new_size);
  188. size_t crash_get_memory_size(void);
  189. void crash_free_reserved_phys_range(unsigned long begin, unsigned long end);
  190. #else /* !CONFIG_KEXEC */
  191. struct pt_regs;
  192. struct task_struct;
  193. static inline void crash_kexec(struct pt_regs *regs) { }
  194. static inline int kexec_should_crash(struct task_struct *p) { return 0; }
  195. #endif /* CONFIG_KEXEC */
  196. #endif /* LINUX_KEXEC_H */