Table of Contents

NAME

SYNOPSIS

DESCRIPTION

returns information about a mounted file system. is the path name of any file within the mounted file system. is a pointer to a structure defined as follows: typedef struct { int32_t val[2]; } fsid_t;

#define MFSNAMELEN 16 /* length of fs type name, including nul */ #define MNAMELEN 32    /* length of buffer for returned name */

struct statfs { short f_type;    /* type of file system (unused; zero) */
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 */
uid_t f_owner;    /* user that mounted the file system */
long f_spare[4];    /* spare for later */
char f_fstypename[MFSNAMELEN]; /* fs type name */
char f_mntonname[MNAMELEN]; /* directory on which mounted */
char f_mntfromname[MNAMELEN]; /* mounted file system */
}; Fields that are undefined for a particular file system are set to -1. returns the same information about an open file referenced by descriptor

RETURN VALUES

Upon successful completion, a value of 0 is returned. Otherwise, -1 is returned and the global variable is set to indicate the error.

ERRORS

fails if one or more of the following are true: A component of the path prefix of is not a directory. The length of a component of exceeds characters, or the length of exceeds characters. The file referred to by does not exist. Search permission is denied for a component of the path prefix of Too many symbolic links were encountered in translating or points to an invalid address. An error occurred while reading from or writing to the file system. fails if one or more of the following are true: is not a valid open file descriptor. points to an invalid address. An error occurred while reading from or writing to the file system.

HISTORY

The function first appeared in 4.4BSD.

Table of Contents