MirOS Manual: df(1)

DF(1)                        BSD Reference Manual                        DF(1)

NAME

     df - display free disk space

SYNOPSIS

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

DESCRIPTION

     The df utility displays statistics about the amount of free disk space on
     the specified file_system or on the file system of which file is a part.
     By default, values are displayed as 512-byte block counts. If neither a
     file nor a file_system operand is specified, statistics for all mounted
     file systems are displayed (subject to the -l and -t options below).

     The options are as follows:

     -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 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 ar-
             gument, a warning is issued and no information is given on that
             file system.

     -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      Print out information in a stricter format designed to be parsed
             by portable scripts.

     -t type
             Indicate the actions should only be taken on file systems of the
             specified type. More than one type may be specified in a comma-
             separated list. The list of file system types can be prefixed
             with "no" to specify the file system 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 issued and
             no information is given on that file system.

ENVIRONMENT

     BLOCKSIZE  If the environment variable BLOCKSIZE is set, and the -k op-
                tions are not specified, the block counts will be displayed in
                units of that size block.

EXAMPLES

     $ df -kP /usr

     Output, in a strict format suitable for portable scripts, disk space
     statistics for the /usr file system using kilobyte block sizes.

DIAGNOSTICS

     The df utility exits with one of the following values:

     0     Successful completion.

     >0    An error occurred.

SEE ALSO

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

STANDARDS

     The df utility is compliant with the IEEE Std 1003.2-1992 ("POSIX.2")
     specification.

HISTORY

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

MirOS BSD #10-current          January 13, 1994                              1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.