chdir
Section: System Calls (2)
Updated: 2026-02-08
Index
JM Home Page
roff page
名前
chdir, fchdir - 作業ディレクトリの変更
ライブラリ
標準 C ライブラリ (libc,~-lc)
書式
#include <unistd.h>
int chdir(const char *path);
int fchdir(int fd);
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
fchdir():
_XOPEN_SOURCE >= 500
|| /* Since glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
|| /* glibc up to and including 2.19: */ _BSD_SOURCE
説明
chdir() は、呼び出し元プロセスの現在の作業ディレクトリ (current working directory) を、 path
に指定されたディレクトリに変更する。
fchdir() は、ディレクトリがオープンされたファイルディスクリプターとして 指定される以外は、 chdir() と同じである。
返り値
On success, zero is returned. On error, -1 is returned, and errno is set
to indicate the error.
エラー
ファイルシステムによっては他のエラーが返される事がある。 chdir() で一般的なエラーを以下に挙げる:
- EACCES
-
path の構成要素のいずれかに検索許可 (search permission) がない (path_resolution(7)
も参照すること)。
- EFAULT
-
path がアクセスできるアドレス空間外を指している。
- EIO
-
I/O エラーが発生した。
- ELOOP
-
path を解決する際に遭遇したシンボリックリンクが多過ぎる。
- ENAMETOOLONG
-
path が長過ぎる。
- ENOENT
-
path で指定されたディレクトリが存在しない。
- ENOMEM
-
カーネルに十分なメモリーがない。
- ENOTDIR
-
path の構成要素がディレクトリではない。
fchdir() で一般的なエラーを以下に挙げる:
- EACCES
-
fd をディレクトリとしてオープンするための検索許可がない。
- EBADF
-
fd が適切なファイルディスクリプターでない。
- ENOTDIR
-
fd がディレクトリを参照していない。
標準規格
POSIX.1-2024.
歴史
- chdir()
-
SVr4, POSIX.1-1988, 4.4BSD.
- fchdir()
-
SVr4, 4.4BSD, SUSv1, POSIX.1-2001 XSI, POSIX.1-2008.
注意
The current working directory is the starting point for interpreting
relative pathnames (those not starting with '/').
fork(2) で作成された子プロセスは、親プロセスの現在の作業ディレクトリを 継承する。 execve(2)
の前後で、現在の作業ディレクトリは変更されない。
関連項目
chroot(2), getcwd(3), path_resolution(7)
Index
- 名前
-
- ライブラリ
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 標準規格
-
- 歴史
-
- 注意
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.