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.2 January 13, 1994 2
Powered by man-cgi (2024-03-20).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.