tail head cat sleep
QR code linking to this page

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);

解説

path で指定された、または fd で参照されたファイルの所有者 ID およびグループ ID を、 引数に指定された owner および group に変更します。 ファイルの所有者は、 group に自分が所属している任意のグループを指定できます。 しかし、 owner を変更することができるのはスーパユーザのみです。

chown() システムコールは、スーパユーザによって実行される場合をのぞいて、 ファイル上のユーザ ID 設定ビットとグループ ID 設定ビットをクリアします。 これは、ユーザ ID 設定あるいはグループ ID 設定されたプログラムが 偶然、またはいたずらで作成されるのを防止するためです。 chown() システムコールは、シンボリックリンクをたどり、 リンク自体ではなくリンクのターゲットに作用します。

fchown() システムコールが特に便利なのは、ファイルロッキングプリミティブとともに 使用するときです (flock(2) を参照)。

lchown() システムコールは、 chown() に類似していますが、シンボリックリンクをたどりません。

所有者 ID またはグループ ID として -1 を指定した場合、 その ID は変更されません。

戻り値

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] ファイルシステムに読み書きしている間に入出力エラーが発生しました。

関連項目

chgrp(1), chmod(2), flock(2), chown(8)

規格

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

歴史

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

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


CHOWN (2) April 19, 1994

tail head cat sleep
QR code linking to this page


このマニュアルページサービスについてのご意見は Ben Bullock にお知らせください。 Privacy policy.

If it wasn't for C, we'd be using BASI, PASAL and OBOL