STATFS(2)

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

書式
#include <sys/vfs.h>

int statfs(const char *path, struct statfs *buf);
int fstatfs(int fd, struct statfs *buf);

書式
statfs はマウント(mount)されたファイル・システムにつての情報を返す。 path はマウントされたファイル・システムにあるファイルのパス名。 buf は以下のように定義される statfs 構造体へのポインター:
    struct statfs {
       long    f_type;     /* type of filesystem (see below) */
       long    f_bsize;    /* optimal transfer block size */
       long    f_blocks;   /* total data blocks in file system */
       long    f_bfree;    /* free blocks in fs */
       long    f_bavail;   /* free blocks avail to non-superuser */
       long    f_files;    /* total file nodes in file system */
       long    f_ffree;    /* free file nodes in fs */
       fsid_t  f_fsid;     /* file system id */
       long    f_namelen;  /* maximum length of filenames */
       long    f_spare[6]; /* spare for later */
    };
    ファイル・システムの型:
    linux/affs_fs.h:
       AFFS_SUPER_MAGIC      0xADFF
    linux/ext_fs.h:
       EXT_SUPER_MAGIC       0x137D
    linux/ext2_fs.h:
       EXT2_OLD_SUPER_MAGIC  0xEF51
       EXT2_SUPER_MAGIC      0xEF53
    linux/hpfs_fs.h:
       HPFS_SUPER_MAGIC      0xF995E849
    linux/iso_fs.h:
       ISOFS_SUPER_MAGIC     0x9660
    linux/minix_fs.h:
       MINIX_SUPER_MAGIC     0x137F /* orig. minix */
       MINIX_SUPER_MAGIC2    0x138F /* 30 char minix */
       MINIX2_SUPER_MAGIC    0x2468 /* minix V2 */
       MINIX2_SUPER_MAGIC2   0x2478 /* minix V2, 30 char names */
    linux/msdos_fs.h:
       MSDOS_SUPER_MAGIC     0x4d44
    linux/ncp_fs.h:
       NCP_SUPER_MAGIC       0x564c
    linux/nfs_fs.h:
       NFS_SUPER_MAGIC       0x6969
    linux/proc_fs.h:
       PROC_SUPER_MAGIC      0x9fa0
    linux/smb_fs.h:
       SMB_SUPER_MAGIC       0x517B
    linux/sysv_fs.h:
       XENIX_SUPER_MAGIC     0x012FF7B4
       SYSV4_SUPER_MAGIC     0x012FF7B5
       SYSV2_SUPER_MAGIC     0x012FF7B6
       COH_SUPER_MAGIC       0x012FF7B7
    linux/ufs_fs.h:
       UFS_MAGIC             0x00011954
    linux/xia_fs.h:
       _XIAFS_SUPER_MAGIC    0x012FD16D

それぞれのファイル・システムにおいて未定義のフィールドは -1 が 設定される。 fstatfs はディスクリプター(descriptor) fd によって参照されるオープン(open)されたファイルについて、同じ情報を返す。

返り値
成功すればゼロが返される。エラーの場合は -1 が返され、 errno が適切に設定される。

エラー
statfs においては :

ENOTDIR
    path のディレクトリ部分がディレクトリでない。

ENAMETOOLONG
    path が長過ぎる。

ENOENT
    path によって参照されるファイルが存在していない。

EACCES
    path のディレクトリ部分に検索許可が与えられていない。

ELOOP
    path のシンボリック・リンク(symbolic link)が多すぎる。

EFAULT
    buf または path が不正なアドレスを指している。

EIO ファイル・システムの読み込み、書き込みの間に I/O エラーが発生した。 +.TP ENOMEM カーネルに十分なメモリがない。

ENOSYS
    path のあるファイルシステムが statfs をサポートしていない。

fstatfsについては:

EBADF
    fd は正しいオープンされたファイル・ディスクリプターではない。

EFAULT
    buf が不正なアドレスを指している。

EIO ファイル・システムの読み込み、書き込みの間に I/O エラーが発生した。

ENOSYS
    fd のあるファイル・システムが statfs をサポートしていない。

準拠
4.4BSD

関連項目
stat(2)