NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | HISTORY | ATTRIBUTES
#include <sys/param.h> #include <sys/mount.h>int statfs(const char * path, struct statfs * buf);
MSDOSFS, NFS_CLIENT, UFS
The statfs function call returns information about a mounted file system. The path name of any file in the mounted filesystem is defined by path . The buf pointer indicates a statfs structure defined as follows:
typedef quad fsid_t; #define MNAMELEN 90 /* length of buffer for returned name */ struct statfs { short f_type; /* type of filesystem (see below) */ short f_flags; /* copy of mount flags */ long f_bsize; /* fundamental file system block size */ long f_iosize; /* optimal transfer block size */ long f_blocks; /* total data blocks in file system */ long f_bfree; /* free blocks in fs */ long f_bavail; /* free blocks avail to non-superuser */ long f_files; /* total file nodes in file system */ long f_ffree; /* free file nodes in fs */ fsid_t f_fsid; /* file system id */ long f_spare[9]; /* spare for later */ char f_mntonname[MNAMELEN]; /* mount point */ char f_mntfromname[MNAMELEN]; /* mounted filesystem */ }; /* * File system types. */ #define MOUNT_UFS 1 /* Fast Filesystem */ #define MOUNT_NFS 2 /* Sun-compatible Network Filesystem */ #define MOUNT_MFS 3 /* Memory-based Filesystem */ #define MOUNT_MSDOS 4 /* MS/DOS Filesystem */ #define MOUNT_LFS 5 /* Log-based Filesystem */ #define MOUNT_LOFS 6 /* Loopback Filesystem */ #define MOUNT_FDESC 7 /* File Descriptor Filesystem */ #define MOUNT_PORTAL 8 /* Portal Filesystem */ #define MOUNT_NULL 9 /* Minimal Filesystem Layer */ #define MOUNT_UMAP 10 /* Uid/Gid Remapping Filesystem */ #define MOUNT_KERNFS 11 /* Kernel Information Filesystem */ #define MOUNT_PROCFS 12 /* /proc Filesystem */ #define MOUNT_AFS 13 /* Andrew Filesystem */ #define MOUNT_CD9660 14 /* ISO9660 (aka CDROM) Filesystem */ #define MOUNT_UNION 15 /* Union (translucent) Filesystem */ |
Fields that are undefined for a particular file system are set to undefined values. The fstatfs system call returns the same information about an open file referenced by the fd descriptor.
Upon successful completion, a value of 0 is returned. Otherwise, -1 is returned and the global variable errno is set to indicate the error condition.
The error messages for statfs are the following:
A component of the path prefix of path is not a directory.
path contains a character with the high-order bit set.
The length of a component of path exceeds 255 characters, or the length of path exceeds 1023 characters.
The file referred to by path does not exist.
Search permission is denied for a component of the path prefix of path .
Too many symbolic links were encountered in translating path .
In user mode, buf or path points to an invalid address. In supervisor mode, this is not detected and the state of the target is unknown.
An I/O error occurred while reading from or writing to the file system.
The error messages for fstatfs are the following:
fd is not a valid open file descriptor.
buf points to an invalid address.
An I/O error occurred while reading from or writing to the file system.
The statfs function first appeared in 4.4BSD.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | HISTORY | ATTRIBUTES