1 .\" Copyright (C) 2003 Andries Brouwer (aeb@cwi.nl)
3 .\" Permission is granted to make and distribute verbatim copies of this
4 .\" manual provided the copyright notice and this permission notice are
5 .\" preserved on all copies.
7 .\" Permission is granted to copy and distribute modified versions of this
8 .\" manual under the conditions for verbatim copying, provided that the
9 .\" entire resulting derived work is distributed under the terms of a
10 .\" permission notice identical to this one.
12 .\" Since the Linux kernel and libraries are constantly changing, this
13 .\" manual page may be incorrect or out-of-date. The author(s) assume no
14 .\" responsibility for errors or omissions, or for damages resulting from
15 .\" the use of the information contained herein. The author(s) may not
16 .\" have taken the same level of care in the production of this manual,
17 .\" which is licensed free of charge, as they might when working
20 .\" Formatted or processed versions of this manual, if unaccompanied by
21 .\" the source, must acknowledge the copyright and authors of this work.
23 .\" The pathconf note is from Walter Harms
24 .\" This is not a system call on Linux
26 .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
28 .TH STATVFS 3 2003-08-22 "Linux" "Linux Programmer's Manual"
30 statvfs, fstatvfs \- get file system statistics
32 .B #include <sys/statvfs.h>
34 .BI "int statvfs(const char *" path ", struct statvfs *" buf );
36 .BI "int fstatvfs(int " fd ", struct statvfs *" buf );
40 returns information about a mounted file system.
42 is the pathname of any file within the mounted file system.
46 structure defined approximately as follows:
51 unsigned long f_bsize; /* file system block size */
52 unsigned long f_frsize; /* fragment size */
53 fsblkcnt_t f_blocks; /* size of fs in f_frsize units */
54 fsblkcnt_t f_bfree; /* # free blocks */
55 fsblkcnt_t f_bavail; /* # free blocks for unprivileged users */
56 fsfilcnt_t f_files; /* # inodes */
57 fsfilcnt_t f_ffree; /* # free inodes */
58 fsfilcnt_t f_favail; /* # free inodes for unprivileged users */
59 unsigned long f_fsid; /* file system ID */
60 unsigned long f_flag; /* mount flags */
61 unsigned long f_namemax; /* maximum filename length */
77 is a bit mask (of mount flags, see
79 Bits defined by POSIX are
82 Read-only file system.
85 Set-user-ID/set-group-ID bits are ignored by
88 It is unspecified whether all members of the returned struct
89 have meaningful values on all file systems.
92 returns the same information about an open file referenced by descriptor
95 On success, zero is returned.
96 On error, \-1 is returned, and
103 Search permission is denied for a component of the path prefix of
106 .BR path_resolution (7).)
111 is not a valid open file descriptor.
117 points to an invalid address.
120 This call was interrupted by a signal.
123 An I/O error occurred while reading from the file system.
127 Too many symbolic links were encountered in translating
137 The file referred to by
142 Insufficient kernel memory was available.
145 The file system does not support this call.
149 A component of the path prefix of
154 Some values were too large to be represented in the returned struct.
158 The Linux kernel has system calls
162 to support this library call.
164 The current glibc implementations of
167 pathconf(path, _PC_REC_XFER_ALIGN);
168 pathconf(path, _PC_ALLOC_SIZE_MIN);
169 pathconf(path, _PC_REC_MIN_XFER_SIZE);
177 fields of the return value of
178 .IR "statvfs(path,buf)" .