SETMODE
Section: C Library Functions (3)
索引
jman
BSD mandoc
索引
名称
getmode
setmode
- モードビットを更新する
索引
ライブラリ
Lb libc
索引
書式
In unistd.h
Ft mode_t
Fn getmode const void *set mode_t mode
Ft void *
Fn setmode const char *mode_str
索引
解説
Fn getmode
関数は、
Fa set
が指す値によって変更された様にファイルパーミッションビット
Fa mode
のコピーを返します。モードビットだけが変更されるのに対し、
ファイルモードの他の部分を調査できます。
Fn setmode
関数は、
chmod(1)
で述べた様に絶対値
(8
進数
)
またはシンボリック値を引数として取り、
Fn getmode
に与えられるモード値を指すポインタを返します。
ファイル作成マスクには相対的なシンボリック値もあるので、
Fn setmode
は
umask(2)
を呼び出すことがあります。これが生じた場合、ファイル作成マスクは
Fn setmode
が復帰する前に復元されます。
呼び出しプログラムがファイル作成マスクの値を
Fn setmode
を呼び出した後で変更する場合、将来のファイルモードを正しく更新するために
Fn getmode
を呼ぶなら、
Fn setmode
をもう一度呼び出す必要があります。
Fn setmode
に渡されたモードが無効な場合、または戻り値に関する
メモリを割り当てできない場合、
Fn setmode
は
NULL
を返します。
Fn setmode
から返された値は
Fn malloc
から得られ、プログラムがその値に対する処理を終えた時、
通常は
Fn getmode
の呼び出しの後に、
Fn free
でシステムに返す必要があります。
索引
エラー
Fn setmode
関数は、処理に失敗して
errno
をライブラリルーチン
malloc(3)
で指定されたエラーのどれかに設定することがあります。
索引
関連項目
chmod(1),
stat(2),
umask(2),
malloc(3)
索引
歴史
Fn getmode
関数と
Fn setmode
関数は
BSD 4.4
で最初に登場しました。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- エラー
-
- 関連項目
-
- 歴史
-
Time: 07:07:07 GMT, January 12, 2009