statfsdev.3c (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

statfsdev(3C) statfsdev(3C)

NAME

statfsdev(), fstatfsdev() - get ﬁle 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 ﬁle system contained in the ﬁle speciﬁed by path .

buf is a pointer to a

statfs structure into which information is placed concerning the ﬁle system. The

contents of the structure pointed to by buf include the following members:

int32_t f_bavail /* free blocks available to non-superuser */

int32_t f_bfree /* free blocks */

int32_t f_blocks /* total blocks in file system */

int32_t f_bsize /* fundamental file system block size in bytes */

int32_t f_ffree /* free file nodes in file system */

int32_t f_files /* total file nodes in file system */

int32_t 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 */

The ﬁelds f_blocks, f_bavail, and f_bfree are expressed in terms of blocks of size

f_bsize.

Fields that are undeﬁned for a particular ﬁle system are set to − 1.

fstatfsdev() returns the same information as above, but about the open ﬁle referred to by ﬁle

descriptor ﬁldes .

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 preﬁx.

[EAGAIN] The ﬁle exists, enforcement mode ﬁle/record locking is set, and there are outstand-

ing record locks on the ﬁle.

[EFAULT] path points to an invalid address.

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

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

[ENAMETOOLONG]

The length of the speciﬁed 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 ﬁle table is full.

[ENOENT] The named ﬁle does not exist.

[ENOTDIR] A component of the path preﬁx is not a directory.

[ENXIO] The device speciﬁed by the named special ﬁle does not exist.

[EOVERFLOW]

Result would overﬂow one or more ﬁelds of the

statfs struct.

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

[EBADF] ﬁldes is not a valid open ﬁle descriptor.

[ESPIPE] ﬁledes points to an invalid address.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)

PAGE 1
statfsdev(3C) statfsdev(3C) NAME statfsdev(), fstatfsdev() - get file system statistics SYNOPSIS #include int statfsdev(const char *path, struct statfs *buf); int fstatfsdev(int fildes, struct statfs *buf); DESCRIPTION statfsdev() returns information about the file system contained in the file specified by path . buf is a pointer to a statfs structure into which information is placed concerning the file system.
PAGE 2
statfsdev(3C) statfsdev(3C) 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.