Scroll to navigation

STATVFS(3) Linux Programmer's Manual STATVFS(3)

名前

statvfs, fstatvfs - ファイルシステムの統計を取得する

書式

#include <sys/statvfs.h>

int statvfs(const char *path, struct statvfs *buf);
int fstatvfs(int fd, struct statvfs *buf);

説明

関数 statvfs() はマウントされたファイルシステムについての情報を返す。 path はマウントされたファイルシステム中の任意のファイルのパス名である。 buf は、だいたい以下のように定義されている statvfs 構造体へのポインターである:


struct statvfs {


    unsigned long  f_bsize;    /* Filesystem block size */


    unsigned long  f_frsize;   /* Fragment size */


    fsblkcnt_t     f_blocks;   /* Size of fs in f_frsize units */


    fsblkcnt_t     f_bfree;    /* Number of free blocks */


    fsblkcnt_t     f_bavail;   /* Number of free blocks for


                                  unprivileged users */


    fsfilcnt_t     f_files;    /* Number of inodes */


    fsfilcnt_t     f_ffree;    /* Number of free inodes */


    fsfilcnt_t     f_favail;   /* Number of free inodes for


                                  unprivileged users */


    unsigned long  f_fsid;     /* Filesystem ID */


    unsigned long  f_flag;     /* Mount flags */


    unsigned long  f_namemax;  /* Maximum filename length */
};

ここで、型 fsblkcnt_t と fsfilcnt_t は <sys/types.h> で定義されている。 かつて、これらは共に unsigned long であった。

The field f_flag is a bit mask indicating various options that were employed when mounting this filesystem. It contains zero or more of the following flags:

Mandatory locking is permitted on the filesystem (see fcntl(2)).
Do not update access times; see mount(2).
Disallow access to device special files on this filesystem.
Do not update directory access times; see mount(2).
Execution of programs is disallowed on this filesystem.
The set-user-ID and set-group-ID bits are ignored by exec(3) for executable files on this filesystem
This filesystem is mounted read-only.
Update atime relative to mtime/ctime; see mount(2).
Writes are synched to the filesystem immediately (see the description of O_SYNC in open(2)).

返された構造体の全てのメンバが全てのファイルシステムで 意味のある値であるか否かは、指定されていない。

fstatvfs() は、ディスクリプター fd で参照されるオープンされたファイルについて、同じ情報を返す。

返り値

成功した場合、0 が返される。 失敗した場合、 -1 が返され、 errno に適切な値がセットされる。

エラー

(statvfs() の場合) path のディレクトリ部分に検索許可が与えられていない (path_resolution(7) も参照すること)。
(fstatvfs() の場合) fd が有効なオープンファイルディスクリプターではない。
buf または path が無効なアドレスを指している。
この呼び出しがシグナルで中断された。 signal(7) 参照。
ファイルシステムからの読み込みの間に I/O エラーが発生した。
(statvfs() の場合) path にシンボリックリンクが多すぎる。
(statvfs() の場合) path が長すぎる。
(statvfs() の場合) path で参照されるファイルが存在しない。
十分なカーネルメモリーがない。
ファイルシステムがこの呼び出しをサポートしていない。
(statvfs() の場合) path のディレクトリ部分がディレクトリでない。
いくつかの値が大き過ぎて、返り値の構造体で表現できない。

属性

この節で使用されている用語の説明については、 attributes(7) を参照。

インターフェース 属性 値
statvfs(), fstatvfs() Thread safety MT-Safe

準拠

POSIX.1-2001, POSIX.1-2008.

Only the ST_NOSUID and ST_RDONLY flags of the f_flag field are specified in POSIX.1. To obtain definitions of the remaining flags, one must define _GNU_SOURCE.

注意

Linux カーネルには、このライブラリコールをサポートするために、 statfs(2), fstatfs(2) システムコールがある。

In glibc versions before 2.13, statvfs() populated the bits of the f_flag field by scanning the mount options shown in /proc/mounts. However, starting with Linux 2.6.36, the underlying statfs(2) system call provides the necessary information via the f_flags field, and since glibc version 2.13, the statvfs() function will use information from that field rather than scanning /proc/mounts.

The glibc implementations of


pathconf(path, _PC_REC_XFER_ALIGN);
pathconf(path, _PC_ALLOC_SIZE_MIN);
pathconf(path, _PC_REC_MIN_XFER_SIZE);

respectively use the f_frsize, f_frsize, and f_bsize fields returned by a call to statvfs() with the argument path.

関連項目

statfs(2)

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

2017-09-15 Linux