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, false);
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);