USTAT(2)

名前
ustat - ファイル・システム(file system)の統計を得る

書式
#include <sys/types.h>

int ustat(dev_t dev, struct ustat * ubuf);

説明
ustat はマウント(mount)されたファイル・システムの情報を返す。 dev は調べるファイル・システムを含んでいるデバイス(device)の デバイス番号。 ubuf は以下のメンバーを含む ustat 構造体へのポインター:

    daddr_t	f_tfree;	/* Total free blocks */
    ino_t   f_tinode;       /* Number of free inodes */
    char	f_fname[6];	/* Filsys name */
    char	f_fpack[6];	/* Filsys pack name */

後の二つのフィールド、f_fname と f_fpack は実装(implemented) されておらず、常にヌル文字(null character)で埋められる。

返り値
成功した場合にはゼロが返され、 ubuf で示される ustat 構造体が埋められる。 エラーの場合は -1 が返され、 errno が適切に設定される。

エラー

EINVAL
    dev がマウントされたファイル・システムを含むデバイスを参照していない。

EFAULT
    ubuf がアクセス可能な空間の外側を指している。

ENOSYS
    dev で参照されるマウントされたファイル・システムがこの操作(operation)を サポートしていないか、Linux のバージョンが 1.3.16 以前である。

注意
ustat は互換性のためだけに提供される。新しいプログラムは全てこれの代りに statfs(2) を使用するべきである。

準拠
SVr4. SVr4 には他に ENOLINK, ECOMM, EINTR についての記述があるが、 ENOSYS エラーについての記述はない。

準拠
System V

関連項目
statfs(2), stat(2)