b7c31a4f1d78c13a4f9c4267eeeab36a166df2a6
[platform/upstream/coreutils.git] / man / df.x
1 [NAME]
2 df \- report file system disk space usage
3 [DESCRIPTION]
4 This manual page
5 documents the GNU version of
6 .BR df .
7 .B df
8 displays the amount of disk space available on the file system
9 containing each file name argument.  If no file name is given, the
10 space available on all currently mounted file systems is shown.  Disk
11 space is shown in 1K blocks by default, unless the environment
12 variable POSIXLY_CORRECT is set, in which case 512-byte blocks are
13 used.
14 .PP
15 If an argument is the absolute file name of a disk device node containing a
16 mounted file system,
17 .B df
18 shows the space available on that file system rather than on the
19 file system containing the device node (which is always the root
20 file system).  This version of
21 .B df
22 cannot show the space available on unmounted file systems, because on
23 most kinds of systems doing so requires very nonportable intimate
24 knowledge of file system structures.
25 .SH OPTIONS