statfsdev(3C)

NAME

statfsdev, fstatfsdev − get file system statistics

SYNOPSIS

#include <sys/vfs.h>

int statfsdev(const char *path, struct statfs *buf);

int fstatfsdev(int fildes, struct statfs *buf);

DESCRIPTION

statfsdev() returns information about the file system on the file specified by path.

buf is a pointer to a statfs structure into which information is placed concerning the file system. The contents of the structure pointed to by buf include the following members:

long f_bavail    /* free blocks available to non-superuser */
long f_bfree     /* free blocks */
long f_blocks    /* total blocks in file system */
long f_bsize     /* fundamental file system block size in bytes */
long f_ffree     /* free file nodes in file system */
long f_files     /* total file nodes in file system */
long f_type      /* type of info, zero for now */
fsid_t f_fsid    /* file system ID. f_fsid[1] is MOUNT_UFS,
                                    MOUNT_NFS, or MOUNT_CDFS */

Fields that are undefined for a particular file system are set to −1 .

fstatfsdev() returns the same information as above, but about the open file referred to by file descriptor fildes.

RETURN VALUE

Upon successful completion, statfsdev() and fstatfsdev() return zero. Otherwise, they return −1 and set the global variable errno to indicate the error.

ERRORS

statfsdev() fails if one or more of the following conditions are encountered:

[EACCES] Search permission is denied for a component of the path prefix.

[EAGAIN] The file exists, enforcement mode file/record locking is set, and there are outstanding record locks on the file.

[EFAULT] path points to an invalid address.

[ELOOP] Too many symbolic links are encountered in translating the path name.

[EMFILE] The maximum number of file descriptors allowed are currently open.

[ENAMETOOLONG]
The length of the specified path name exceeds PATH_MAX bytes, or the length of a component of the path name exceeds NAME_MAX bytes while _POSIX_NO_TRUNC is in effect.

[ENFILE] The system file table is full.

[ENOENT] The named file does not exist.

[ENOTDIR] A component of the path prefix is not a directory.

[ENXIO] The device specified by the named special file does not exist.

fstatfsdev() fails if one or more of the following is true:

[EBADF] fildes is not a valid open file descriptor.

[ESPIPE] filedes points to an invalid address.

Both fstatfsdev() and statfsdev() fail if one or more of the following is true:

[EAGAIN] Enforcement-mode record locking was set, and there was a blocking write lock.

[EDEADLK] A resource deadlock would occur as a result of this operation.

[EINTR] A system call was interrupted by a signal.

[EINVAL] The file specified by path or filedes does not contain a file system of any known type.

[ENOLCK] The system lock table was full, so the read could not go to sleep until the blocking write lock was removed.

AUTHOR

statfsdev() and fstatfsdev() were developed by HP.

FILES

/usr/include/sys/mount.h

Museum

Related Articles