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

名称
ライブラリ
書式
解説
エラー
関連項目
歴史

jman



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