df(1) - f7

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       -h, --human-readable
41              print sizes in human readable format (e.g., 1K 234M 2G)
42
43       -H, --si
44              likewise, but use powers of 1000 not 1024
45
46       -i, --inodes
47              list inode information instead of block usage
48
49       -k     like --block-size=1K
50
51       -l, --local
52              limit listing to local file systems
53
54       --no-sync
55              do not invoke sync before getting usage info (default)
56
57       -P, --portability
58              use the POSIX output format
59
60       --sync invoke sync before getting usage info
61
62       -t, --type=TYPE
63              limit listing to file systems of type TYPE
64
65       -T, --print-type
66              print file system type
67
68       -x, --exclude-type=TYPE
69              limit listing to file systems not of type TYPE
70
71       -v     (ignored)
72
73       --help display this help and exit
74
75       --version
76              output version information and exit
77
78       SIZE may be (or may be an integer optionally followed by) one  of  fol‐
79       lowing: kB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T,
80       P, E, Z, Y.
81

AUTHOR

83       Written by Torbjorn Granlund, David MacKenzie, and Paul Eggert.
84

REPORTING BUGS

86       Report bugs to <bug-coreutils@gnu.org>.
87

COPYRIGHT

89       Copyright © 2007 Free Software Foundation, Inc.
90       This is free software.  You may redistribute copies  of  it  under  the
91       terms       of       the      GNU      General      Public      License
92       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY,  to  the
93       extent permitted by law.
94