df(1) - c6

1DF(1)                            User Commands                           DF(1)
2
3
4

NAME

6       df - report file system disk space usage
7

SYNOPSIS

9       df [OPTION]... [FILE]...
10

DESCRIPTION

12       This  manual  page  documents  the  GNU version of df.  df displays the
13       amount of disk space available on the file system containing each  file
14       name  argument.   If  no file name is given, the space available on all
15       currently mounted file systems is shown.  Disk space  is  shown  in  1K
16       blocks  by  default, unless the environment variable POSIXLY_CORRECT is
17       set, in which case 512-byte blocks are used.
18
19       If an argument is the absolute file name of a disk device node contain‐
20       ing  a  mounted  file system, df shows the space available on that file
21       system rather than on the file system containing the device node (which
22       is  always  the  root file system).  This version of df cannot show the
23       space available on unmounted file systems, because  on  most  kinds  of
24       systems  doing  so requires very nonportable intimate knowledge of file
25       system structures.
26

OPTIONS

28       Show information about the file system on which each FILE  resides,  or
29       all file systems by default.
30
31       Mandatory  arguments  to  long  options are mandatory for short options
32       too.
33
34       -a, --all
35              include dummy file systems
36
37       -B, --block-size=SIZE
38              use SIZE-byte blocks
39
40       --direct
41              show statistics for a file instead of mount point
42
43       --total
44              produce a grand total
45
46       -h, --human-readable
47              print sizes in human readable format (e.g., 1K 234M 2G)
48
49       -H, --si
50              likewise, but use powers of 1000 not 1024
51
52       -i, --inodes
53              list inode information instead of block usage
54
55       -k     like --block-size=1K
56
57       -l, --local
58              limit listing to local file systems
59
60       --no-sync
61              do not invoke sync before getting usage info (default)
62
63       -P, --portability
64              use the POSIX output format
65
66       --sync invoke sync before getting usage info
67
68       -t, --type=TYPE
69              limit listing to file systems of type TYPE
70
71       -T, --print-type
72              print file system type
73
74       -x, --exclude-type=TYPE
75              limit listing to file systems not of type TYPE
76
77       -v     (ignored)
78
79       --help display this help and exit
80
81       --version
82              output version information and exit
83
84       Display  values  are  in  units  of  the  first  available  SIZE   from
85       --block-size,  and the DF_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environ‐
86       ment variables.  Otherwise, units default to  1024  bytes  (or  512  if
87       POSIXLY_CORRECT is set).
88
89       SIZE  may  be (or may be an integer optionally followed by) one of fol‐
90       lowing: KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T,
91       P, E, Z, Y.
92

AUTHOR

94       Written by Torbjorn Granlund, David MacKenzie, and Paul Eggert.
95

REPORTING BUGS

97       Report df bugs to bug-coreutils@gnu.org
98       GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
99       General help using GNU software: <http://www.gnu.org/gethelp/>
100       Report df translation bugs to <http://translationproject.org/team/>
101

COPYRIGHT

103       Copyright  ©  2010  Free Software Foundation, Inc.  License GPLv3+: GNU
104       GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
105       This is free software: you are free  to  change  and  redistribute  it.
106       There is NO WARRANTY, to the extent permitted by law.
107