icon Top 9 categories map      RocketAware > man pages >


Tips: Browse or Search all pages for efficient awareness of more than 6000 of the most popular reusable and open source applications, functions, libraries, and FAQs.

The "RKT couplings" below include links to source code, updates, additional information, advice, FAQs, and overviews.


Search all pages


By activity
Professions, Sciences, Humanities, Business, ...

User Interface
Text-based, GUI, Audio, Video, Keyboards, Mouse, Images,...

Text Strings
Conversions, tests, processing, manipulation,...

Integer, Floating point, Matrix, Statistics, Boolean, ...

Algorithms, Memory, Process control, Debugging, ...

Stored Data
Data storage, Integrity, Encryption, Compression, ...

Networks, protocols, Interprocess, Remote, Client Server, ...

Hard World
Timing, Calendar and Clock, Audio, Video, Printer, Controls...

File System
Management, Filtering, File & Directory access, Viewers, ...


RocketLink!--> Man page versions: OpenBSD FreeBSD NetBSD RedHat Others

STATFS(2)                 OpenBSD Programmer's Manual                STATFS(2)

     statfs - get file system statistics

     #include <sys/param.h>
     #include <sys/mount.h>

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

     fstatfs(int fd, struct statfs *buf);

     statfs() returns information about a mounted file system.  path is the
     path name of any file within the mounted file system.  buf is a pointer
     to a statfs 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 {
         u_int32_t  f_flags;       /* copy of mount flags */
         u_int32_t  f_bsize;       /* fundamental file system block size */
         u_int32_t  f_iosize;      /* optimal transfer block size */
         u_int32_t  f_blocks;      /* total data blocks in file system */
         u_int32_t  f_bfree;       /* free blocks in fs */
         u_int32_t  f_bavail;      /* free blocks avail to non-superuser */
         u_int32_t  f_files;       /* total file nodes in file system */
         u_int32_t  f_ffree;       /* free file nodes in fs */
         fsid_t     f_fsid;        /* file system id */
         uid_t      f_owner;       /* user that mounted the file system */
         u_int32_t  f_syncwrites;  /* count of sync writes since mount */
         u_int32_t  f_asyncwrites; /* count of async writes since mount */
         u_int32_t  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 */
         union mount_info mount_info;         /* per-filesystem mount options */

     fstatfs() returns the same information about an open file referenced by
     descriptor fd.

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

     statfs() fails if one or more of the following are true:

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

                   The length of a component of path exceeds {NAME_MAX} char-
                   acters, or the length of path exceeds {PATH_MAX} charac-

     [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

     [EFAULT]      buf or path points to an invalid address.

     [EIO]         An I/O error occurred while reading from or writing to the
                   file system.

     fstatfs() fails if one or more of the following are true:

     [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.

     df(1),  mount(2),  stat(2)

     The statfs() function first appeared in 4.4BSD.

OpenBSD 2.6                    February 11, 1994                             2

Source: OpenBSD 2.6 man pages. Copyright: Portions are copyrighted by BERKELEY
SOFTWARE DESIGN, INC., The Regents of the University of California, Massachusetts
Institute of Technology, Free Software Foundation, FreeBSD Inc., and others.

(Corrections, notes, and links courtesy of RocketAware.com)

[Detailed Topics]

[Overview Topics]

Up to: File System Information - Obtaining information of the filesystem as a whole. Status of disk subsystems, capacity, etc.

RocketLink!--> Man page versions: OpenBSD FreeBSD NetBSD RedHat Others

Rapid-Links: Search | About | Comments | Submit Path: RocketAware > man pages > statfs.2/
RocketAware.com is a service of Mib Software
Copyright 1999, Forrest J. Cavalier III. All Rights Reserved.
We welcome submissions and comments