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

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

jman



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