.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2010 Intel Corporation, Author: Andi Kleen .\" and Copyright 2014, Vivek Goyal .\" and Copyright (c) 2015, Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH kexec_load 2 "30 марта 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ kexec_load, kexec_file_load \- загружает новое ядро для выполнения в будущем .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP /* определения констант \fBKEXEC_*\fP */ \fB#include \fP /* определения констант \fBSYS_*\fP */ \fB#include \fP .PP \fBlong syscall(SYS_kexec_load, unsigned long \fP\fIentry\fP\fB,\fP \fB unsigned long \fP\fInr_segments\fP\fB, struct kexec_segment *\fP\fIsegments\fP\fB,\fP \fB unsigned long \fP\fIflags\fP\fB);\fP \fBlong syscall(SYS_kexec_file_load, int \fP\fIkernel_fd\fP\fB, int \fP\fIinitrd_fd\fP\fB,\fP \fB unsigned long \fP\fIcmdline_len\fP\fB, const char *\fP\fIcmdline\fP\fB,\fP \fB unsigned long \fP\fIflags\fP\fB);\fP .fi .PP \fINote\fP: glibc provides no wrappers for these system calls, necessitating the use of \fBsyscall\fP(2). .SH ОПИСАНИЕ Системный вызов \fBkexec_load\fP() загружает новое ядро, которое можно запустить позже с помощью \fBreboot\fP(2). .PP Аргумент \fIflags\fP представляет собой битовую маску, которая управляет работой вызова. В \fIflags\fP можно указать следующие значения: .TP \fBKEXEC_ON_CRASH\fP (начиная с Linux 2.6.13) Запускать новое ядро автоматически после аварии системы. Данное «аварийное ядро» загружено в область зарезервированной памяти, которая определена во время загрузки с помощью параметра командной строки ядра \fIcrashkernel\fP. Область данной зарезервированной памяти экспортируется в пространство пользователя через файл \fI/proc/iomem\fP, в элемент с меткой «Crash kernel». Приложение в пользовательском пространстве может проанализировать этот файл и подготовить список сегментов (смотрите далее), которые определяют эту зарезервированную память в качестве приёмника. Если данный флаг установлен, то ядро проверяет входят ли сегменты назначения, указанные в \fIsegments\fP, в зарезервированную область. .TP \fBKEXEC_PRESERVE_CONTEXT\fP (начиная с Linux 2.6.27) Сохранять аппаратное и программное состояния перед выполнением нового ядра. Может использоваться для перевода системы в состояние ожидания (suspend). Этот флаг доступен только, если ядро было собрано с параметром \fBCONFIG_KEXEC_JUMP\fP, и работает только, если значение \fInr_segments\fP больше 0. .PP В старших битах (соответствуют маске 0xffff0000) \fIflags\fP задаётся архитектура, на которой будет выполняться ядро. Константой (через OR) \fBKEXEC_ARCH_DEFAULT\fP задаётся использование текущей архитектуры; также есть другие константы, описывающие архитектуры: \fBKEXEC_ARCH_386\fP, \fBKEXEC_ARCH_68K\fP, \fBKEXEC_ARCH_X86_64\fP, \fBKEXEC_ARCH_PPC\fP, \fBKEXEC_ARCH_PPC64\fP, \fBKEXEC_ARCH_IA_64\fP, \fBKEXEC_ARCH_ARM\fP, \fBKEXEC_ARCH_S390\fP, \fBKEXEC_ARCH_SH\fP, \fBKEXEC_ARCH_MIPS\fP и \fBKEXEC_ARCH_MIPS_LE\fP.Архитектура должна быть работоспособна на ЦП системы. .PP В аргументе \fIentry\fP задаётся физический адрес точки входа в образе ядра. В аргументе \fInr_segments\fP задаётся количество сегментов, на которые указывает указатель \fIsegments\fP; ядро введено (произвольно) ограничение в 16 сегментов. В аргументе \fIsegments\fP задаётся массив структур \fIkexec_segment\fP, который определяет разметку ядра: .PP .in +4n .EX struct kexec_segment { void *buf; /* буфер в пользовательском пространстве */ size_t bufsz; /* размер буфера в пользовательском пространстве */ void *mem; /* физический адрес ядра */ size_t memsz; /* размер ядра */ }; .EE .in .PP Образ ядра, определённый \fIsegments\fP, копируется из вызывающего процесса в обычную память или в зарезервированную память (если определён \fBKEXEC_ON_CRASH\fP). Сначала ядро выполняет различные проверки информации, переданной в \fIsegments\fP. Если всё в порядке, то ядро копирует сегмент данных в память ядра. Каждый сегмент, указанный в \fIsegments\fP, копируется следующим образом: .IP \[bu] 3 Значения \fIbuf\fP и \fIbufsz\fP определяют область памяти в виртуальном адресном пространстве вызывающего, который является источником копирования. Значение \fIbufsz\fP может не превышать значение в поле \fImemsz\fP. .IP \[bu] Значения \fImem\fP и \fImemsz\fP определяют физическое адресное пространство — приёмник копии. Значения, задаваемые в обоих полях, должны быть кратны размеру системной страницы. .IP \[bu] \fIbufsz\fP байт копируется из буфера источника в буфер назначения ядра. Если \fIbufsz\fP меньше чем \fImemsz\fP, то оставшиеся байты в буфере ядра заполняются нулями. .PP При обычной работе kexec (т. е., флаг не установлен \fBKEXEC_ON_CRASH\fP) сегмент данных загружен в любую доступную память и перемещение выполняется в конечное назначение во время перезагрузки kexec (например, при выполнении команды \fBkexec\fP(8) с параметром \fI\-e\fP). .PP При панике kexec (т. е., флаг \fBKEXEC_ON_CRASH\fP установлен)сегмент данных загружен в зарезервированную память на момент вызова, и, после падения (crash), механизм kexec просто передаёт управление ядру. .PP Системный вызов \fBkexec_load\fP() доступен только, если ядро было собрано с параметром \fBCONFIG_KEXEC\fP. .SS kexec_file_load() The \fBkexec_file_load\fP() system call is similar to \fBkexec_load\fP(), but it takes a different set of arguments. It reads the kernel to be loaded from the file referred to by the file descriptor \fIkernel_fd\fP, and the initrd (initial RAM disk) to be loaded from file referred to by the file descriptor \fIinitrd_fd\fP. The \fIcmdline\fP argument is a pointer to a buffer containing the command line for the new kernel. The \fIcmdline_len\fP argument specifies size of the buffer. The last byte in the buffer must be a null byte (\[aq]\e0\[aq]). .PP Аргумент \fIflags\fP представляет собой битовую маску, которая изменяет поведение вызова. В \fIflags\fP можно указать следующие значения: .TP \fBKEXEC_FILE_UNLOAD\fP Выгрузить загруженное в данный момент ядро. .TP \fBKEXEC_FILE_ON_CRASH\fP Загрузить новое ядро в область памяти зарезервированную под аварийное ядро (как для \fBKEXEC_ON_CRASH\fP). Ядро запускается, если отказывает работающее в данный момент ядро. .TP \fBKEXEC_FILE_NO_INITRAMFS\fP Загрузка initrd/initramfs не обязательна. Установите данный флаг, если не нужно загружать initramfs. Если флаг установлен, то значение, передаваемое в \fIinitrd_fd\fP игнорируется. .PP .\" See also http://lwn.net/Articles/603116/ Системный вызов \fBkexec_file_load\fP() был добавлен для поддержки систем, где загрузка «kexec» должна быть ограничена только подписанными ядрами. Данный системный вызов доступен только, если ядро собрано с параметром \fBCONFIG_KEXEC_FILE\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении эти системные вызовы возвращают 0. При ошибке возвращается \-1, а в \fIerrno\fP содержится код ошибки. .SH ОШИБКИ .TP \fBEADDRNOTAVAIL\fP .\" See kernel/kexec.::sanity_check_segment_list in the 3.19 kernel source Указаны флаги \fBKEXEC_ON_CRASH\fP, но область, заданная полями \fImem\fP и \fImemsz\fP одного из элементов \fIsegments\fP, находится за пределами диапазона памяти, зарезервированного для аварийного ядра. .TP \fBEADDRNOTAVAIL\fP Значение в поле \fImem\fP или \fImemsz\fP в одном из элементов \fIsegments\fP не кратно размеру системной страницы. .TP \fBEBADF\fP Значение \fIkernel_fd\fP или \fIinitrd_fd\fP не является правильным файловым дескриптором. .TP \fBEBUSY\fP Уже загружено другое аварийное ядро или аварийное ядро уже используется. .TP \fBEINVAL\fP Значение \fIflags\fP неверно. .TP \fBEINVAL\fP Значение поля \fIbufsz\fP одного из элементов \fIsegments\fP превышает значение в соответствующем поле \fImemsz\fP. .TP \fBEINVAL\fP Значение \fInr_segments\fP превышает \fBKEXEC_SEGMENT_MAX\fP (16). .TP \fBEINVAL\fP Два или более буфера назначения ядра перекрываются. .TP \fBEINVAL\fP The value in \fIcmdline[cmdline_len\-1]\fP is not \[aq]\e0\[aq]. .TP \fBEINVAL\fP Файл, на который ссылается \fIkernel_fd\fP или \fIinitrd_fd\fP, пуст (нулевой длины). .TP \fBENOEXEC\fP Значение \fIkernel_fd\fP не указывает на открытый файл, или ядро не может загрузить этот файл. В настоящее время, файл должен быть в формате и содержать ядро x86, которое можно загрузить в память выше 4\ ГиБ (смотрите файл исходного кода ядра \fIDocumentation/x86/boot.txt\fP). .TP \fBENOMEM\fP Невозможно выделить память. .TP \fBEPERM\fP Вызывающий не имеет мандата \fBCAP_SYS_BOOT\fP. .SH СТАНДАРТЫ Linux. .SH ИСТОРИЯ .TP \fBkexec_load\fP() Linux 2.6.13. .TP \fBkexec_file_load\fP() Linux 3.17. .SH "СМ. ТАКЖЕ" \fBreboot\fP(2), \fBsyscall\fP(2), \fBkexec\fP(8) .PP Файлы исходного кода ядра \fIDocumentation/kdump/kdump.txt\fP и \fIDocumentation/admin\-guide/kernel\-parameters.txt\fP .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Alex Nik , Azamat Hackimov , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .