Linux Audio

Check our new training course

Loading...
v5.4
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * kexec.c - kexec_load system call
  4 * Copyright (C) 2002-2004 Eric Biederman  <ebiederm@xmission.com>
  5 */
  6
  7#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  8
  9#include <linux/capability.h>
 10#include <linux/mm.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>
 19
 20#include "kexec_internal.h"
 21
 22static int copy_user_segment_list(struct kimage *image,
 23				  unsigned long nr_segments,
 24				  struct kexec_segment __user *segments)
 25{
 26	int ret;
 27	size_t segment_bytes;
 28
 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);
 33	if (ret)
 34		ret = -EFAULT;
 35
 36	return ret;
 37}
 38
 39static int kimage_alloc_init(struct kimage **rimage, unsigned long entry,
 40			     unsigned long nr_segments,
 41			     struct kexec_segment __user *segments,
 42			     unsigned long flags)
 43{
 44	int ret;
 45	struct kimage *image;
 46	bool kexec_on_panic = flags & KEXEC_ON_CRASH;
 47
 48	if (kexec_on_panic) {
 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;
 53	}
 54
 55	/* Allocate and initialize a controlling structure */
 56	image = do_kimage_alloc_init();
 57	if (!image)
 58		return -ENOMEM;
 59
 60	image->start = entry;
 61
 62	ret = copy_user_segment_list(image, nr_segments, segments);
 63	if (ret)
 64		goto out_free_image;
 65
 66	if (kexec_on_panic) {
 67		/* Enable special crash kernel control page alloc policy. */
 68		image->control_page = crashk_res.start;
 69		image->type = KEXEC_TYPE_CRASH;
 70	}
 71
 72	ret = sanity_check_segment_list(image);
 73	if (ret)
 74		goto out_free_image;
 75
 76	/*
 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.
 80	 */
 81	ret = -ENOMEM;
 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");
 86		goto out_free_image;
 87	}
 88
 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;
 94		}
 95	}
 96
 97	*rimage = image;
 98	return 0;
 99out_free_control_pages:
100	kimage_free_page_list(&image->control_pages);
101out_free_image:
102	kfree(image);
103	return ret;
104}
105
106static int do_kexec_load(unsigned long entry, unsigned long nr_segments,
107		struct kexec_segment __user *segments, unsigned long flags)
108{
109	struct kimage **dest_image, *image;
110	unsigned long i;
111	int ret;
112
 
 
 
 
 
 
 
 
113	if (flags & KEXEC_ON_CRASH) {
114		dest_image = &kexec_crash_image;
115		if (kexec_crash_image)
116			arch_kexec_unprotect_crashkres();
117	} else {
118		dest_image = &kexec_image;
119	}
120
121	if (nr_segments == 0) {
122		/* Uninstall image */
123		kimage_free(xchg(dest_image, NULL));
124		return 0;
 
125	}
126	if (flags & KEXEC_ON_CRASH) {
127		/*
128		 * Loading another kernel to switch to if this one
129		 * crashes.  Free any current crash dump kernel before
130		 * we corrupt it.
131		 */
132		kimage_free(xchg(&kexec_crash_image, NULL));
133	}
134
135	ret = kimage_alloc_init(&image, entry, nr_segments, segments, flags);
136	if (ret)
137		return ret;
138
139	if (flags & KEXEC_PRESERVE_CONTEXT)
140		image->preserve_context = 1;
141
 
 
 
 
 
142	ret = machine_kexec_prepare(image);
143	if (ret)
144		goto out;
145
146	/*
147	 * Some architecture(like S390) may touch the crash memory before
148	 * machine_kexec_prepare(), we must copy vmcoreinfo data after it.
149	 */
150	ret = kimage_crash_copy_vmcoreinfo(image);
151	if (ret)
152		goto out;
153
154	for (i = 0; i < nr_segments; i++) {
155		ret = kimage_load_segment(image, &image->segment[i]);
156		if (ret)
157			goto out;
158	}
159
160	kimage_terminate(image);
161
 
 
 
 
162	/* Install the new kernel and uninstall the old */
163	image = xchg(dest_image, image);
164
165out:
166	if ((flags & KEXEC_ON_CRASH) && kexec_crash_image)
167		arch_kexec_protect_crashkres();
168
169	kimage_free(image);
 
 
170	return ret;
171}
172
173/*
174 * Exec Kernel system call: for obvious reasons only root may call it.
175 *
176 * This call breaks up into three pieces.
177 * - A generic part which loads the new kernel from the current
178 *   address space, and very carefully places the data in the
179 *   allocated pages.
180 *
181 * - A generic part that interacts with the kernel and tells all of
182 *   the devices to shut down.  Preventing on-going dmas, and placing
183 *   the devices in a consistent state so a later kernel can
184 *   reinitialize them.
185 *
186 * - A machine specific part that includes the syscall number
187 *   and then copies the image to it's final destination.  And
188 *   jumps into the image at entry.
189 *
190 * kexec does not sync, or unmount filesystems so if you need
191 * that to happen you need to do that yourself.
192 */
193
194static inline int kexec_load_check(unsigned long nr_segments,
195				   unsigned long flags)
196{
 
 
197	int result;
198
199	/* We only trust the superuser with rebooting the system. */
200	if (!capable(CAP_SYS_BOOT) || kexec_load_disabled)
201		return -EPERM;
202
203	/* Permit LSMs and IMA to fail the kexec */
204	result = security_kernel_load_data(LOADING_KEXEC_IMAGE);
205	if (result < 0)
206		return result;
207
208	/*
209	 * kexec can be used to circumvent module loading restrictions, so
210	 * prevent loading in that case
211	 */
212	result = security_locked_down(LOCKDOWN_KEXEC);
213	if (result)
214		return result;
215
216	/*
217	 * Verify we have a legal set of flags
218	 * This leaves us room for future extensions.
219	 */
220	if ((flags & KEXEC_FLAGS) != (flags & ~KEXEC_ARCH_MASK))
221		return -EINVAL;
222
223	/* Put an artificial cap on the number
224	 * of segments passed to kexec_load.
225	 */
226	if (nr_segments > KEXEC_SEGMENT_MAX)
227		return -EINVAL;
228
229	return 0;
230}
231
232SYSCALL_DEFINE4(kexec_load, unsigned long, entry, unsigned long, nr_segments,
233		struct kexec_segment __user *, segments, unsigned long, flags)
234{
235	int result;
 
236
237	result = kexec_load_check(nr_segments, flags);
238	if (result)
239		return result;
240
241	/* Verify we are on the appropriate architecture */
242	if (((flags & KEXEC_ARCH_MASK) != KEXEC_ARCH) &&
243		((flags & KEXEC_ARCH_MASK) != KEXEC_ARCH_DEFAULT))
244		return -EINVAL;
245
246	/* Because we write directly to the reserved memory
247	 * region when loading crash kernels we need a mutex here to
248	 * prevent multiple crash  kernels from attempting to load
249	 * simultaneously, and to prevent a crash kernel from loading
250	 * over the top of a in use crash kernel.
251	 *
252	 * KISS: always take the mutex.
253	 */
254	if (!mutex_trylock(&kexec_mutex))
255		return -EBUSY;
256
257	result = do_kexec_load(entry, nr_segments, segments, flags);
258
259	mutex_unlock(&kexec_mutex);
260
261	return result;
262}
263
264#ifdef CONFIG_COMPAT
265COMPAT_SYSCALL_DEFINE4(kexec_load, compat_ulong_t, entry,
266		       compat_ulong_t, nr_segments,
267		       struct compat_kexec_segment __user *, segments,
268		       compat_ulong_t, flags)
269{
270	struct compat_kexec_segment in;
271	struct kexec_segment out, __user *ksegments;
272	unsigned long i, result;
273
274	result = kexec_load_check(nr_segments, flags);
275	if (result)
276		return result;
277
278	/* Don't allow clients that don't understand the native
279	 * architecture to do anything.
280	 */
281	if ((flags & KEXEC_ARCH_MASK) == KEXEC_ARCH_DEFAULT)
282		return -EINVAL;
283
284	ksegments = compat_alloc_user_space(nr_segments * sizeof(out));
 
 
 
 
285	for (i = 0; i < nr_segments; i++) {
286		result = copy_from_user(&in, &segments[i], sizeof(in));
287		if (result)
288			return -EFAULT;
289
290		out.buf   = compat_ptr(in.buf);
291		out.bufsz = in.bufsz;
292		out.mem   = in.mem;
293		out.memsz = in.memsz;
294
295		result = copy_to_user(&ksegments[i], &out, sizeof(out));
296		if (result)
297			return -EFAULT;
298	}
299
300	/* Because we write directly to the reserved memory
301	 * region when loading crash kernels we need a mutex here to
302	 * prevent multiple crash  kernels from attempting to load
303	 * simultaneously, and to prevent a crash kernel from loading
304	 * over the top of a in use crash kernel.
305	 *
306	 * KISS: always take the mutex.
307	 */
308	if (!mutex_trylock(&kexec_mutex))
309		return -EBUSY;
310
311	result = do_kexec_load(entry, nr_segments, ksegments, flags);
312
313	mutex_unlock(&kexec_mutex);
314
315	return result;
316}
317#endif
v6.8
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * kexec.c - kexec_load system call
  4 * Copyright (C) 2002-2004 Eric Biederman  <ebiederm@xmission.com>
  5 */
  6
  7#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  8
  9#include <linux/capability.h>
 10#include <linux/mm.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>
 19
 20#include "kexec_internal.h"
 21
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 22static int kimage_alloc_init(struct kimage **rimage, unsigned long entry,
 23			     unsigned long nr_segments,
 24			     struct kexec_segment *segments,
 25			     unsigned long flags)
 26{
 27	int ret;
 28	struct kimage *image;
 29	bool kexec_on_panic = flags & KEXEC_ON_CRASH;
 30
 31	if (kexec_on_panic) {
 32		/* Verify we have a valid entry point */
 33		if ((entry < phys_to_boot_phys(crashk_res.start)) ||
 34		    (entry > phys_to_boot_phys(crashk_res.end)))
 35			return -EADDRNOTAVAIL;
 36	}
 37
 38	/* Allocate and initialize a controlling structure */
 39	image = do_kimage_alloc_init();
 40	if (!image)
 41		return -ENOMEM;
 42
 43	image->start = entry;
 44	image->nr_segments = nr_segments;
 45	memcpy(image->segment, segments, nr_segments * sizeof(*segments));
 
 
 46
 47	if (kexec_on_panic) {
 48		/* Enable special crash kernel control page alloc policy. */
 49		image->control_page = crashk_res.start;
 50		image->type = KEXEC_TYPE_CRASH;
 51	}
 52
 53	ret = sanity_check_segment_list(image);
 54	if (ret)
 55		goto out_free_image;
 56
 57	/*
 58	 * Find a location for the control code buffer, and add it
 59	 * the vector of segments so that it's pages will also be
 60	 * counted as destination pages.
 61	 */
 62	ret = -ENOMEM;
 63	image->control_code_page = kimage_alloc_control_pages(image,
 64					   get_order(KEXEC_CONTROL_PAGE_SIZE));
 65	if (!image->control_code_page) {
 66		pr_err("Could not allocate control_code_buffer\n");
 67		goto out_free_image;
 68	}
 69
 70	if (!kexec_on_panic) {
 71		image->swap_page = kimage_alloc_control_pages(image, 0);
 72		if (!image->swap_page) {
 73			pr_err("Could not allocate swap buffer\n");
 74			goto out_free_control_pages;
 75		}
 76	}
 77
 78	*rimage = image;
 79	return 0;
 80out_free_control_pages:
 81	kimage_free_page_list(&image->control_pages);
 82out_free_image:
 83	kfree(image);
 84	return ret;
 85}
 86
 87static int do_kexec_load(unsigned long entry, unsigned long nr_segments,
 88		struct kexec_segment *segments, unsigned long flags)
 89{
 90	struct kimage **dest_image, *image;
 91	unsigned long i;
 92	int ret;
 93
 94	/*
 95	 * Because we write directly to the reserved memory region when loading
 96	 * crash kernels we need a serialization here to prevent multiple crash
 97	 * kernels from attempting to load simultaneously.
 98	 */
 99	if (!kexec_trylock())
100		return -EBUSY;
101
102	if (flags & KEXEC_ON_CRASH) {
103		dest_image = &kexec_crash_image;
104		if (kexec_crash_image)
105			arch_kexec_unprotect_crashkres();
106	} else {
107		dest_image = &kexec_image;
108	}
109
110	if (nr_segments == 0) {
111		/* Uninstall image */
112		kimage_free(xchg(dest_image, NULL));
113		ret = 0;
114		goto out_unlock;
115	}
116	if (flags & KEXEC_ON_CRASH) {
117		/*
118		 * Loading another kernel to switch to if this one
119		 * crashes.  Free any current crash dump kernel before
120		 * we corrupt it.
121		 */
122		kimage_free(xchg(&kexec_crash_image, NULL));
123	}
124
125	ret = kimage_alloc_init(&image, entry, nr_segments, segments, flags);
126	if (ret)
127		goto out_unlock;
128
129	if (flags & KEXEC_PRESERVE_CONTEXT)
130		image->preserve_context = 1;
131
132#ifdef CONFIG_CRASH_HOTPLUG
133	if (flags & KEXEC_UPDATE_ELFCOREHDR)
134		image->update_elfcorehdr = 1;
135#endif
136
137	ret = machine_kexec_prepare(image);
138	if (ret)
139		goto out;
140
141	/*
142	 * Some architecture(like S390) may touch the crash memory before
143	 * machine_kexec_prepare(), we must copy vmcoreinfo data after it.
144	 */
145	ret = kimage_crash_copy_vmcoreinfo(image);
146	if (ret)
147		goto out;
148
149	for (i = 0; i < nr_segments; i++) {
150		ret = kimage_load_segment(image, &image->segment[i]);
151		if (ret)
152			goto out;
153	}
154
155	kimage_terminate(image);
156
157	ret = machine_kexec_post_load(image);
158	if (ret)
159		goto out;
160
161	/* Install the new kernel and uninstall the old */
162	image = xchg(dest_image, image);
163
164out:
165	if ((flags & KEXEC_ON_CRASH) && kexec_crash_image)
166		arch_kexec_protect_crashkres();
167
168	kimage_free(image);
169out_unlock:
170	kexec_unlock();
171	return ret;
172}
173
174/*
175 * Exec Kernel system call: for obvious reasons only root may call it.
176 *
177 * This call breaks up into three pieces.
178 * - A generic part which loads the new kernel from the current
179 *   address space, and very carefully places the data in the
180 *   allocated pages.
181 *
182 * - A generic part that interacts with the kernel and tells all of
183 *   the devices to shut down.  Preventing on-going dmas, and placing
184 *   the devices in a consistent state so a later kernel can
185 *   reinitialize them.
186 *
187 * - A machine specific part that includes the syscall number
188 *   and then copies the image to it's final destination.  And
189 *   jumps into the image at entry.
190 *
191 * kexec does not sync, or unmount filesystems so if you need
192 * that to happen you need to do that yourself.
193 */
194
195static inline int kexec_load_check(unsigned long nr_segments,
196				   unsigned long flags)
197{
198	int image_type = (flags & KEXEC_ON_CRASH) ?
199			 KEXEC_TYPE_CRASH : KEXEC_TYPE_DEFAULT;
200	int result;
201
202	/* We only trust the superuser with rebooting the system. */
203	if (!kexec_load_permitted(image_type))
204		return -EPERM;
205
206	/* Permit LSMs and IMA to fail the kexec */
207	result = security_kernel_load_data(LOADING_KEXEC_IMAGE, false);
208	if (result < 0)
209		return result;
210
211	/*
212	 * kexec can be used to circumvent module loading restrictions, so
213	 * prevent loading in that case
214	 */
215	result = security_locked_down(LOCKDOWN_KEXEC);
216	if (result)
217		return result;
218
219	/*
220	 * Verify we have a legal set of flags
221	 * This leaves us room for future extensions.
222	 */
223	if ((flags & KEXEC_FLAGS) != (flags & ~KEXEC_ARCH_MASK))
224		return -EINVAL;
225
226	/* Put an artificial cap on the number
227	 * of segments passed to kexec_load.
228	 */
229	if (nr_segments > KEXEC_SEGMENT_MAX)
230		return -EINVAL;
231
232	return 0;
233}
234
235SYSCALL_DEFINE4(kexec_load, unsigned long, entry, unsigned long, nr_segments,
236		struct kexec_segment __user *, segments, unsigned long, flags)
237{
238	struct kexec_segment *ksegments;
239	unsigned long result;
240
241	result = kexec_load_check(nr_segments, flags);
242	if (result)
243		return result;
244
245	/* Verify we are on the appropriate architecture */
246	if (((flags & KEXEC_ARCH_MASK) != KEXEC_ARCH) &&
247		((flags & KEXEC_ARCH_MASK) != KEXEC_ARCH_DEFAULT))
248		return -EINVAL;
249
250	ksegments = memdup_array_user(segments, nr_segments, sizeof(ksegments[0]));
251	if (IS_ERR(ksegments))
252		return PTR_ERR(ksegments);
 
 
 
 
 
 
 
253
254	result = do_kexec_load(entry, nr_segments, ksegments, flags);
255	kfree(ksegments);
 
256
257	return result;
258}
259
260#ifdef CONFIG_COMPAT
261COMPAT_SYSCALL_DEFINE4(kexec_load, compat_ulong_t, entry,
262		       compat_ulong_t, nr_segments,
263		       struct compat_kexec_segment __user *, segments,
264		       compat_ulong_t, flags)
265{
266	struct compat_kexec_segment in;
267	struct kexec_segment *ksegments;
268	unsigned long i, result;
269
270	result = kexec_load_check(nr_segments, flags);
271	if (result)
272		return result;
273
274	/* Don't allow clients that don't understand the native
275	 * architecture to do anything.
276	 */
277	if ((flags & KEXEC_ARCH_MASK) == KEXEC_ARCH_DEFAULT)
278		return -EINVAL;
279
280	ksegments = kmalloc_array(nr_segments, sizeof(ksegments[0]),
281			GFP_KERNEL);
282	if (!ksegments)
283		return -ENOMEM;
284
285	for (i = 0; i < nr_segments; i++) {
286		result = copy_from_user(&in, &segments[i], sizeof(in));
287		if (result)
288			goto fail;
289
290		ksegments[i].buf   = compat_ptr(in.buf);
291		ksegments[i].bufsz = in.bufsz;
292		ksegments[i].mem   = in.mem;
293		ksegments[i].memsz = in.memsz;
 
 
 
 
294	}
295
 
 
 
 
 
 
 
 
 
 
 
296	result = do_kexec_load(entry, nr_segments, ksegments, flags);
297
298fail:
299	kfree(ksegments);
300	return result;
301}
302#endif