1 // SPDX-License-Identifier: GPL-2.0-only
3 * kexec.c - kexec_load system call
4 * Copyright (C) 2002-2004 Eric Biederman <ebiederm@xmission.com>
7 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
9 #include <linux/capability.h>
11 #include <linux/file.h>
12 #include <linux/security.h>
13 #include <linux/kexec.h>
14 #include <linux/mutex.h>
15 #include <linux/list.h>
16 #include <linux/syscalls.h>
17 #include <linux/vmalloc.h>
18 #include <linux/slab.h>
20 #include "kexec_internal.h"
22 static int copy_user_segment_list(struct kimage
*image
,
23 unsigned long nr_segments
,
24 struct kexec_segment __user
*segments
)
29 /* Read in the segments */
30 image
->nr_segments
= nr_segments
;
31 segment_bytes
= nr_segments
* sizeof(*segments
);
32 ret
= copy_from_user(image
->segment
, segments
, segment_bytes
);
39 static int kimage_alloc_init(struct kimage
**rimage
, unsigned long entry
,
40 unsigned long nr_segments
,
41 struct kexec_segment __user
*segments
,
46 bool kexec_on_panic
= flags
& KEXEC_ON_CRASH
;
49 /* Verify we have a valid entry point */
50 if ((entry
< phys_to_boot_phys(crashk_res
.start
)) ||
51 (entry
> phys_to_boot_phys(crashk_res
.end
)))
52 return -EADDRNOTAVAIL
;
55 /* Allocate and initialize a controlling structure */
56 image
= do_kimage_alloc_init();
62 ret
= copy_user_segment_list(image
, nr_segments
, segments
);
67 /* Enable special crash kernel control page alloc policy. */
68 image
->control_page
= crashk_res
.start
;
69 image
->type
= KEXEC_TYPE_CRASH
;
72 ret
= sanity_check_segment_list(image
);
77 * Find a location for the control code buffer, and add it
78 * the vector of segments so that it's pages will also be
79 * counted as destination pages.
82 image
->control_code_page
= kimage_alloc_control_pages(image
,
83 get_order(KEXEC_CONTROL_PAGE_SIZE
));
84 if (!image
->control_code_page
) {
85 pr_err("Could not allocate control_code_buffer\n");
89 if (!kexec_on_panic
) {
90 image
->swap_page
= kimage_alloc_control_pages(image
, 0);
91 if (!image
->swap_page
) {
92 pr_err("Could not allocate swap buffer\n");
93 goto out_free_control_pages
;
99 out_free_control_pages
:
100 kimage_free_page_list(&image
->control_pages
);
106 static int do_kexec_load(unsigned long entry
, unsigned long nr_segments
,
107 struct kexec_segment __user
*segments
, unsigned long flags
)
109 struct kimage
**dest_image
, *image
;
113 if (flags
& KEXEC_ON_CRASH
) {
114 dest_image
= &kexec_crash_image
;
115 if (kexec_crash_image
)
116 arch_kexec_unprotect_crashkres();
118 dest_image
= &kexec_image
;
121 if (nr_segments
== 0) {
122 /* Uninstall image */
123 kimage_free(xchg(dest_image
, NULL
));
126 if (flags
& KEXEC_ON_CRASH
) {
128 * Loading another kernel to switch to if this one
129 * crashes. Free any current crash dump kernel before
132 kimage_free(xchg(&kexec_crash_image
, NULL
));
135 ret
= kimage_alloc_init(&image
, entry
, nr_segments
, segments
, flags
);
139 if (flags
& KEXEC_PRESERVE_CONTEXT
)
140 image
->preserve_context
= 1;
142 ret
= machine_kexec_prepare(image
);
147 * Some architecture(like S390) may touch the crash memory before
148 * machine_kexec_prepare(), we must copy vmcoreinfo data after it.
150 ret
= kimage_crash_copy_vmcoreinfo(image
);
154 for (i
= 0; i
< nr_segments
; i
++) {
155 ret
= kimage_load_segment(image
, &image
->segment
[i
]);
160 kimage_terminate(image
);
162 ret
= machine_kexec_post_load(image
);
166 /* Install the new kernel and uninstall the old */
167 image
= xchg(dest_image
, image
);
170 if ((flags
& KEXEC_ON_CRASH
) && kexec_crash_image
)
171 arch_kexec_protect_crashkres();
178 * Exec Kernel system call: for obvious reasons only root may call it.
180 * This call breaks up into three pieces.
181 * - A generic part which loads the new kernel from the current
182 * address space, and very carefully places the data in the
185 * - A generic part that interacts with the kernel and tells all of
186 * the devices to shut down. Preventing on-going dmas, and placing
187 * the devices in a consistent state so a later kernel can
190 * - A machine specific part that includes the syscall number
191 * and then copies the image to it's final destination. And
192 * jumps into the image at entry.
194 * kexec does not sync, or unmount filesystems so if you need
195 * that to happen you need to do that yourself.
198 static inline int kexec_load_check(unsigned long nr_segments
,
203 /* We only trust the superuser with rebooting the system. */
204 if (!capable(CAP_SYS_BOOT
) || kexec_load_disabled
)
207 /* Permit LSMs and IMA to fail the kexec */
208 result
= security_kernel_load_data(LOADING_KEXEC_IMAGE
);
213 * kexec can be used to circumvent module loading restrictions, so
214 * prevent loading in that case
216 result
= security_locked_down(LOCKDOWN_KEXEC
);
221 * Verify we have a legal set of flags
222 * This leaves us room for future extensions.
224 if ((flags
& KEXEC_FLAGS
) != (flags
& ~KEXEC_ARCH_MASK
))
227 /* Put an artificial cap on the number
228 * of segments passed to kexec_load.
230 if (nr_segments
> KEXEC_SEGMENT_MAX
)
236 SYSCALL_DEFINE4(kexec_load
, unsigned long, entry
, unsigned long, nr_segments
,
237 struct kexec_segment __user
*, segments
, unsigned long, flags
)
241 result
= kexec_load_check(nr_segments
, flags
);
245 /* Verify we are on the appropriate architecture */
246 if (((flags
& KEXEC_ARCH_MASK
) != KEXEC_ARCH
) &&
247 ((flags
& KEXEC_ARCH_MASK
) != KEXEC_ARCH_DEFAULT
))
250 /* Because we write directly to the reserved memory
251 * region when loading crash kernels we need a mutex here to
252 * prevent multiple crash kernels from attempting to load
253 * simultaneously, and to prevent a crash kernel from loading
254 * over the top of a in use crash kernel.
256 * KISS: always take the mutex.
258 if (!mutex_trylock(&kexec_mutex
))
261 result
= do_kexec_load(entry
, nr_segments
, segments
, flags
);
263 mutex_unlock(&kexec_mutex
);
269 COMPAT_SYSCALL_DEFINE4(kexec_load
, compat_ulong_t
, entry
,
270 compat_ulong_t
, nr_segments
,
271 struct compat_kexec_segment __user
*, segments
,
272 compat_ulong_t
, flags
)
274 struct compat_kexec_segment in
;
275 struct kexec_segment out
, __user
*ksegments
;
276 unsigned long i
, result
;
278 result
= kexec_load_check(nr_segments
, flags
);
282 /* Don't allow clients that don't understand the native
283 * architecture to do anything.
285 if ((flags
& KEXEC_ARCH_MASK
) == KEXEC_ARCH_DEFAULT
)
288 ksegments
= compat_alloc_user_space(nr_segments
* sizeof(out
));
289 for (i
= 0; i
< nr_segments
; i
++) {
290 result
= copy_from_user(&in
, &segments
[i
], sizeof(in
));
294 out
.buf
= compat_ptr(in
.buf
);
295 out
.bufsz
= in
.bufsz
;
297 out
.memsz
= in
.memsz
;
299 result
= copy_to_user(&ksegments
[i
], &out
, sizeof(out
));
304 /* Because we write directly to the reserved memory
305 * region when loading crash kernels we need a mutex here to
306 * prevent multiple crash kernels from attempting to load
307 * simultaneously, and to prevent a crash kernel from loading
308 * over the top of a in use crash kernel.
310 * KISS: always take the mutex.
312 if (!mutex_trylock(&kexec_mutex
))
315 result
= do_kexec_load(entry
, nr_segments
, ksegments
, flags
);
317 mutex_unlock(&kexec_mutex
);