.\" <michael@cantor.informatik.rwth-aachen.de>: NFS details
.\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
-.\" Japanese Version Copyright (c) 1996 Yosiaki Yanagihara
-.\" all rights reserved.
-.\" Translated 1996-06-24, Yosiaki Yanagihara <yosiaki@bsd2.kbnes.nec.co.jp>
-.\" Modified 1998-05-11, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" Updated & Modified 2001-06-25, Yuichi SATO <ysato@h4.dion.ne.jp>
-.\" Updated & Modified 2004-12-29, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated 2008-08-09, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.05
+.\"*******************************************************************
.\"
-.TH CHMOD 2 2010-09-26 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH CHMOD 2 2010\-09\-26 Linux "Linux Programmer's Manual"
.SH 名前
chmod, fchmod \- ファイルのモードを変更する
.SH 書式
-.B #include <sys/stat.h>
+\fB#include <sys/stat.h>\fP
.sp
-.BI "int chmod(const char *" path ", mode_t " mode );
+\fBint chmod(const char *\fP\fIpath\fP\fB, mode_t \fP\fImode\fP\fB);\fP
.br
-.BI "int fchmod(int " fd ", mode_t " mode );
+\fBint fchmod(int \fP\fIfd\fP\fB, mode_t \fP\fImode\fP\fB);\fP
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
.ad l
.PD 0
-.BR fchmod ():
+\fBfchmod\fP():
.RS 4
-_BSD_SOURCE ||
-_XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
.br
|| /* glibc 2.12 以降: */ _POSIX_C_SOURCE\ >=\ 200809L
+.RE
.PD
.ad
.SH 説明
-これらのシステムコールはファイルのアクセス許可 (permission) を変更する。
-システムコール間の違いは、ファイルの指定の仕方だけである。
+これらのシステムコールはファイルのアクセス許可 (permission) を変更する。 システムコール間の違いは、ファイルの指定の仕方だけである。
.IP * 2
-.BR chmod ()
-は、
-.I path
-で指定されたパス名を持つファイルの許可を変更する。
-.I path
+\fBchmod\fP() は、 \fIpath\fP で指定されたパス名を持つファイルの許可を変更する。 \fIpath\fP
がシンボリック・リンクの場合は、リンクの展開が行われる。
.IP *
-.BR fchmod ()
-は、オープンされたファイルディスクリプタ
-.I fd
-により参照されるファイルの許可を変更する。
+\fBfchmod\fP() は、オープンされたファイルディスクリプタ \fIfd\fP により参照されるファイルの許可を変更する。
.PP
-新しいファイル許可は
-.I mode
-で指定される。
-.I mode
-は、以下に示す値の 0 個以上の OR (論理和) をとって作成される
+新しいファイル許可は \fImode\fP で指定される。 \fImode\fP は、以下に示す値の 0 個以上の OR (論理和) をとって作成される
ビットマスクである。
-.TP 18
-.BR S_ISUID " (04000)"
-set-user-ID
-.RB ( execve (2)
-時にプロセスの実効ユーザ ID にセットされる)
-.TP
-.BR S_ISGID " (02000)"
-set-group-ID
-(以下の場合に
-.RB ( execve (2)
-実行時にプロセスの実効グループ ID にセットされる、
-強制ロック (mandatory locking) を行う
-.RB ( fcntl (2)
-の説明を参照)、
-新しいファイルのグループとして親ディレクトリと同じものを使う
-.RB ( chown (2)
-と
-.BR ( mkdir (2)
-の説明を参照)
-.TP
-.BR S_ISVTX " (01000)"
-スティッキー・ビット (sticky bit) (削除制限フラグ、
-.BR unlink (2)
-の説明を参照)
-.TP
-.BR S_IRUSR " (00400)"
+.TP 18
+\fBS_ISUID\fP (04000)
+set\-user\-ID (\fBexecve\fP(2) 時にプロセスの実効ユーザ ID にセットされる)
+.TP
+\fBS_ISGID\fP (02000)
+set\-group\-ID (以下の場合に (\fBexecve\fP(2) 実行時にプロセスの実効グループ ID にセットされる、 強制ロック
+(mandatory locking) を行う (\fBfcntl\fP(2) の説明を参照)、
+新しいファイルのグループとして親ディレクトリと同じものを使う (\fBchown\fP(2) と \fB(\fPmkdir\fB(2)\fP の説明を参照)
+.TP
+\fBS_ISVTX\fP (01000)
+スティッキー・ビット (sticky bit) (削除制限フラグ、 \fBunlink\fP(2) の説明を参照)
+.TP
+\fBS_IRUSR\fP (00400)
所有者による読み取り
-.TP
-.BR S_IWUSR " (00200)"
+.TP
+\fBS_IWUSR\fP (00200)
所有者による書き込み
-.TP
-.BR S_IXUSR " (00100)"
-所有者による実行 (execute) / 検索 (search)
-(「検索」はディレクトリに対して適用されるもので、
+.TP
+\fBS_IXUSR\fP (00100)
+所有者による実行 (execute) / 検索 (search) (「検索」はディレクトリに対して適用されるもので、
そのディレクトリ内のエントリーへアクセスできるかを意味する)
-.TP
-.BR S_IRGRP " (00040)"
+.TP
+\fBS_IRGRP\fP (00040)
グループによる読み取り
-.TP
-.BR S_IWGRP " (00020)"
+.TP
+\fBS_IWGRP\fP (00020)
グループによる書き込み
-.TP
-.BR S_IXGRP " (00010)"
+.TP
+\fBS_IXGRP\fP (00010)
グループによる実行 / 検索
-.TP
-.BR S_IROTH " (00004)"
+.TP
+\fBS_IROTH\fP (00004)
他人 (others) による読み取り
-.TP
-.BR S_IWOTH " (00002)"
+.TP
+\fBS_IWOTH\fP (00002)
他人による書き込み
-.TP
-.BR S_IXOTH " (00001)"
+.TP
+\fBS_IXOTH\fP (00001)
他人による実行 / 検索
.PP
-呼び出したプロセスの実効 (effective) UID がファイルの所有者と一致するか、
-そのプロセスが特権を持たなければならない
-(Linux では
-.B CAP_FOWNER
-ケーパビリティ (capability) を持たなければならない)。
+呼び出したプロセスの実効 (effective) UID がファイルの所有者と一致するか、 そのプロセスが特権を持たなければならない (Linux では
+\fBCAP_FOWNER\fP ケーパビリティ (capability) を持たなければならない)。
-呼び出したプロセスに特権がなく (Linux では
-.B CAP_FSETID
-ケーパビリティがなく)、かつファイルのグループ ID が
-プロセスの実効グループ ID または補助的なグループ ID にマッチしない場合、
-.B S_ISGID
+呼び出したプロセスに特権がなく (Linux では \fBCAP_FSETID\fP ケーパビリティがなく)、かつファイルのグループ ID が
+プロセスの実効グループ ID または補助的なグループ ID にマッチしない場合、 \fBS_ISGID\fP
ビットはオフにされるが、これによってエラーが返されることはない。
-安全のための処置として、
-ファイル・システムによっては、ファイルの書き込みを行う時に
-セット・ユーザー ID とセット・グループ ID ビットと実行ビットが
-オフにされることがある。
-(Linux では、書き込みプロセスが
-.B CAP_FSETID
-ケーパビリティを持っていない場合に、これが起こる。)
-ファイル・システムの中には、スーパー・ユーザーだけが
-特別の意味を持つスティッキー・ビットを設定できるものがある。
-スティッキー・ビットとディレクトリに対する
-セット・ユーザー (グループ)・ID ビットについては、
-.BR stat (2)
-を見よ。
+安全のための処置として、 ファイル・システムによっては、ファイルの書き込みを行う時に セット・ユーザー ID とセット・グループ ID
+ビットと実行ビットが オフにされることがある。 (Linux では、書き込みプロセスが \fBCAP_FSETID\fP
+ケーパビリティを持っていない場合に、これが起こる。) ファイル・システムの中には、スーパー・ユーザーだけが
+特別の意味を持つスティッキー・ビットを設定できるものがある。 スティッキー・ビットとディレクトリに対する セット・ユーザー (グループ)・ID
+ビットについては、 \fBstat\fP(2) を見よ。
-NFS ファイルシステム上では、パーミッションを制限すると、
-既にオープンされているファイルに対してすぐに影響が及ぶ。
-これはアクセス制御がサーバー上で行われているが、
-オープンされているファイルはクライアント側で管理されているためである。
-クライアント側でファイル属性のキャッシュが有効になっている場合に、
-パーミッションの制限を緩くすると、
+NFS ファイルシステム上では、パーミッションを制限すると、 既にオープンされているファイルに対してすぐに影響が及ぶ。
+これはアクセス制御がサーバー上で行われているが、 オープンされているファイルはクライアント側で管理されているためである。
+クライアント側でファイル属性のキャッシュが有効になっている場合に、 パーミッションの制限を緩くすると、
他のクライアントに情報が伝わるのが遅れるかもしれない。
.SH 返り値
-成功すると、0 を返す。失敗すると、\-1を返し、
-.I errno
-に適切な値を設定する。
+成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
.SH エラー
-ファイル・システムによっては他のエラーを返す場合がある。
-.BR chmod ()
-で一般的なエラーを以下に挙げる。
-.TP
-.B EACCES
-パス名の構成要素に検索許可がない
-.RB ( path_resolution (7)
-も見よ)。
-.TP
-.B EFAULT
-.I path
-が割り当てられたアドレス空間外を指している。
-.TP
-.B EIO
+ファイル・システムによっては他のエラーを返す場合がある。 \fBchmod\fP() で一般的なエラーを以下に挙げる。
+.TP
+\fBEACCES\fP
+パス名の構成要素に検索許可がない (\fBpath_resolution\fP(7) も見よ)。
+.TP
+\fBEFAULT\fP
+\fIpath\fP がアクセスできるアドレス空間外を指している。
+.TP
+\fBEIO\fP
I/O エラーが発生した。
-.TP
-.B ELOOP
-.I path
-を解決する際に遭遇したシンボリック・リンクが多過ぎる。
-.TP
-.B ENAMETOOLONG
-.I path
-が長過ぎる。
-.TP
-.B ENOENT
+.TP
+\fBELOOP\fP
+\fIpath\fP を解決する際に遭遇したシンボリック・リンクが多過ぎる。
+.TP
+\fBENAMETOOLONG\fP
+\fIpath\fP が長過ぎる。
+.TP
+\fBENOENT\fP
ファイルが存在しない。
-.TP
-.B ENOMEM
+.TP
+\fBENOMEM\fP
カーネルに十分なメモリがない。
-.TP
-.B ENOTDIR
+.TP
+\fBENOTDIR\fP
パス名の構成要素がディレクトリではない。
-.TP
-.B EPERM
-実効 UID がファイルの所有者と一致せず、プロセスに特権がない
-(Linux では
-.B CAP_FOWNER
-ケーパビリティを持たない)。
-.TP
-.B EROFS
+.TP
+\fBEPERM\fP
+実効 UID がファイルの所有者と一致せず、プロセスに特権がない (Linux では \fBCAP_FOWNER\fP ケーパビリティを持たない)。
+.TP
+\fBEROFS\fP
ファイルが読み込み専用 (read only) のファイル・システム上にある。
.PP
-.BR fchmod ()
-で一般的なエラーを挙げる:
-.TP
-.B EBADF
-ファイル・ディスクリプター
-.I fd
-が有効でない。
-.TP
-.B EIO
+\fBfchmod\fP() で一般的なエラーを挙げる:
+.TP
+\fBEBADF\fP
+ファイル・ディスクリプター \fIfd\fP が有効でない。
+.TP
+\fBEIO\fP
上記を参照。
-.TP
-.B EPERM
+.TP
+\fBEPERM\fP
上記を参照。
-.TP
-.B EROFS
+.TP
+\fBEROFS\fP
上記を参照。
.SH 準拠
-4.4BSD, SVr4, POSIX.1-2001.
+4.4BSD, SVr4, POSIX.1\-2001.
.SH 関連項目
-.BR chown (2),
-.BR execve (2),
-.BR fchmodat (2),
-.BR open (2),
-.BR stat (2),
-.BR path_resolution (7)
+\fBchown\fP(2), \fBexecve\fP(2), \fBfchmodat\fP(2), \fBopen\fP(2), \fBstat\fP(2),
+\fBpath_resolution\fP(7)
OSDN Git Service
