chmod(2)

構文

#include <sys/stat.h>

int chmod(const char *path, mode_t mode);

int fchmod(int fildes, mode_t mode);

説明

chmod() と fchmod() システムコール は、 mode で指定されているビットパターンにしたがって、ファイルのモードの アクセスパーミッションを設定します。 path は、ファイルを指定するパス名を示します。 fildes は、ファイル記述子です。

アクセスパーミッション ビットを表現する、以下の記号定数は、 <sys/stat.h> 内で定義されており、 mode 引き数を構成するために使われます。 mode の値は、希望するパーミッションに対する記号定数の値のビットごとの論理和 になります。

ファイルのモードを変更するには、プロセスの実効ユーザー ID が、ファイルの所有者か 適切な特権 を持つユーザーのものと一致していなくてはいけません。

プロセスの実効ユーザー ID が 適切な特権 を持つユーザーのものでない場合は、 モードビット S_ISVTX がクリアされます。

プロセスの実効ユーザー ID が 適切な特権 を持つユーザーのものではなく、 プロセスの実効グループ ID がファイルのグループ ID と一致せず、補助グループリスト内のどのグループ ID もファイルのグループ ID と一致しない場合は、 モードビット S_ISGID がクリアされます。

モードビット S_ENFMT (S_ISGID と同じ) は、グループに実行許可のないファイルに対する強制的なファイルロッキング モード lockf(2) と fcntl(2) を参照) に使われます。 これは、そのようなファイルに対する、 open()、 creat()、 read()、 write() 呼び出しに影響を与えます open(2)、 creat(2)、 read(2)、 write(2) を参照)。

実行可能ファイルが共有テキストになっている場合、 モードビット S_ISVTX は、ファイルが最後に実行されたときに、 ファイルのプログラムテキスト部のスワップ領域イメージをシステムが 破棄してしまうのを防止します。 この場合、次のユーザーがファイルを実行するときに、 テキストをファイルシステムから読み込まずに、単にスワップインするだけ でよいので、時間を節約できます。

ディレクトリに対してモードビット S_ISVTX (スティッキービット) がセットされている場合、そのディレクトリにあるファイルの削除および名称変更を行えるのは、そのファイルの所有者、そのディレクトリの所有者、またはスーパーユーザーだけです (この制限は、ディレクトリのモードでこのような操作が他に許されている場合にも適用されます)。

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

戻り値

chmod() は次の値を返します。

エラー

chmod() が失敗した場合、ファイルのモードは変更されません。 次の値の １ つが errno にセットされます。

fchmod() が失敗した場合、ファイルのモードは変更されません。 次の値の １ つが errno にセットされます。

著者

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

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

参照

chmod(1)、 getacl(1)、 chown(2)、 creat(2)、 fcntl(2)、 getacl(2)、 read(2)、 lockf(2)、 mknod(2)、 open(2)、 setacl(2)、 write(2)、 acl(5)、 aclv(5)

標準準拠