GETFSSTAT
Section: System Calls (2)
索引
jman
BSD mandoc
索引
名称
getfsstat
- マウントされたすべてのファイルシステムのリストを得る
索引
ライブラリ
Lb libc
索引
書式
In sys/param.h
In sys/ucred.h
In sys/mount.h
Ft int
Fn getfsstat struct statfs *buf long bufsize int flags
索引
解説
Fn getfsstat
システムコールは、マウントされたすべてのファイルシステムに関する情報を
返します。
Fa buf
引数は
statfs(2)
に記述された
Vt statfs
構造体へのポインタです。
特定のファイルシステムについて未定義となるフィールドは -1 に設定されます。
バッファは
Fa fsstat
構造体の配列で埋められます。
マウントされた各ファイルシステムについて 1 つずつ、最高
Fa bufsize
で指定されたバイト数までです。
Fa bufsize
引数は、
Fa buf
が保持することができるバイト数であり、保持することができる statfs 構造体の
数ではないことに、注意して下さい。
Fa buf
として NULL が指定されている場合、
Fn getfsstat
はマウントされているファイルシステムの数のみを返します。
通常、
Fa flags
には
MNT_WAIT
を指定するべきです。
Fa flags
として
MNT_NOWAIT
が指定されている場合、
Fn getfsstat
は各ファイルシステムからの更新を要求せずに利用できる情報を返します。
そのため、情報のうちには古くなっているものがあるでしょうが、
Fn getfsstat
は応答できないファイルシステムからの情報を
待機してブロックすることはありません。
索引
戻り値
正常に完了すると
Fa fsstat
構造体の数が返されます。
そうでない場合は -1 が返され、エラーを示すためにグローバル変数
errno
が設定されます。
索引
エラー
Fn getfsstat
システムコールは以下の 1 つでも真の場合、処理に失敗します:
- Bq Er EFAULT
-
Fa buf
引数が無効なアドレスを指しています。
- Bq Er EIO
-
ファイルシステムを読み書きしている間に
I/O
(入出力) エラーが発生しました。
索引
関連項目
statfs(2),
fstab(5),
mount(8)
索引
歴史
Fn getfsstat
システムコールは
BSD 4.4
ではじめて登場しました。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- 戻り値
-
- エラー
-
- 関連項目
-
- 歴史
-
Time: 07:06:26 GMT, January 12, 2009