summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man2/kexec_load.2
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-tumbleweed/man2/kexec_load.2')
-rw-r--r--upstream/opensuse-tumbleweed/man2/kexec_load.228
1 files changed, 14 insertions, 14 deletions
diff --git a/upstream/opensuse-tumbleweed/man2/kexec_load.2 b/upstream/opensuse-tumbleweed/man2/kexec_load.2
index 604fa1cf..99e018dc 100644
--- a/upstream/opensuse-tumbleweed/man2/kexec_load.2
+++ b/upstream/opensuse-tumbleweed/man2/kexec_load.2
@@ -4,7 +4,7 @@
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.TH kexec_load 2 2023-03-30 "Linux man-pages 6.05.01"
+.TH kexec_load 2 2024-05-02 "Linux man-pages (unreleased)"
.SH NAME
kexec_load, kexec_file_load \- load a new kernel for later execution
.SH LIBRARY
@@ -15,7 +15,7 @@ Standard C library
.BR "#include <linux/kexec.h>" " /* Definition of " KEXEC_* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
-.PP
+.P
.BI "long syscall(SYS_kexec_load, unsigned long " entry ,
.BI " unsigned long " nr_segments \
", struct kexec_segment *" segments ,
@@ -24,7 +24,7 @@ Standard C library
.BI " unsigned long " cmdline_len ", const char *" cmdline ,
.BI " unsigned long " flags );
.fi
-.PP
+.P
.IR Note :
glibc provides no wrappers for these system calls,
necessitating the use of
@@ -34,7 +34,7 @@ The
.BR kexec_load ()
system call loads a new kernel that can be executed later by
.BR reboot (2).
-.PP
+.P
The
.I flags
argument is a bit mask that controls the operation of the call.
@@ -66,7 +66,7 @@ This flag is available only if the kernel was configured with
and is effective only if
.I nr_segments
is greater than 0.
-.PP
+.P
The high-order bits (corresponding to the mask 0xffff0000) of
.I flags
contain the architecture of the to-be-executed kernel.
@@ -87,7 +87,7 @@ or one of the following architecture constants
and
.BR KEXEC_ARCH_MIPS_LE .
The architecture must be executable on the CPU of the system.
-.PP
+.P
The
.I entry
argument is the physical entry address in the kernel image.
@@ -102,7 +102,7 @@ The
argument is an array of
.I kexec_segment
structures which define the kernel layout:
-.PP
+.P
.in +4n
.EX
struct kexec_segment {
@@ -113,7 +113,7 @@ struct kexec_segment {
};
.EE
.in
-.PP
+.P
The kernel image defined by
.I segments
is copied from the calling process into
@@ -154,7 +154,7 @@ If
is less than
.IR memsz ,
then the excess bytes in the kernel buffer are zeroed out.
-.PP
+.P
In case of a normal kexec (i.e., the
.B KEXEC_ON_CRASH
flag is not set), the segment data is loaded in any available memory
@@ -163,13 +163,13 @@ and is moved to the final destination at kexec reboot time (e.g., when the
command is executed with the
.I \-e
option).
-.PP
+.P
In case of kexec on panic (i.e., the
.B KEXEC_ON_CRASH
flag is set), the segment data is
loaded to reserved memory at the time of the call, and, after a crash,
the kexec mechanism simply passes control to that kernel.
-.PP
+.P
The
.BR kexec_load ()
system call is available only if the kernel was configured with
@@ -194,7 +194,7 @@ The
.I cmdline_len
argument specifies size of the buffer.
The last byte in the buffer must be a null byte (\[aq]\e0\[aq]).
-.PP
+.P
The
.I flags
argument is a bit mask which modifies the behavior of the call.
@@ -216,7 +216,7 @@ Specify this flag if no initramfs is being loaded.
If this flag is set, the value passed in
.I initrd_fd
is ignored.
-.PP
+.P
The
.BR kexec_file_load ()
.\" See also http://lwn.net/Articles/603116/
@@ -324,7 +324,7 @@ Linux 3.17.
.BR reboot (2),
.BR syscall (2),
.BR kexec (8)
-.PP
+.P
The kernel source files
.I Documentation/kdump/kdump.txt
and