语法

#include / 或/

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

另外参见

stat(2)，statvfs(3)，path_resolution(7)

遵循规范

特定于Linux。 Linux statfs()受4.4BSD的启发(但它们没有使用相同的结构)。

返回值

成功时，返回零。如果出错，则返回-1，并正确设置errno。

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。

Linux程序员手册 第2部分
更新日期： 2020-06-09

名称

statfs，fstatfs-获取文件系统统计信息

错误说明

EACCES

(statfs())拒绝对path的路径前缀的组成部分进行搜索。 (另请参见path_resolution(7)。)

EBADF

(fstatfs())fd不是有效的打开文件描述符。

EFAULT

buf或path指向无效的地址。

EINTR

呼叫被信号打断；参见signal(7)。

EIO

从文件系统读取时发生I / O错误。

ELOOP

(statfs())在翻译路径中遇到太多符号链接。

ENAMETOOLONG

(statfs())路径太长。

ENOENT

(statfs())路径引用的文件不存在。

ENOMEM

内核内存不足。

ENOSYS

文件系统不支持此调用。

ENOTDIR

(statfs())path的路径前缀的组成部分不是目录。

EOVERFLOW

一些值太大而无法在返回的结构中表示。

BUGS

从Linux 2.6.38到Linux 3.1(包括Linux 3.1)，fstatfs()失败，并为pipe(2)创建的文件描述符显示错误ENOSYS。

备注

用于statfs结构定义中各个字段的__fsword_t类型是glibc内部类型，不适合公共使用。当试图将这些字段复制或比较到程序中的局部变量时，这使程序员陷入了一个难题。在大多数系统上，将unsigned int用于此类变量就足够了。

最初的Linux statfs()和fstatfs()系统调用在设计时并未考虑到非常大的文件大小。随后，Linux 2.6添加了采用新结构statfs64的新statfs64()和fstatfs64()系统调用。新结构包含与原始statfs结构相同的字段，但是增加了各种字段的大小，以适应较大的文件大小。 glibc statfs()和fstatfs()包装函数透明地处理内核差异。

某些系统仅具有，其他系统也具有，其中前者包括后者。因此，似乎包括前者是最佳选择。

LSB已弃用该库调用statfs()和fstatfs()，并告诉我们改用statvfs(2)和fstatvfs(2)。

The f_fsid field

Solaris，Irix和POSIX具有系统调用statvfs(2)，该函数返回包含无符号长f_fsid的struct statvfs(在中定义)。 Linux，SunOS，HP-UX，4.4BSD具有系统调用statfs()，该函数返回包含fsid_t f_fsid的struct statfs(在中定义)，其中fsid_t定义为struct {int val [2]; }。对于FreeBSD，除了使用include file之外，其他情况相同。

通常的想法是f_fsid包含一些随机的内容，以便该对(f_fsid，ino)唯一确定一个文件。某些操作系统使用设备号(或设备号)或与文件系统类型结合使用的设备号。几个操作系统限制仅将f_fsid字段分配给超级用户(对于非特权用户，则将其设置为零)，因为导出NFS时，此字段在文件系统的文件句柄中使用，并且将其分配给安全是一个安全问题。

在某些操作系统下，fsid可用作sysfs(2)系统调用的第二个参数。

说明

statfs()系统调用返回有关已挂载文件系统的信息。 path是已挂载文件系统中任何文件的路径名。 buf是指向statfs结构的指针，该结构大致如下定义：

struct statfs {
    __fsword_t f_type;    /* Type of filesystem (see below) */
    __fsword_t f_bsize;   /* Optimal transfer block size */
    fsblkcnt_t f_blocks;  /* Total data blocks in filesystem */
    fsblkcnt_t f_bfree;   /* Free blocks in filesystem */
    fsblkcnt_t f_bavail;  /* Free blocks available to
                             unprivileged user */
    fsfilcnt_t f_files;   /* Total inodes in filesystem */
    fsfilcnt_t f_ffree;   /* Free inodes in filesystem */
    fsid_t     f_fsid;    /* Filesystem ID */
    __fsword_t f_namelen; /* Maximum length of filenames */
    __fsword_t f_frsize;  /* Fragment size (since Linux 2.6) */
    __fsword_t f_flags;   /* Mount flags of filesystem
                             (since Linux 2.6.36) */
    __fsword_t f_spare[xxx];
                    /* Padding bytes reserved for future use */
};

以下文件系统类型可能出现在f_type中：

ADFS_SUPER_MAGIC      0xadf5
AFFS_SUPER_MAGIC      0xadff
AFS_SUPER_MAGIC       0x5346414f
ANON_INODE_FS_MAGIC   0x09041934 /* Anonymous inode FS (for
                                    pseudofiles that have no name;
                                    e.g., epoll, signalfd, bpf) */
AUTOFS_SUPER_MAGIC    0x0187
BDEVFS_MAGIC          0x62646576
BEFS_SUPER_MAGIC      0x42465331
BFS_MAGIC             0x1badface
BINFMTFS_MAGIC        0x42494e4d
BPF_FS_MAGIC          0xcafe4a11
BTRFS_SUPER_MAGIC     0x9123683e
BTRFS_TEST_MAGIC      0x73727279
CGROUP_SUPER_MAGIC    0x27e0eb   /* Cgroup pseudo FS */
CGROUP2_SUPER_MAGIC   0x63677270 /* Cgroup v2 pseudo FS */
CIFS_MAGIC_NUMBER     0xff534d42
CODA_SUPER_MAGIC      0x73757245
COH_SUPER_MAGIC       0x012ff7b7
CRAMFS_MAGIC          0x28cd3d45
DEBUGFS_MAGIC         0x64626720
DEVFS_SUPER_MAGIC     0x1373     /* Linux 2.6.17 and earlier */
DEVPTS_SUPER_MAGIC    0x1cd1
ECRYPTFS_SUPER_MAGIC  0xf15f
EFIVARFS_MAGIC        0xde5e81e4
EFS_SUPER_MAGIC       0x00414a53
EXT_SUPER_MAGIC       0x137d     /* Linux 2.0 and earlier */
EXT2_OLD_SUPER_MAGIC  0xef51
EXT2_SUPER_MAGIC      0xef53
EXT3_SUPER_MAGIC      0xef53
EXT4_SUPER_MAGIC      0xef53
F2FS_SUPER_MAGIC      0xf2f52010
FUSE_SUPER_MAGIC      0x65735546
FUTEXFS_SUPER_MAGIC   0xbad1dea  /* Unused */
HFS_SUPER_MAGIC       0x4244
HOSTFS_SUPER_MAGIC    0x00c0ffee
HPFS_SUPER_MAGIC      0xf995e849
HUGETLBFS_MAGIC       0x958458f6
ISOFS_SUPER_MAGIC     0x9660
JFFS2_SUPER_MAGIC     0x72b6
JFS_SUPER_MAGIC       0x3153464a
MINIX_SUPER_MAGIC     0x137f     /* oroirnal minix FS */
MINIX_SUPER_MAGIC2    0x138f     /* 30 char minix FS */
MINIX2_SUPER_MAGIC    0x2468     /* minix V2 FS */
MINIX2_SUPER_MAGIC2   0x2478     /* minix V2 FS, 30 char names */
MINIX3_SUPER_MAGIC    0x4d5a     /* minix V3 FS, 60 char names */
MQUEUE_MAGIC          0x19800202 /* POSIX message queue FS */
MSDOS_SUPER_MAGIC     0x4d44
MTD_INODE_FS_MAGIC    0x11307854
NCP_SUPER_MAGIC       0x564c
NFS_SUPER_MAGIC       0x6969
NILFS_SUPER_MAGIC     0x3434
NSFS_MAGIC            0x6e736673
NTFS_SB_MAGIC         0x5346544e
OCFS2_SUPER_MAGIC     0x7461636f
OPENPROM_SUPER_MAGIC  0x9fa1
OVERLAYFS_SUPER_MAGIC 0x794c7630
PIPEFS_MAGIC          0x50495045
PROC_SUPER_MAGIC      0x9fa0     /* /proc FS */
PSTOREFS_MAGIC        0x6165676c
QNX4_SUPER_MAGIC      0x002f
QNX6_SUPER_MAGIC      0x68191122
RAMFS_MAGIC           0x858458f6
REISERFS_SUPER_MAGIC  0x52654973
ROMFS_MAGIC           0x7275
SECURITYFS_MAGIC      0x73636673
SELINUX_MAGIC         0xf97cff8c
SMACK_MAGIC           0x43415d53
SMB_SUPER_MAGIC       0x517b
SMB2_MAGIC_NUMBER     0xfe534d42
SOCKFS_MAGIC          0x534f434b
SQUASHFS_MAGIC        0x73717368
SYSFS_MAGIC           0x62656572
SYSV2_SUPER_MAGIC     0x012ff7b6
SYSV4_SUPER_MAGIC     0x012ff7b5
TMPFS_MAGIC           0x01021994
TRACEFS_MAGIC         0x74726163
UDF_SUPER_MAGIC       0x15013346
UFS_MAGIC             0x00011954
USBDEVICE_SUPER_MAGIC 0x9fa2
V9FS_MAGIC            0x01021997
VXFS_SUPER_MAGIC      0xa501fcf5
XENFS_SUPER_MAGIC     0xabba1974
XENIX_SUPER_MAGIC     0x012ff7b4
XFS_SUPER_MAGIC       0x58465342
_XIAFS_SUPER_MAGIC    0x012fd16d /* Linux 2.0 and earlier */

这些MAGIC常量中的大多数都在/usr/include/linux/magic.h中定义，有些在内核源代码中进行了硬编码。

f_flags字段是一个位掩码，指示文件系统的安装选项。它包含零个或多个以下位：

ST_MANDLOCK

在文件系统上允许强制锁定(请参阅fcntl(2))。

ST_NOATIME

不更新访问时间；参见mount(2)。

ST_NODEV

禁止访问此文件系统上的设备专用文件。

ST_NODIRATIME

不更新目录访问时间；参见mount(2)。

ST_NOEXEC

在此文件系统上不允许执行程序。

ST_NOSUID

exec(3)将忽略此文件系统上的可执行文件的set-user-ID和set-group-ID位

ST_RDONLY

该文件系统是只读安装的。

ST_RELATIME

相对于mtime / ctime更新atime；参见mount(2)。

ST_SYNCHRONOUS

写入立即同步到文件系统(请参阅open(2)中的O_SYNC描述)。

没有人知道f_fsid应该包含什么(但请参见下文)。

对于特定文件系统，未定义的字段设置为0。

fstatfs()返回有关描述符fd引用的打开文件的相同信息。