.\" commit fe3d197f84319d3bce379a9c0dc17b1f48ad358c
.\" See also http://lwn.net/Articles/582712/
.\" See also https://gcc.gnu.org/wiki/Intel%20MPX%20support%20in%20the%20GCC%20compiler
-Enable or disable kernel management of Memory Protection eXtensions (MPX)
-bounds tables.
+Memory Protection eXtensions (MPX) の境界テーブル (bounds table)
+のカーネル管理の有効化/無効化を行う。
-MPX is a hardware\-assisted mechanism for performing bounds checking on
-pointers. It consists of a set of registers storing bounds information and
-a set of special instruction prefixes that tell the CPU on which
-instructions it should do bounds enforcement. There is a limited number of
-these registers and when there are more pointers than registers, their
-contents must be "spilled" into a set of tables. These tables are called
-"bounds tables" and the MPX \fBprctl\fP() operations control whether the
-kernel manages their allocation and freeing.
+MPX は、 ポインターの境界チェックを行うハードウェア支援機構である。 この機能は、 境界情報を格納するレジスター群と、
+境界チェックをどの命令に課すかを CPU に教えるための特別な命令プレフィックスの集合で構成される。 これらのレジスター数は限られており、
+レジスター数よりも多くのポインターがある場合には、 その内容をテーブル群に退避する (spilled) 必要がある。 これらのテーブル群は「境界テーブル
+(bounds tables)」と呼ばれ、 MPX \fBprctl\fP 命令はカーネルがこれらの割り当てと解放を行うかどうかを制御する。
-When management is enabled, the kernel will take over allocation and freeing
-of the bounds tables. It does this by trapping the #BR exceptions that
-result at first use of missing bounds tables and instead of delivering the
-exception to user space, it allocates the table and populates the bounds
-directory with the location of the new table. For freeing, the kernel
-checks to see if bounds tables are present for memory which is not
-allocated, and frees them if so.
+管理が有効になっている場合、 カーネルが境界テーブルの割り当てと解放を担当する。 最初に存在しない境界テーブルを使おうとした際に上がる #BR
+例外を捕捉し、 ユーザー空間に例外を配送せずに、 テーブルの割り当てを行い、 新しいテーブルに境界情報 (bounds directory)
+を書き込む。 解放に関しては、 カーネルが割り当てられていないメモリーに対応する境界テーブルが存在するかを確認し、 そうであれば解放を行う。
-Before enabling MPX management using \fBPR_MPX_ENABLE_MANAGEMENT\fP, the
-application must first have allocated a user\-space buffer for the bounds
-directory and placed the location of that directory in the \fIbndcfgu\fP
-register.
+\fBPR_MPX_ENABLE_MANAGEMENT\fP を使って MPX 管理を有効にする前に、
+アプリケーションはまず境界情報管理用のユーザー空間バッファーを割り当て、 その管理情報の場所を \fIbndcfgu\fP
+レジスターに設定しなければならない。
-These calls will fail if the CPU or kernel does not support MPX. Kernel
-support for MPX is enabled via the \fBCONFIG_X86_INTEL_MPX\fP configuration
-option. You can check whether the CPU supports MPX by looking for the 'mpx'
-CPUID bit, like with the following command:
+CPU やカーネルが MPX をサポートしていない場合、 これらの呼び出しは失敗する。 カーネルによる MPX のサポートは
+\fBCONFIG_X86_INTEL_MPX\fP 設定オプションで有効にできる。 CPU が MPX をサポートしているかを確認するには、 以下のように
+\&'mpx' CPUID ビットを見ればよい。
cat /proc/cpuinfo | grep ' mpx '
-A thread may not switch in or out of long (64\-bit) mode while MPX is
-enabled.
+MPX が有効になっている間は、 スレッドはロング (64 ビット) モードのオン/オフの切り替えはできない。
-All threads in a process are affected by these calls.
+プロセス内のすべてのスレッドがこれらの呼び出しの影響を受ける。
-The child of a \fBfork\fP(2) inherits the state of MPX management. During
-\fBexecve\fP(2), MPX management is reset to a state as if
-\fBPR_MPX_DISABLE_MANAGEMENT\fP had been called.
+\fBfork\fP(2) で作成された子プロセスは MPX 管理の状態を継承する。 \fBexecve\fP(2) の中で、 MPX 管理は
+\fBPR_MPX_DISABLE_MANAGEMENT\fP が呼ばれた場合と同じ状態がリセットされる。
.\"
Intel MPX についての詳しい情報は、カーネルソースファイル \fIDocumentation/x86/intel_mpx.txt\fP を参照。
.TP
\fBPR_SET_CHILD_SUBREAPER\fP (Linux 3.4 以降)
.\" commit ebec18a6d3aa1e7d84aab16225e87fd25170ec2b
-If \fIarg2\fP is nonzero, set the "child subreaper" attribute of the calling
-process; if \fIarg2\fP is zero, unset the attribute. When a process is marked
-as a child subreaper, all of the children that it creates, and their
-descendants, will be marked as having a subreaper. In effect, a subreaper
-fulfills the role of \fBinit\fP(1) for its descendant processes. Upon
-termination of a process that is orphaned (i.e., its immediate parent has
-already terminated) and marked as having a subreaper, the nearest still
-living ancestor subreaper will receive a \fBSIGCHLD\fP signal and be able to
-\fBwait\fP(2) on the process to discover its termination status.
+\fIarg2\fP が 0 以外の場合、 呼び出し元プロセスの "child subreaper" 属性をセットする。 \fIarg2\fP が 0 の場合、
+この属性をクリアする。 プロセスが child subreaper のマークが付いている場合、 このプロセスの子プロセスやその子孫にはすべて
+subreaper のマークが付与される。 subreaper は事実上その子孫のプロセスに対して \fBinit\fP(1) の役割を果たす。
+孤児になったプロセス (直接の親プロセスがすでに終了しているプロセス) が終了した際、 そのプロセスに subreaper のマークが付いていると、
+最も近い存在する先祖の subreaper プロセスに \fBSIGCHLD\fP シグナルが送られ、 そのプロセスの \fBwait\fP
+を使って終了ステータスを知ることができる。
.TP
\fBPR_GET_CHILD_SUBREAPER\fP (Linux 3.4 以降)
-Return the "child subreaper" setting of the caller, in the location pointed
-to by \fI(int\ *) arg2\fP.
+呼び出し元の "child subreaper" 設定を、 \fI(int\ *) arg2\fP が指す場所に返す。
.TP
\fBPR_SET_DUMPABLE\fP (Linux 2.3.20 以降)
.\" See http://marc.theaimsgroup.com/?l=linux-kernel&m=115270289030630&w=2
バイトを格納できるようにすべきである。 返される文字列はヌル終端される。
.TP
\fBPR_SET_NO_NEW_PRIVS\fP (Linux 3.5 以降)
-Set the calling process's \fIno_new_privs\fP bit to the value in \fIarg2\fP. With
-\fIno_new_privs\fP set to 1, \fBexecve\fP(2) promises not to grant privileges to
-do anything that could not have been done without the \fBexecve\fP(2) call
-(for example, rendering the set\-user\-ID and set\-group\-ID permission bits,
-and file capabilities non\-functional). Once set, this bit cannot be unset.
-The setting of this bit is inherited by children created by \fBfork\fP(2) and
-\fBclone\fP(2), and preserved across \fBexecve\fP(2).
+呼び出し元プロセスの \fIno_new_privs\fP ビットを \fIarg2\fP の値に設定する。 \fIno_new_privs\fP が 1
+に設定されると、 \fBexecve\fP(2) は、 \fBexecve\fP(2) の呼び出しなしでは実行できなかったことに対する特権を許可しなくなる
+(例えば、 set\-user\-ID/set\-group\-ID 許可ビットやファイルケーパビリティが動作しなくなる)。 一度設定される、
+このビットは解除することができない。 このビットの設定は \fBfork\fP(2) や \fBclone\fP(2) で作成された子プロセスに継承され、
+\fBexecve\fP(2) の前後で保持される。
詳しい情報は、カーネルソースファイル \fIDocumentation/prctl/no_new_privs.txt\fP を参照。
.TP
\fBPR_GET_NO_NEW_PRIVS\fP (Linux 3.5 以降)
-Return (as the function result) the value of the \fIno_new_privs\fP bit for the
-current process. A value of 0 indicates the regular \fBexecve\fP(2)
-behavior. A value of 1 indicates \fBexecve\fP(2) will operate in the
-privilege\-restricting mode described above.
+現在のプロセスの \fIno_new_privs\fP ビットの値を (関数の結果として) 返す。 値 0 は通常の \fBexecve\fP(2)
+の動作を意味する。 値 1 は \fBexecve\fP(2) が上記で述べた特権を制限する動作をすることを示す。
.TP
\fBPR_SET_PDEATHSIG\fP (Linux 2.1.57 以降)
親プロセス死亡シグナル (parent process death signal) を \fIarg2\fP に設定する (設定できるシグナル値の範囲は
\fBPR_SET_PTRACER\fP (Linux 3.4 以降)
.\" commit 2d514487faf188938a4ee4fb3464eeecfbdcf8eb
.\" commit bf06189e4d14641c0148bea16e9dd24943862215
-This is meaningful only when the Yama LSM is enabled and in mode 1
-("restricted ptrace", visible via \fI/proc/sys/kernel/yama/ptrace_scope\fP).
-When a "ptracer process ID" is passed in \fIarg2\fP, the caller is declaring
-that the ptracer process can \fBptrace\fP(2) the calling process as if it were
-a direct process ancestor. Each \fBPR_SET_PTRACER\fP operation replaces the
-previous "ptracer process ID". Employing \fBPR_SET_PTRACER\fP with \fIarg2\fP set
-to 0 clears the caller's "ptracer process ID". If \fIarg2\fP is
-\fBPR_SET_PTRACER_ANY\fP, the ptrace restrictions introduced by Yama are
-effectively disabled for the calling process.
+この設定は Yama LSM が有効になっていてモード 1 ("restricted ptrace") の場合のみに意味を持つ (モードは
+\fI/proc/sys/kernel/yama/ptrace_scope\fP で参照可能)。 "ptrace プロセス ID" が \fIarg2\fP
+で渡された場合、 呼び出し元は ptracer プロセスがそのプロセスが直接のプロセスの先祖であるかのよう呼び出したプロセスを \fBptrace\fP
+できる、 と宣言しているということだ。 \fBPR_SET_PTRACER\fP 操作を行う毎に、 直前の "ptracer プロセス ID"
+は置きかえられる。 \fIarg2\fP で \fBPR_SET_PTRACER\fP を 0 に設定すると、 呼び出し元の "ptracer プロセス ID"
+がクリアされる。 \fIarg2\fP が \fBPR_SET_PTRACER\fP の場合、 Yama が導入した ptrace
+の制限は呼び出し元プロセスに対しては無効になる。
詳しい情報は、カーネルソースファイル \fIDocumentation/security/Yama.txt\fP を参照。
.TP
.\" commit 6976675d94042fbd446231d1bd8b7de71a980ada
.\" It seems that it's not possible to set the timer slack to zero;
.\" The minimum value is 1? Seems a little strange.
-Set the current timer slack for the calling thread to the nanosecond value
-supplied in \fIarg2\fP. If \fIarg2\fP is less than or equal to zero, reset the
-current timer slack to the thread's default timer slack value. The timer
-slack is used by the kernel to group timer expirations for the calling
-thread that are close to one another; as a consequence, timer expirations
-for the thread may be up to the specified number of nanoseconds late (but
-will never expire early). Grouping timer expirations can help reduce system
-power consumption by minimizing CPU wake\-ups.
+呼び出し元スレッドの現在の timer slack を \fIarg2\fP で指定されたナノ秒に設定する。 \fIarg2\fP が 0 以下の場合、 現在の
+timer slack をそのスレッドのデフォルトの timer slack 値にリセットする。 カーネルは timer slack を使って、
+呼び出し元スレッドのタイマー満了のうち、どのくらい近いものグルーピングする (一纏めにする) かを決める。 その結果、
+そのスレッドのタイマーの満了は最大で指定されたナノ秒分だけ遅れる場合がある。 タイマー満了をグルーピングすることで、 CPU
+を起こす回数が最小化されシステムの消費電力を減らすことができる。
.\" List obtained by grepping for futex usage in glibc source
-The timer expirations affected by timer slack are those set by \fBselect\fP(2),
-\fBpselect\fP(2), \fBpoll\fP(2), \fBppoll\fP(2), \fBepoll_wait\fP(2), \fBepoll_pwait\fP(2),
-\fBclock_nanosleep\fP(2), \fBnanosleep\fP(2), and \fBfutex\fP(2) (and thus the
-library functions implemented via futexes, including
-\fBpthread_cond_timedwait\fP(3), \fBpthread_mutex_timedlock\fP(3),
-\fBpthread_rwlock_timedrdlock\fP(3), \fBpthread_rwlock_timedwrlock\fP(3), and
-\fBsem_timedwait\fP(3)).
+timer slack の影響を受けるのは、 システムコール \fBselect\fP(2), \fBpselect\fP(2), \fBpoll\fP(2),
+\fBppoll\fP(2), \fBepoll_wait\fP(2), \fBepoll_pwait\fP(2), \fBclock_nanosleep\fP(2),
+\fBnanosleep\fP(2), \fBfutex\fP(2) により設定されたタイマー満了である
+(また、 futex を使って実装されているライブラリ関数 \fBpthread_cond_timedwait\fP(3),
+\fBpthread_mutex_timedlock\fP(3), \fBpthread_rwlock_timedrdlock\fP(3),
+\fBpthread_rwlock_timedwrlock\fP(3), \fBsem_timedwait\fP(3) も影響を受ける)。
-Timer slack is not applied to threads that are scheduled under a real\-time
-scheduling policy (see \fBsched_setscheduler\fP(2)).
+timer slack はリアルタイムスケジューリングポリシーでスケジューリングされるスレッドには提供されない
+(\fBsched_setscheduler\fP(2) 参照)。
-Each thread has two associated timer slack values: a "default" value, and a
-"current" value. The current value is the one that governs grouping of
-timer expirations. When a new thread is created, the two timer slack values
-are made the same as the current value of the creating thread. Thereafter,
-a thread can adjust its current timer slack value via \fBPR_SET_TIMERSLACK\fP
-(the default value can't be changed). The timer slack values of \fIinit\fP
-(PID 1), the ancestor of all processes, are 50,000 nanoseconds (50
-microseconds). The timer slack values are preserved across \fBexecve\fP(2).
+各スレッドには timer slack に関連する値が 2 つある。 「デフォルト値」と「現在値」である。
+現在値はタイマー満了のグルーピングを制御する。 新しいスレッドが作成される際、 2 つの timer slack
+値はそのスレッドを作成したスレッドの現在値と同じに設定される。 その後、 スレッドは \fBPR_SET_TIMERSLACK\fP で現在の timer
+slack 値を調整できる (デフォルト値は変更できない)。 すべてのプロセスの先祖となる \fIinit\fP (PID 1) の timer slack
+値は 50,000 ナノ秒 (50 ミリ秒) である。 timer slack 値は \fBexecve\fP(2) の前後で保持される。
.TP
\fBPR_GET_TIMERSLACK\fP (Linux 2.6.28 以降)
呼び出し元スレッドの現在のタイマーのスラック値を (関数の結果として) 返す。
arg2\fP が指す場所に格納して返す。
.TP
\fBPR_MCE_KILL\fP (Linux 2.6.32 以降)
-Set the machine check memory corruption kill policy for the current thread.
-If \fIarg2\fP is \fBPR_MCE_KILL_CLEAR\fP, clear the thread memory corruption kill
-policy and use the system\-wide default. (The system\-wide default is defined
-by \fI/proc/sys/vm/memory_failure_early_kill\fP; see \fBproc\fP(5).) If \fIarg2\fP
-is \fBPR_MCE_KILL_SET\fP, use a thread\-specific memory corruption kill policy.
-In this case, \fIarg3\fP defines whether the policy is \fIearly kill\fP
-(\fBPR_MCE_KILL_EARLY\fP), \fIlate kill\fP (\fBPR_MCE_KILL_LATE\fP), or the
-system\-wide default (\fBPR_MCE_KILL_DEFAULT\fP). Early kill means that the
-thread receives a \fBSIGBUS\fP signal as soon as hardware memory corruption is
-detected inside its address space. In late kill mode, the process is killed
-only when it accesses a corrupted page. See \fBsigaction\fP(2) for more
-information on the \fBSIGBUS\fP signal. The policy is inherited by children.
-The remaining unused \fBprctl\fP() arguments must be zero for future
-compatibility.
+現在のスレッドの machine check memory corruption kill ポリシーを設定する。 \fIarg2\fP が
+\fBPR_MCE_KILL_CLEAR\fP の場合、 このスレッドの memory corruption kill ポリシーをクリアし、
+システム全体のデフォルト値を使用する (システム全体のデフォルトは \fI/proc/sys/vm/memory_failure_early_kill\fP
+で定義される。 \fBproc\fP(5) 参照)。 \fIarg2\fP が \fBPR_MCE_KILL_SET\fP の場合、 スレッド固有の memory
+corruption kill ポリシーを使用する。 この場合、 \fIarg3\fP によりこのポリシーが \fIearly kill\fP
+(\fBPR_MCE_KILL_EARLY\fP か、 \fIlate kill\fP (\fBPR_MCE_KILL_LATE\fP) か、 システム全体のデフォルト値
+(\fBPR_MCE_KILL_DEFAULT\fP) が指定される。 early kill は、 ハードウェアメモリー破壊 (corruption)
+がスレッドのアドレス空間内で検出されるとすぐに、 そのスレッドが \fBSIGBUS\fP シグナルを受信することを意味する。 late kill
+モードでは、 メモリー破壊が起こったページにアクセスした場合にのみ、 そのプロセスが kill される。 \fBSIGBUS\fP シグナルの詳細は
+\fBsigaction\fP(2) を参照。 このポリシーは子プロセスに継承される。 未使用の残りの \fBprctl\fP() の引き数は将来の互換性のため 0
+にしなければならない。
.TP
\fBPR_MCE_KILL_GET\fP (Linux 2.6.32 以降)
-Return the current per\-process machine check kill policy. All unused
-\fBprctl\fP() arguments must be zero.
+現在のプロセス単位の machine check kill ポリシーを返す。 未使用の \fBprctl\fP() の引き数はすべて 0
+にしなければならない。
.TP
\fBPR_SET_MM\fP (Linux 3.3 以降)
.\" commit 028ee4be34a09a6d48bdf30ab991ae933a7bc036
.\" commit fe3d197f84319d3bce379a9c0dc17b1f48ad358c
.\" See also http://lwn.net/Articles/582712/
.\" See also https://gcc.gnu.org/wiki/Intel%20MPX%20support%20in%20the%20GCC%20compiler
-Enable or disable kernel management of Memory Protection eXtensions (MPX)
-bounds tables.
+Memory Protection eXtensions (MPX) の境界テーブル (bounds table)
+のカーネル管理の有効化/無効化を行う。
-MPX is a hardware\-assisted mechanism for performing bounds checking on
-pointers. It consists of a set of registers storing bounds information and
-a set of special instruction prefixes that tell the CPU on which
-instructions it should do bounds enforcement. There is a limited number of
-these registers and when there are more pointers than registers, their
-contents must be "spilled" into a set of tables. These tables are called
-"bounds tables" and the MPX \fBprctl\fP() operations control whether the
-kernel manages their allocation and freeing.
+MPX は、 ポインターの境界チェックを行うハードウェア支援機構である。 この機能は、 境界情報を格納するレジスター群と、
+境界チェックをどの命令に課すかを CPU に教えるための特別な命令プレフィックスの集合で構成される。 これらのレジスター数は限られており、
+レジスター数よりも多くのポインターがある場合には、 その内容をテーブル群に退避する (spilled) 必要がある。 これらのテーブル群は「境界テーブル
+(bounds tables)」と呼ばれ、 MPX \fBprctl\fP 命令はカーネルがこれらの割り当てと解放を行うかどうかを制御する。
-When management is enabled, the kernel will take over allocation and freeing
-of the bounds tables. It does this by trapping the #BR exceptions that
-result at first use of missing bounds tables and instead of delivering the
-exception to user space, it allocates the table and populates the bounds
-directory with the location of the new table. For freeing, the kernel
-checks to see if bounds tables are present for memory which is not
-allocated, and frees them if so.
+管理が有効になっている場合、 カーネルが境界テーブルの割り当てと解放を担当する。 最初に存在しない境界テーブルを使おうとした際に上がる #BR
+例外を捕捉し、 ユーザー空間に例外を配送せずに、 テーブルの割り当てを行い、 新しいテーブルに境界情報 (bounds directory)
+を書き込む。 解放に関しては、 カーネルが割り当てられていないメモリーに対応する境界テーブルが存在するかを確認し、 そうであれば解放を行う。
-Before enabling MPX management using \fBPR_MPX_ENABLE_MANAGEMENT\fP, the
-application must first have allocated a user\-space buffer for the bounds
-directory and placed the location of that directory in the \fIbndcfgu\fP
-register.
+\fBPR_MPX_ENABLE_MANAGEMENT\fP を使って MPX 管理を有効にする前に、
+アプリケーションはまず境界情報管理用のユーザー空間バッファーを割り当て、 その管理情報の場所を \fIbndcfgu\fP
+レジスターに設定しなければならない。
-These calls will fail if the CPU or kernel does not support MPX. Kernel
-support for MPX is enabled via the \fBCONFIG_X86_INTEL_MPX\fP configuration
-option. You can check whether the CPU supports MPX by looking for the 'mpx'
-CPUID bit, like with the following command:
+CPU やカーネルが MPX をサポートしていない場合、 これらの呼び出しは失敗する。 カーネルによる MPX のサポートは
+\fBCONFIG_X86_INTEL_MPX\fP 設定オプションで有効にできる。 CPU が MPX をサポートしているかを確認するには、 以下のように
+\&'mpx' CPUID ビットを見ればよい。
cat /proc/cpuinfo | grep ' mpx '
-A thread may not switch in or out of long (64\-bit) mode while MPX is
-enabled.
+MPX が有効になっている間は、 スレッドはロング (64 ビット) モードのオン/オフの切り替えはできない。
-All threads in a process are affected by these calls.
+プロセス内のすべてのスレッドがこれらの呼び出しの影響を受ける。
-The child of a \fBfork\fP(2) inherits the state of MPX management. During
-\fBexecve\fP(2), MPX management is reset to a state as if
-\fBPR_MPX_DISABLE_MANAGEMENT\fP had been called.
+\fBfork\fP(2) で作成された子プロセスは MPX 管理の状態を継承する。 \fBexecve\fP(2) の中で、 MPX 管理は
+\fBPR_MPX_DISABLE_MANAGEMENT\fP が呼ばれた場合と同じ状態がリセットされる。
.\"
Intel MPX についての詳しい情報は、カーネルソースファイル \fIDocumentation/x86/intel_mpx.txt\fP を参照。
OSDN Git Service
