chown(2)

構文

#include <unistd.h>

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

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

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

説明

chown() システムコールは、ファイルのユーザーとグループの所有権を変更します。 path は、ファイルのパス名を示しています。 chown() は、 ファイルの所有者 ID とグループ ID を、 owner と group で指定された数値にそれぞれ設定します。 owner や group に UID_NO_CHANGE や GID_NO_CHANGE の値が指定されている場合、ファイルの所有者 ID やグループ ID はそれぞれ変更されません。 owner と group は、 UID_MAX より小さくなくてはいけないことに注意してください limits(5) を参照)。

ファイルの所有者、あるいは、適切な特権を持っている ユーザーと同じ実効ユーザー ID を持つプロセスだけが、ファイルの所有権を変更することができます。 特権グループがサポートされている場合、 ファイルの所有者が、 CHOWN が許されている特権グループのメンバーであり、 setprivgrp コマンド setprivgrp(1M) を参照) により設定されているときに限り、 所有権を変更することができます。 デフォルトでは、ユーザーは全員、 CHOWN 特権を持っています。

ファイルのグループ所有権は、現在のプロセスのアクセスリスト内の グループか、現在のプロセスの実グループか有効グループの ID に変更されます。 特権グループがサポートされていて、ユーザーが CHOWN 特権を持っている場合、ファイルをどのグループにも指定することができます。

スーパーユーザー以外のユーザーが通常のファイルに対して chown() を呼び出した場合、ファイルモードのセットユーザー ID ビットとセットグループ ID ビットはクリアされます。 他のタイプのファイルに対して chown() が呼び出された場合、これらのビットが保存されるかクリアされるかは、 インプリメンテーションに依存しています。

chown() で指定されているパスの最後の構成要素がシンボリックリンクになっているとき、 このリンクはたどられ、パス名変換は続けられます。 chown() は、リンク自体の所有者とグループを変更するのではなく、シンボリックリンクの リンク先の所有者とグループを変更します。

fchown() システムコールは、パス名ではなくファイル記述子で操作対象を指定することを除き、 chown() と同じように機能します。 fildes は、ファイル記述子です。

lchown() システムコールは、指定されたファイルがシンボリックリンクの場合を除き、 chown() と同じように、指定されたファイルの所有者 ID とグループ ID を設定します。この場合、 lchown() はシンボリックリンク ファイル自体の所有者とグループを変更します。

戻り値

chown() と fchown() は次の値を返します。

エラー

chown() または lchown() が失敗した場合、次の値の １ つが errno にセットされます。

fchown() が失敗した場合、次の値の １ つが errno にセットされます。

著者

chown() は、 AT&T で開発されました。

fchown() は、カリフォルニア大学バークレイ校で開発されました。

参照

chown(1), setprivgrp(1M), chmod(2), setacl(2), acl(5), aclv(5), limits(5)

標準準拠

chown(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1

fchown(): AES, SVID3