CHMOD

Section: System Calls (2)
索引 jman

BSD mandoc
 

索引

名称

chmod fchmod lchmod - ファイルのモードを変更する  

索引

ライブラリ

Lb libc  

索引

書式

In sys/stat.h Ft int Fn chmod const char *path mode_t mode Ft int Fn fchmod int fd mode_t mode Ft int Fn lchmod const char *path mode_t mode  

索引

解説

Fa path で指定されるか、またはファイル記述子 Fa fd で参照されるファイルの ファイル許可ビットを Fa mode に変更します。 Fn chmod システムコールは、プロセス所有者 (ユーザ) が Fa path (または Fa fd ) で指定されたファイルを所有するか、またはスーパユーザで あるかのどちらかであることを確認します。 Fn chmod システムコールは、シンボリックリンクをたどり、 リンク自体ではなくリンクのターゲットに作用します。

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

モードは In sys/stat.h で定義された許可ビットマスクの論理和 ( or から作成されます:

#define S_IRWXU 0000700    /* 所有者用の RWX マスク */
#define S_IRUSR 0000400    /* 所有者用の R */
#define S_IWUSR 0000200    /* 所有者用の W */
#define S_IXUSR 0000100    /* 所有者用の X */

#define S_IRWXG 0000070    /* グループ用の RWX マスク */
#define S_IRGRP 0000040    /* グループ用の R */
#define S_IWGRP 0000020    /* グループ用の W */
#define S_IXGRP 0000010    /* グループ用の X */

#define S_IRWXO 0000007    /* その他用の RWX マスク */
#define S_IROTH 0000004    /* その他用の R */
#define S_IWOTH 0000002    /* その他用の W */
#define S_IXOTH 0000001    /* その他用の X */

#define S_ISUID 0004000    /* 実行時にユーザ ID を設定 */
#define S_ISGID 0002000    /* 実行時にグループ ID を設定 */
#define S_ISVTX 0001000    /* スティッキビット */
#ifndef __BSD_VISIBLE
#define S_ISTXT 0001000    /* スティッキビット */
#endif

Fx VM システムは、実行可能モジュールについてスティッキビット (ISTXT ) を完全に無視します。 UFS をベースとしたファイルシステム (FFS, LFS) では、 スティッキビットはディレクトリにだけ設定できます。

ISTXT (`スティッキビット') が設定されているディレクトリでは、 特権のないユーザは、そのディレクトリ内にある他ユーザのファイルの削除、 名前の変更ができません。 どのユーザでも、そのユーザが所有するか適切な許可のあるディレクトリについて スティッキビットを設定できます。 スティッキビットの性質の詳細については、 sticky(8) を参照してください。

あるディレクトリに ISUID (ユーザ ID 設定ビット) が設定されており、 かつファイルシステムをマウントする際に MNT_SUIDDIR オプションが 指定されていた場合、 このディレクトリ内に作成される新しいファイルとサブディレクトリの所有者は、 ディレクトリの所有者に設定されます。 この機能が有効であるとき、新しいディレクトリは親から ISUID ビットを継承します。 実行ビットはファイルから取り除かれ、ファイルは root の所有とはなりません。 この機能は、ファイルへの書込みがユーザに許可される条件を変更しません。 ファイルが作成された後の最終的な所有者の決定に影響するのみです。 グループは継承されません。

この機能は、ftp、SAMBA または netatalk 経由の PC ユーザへの ファイルサービスで使用されるよう設計されています。 これはシェルユーザにセキュリティホールを提供するので、 特に、ホームディレクトリでは使用してはなりません。 このオプションが機能するためには、 カーネル内に SUIDDIR オプションが必要です。 UFS ファイルシステムだけがこのオプションをサポートします。 suiddir マウントオプションの詳細については、 mount(8) を参照してください。

スーパユーザ以外のユーザによる、 ファイルの書込みまたはファイルの所有者の変更によってユーザ ID 設定ビットと グループ ID 設定ビットはオフに切り替えられます。 互換性は犠牲になりますが、 ユーザ ID 設定 (グループ ID 設定) ビットを残したまま ファイルが変更されるのを防ぐことで、 システムはいくらか安全になります。  

索引

戻り値

Rv -std  

索引

エラー

Fn chmod システムコールは、次の場合に処理に失敗しファイルモードは変更されません:

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

Fn fchmod システムコールは、次の場合に処理を失敗します:

Bq Er EBADF
記述子が有効ではありません。
Bq Er EINVAL
Fa fd 引数がファイルではなくソケットを参照しています。
Bq Er EROFS
ファイルが読取り専用のファイルシステム上に置かれています。
Bq Er EIO
ファイルシステムに読み書きしている間に入出力エラーが発生しました。

 

索引

関連項目

chmod(1), chown(2), open(2), stat(2), sticky(8)  

索引

規格

Fn chmod システムコールは Er EFTYPE が返されることと S_ISTXT の使用法を除けば St -p1003.1-90 に適合しています。  

索引

歴史

Fn chmod システムコールは AT&T System v7 で登場しました。 Fn fchmod システムコールは BSD 4.2 で登場しました。 Fn lchmod システムコールは Fx 3.0 で登場しました。


 

索引

Index

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

jman



Time: 07:06:28 GMT, January 12, 2009