df(1) - NetBSD Manual Pages

DF(1)                       NetBSD Reference Manual                      DF(1)


NAME

     df - display free disk space


SYNOPSIS

     df [-aiklmnP] [-t type] [file | file_system ...]


DESCRIPTION

     df displays statistics about the amount of free disk space on the speci-
     fied file_system or on the file system of which file is a part.  Values
     are displayed in 512-byte per block block counts.  If neither a file or a
     file_system operand is specified, statistics for all mounted file systems
     are displayed (subject to the -l and -t options below).

     Note that the printed count of available blocks takes minfree into ac-
     count, and thus will be negative when the number of free blocks on the
     filesystem is less than minfree.

     The following options are available:

     -a      Show all filesystems. By default only filesystems mounted with
             the MNT_IGNORE flag clear are shown.

     -i      Include statistics on the number of free inodes.

     -k      By default, all sizes are reported in 512-byte block counts.  The
             -k option causes the numbers to be reported in kilobyte (1024
             bytes) counts.

     -l      Display statistics only about mounted file systems with the
             MNT_LOCAL flag set.  If a non-local file system is given as an
             argument, a warning is issued and no information is given on that
             file system.

     -m      The -m option causes the numbers to be reported in megabyte
             (1024*1024 bytes) counts.

     -n      Print out the previously obtained statistics from the file sys-
             tems.  This option should be used if it is possible that one or
             more file systems are in a state such that they will not be able
             to provide statistics without a long delay.  When this option is
             specified, df will not request new statistics from the file sys-
             tems, but will respond with the possibly stale statistics that
             were previously obtained.

     -P      Produce output in the following portable format:

             If both the -P and -k option are specified, the output will be
             preceded by the following header line, formatted to match the da-
             ta following it:

             "Filesystem 1024-blocks Used Available Capacity Mounted on\n"

             If the -P option is specified without the -k options, the output
             will be preceded by the following header line, formatted to
             matche the data following it:

             "Filesystem <blksize>-blocks Used Available Capacity Mounted on\n"

             The header line is followed by data formatted as follows:

             "%s %d %d %d %d%% %s\n", <file system name>, <total space>,
                 <space used>, <space free>, <percentage used>,
                 <file system root>

     -t type
             Is used to indicate the actions should only be taken on filesys-
             tems of the specified type.  More than one type may be specified
             in a comma separated list.  The list of filesystem types can be
             prefixed with ``no'' to specify the filesystem types for which
             action should not be taken.  If a file system is given on the
             command line that is not of the specified type, a warning is is-
             sued and no information is given on that file system.


ENVIRONMENT

     BLOCKSIZE  If the environment variable BLOCKSIZE is set, and the -k and
                -m options are not specified, the block counts will be dis-
                played in units of that size block.


SEE ALSO

     quota(1), fstatfs(2), getfsstat(2), statfs(2), getbsize(3),
     getmntinfo(3), fs(5), fstab(5), mount(8), quot(8), tunefs(8)


HISTORY

     A df utility appeared in Version 6 AT&T UNIX.

NetBSD 1.6                     January 13, 1994                              2