CHROOT(2) — UNIX Programmer’s Manual

名称

chroot − ルートディレクトリを変更する

chroot(dirname)
char ∗dirname;

dirname は、ディレクトリのナルバイトで終わっているパス名のアドレスです。 chroot は、このディレクトリをルートディレクトリ(“/”で始まっているパス名の開始点)にします。

ディレクトリがルートディレクトリになるためには、プロセスがそのディレクトリに対して実行(サーチ)可能でなければなりません。

このコールは、スーパーユーザだけに制限されています。

正常終了時には、値 0 が返されます。そうでない場合には、 −1 が返され、 errno がセットされてエラーを示します。

以下に示されている項目のうち 1つ以上が真である場合には、 chroot は失敗し、ルートディレクトリは変更されません。

[ENOTDIR] パス名の構成要素がディレクトリではないものがある。

[EINVAL] パス名に最上位ビットのセットされたキャラクタが含まれている。 (NEWS-OSには、このエラーはおきない。)

[ENAMETOOLONG]
パス名の 1構成要素が 255 バイトを超えている、またはパス名全体が 1023 バイトを超えている。

[ENOENT] 指定されたディレクトリが存在していない。

[EACCES] パス名のいずれかの構成要素についてサーチパーミッションが許されていないものがある。

[ELOOP] パス名の処理で遭遇したシンボリックリンクの数が多すぎる。

[EFAULT] path が、そのプロセスに割り当てられたアドレススペースの外を指している。

[EIO] ファイルシステムへの書き込みまたはファイルシステムからの読み取りを行っている間に入出力エラーが発生した。