Differences between version 2 and previous revision of fstatfs(2).
Other diffs: Previous Major Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 2 | Last edited on Thursday, November 7, 2002 12:00:22 am | by PerryLorier | Revert |
| Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:40 am | by perry | Revert |
@@ -1,200 +1,93 @@
-STATFS
-!!!STATFS
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-CONFORMING TO
-SEE ALSO
-----
!!NAME
-
-
statfs, fstatfs - get file system statistics
!!SYNOPSIS
+ __#include <sys/vfs.h>__
-__#include
__
+
__int statfs(const char *__''path''__, struct statfs *__''buf''__);__
+ __int fstatfs(int__ ''fd''__, struct statfs *__''buf''__);
__
-
-__int statfs(const char *__''path''__, struct statfs
-*__''buf''__);
-int fstatfs(int__ ''fd''__, struct statfs
-*__''buf''__);__
!!DESCRIPTION
+statfs(2) returns information about a mounted file system. ''path'' is the path name of any file within the mounted filesystem. ''buf'' is a pointer to a ''statfs'' structure defined as follows:
+ struct statfs {
+ long f_type; /* type of filesystem (see below) */
+ long f_bsize; /* 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_namelen; /* maximum length of filenames */
+ long f_spare[[6]; /* spare for later */
+ };
-
-__statfs__ returns information about a mounted file
-system. ''path'' is the path name of any file within the
-mounted filesystem. ''buf'' is a pointer to a
-''statfs'' structure defined as follows:
-
-
-struct statfs {
-long f_type; /* type of filesystem (see below) */
-long f_bsize; /* 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_namelen; /* maximum length of filenames */
-long f_spare[[6]; /* spare for later */
-};
File system types:
linux/affs_fs.h:
-AFFS_SUPER_MAGIC 0xADFF
+
AFFS_SUPER_MAGIC 0xADFF
linux/efs_fs.h:
-EFS_SUPER_MAGIC 0x00414A53
+
EFS_SUPER_MAGIC 0x00414A53
linux/ext_fs.h:
-EXT_SUPER_MAGIC 0x137D
+
EXT_SUPER_MAGIC 0x137D
linux/ext2_fs.h:
-EXT2_OLD_SUPER_MAGIC 0xEF51
-EXT2_SUPER_MAGIC 0xEF53
+
EXT2_OLD_SUPER_MAGIC 0xEF51
+ EXT2_SUPER_MAGIC 0xEF53
linux/hpfs_fs.h:
-HPFS_SUPER_MAGIC 0xF995E849
+
HPFS_SUPER_MAGIC 0xF995E849
linux/iso_fs.h:
-ISOFS_SUPER_MAGIC 0x9660
+
ISOFS_SUPER_MAGIC 0x9660
linux/minix_fs.h:
-MINIX_SUPER_MAGIC 0x137F /* orig. minix */
-MINIX_SUPER_MAGIC2 0x138F /* 30 char minix */
-MINIX2_SUPER_MAGIC 0x2468 /* minix V2 */
-MINIX2_SUPER_MAGIC2 0x2478 /* minix V2, 30 char names */
+
MINIX_SUPER_MAGIC 0x137F /* orig. minix */
+ MINIX_SUPER_MAGIC2 0x138F /* 30 char minix */
+ MINIX2_SUPER_MAGIC 0x2468 /* minix V2 */
+ MINIX2_SUPER_MAGIC2 0x2478 /* minix V2, 30 char names */
linux/msdos_fs.h:
-MSDOS_SUPER_MAGIC 0x4d44
+
MSDOS_SUPER_MAGIC 0x4d44
linux/ncp_fs.h:
-NCP_SUPER_MAGIC 0x564c
+
NCP_SUPER_MAGIC 0x564c
linux/nfs_fs.h:
-NFS_SUPER_MAGIC 0x6969
+
NFS_SUPER_MAGIC 0x6969
linux/proc_fs.h:
-PROC_SUPER_MAGIC 0x9fa0
+
PROC_SUPER_MAGIC 0x9fa0
linux/smb_fs.h:
-SMB_SUPER_MAGIC 0x517B
+
SMB_SUPER_MAGIC 0x517B
linux/sysv_fs.h:
-XENIX_SUPER_MAGIC 0x012FF7B4
-SYSV4_SUPER_MAGIC 0x012FF7B5
-SYSV2_SUPER_MAGIC 0x012FF7B6
-COH_SUPER_MAGIC 0x012FF7B7
+
XENIX_SUPER_MAGIC 0x012FF7B4
+ SYSV4_SUPER_MAGIC 0x012FF7B5
+ SYSV2_SUPER_MAGIC 0x012FF7B6
+ COH_SUPER_MAGIC 0x012FF7B7
linux/ufs_fs.h:
-UFS_MAGIC 0x00011954
+
UFS_MAGIC 0x00011954
linux/xfs_fs.h:
-XFS_SUPER_MAGIC 0x58465342
+
XFS_SUPER_MAGIC 0x58465342
linux/xia_fs.h:
-_XIAFS_SUPER_MAGIC 0x012FD16D
+
_XIAFS_SUPER_MAGIC 0x012FD16D
+Fields that are undefined for a particular file system are set to 0. fstatfs(2) returns the same information about an open file referenced by descriptor ''fd''.
-Fields that are undefined for a particular file system are
-set to 0. __fstatfs__ returns the same information about
-an open file referenced by descriptor
-''fd''.
!!RETURN VALUE
+On success, zero is returned. On error, -1 is returned, and ''errno'' is set appropriately.
-
-On success, zero is returned. On error, -1 is returned, and
-''errno'' is set appropriately.
!!ERRORS
+For statfs(2):
+;[ENOTDIR]: A component of the path prefix of ''path'' is not a directory.
+;[ENAMETOOLONG]: ''path'' is too long.
+;[ENOENT]: The file referred to by ''path'' does not exist.
+;[EACCES]: Search permission is denied for a component of the path prefix of ''path''.
+;[ELOOP]: Too many symbolic links were encountered in translating ''path''.
+;[EFAULT]: ''Buf'' or ''path'' points to an invalid address.
+;[EIO]: An I/O error occurred while reading from or writing to the file system.
+;[ENOMEM]: Insufficient kernel memory was available.
+;[ENOSYS]: The filesystem ''path'' is on does not support statfs(2).
+For fstatfs(2):
+ ;[EBADF]: ''fd'' is not a valid open file descriptor.
+ ;[EFAULT]: ''buf'' points to an invalid address.
+ ;[EIO]: An I/O error occurred while reading from or writing to the file system.
+ ;[ENOSYS]: The filesystem ''fd'' is open on does not support statfs(2).
-For __statfs__:
-
-
-__ENOTDIR__
-
-
-A component of the path prefix of ''path'' is not a
-directory.
-
-
-__ENAMETOOLONG__
-
-
-''path'' is too long.
-
-
-__ENOENT__
-
-
-The file referred to by ''path'' does not
-exist.
-
-
-__EACCES__
-
-
-Search permission is denied for a component of the path
-prefix of ''path''.
-
-
-__ELOOP__
-
-
-Too many symbolic links were encountered in translating
-''path''.
-
-
-__EFAULT__
-
-
-''Buf'' or ''path'' points to an invalid
-address.
-
-
-__EIO__
-
-
-An I/O error occurred while reading from or writing to the
-file system.
-
-
-__ENOMEM__
-
-
-Insufficient kernel memory was available.
-
-
-__ENOSYS__
-
-
-The filesystem ''path'' is on does not support
-__statfs__.
-
-
-For __fstatfs__:
-
-
-__EBADF__
-
-
-''fd'' is not a valid open file descriptor.
-
-
-__EFAULT__
-
-
-''buf'' points to an invalid address.
-
-
-__EIO__
-
-
-An I/O error occurred while reading from or writing to the
-file system.
-
-
-__ENOSYS__
-
-
-The filesystem ''fd'' is open on does not support
-__statfs__.
!!CONFORMING TO
+The Linux statfs(2) was inspired by the 4.4BSD one (but they do not use the same structure).
-
-The Linux __statfs__ was inspired by the 4.4BSD one (but
-they do not use the same structure).
!!SEE ALSO
-
-
-
-----
+stat(2), fstat(2), statfs(2)
