statvfs.2 (2010 09)

s
statvfs(2) statvfs(2)
NAME
statvfs, fstatvfs - get file system information
SYNOPSIS
#include <sys/types.h>
#include <sys/statvfs.h>
int statvfs (const char *path, struct statvfs *buf);
int fstatvfs (int fildes, struct statvfs *buf);
DESCRIPTION
statvfs() returns information about a mounted file system.
fstatvfs() returns similar information about an open file.
The parameters for the
statvfs() and fstatvfs() functions are as follows:
path is a pointer to a path name of any file within the mounted file system.
buf is a pointer to a
statvfs
structure, which is where the file system status information is
stored.
fildes is a file descriptor for an open file, which is created with the successful completion of an
open(), creat(), dup(), fcntl(),orpipe() system call (see open(2), creat (2),
dup(2), fcntl (2), or pipe (2)).
The
statvfs structure contains the following members:
fsblkcnt_t f_blocks; /* total blocks of f_frsize on file system */
fsblkcnt_t f_bfree; /* free blocks */
fsblkcnt_t f_bavail; /* blocks available to non-superusers or
users without the LIMIT privilege */
fsfilcnt_t f_files; /* total file nodes in file system */
fsfilcnt_t f_ffree; /* free file nodes in file system */
fsfilcnt_t f_favail; /* file nodes available to non-superusers
or users without the LIMIT privilege */
ulong f_bsize; /* preferred file system block size */
ulong f_frsize; /* fundamental file system block size */
ulong f_size; /* see note below */
ulong f_fsid; /* file system ID for file system */
/* type; see sysfs(2) */
char f_basetype[FSTYPSZ]; /* file system type name is */
/* null-terminated */
ulong f_flag; /* bit mask of flags */
ulong f_namemax /* maximum file name length */
char f_fstr[32]; /* file system specific string */
time_t f_time; /* Last time file system was written */
The field f_size contains the size of file system in
f_frsize units. Note that this field is not part of the
standard POSIX definition of statvfs. When a 32-bit application uses statvfs64() with a large file
system, f_size will top out at MAXINT, rather than return an [EOVERFLOW] error. Use f_blocks instead.
The field f_basetype contains a null-terminated file-system-type name.
The constant
[FSTYPSZ] is defined in the header file <statvfs.h>.
The following flags can be returned in the f_flag field:
ST_LARGEFILES File system is enabled for large files.
ST_RDONLY File system is read-only.
ST_NOSUID File system does not support setuid and setgid semantics.
ST_EXPORTED File system is exported (NFS).
ST_QUOTA
ST_USRQUOTA User quotas enabled on this file system.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1