+++ /dev/null
-.\" Copyright (C) 2010 Intel Corporation
-.\" Author: Andi Kleen
-.\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein. The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\" Japanese Version Copyright (c) 2012 Akihiro MOTOKI
-.\" all rights reserved.
-.\" Translated 2012-05-05, Akihiro MOTOKI <amotoki@gmail.com>
-.\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
-.\"
-.TH KEXEC_LOAD 2 2014\-08\-19 Linux "Linux Programmer's Manual"
-.SH 名前
-kexec_load \- 新しいカーネルを後で実行するためにロードする
-.SH 書式
-\fB#include <linux/kexec.h>\fP
-.br
-\fBlong kexec_load(unsigned long \fP\fIentry\fP\fB, unsigned long
-\fP\fInr_segments\fP\fB,\fP
-.br
-\fB struct kexec_segment *\fP\fIsegments\fP\fB, unsigned long \fP\fIflags\fP\fB);\fP
-
-\fI注\fP: このシステムコールには glibc のラッパー関数は存在しない。「注意」の節を参照。
-.SH 説明
-\fBkexec_load\fP() システムコールは、新しいカーネルをロードし、
-その後の \fBreboot\fP(2) で実行できるようにする。
-.PP
-\fIflags\fP 引き数は、システムコールの呼び出しの動作を制御するマスクビットである。 \fIflags\fP には以下の値を指定できる。
-.TP
-\fBKEXEC_ON_CRASH\fP (Linux 2.6.13 以降)
-.\" FIXME Explain in more detail how KEXEC_ON_CRASH is actually used
-システムのクラッシュ時に、新しいカーネルを自動的に実行する。
-.TP
-\fBKEXEC_PRESERVE_CONTEXT\fP (Linux 2.6.27 以降)
-新しいカーネルを実行する前に、
-システムのハードウェアとソフトウェアの状態を保存する。
-システムの中断時 (suspend) などで使用できる。
-このフラグは、カーネルの設定で \fBCONFIG_KEXEC_JUMP\fP が有効の場合のみ
-利用可能であり、 \fInr_segments\fP が 0 より大きい場合のみ効果がある。
-.PP
-\fIflags\fP の上位ビット (マスク 0xffff0000 に対応) には、
-実行されるカーネルのアーキテクチャーが入る。
-現在のアーキテクチャーを使うことを意味する定数 \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 の
-いずれか一つを (OR で) 指定する。指定するアーキテクチャーは、
-システムの CPU で実行可能なものでなければならない。
-
-\fIentry\fP 引き数は、カーネルイメージの物理エントリーアドレスである。 \fInr_segments\fP 引き数は、 \fIsegments\fP
-ポインターが指すセグメントの数である。 なお、セグメント数には、カーネルにより 16 という (強制的な) 上限が課される。 \fIsegments\fP
-引き数は \fIkexec_segment\fP 構造体の配列で、 この構造体によりカーネルの配置が定義される。
-.in +4n
-.nf
-
-struct kexec_segment {
- void *buf; /* Buffer in user space */
- size_t bufsz; /* Buffer length in user space */
- void *mem; /* Physical address of kernel */
- size_t memsz; /* Physical address length */
-};
-.fi
-.in
-.PP
-.\" FIXME Explain the details of how the kernel image defined by segments
-.\" is copied from the calling process into previously reserved memory.
-\fIsegments\fP で定義されたカーネルイメージは、
-呼び出したプロセスから予約済みメモリーにコピーされる。
-.SH 返り値
-成功すると、 \fBkexec_load\fP は 0 を返す。
-エラーの場合、 \-1 が返り、 \fIerrno\fP にエラーを示す値が設定される。
-.SH エラー
-.TP
-\fBEBUSY\fP
-別のクラッシュカーネルがすでにロードされているか、
-クラッシュカーネルがすでに使用されている。
-.TP
-\fBEINVAL\fP
-.\" KEXEC_SEGMENT_MAX == 16
-\fIflags\fP が無効である。 \fInr_segments\fP が大きすぎる。
-.TP
-\fBEPERM\fP
-呼び出し側が \fBCAP_SYS_BOOT\fP ケーパビリティを持っていない。
-.SH バージョン
-\fBkexec_load\fP() システムコールは Linux 2.6.13 で初めて登場した。
-.SH 準拠
-このシステムコールは Linux 固有である。
-.SH 注意
-現在のところ、 \fBkexec_load\fP() は glibc ではサポートされていない。
-\fBsyscall\fP(2) を使って呼び出すこと。
-.PP
-.\" FIXME . Andi submitted a patch for this.
-.\" Check if it got accepted later.
-必要な定数は Linux カーネルのソースファイル \fIlinux/kexec.h\fP で定義されている
-が、現在のところ glibc には公開されていない。
-そのため、これらの定数は手動で定義しなければならない。
-
-このシステムコールは、カーネルの設定で \fBCONFIG_KEXEC\fP が有効になって
-いる場合にのみ利用できる。
-.SH 関連項目
-\fBreboot\fP(2), \fBsyscall\fP(2)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.78 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
