CHDIR

Section: Linux Programmer's Manual (2)
Updated: 2019-08-02
Index JM Home Page roff page

名前

chdir, fchdir - 作業ディレクトリの変更

#include <unistd.h>

int chdir(const char *path);
int fchdir(int fd);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

fchdir():

: _XOPEN_SOURCE >= 500
|| /* glibc 2.12 以降: */ _POSIX_C_SOURCE >= 200809L
|| /* glibc 2.19 以前: */ _BSD_SOURCE

chdir() は、呼び出し元プロセスの現在の作業ディレクトリ (current working directory) を、 path に指定されたディレクトリに変更する。

fchdir() は、ディレクトリがオープンされたファイルディスクリプターとして指定される以外は、 chdir() と同じである。

成功した場合は 0 が返される。エラーの場合は -1 が返され、 errno が適切に設定される。

ファイルシステムによっては他のエラーが返される事がある。 chdir() で一般的なエラーを以下に挙げる:

EACCES: path の構成要素のいずれかに検索許可 (search permission) がない (path_resolution(7) も参照すること)。
EFAULT: path がアクセスできるアドレス空間外を指している。
EIO: I/O エラーが発生した。
ELOOP: path を解決する際に遭遇したシンボリックリンクが多過ぎる。
ENAMETOOLONG: path が長過ぎる。
ENOENT: path で指定されたディレクトリが存在しない。
ENOMEM: カーネルに十分なメモリーがない。
ENOTDIR: path の構成要素がディレクトリではない。

fchdir() で一般的なエラーを以下に挙げる:

POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD.

現在の作業ディレクトリは、相対パス名 ('/') で始まっていないパス名) を解釈する際の開始点である。

fork(2) で作成された子プロセスは、親プロセスの現在の作業ディレクトリを継承する。 execve(2) の前後で、現在の作業ディレクトリは変更されない。

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

This document was created by man2html, using the manual pages.
Time: 16:46:40 GMT, November 24, 2023