CHDIR(2) — NEWS-OS Programmer’s Manual

名称

chdir − カレントワーキングディレクトリを変更する

chdir(path)
char ∗path;

path は、ディレクトリのパス名です。 chdir は、このディレクトリをカレントワーキングディレクトリ (“/”で始まっていないパス名のサーチの開始点)にします。

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

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

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

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

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

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

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

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

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

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

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