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

名称

ustat-获取文件系统统计信息

语法

#include <sys/types.h>
#include <unistd.h>    /* libc[45] */
#include <ustat.h>     /* glibc2 */

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

说明

ustat()返回有关已挂载文件系统的信息。 dev是用于标识包含已挂载文件系统的设备的设备号。 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未实现，将始终用空字节(aq \ 0aq)填充。

返回值

成功时，将返回零，并且将填充ubuf指向的ustat结构。错误时，将返回-1，并且已正确设置errno。

错误说明

EFAULT

ubuf点位于您可访问的地址空间之外。

EINVAL

dev不引用包含已挂载文件系统的设备。

ENOSYS

dev引用的已挂载文件系统不支持此操作，也不支持1.3.16之前的任何版本的Linux。

版本

从2.28版开始，glibc不再为此系统调用提供包装器。

遵循规范

SVr4。

备注

不推荐使用ustat()，仅为了兼容性而提供。所有新程序都应改用statfs(2)。

HP-UX notes

ustat结构的HP-UX版本具有一个附加字段f_blksize，该字段在其他位置未知。 HP-UX警告：对于某些文件系统，可用索引节点的数量不会改变。这样的文件系统将在字段f_tinode中返回-1。对于某些文件系统，索引节点是动态分配的。这样的文件系统将返回当前的空闲索引节点数。

另外参见

stat(2)，statfs(2)

出版信息

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