manページ  — CHOWN

chown, fchown, lchown – ファイルの所有者とグループを変更する

ライブラリ 書式 解説 戻り値 エラー 関連項目 規格 歴史

Standard C Library (libc, -lc)

#include <unistd.h>

int
chown(const char *path, uid_t owner, gid_t group);

int
fchown(int fd, uid_t owner, gid_t group);

int
lchown(const char *path, uid_t owner, gid_t group);

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

chown() と lchown() は、次の場合に処理を失敗して、ファイルは変更されません:

[ENOTDIR]
	パスの構成要素中にディレクトリ以外のものが含まれています。
[ENAMETOOLONG]
	パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。
[ENOENT]
	指定されたファイルが存在しません。
[EACCES]
	指定されたパスには、検索が許可されていないディレクトリが含まれています。
[ELOOP]
	パス名を変換するときに検出されたシンボリックリンクが多すぎます。
[EPERM]
	実効ユーザ ID がスーパユーザでありません。
[EROFS]
	指定されたファイルは読取り専用ファイルシステム上にあります。
[EFAULT]
	path 引数が、プロセスに割り当てられたアドレス空間の範囲外を指しています。
[EIO]	ファイルシステムに読み書きしている間に入出力エラーが発生しました。

fchown() システムコールは、次の場合に失敗します:

[EBADF]
	fd 引数が有効な記述子ではありません。
[EINVAL]
	fd 引数がファイルではなくソケットを参照しています。
[EPERM]
	実効ユーザ ID がスーパユーザではありません。
[EROFS]
	指定のファイルは読取り専用ファイルシステムに常駐しています。
[EIO]	ファイルシステムに読み書きしている間に入出力エラーが発生しました。

chown() システムコールは IEEE Std 1003.1-90 ("POSIX.1") に適合しています。

chown() 関数は AT&T v7 で登場しました。 fchown() システムコールは BSD 4.2 で登場しました。

chown() システムコールは BSD 4.4 でシンボリックリンクをたどるように変更されました。 lchown() システムコールは、機能の欠落を補充するために FreeBSD 3.0 で追加されました。