mirror of https://github.com/mkerrisk/man-pages
196 lines
5.7 KiB
Groff
196 lines
5.7 KiB
Groff
.\" Copyright Andries Brouwer, Ragnar Hojland Espinosa and A. Wik, 1998.
|
|
.\"
|
|
.\" This file may be copied under the conditions described
|
|
.\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
|
|
.\" that should have been distributed together with this file.
|
|
.\"
|
|
.TH DF 1 1998-11 "GNU fileutils 4.0"
|
|
.SH NAME
|
|
df \- report filesystem disk space usage
|
|
.SH SYNOPSIS
|
|
.BI "df [" options "] [" file... ]
|
|
.sp
|
|
POSIX options:
|
|
.B "[\-kP] [\-\-]"
|
|
.sp
|
|
GNU options (shortest form):
|
|
.B [\-ahHiklmPv]
|
|
.BI "[\-t " fstype ]
|
|
.BI "[\-x " fstype ]
|
|
.BI "[\-\-block\-size=" size ]
|
|
.B [\-\-print\-type]
|
|
.B [\-\-no\-sync]
|
|
.B [\-\-sync]
|
|
.B "[\-\-help] [\-\-version] [\-\-]"
|
|
.SH DESCRIPTION
|
|
.B df
|
|
reports the amount of disk space used and available on
|
|
filesystems.
|
|
.PP
|
|
With no arguments,
|
|
.B df
|
|
reports the space used and available on all
|
|
currently mounted filesystems (of all types).
|
|
Otherwise,
|
|
.B df
|
|
reports on the filesystem containing each argument
|
|
.IR file .
|
|
.SH "POSIX DETAILS"
|
|
The output is in 512-byte units by default, but in
|
|
1024-byte units when the \-k option is given.
|
|
The output format is undefined, unless the \-P option is given.
|
|
If
|
|
.I file
|
|
is not a regular file, a directory or a FIFO, the result
|
|
is unspecified.
|
|
.SH "GNU DETAILS"
|
|
The output is in 1024-byte units (when no units are
|
|
specified by options), unless the environment variable
|
|
.B POSIXLY_CORRECT
|
|
is set, in which case POSIX is followed.
|
|
.PP
|
|
If an argument
|
|
.I file
|
|
is a disk device file containing a mounted filesystem,
|
|
.B df
|
|
shows the space available on that filesystem rather
|
|
than on the filesystem containing the device node.
|
|
.SH "POSIX OPTIONS"
|
|
.TP
|
|
.B "\-k"
|
|
Use 1024-byte units instead of the default 512-byte units.
|
|
.TP
|
|
.B "\-P"
|
|
Output in six columns, with heading `Filesystem N-blocks
|
|
Used Available Capacity Mounted on' (with N=512, but N=1024
|
|
when the \-k option is given).
|
|
.TP
|
|
.B "\-\-"
|
|
Terminate option list.
|
|
.SH "GNU OPTIONS"
|
|
.TP
|
|
.B "\-a, \-\-all"
|
|
Include in the listing filesystems that have a size of 0 blocks,
|
|
which are omitted by default. Such filesystems are typically
|
|
special-purpose pseudo-filesystems, such as automounter entries.
|
|
Also, filesystems of type "ignore" or "auto", supported by some
|
|
operating systems, are only included if this option is specified.
|
|
.TP
|
|
.BI "\-\-block\-size=" size
|
|
Print sizes in blocks of
|
|
.I size
|
|
bytes. (New but broken in fileutils-4.0.)
|
|
.TP
|
|
.B "\-h, \-\-human\-readable"
|
|
Append a size letter such as
|
|
.B M
|
|
for binary megabytes (`mebibytes') to each size.
|
|
.TP
|
|
.B "\-H, \-\-si"
|
|
Do the same as for
|
|
.BR \-h ,
|
|
but use the official SI units (with powers of 1000 instead of 1024,
|
|
so that M stands for 1000000 instead of 1048576).
|
|
(New in fileutils-4.0.)
|
|
.TP
|
|
.B "\-i, \-\-inodes"
|
|
List inode usage information instead of block usage. An inode
|
|
(short for index node) contains information about a file such
|
|
as its owner, permissions, timestamps, and location on the disk.
|
|
.TP
|
|
.B "\-k, \-\-kilobytes"
|
|
Print sizes in 1024-byte blocks.
|
|
.TP
|
|
.B "\-l, \-\-local"
|
|
Limit the output to local filesystems only.
|
|
(New in fileutils-4.0.)
|
|
.TP
|
|
.B "\-m, \-\-megabytes"
|
|
Print sizes in binary megabyte (that's 1048576 bytes) blocks.
|
|
Note that the four options \-h, \-H, \-k, \-m are mutually exclusive
|
|
and only the last one is effective; for example, it is not the case
|
|
that giving both the \-\-si and \-m options would result in output
|
|
in (actual, 1000000-byte) megabytes. [The interpretation of blocksizes
|
|
is also influenced by the environment variable BLOCK_SIZE, but this
|
|
does not work in the fileutils-4.0 version.]
|
|
.TP
|
|
.B "\-\-no\-sync"
|
|
Do not invoke the
|
|
.B sync
|
|
system call before getting any usage data.
|
|
This may make
|
|
.B df
|
|
run significantly faster, but on some systems (notably SunOS)
|
|
the results may be slightly out of date. This is the default.
|
|
.TP
|
|
.B "\-P, \-\-portability"
|
|
Use the
|
|
.SM POSIX
|
|
output format. This is like the default format
|
|
except that the information about each filesystem is always
|
|
printed on exactly one line; a mount device is never put on a line
|
|
by itself. This means that if the mount device name is more than
|
|
20 characters long (e.g., for some network mounts), the columns
|
|
are misaligned.
|
|
.TP
|
|
.B "\-\-sync"
|
|
Invoke the
|
|
.B sync
|
|
system call before getting any usage data. On some systems
|
|
(notably SunOS), doing this yields more up to date results,
|
|
but in general this option makes
|
|
.B df
|
|
much slower, especially when there are many or very busy filesystems.
|
|
.TP
|
|
.BI "\-t " "fstype, " "\-\-type=" "fstype"
|
|
Limit the listing to filesystems of type
|
|
.IR fstype .
|
|
Multiple filesystem types can be specified by giving multiple
|
|
.B \-t
|
|
options. By default, nothing is omitted.
|
|
.TP
|
|
.B "\-T, \-\-print\-type"
|
|
Print each filesystem's type.
|
|
The types given are those reported by the system
|
|
(and are found in a system-dependent way, for example by reading
|
|
.IR /etc/mtab ).
|
|
See also
|
|
.BR mount (8).
|
|
.TP
|
|
.BI "\-x " "fstype, " "\-\-exclude\-type=" "fstype"
|
|
Limit the listing to filesystems not of type
|
|
.I fstype.
|
|
Multiple filesystem types can be eliminated by giving multiple
|
|
.B "\-x"
|
|
options. By default, no filesystem types are omitted.
|
|
.TP
|
|
.B "\-v"
|
|
Ignored; for compatibility with System V versions of
|
|
.B df.
|
|
.SH "GNU STANDARD OPTIONS"
|
|
.TP
|
|
.B "\-\-help"
|
|
Print a usage message on standard output and exit successfully.
|
|
.TP
|
|
.B "\-\-version"
|
|
Print version information on standard output, then exit successfully.
|
|
.TP
|
|
.B "\-\-"
|
|
Terminate option list.
|
|
.SH ENVIRONMENT
|
|
The variable POSIXLY_CORRECT determines the choice of unit.
|
|
If it is not set, and the variable BLOCKSIZE has a value starting
|
|
with `HUMAN', then behaviour is as for the \-h option,
|
|
unless overridden by \-k or \-m options.
|
|
The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
|
|
usual meaning.
|
|
.SH "CONFORMING TO"
|
|
POSIX 1003.2
|
|
.SH "SEE ALSO"
|
|
.BR mount (8)
|
|
.SH NOTES
|
|
This page describes
|
|
.B df
|
|
as found in the fileutils-4.0 package;
|
|
other versions may differ slightly.
|