- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
kexec_load(2) | System Calls Manual | kexec_load(2) |
ИМЯ¶
kexec_load, kexec_file_load - загружает новое ядро для выполнения в будущем
LIBRARY¶
Standard C library (libc, -lc)
СИНТАКСИС¶
#include <linux/kexec.h> /* определения констант KEXEC_* */ #include <sys/syscall.h> /* определения констант SYS_* */ #include <unistd.h>
long syscall(SYS_kexec_load, unsigned long entry, unsigned long nr_segments, struct kexec_segment *segments, unsigned long flags); long syscall(SYS_kexec_file_load, int kernel_fd, int initrd_fd, unsigned long cmdline_len, const char *cmdline, unsigned long flags);
Note: glibc provides no wrappers for these system calls, necessitating the use of syscall(2).
ОПИСАНИЕ¶
Системный вызов kexec_load() загружает новое ядро, которое можно запустить позже с помощью reboot(2).
Аргумент flags представляет собой битовую маску, которая управляет работой вызова. В flags можно указать следующие значения:
- KEXEC_ON_CRASH (начиная с Linux 2.6.13)
- Запускать новое ядро автоматически после аварии системы. Данное «аварийное ядро» загружено в область зарезервированной памяти, которая определена во время загрузки с помощью параметра командной строки ядра crashkernel. Область данной зарезервированной памяти экспортируется в пространство пользователя через файл /proc/iomem, в элемент с меткой «Crash kernel». Приложение в пользовательском пространстве может проанализировать этот файл и подготовить список сегментов (смотрите далее), которые определяют эту зарезервированную память в качестве приёмника. Если данный флаг установлен, то ядро проверяет входят ли сегменты назначения, указанные в segments, в зарезервированную область.
- KEXEC_PRESERVE_CONTEXT (начиная с Linux 2.6.27)
- Сохранять аппаратное и программное состояния перед выполнением нового ядра. Может использоваться для перевода системы в состояние ожидания (suspend). Этот флаг доступен только, если ядро было собрано с параметром CONFIG_KEXEC_JUMP, и работает только, если значение nr_segments больше 0.
В старших битах (соответствуют маске 0xffff0000) flags задаётся архитектура, на которой будет выполняться ядро. Константой (через OR) KEXEC_ARCH_DEFAULT задаётся использование текущей архитектуры; также есть другие константы, описывающие архитектуры: KEXEC_ARCH_386, KEXEC_ARCH_68K, KEXEC_ARCH_X86_64, KEXEC_ARCH_PPC, KEXEC_ARCH_PPC64, KEXEC_ARCH_IA_64, KEXEC_ARCH_ARM, KEXEC_ARCH_S390, KEXEC_ARCH_SH, KEXEC_ARCH_MIPS и KEXEC_ARCH_MIPS_LE.Архитектура должна быть работоспособна на ЦП системы.
В аргументе entry задаётся физический адрес точки входа в образе ядра. В аргументе nr_segments задаётся количество сегментов, на которые указывает указатель segments; ядро введено (произвольно) ограничение в 16 сегментов. В аргументе segments задаётся массив структур kexec_segment, который определяет разметку ядра:
struct kexec_segment {
void *buf; /* буфер в пользовательском пространстве */
size_t bufsz; /* размер буфера в пользовательском пространстве */
void *mem; /* физический адрес ядра */
size_t memsz; /* размер ядра */ };
Образ ядра, определённый segments, копируется из вызывающего процесса в обычную память или в зарезервированную память (если определён KEXEC_ON_CRASH). Сначала ядро выполняет различные проверки информации, переданной в segments. Если всё в порядке, то ядро копирует сегмент данных в память ядра. Каждый сегмент, указанный в segments, копируется следующим образом:
- •
- Значения buf и bufsz определяют область памяти в виртуальном адресном пространстве вызывающего, который является источником копирования. Значение bufsz может не превышать значение в поле memsz.
- •
- Значения mem и memsz определяют физическое адресное пространство — приёмник копии. Значения, задаваемые в обоих полях, должны быть кратны размеру системной страницы.
- •
- bufsz байт копируется из буфера источника в буфер назначения ядра. Если bufsz меньше чем memsz, то оставшиеся байты в буфере ядра заполняются нулями.
При обычной работе kexec (т. е., флаг не установлен KEXEC_ON_CRASH) сегмент данных загружен в любую доступную память и перемещение выполняется в конечное назначение во время перезагрузки kexec (например, при выполнении команды kexec(8) с параметром -e).
При панике kexec (т. е., флаг KEXEC_ON_CRASH установлен)сегмент данных загружен в зарезервированную память на момент вызова, и, после падения (crash), механизм kexec просто передаёт управление ядру.
Системный вызов kexec_load() доступен только, если ядро было собрано с параметром CONFIG_KEXEC.
kexec_file_load()¶
The kexec_file_load() system call is similar to kexec_load(), but it takes a different set of arguments. It reads the kernel to be loaded from the file referred to by the file descriptor kernel_fd, and the initrd (initial RAM disk) to be loaded from file referred to by the file descriptor initrd_fd. The cmdline argument is a pointer to a buffer containing the command line for the new kernel. The cmdline_len argument specifies size of the buffer. The last byte in the buffer must be a null byte ('\0').
Аргумент flags представляет собой битовую маску, которая изменяет поведение вызова. В flags можно указать следующие значения:
- KEXEC_FILE_UNLOAD
- Выгрузить загруженное в данный момент ядро.
- KEXEC_FILE_ON_CRASH
- Загрузить новое ядро в область памяти зарезервированную под аварийное ядро (как для KEXEC_ON_CRASH). Ядро запускается, если отказывает работающее в данный момент ядро.
- KEXEC_FILE_NO_INITRAMFS
- Загрузка initrd/initramfs не обязательна. Установите данный флаг, если не нужно загружать initramfs. Если флаг установлен, то значение, передаваемое в initrd_fd игнорируется.
Системный вызов kexec_file_load() был добавлен для поддержки систем, где загрузка «kexec» должна быть ограничена только подписанными ядрами. Данный системный вызов доступен только, если ядро собрано с параметром CONFIG_KEXEC_FILE.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении эти системные вызовы возвращают 0. При ошибке возвращается -1, а в errno содержится код ошибки.
ОШИБКИ¶
- EADDRNOTAVAIL
- Указаны флаги KEXEC_ON_CRASH, но область, заданная полями mem и memsz одного из элементов segments, находится за пределами диапазона памяти, зарезервированного для аварийного ядра.
- EADDRNOTAVAIL
- Значение в поле mem или memsz в одном из элементов segments не кратно размеру системной страницы.
- EBADF
- Значение kernel_fd или initrd_fd не является правильным файловым дескриптором.
- EBUSY
- Уже загружено другое аварийное ядро или аварийное ядро уже используется.
- EINVAL
- Значение flags неверно.
- EINVAL
- Значение поля bufsz одного из элементов segments превышает значение в соответствующем поле memsz.
- EINVAL
- Значение nr_segments превышает KEXEC_SEGMENT_MAX (16).
- EINVAL
- Два или более буфера назначения ядра перекрываются.
- EINVAL
- The value in cmdline[cmdline_len-1] is not '\0'.
- EINVAL
- Файл, на который ссылается kernel_fd или initrd_fd, пуст (нулевой длины).
- ENOEXEC
- Значение kernel_fd не указывает на открытый файл, или ядро не может загрузить этот файл. В настоящее время, файл должен быть в формате и содержать ядро x86, которое можно загрузить в память выше 4 ГиБ (смотрите файл исходного кода ядра Documentation/x86/boot.txt).
- ENOMEM
- Невозможно выделить память.
- EPERM
- Вызывающий не имеет мандата CAP_SYS_BOOT.
ВЕРСИИ¶
Системный вызов kexec_load() впервые появился в Linux 2.6.13. Системный вызов kexec_file_load() впервые появился в Linux 3.17.
СТАНДАРТЫ¶
Данные системные вызовы есть только в Linux.
СМ. ТАКЖЕ¶
reboot(2), syscall(2), kexec(8)
Файлы исходного кода ядра Documentation/kdump/kdump.txt и Documentation/admin-guide/kernel-parameters.txt
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан Alex Nik <rage.iz.me@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
5 февраля 2023 г. | Linux man-pages 6.03 |