man pages section 1: User Commands

Exit Print View

Updated: July 2014

df (1g)


df - report file system disk space usage


df [OPTION]... [FILE]...


User Commands                                               DF(1)

     df - report file system disk space usage

     df [OPTION]... [FILE]...

     This  manual  page documents the GNU version of df.  df dis-
     plays the amount of disk space available on the file  system
     containing  each  file  name  argument.   If no file name is
     given, the space available on  all  currently  mounted  file
     systems  is  shown.   Disk  space  is  shown in 1K blocks by
     default, unless the environment variable POSIXLY_CORRECT  is
     set, in which case 512-byte blocks are used.

     If  an  argument  is the absolute file name of a disk device
     node containing a mounted file system, df  shows  the  space
     available on that file system rather than on the file system
     containing the device node (which is always  the  root  file
     system).  This version of df cannot show the space available
     on unmounted file systems, because on most kinds of  systems
     doing  so  requires  very  nonportable intimate knowledge of
     file system structures.

     Show information about the file system on  which  each  FILE
     resides, or all file systems by default.

     Mandatory  arguments to long options are mandatory for short
     options too.

     -a, --all
          include dummy file systems

     -B, --block-size=SIZE
          scale sizes by SIZE before printing them.  E.g.,  '-BM'
          prints  sizes  in  units  of 1,048,576 bytes.  See SIZE
          format below.

          produce a grand total

     -h, --human-readable
          print sizes in human readable format (e.g., 1K 234M 2G)

     -H, --si
          likewise, but use powers of 1000 not 1024

     -i, --inodes
          list inode information instead of block usage

     -k   like --block-size=1K

GNU coreutils 8.16   Last change: March 2012                    1

User Commands                                               DF(1)

     -l, --local
          limit listing to local file systems

          do not invoke sync before getting usage info (default)

     -P, --portability
          use the POSIX output format

          invoke sync before getting usage info

     -t, --type=TYPE
          limit listing to file systems of type TYPE

     -T, --print-type
          print file system type

     -x, --exclude-type=TYPE
          limit listing to file systems not of type TYPE

     -v   (ignored)

          display this help and exit

          output version information and exit

     Display values are in units of the first available SIZE from
     --block-size, and the DF_BLOCK_SIZE, BLOCK_SIZE  and  BLOCK-
     SIZE  environment  variables.   Otherwise,  units default to
     1024 bytes (or 512 if POSIXLY_CORRECT is set).

     SIZE is an  integer  and  optional  unit  (example:  10M  is
     10*1024*1024).   Units are K, M, G, T, P, E, Z, Y (powers of
     1024) or KB, MB, ... (powers of 1000).

     Written by Torbjorn  Granlund,  David  MacKenzie,  and  Paul

     Report df bugs to
     GNU  coreutils home page: <
     General help using GNU  software:  <
     Report   df   translation  bugs  to  <http://translationpro->

GNU coreutils 8.16   Last change: March 2012                    2

User Commands                                               DF(1)

     Copyright (C) 2012 Free Software Foundation,  Inc.   License
     GPLv3+:      GNU      GPL     version     3     or     later
     This is free software: you are free  to  change  and  redis-
     tribute  it.   There is NO WARRANTY, to the extent permitted
     by law.

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | file/gnu-coreutils |
     |Stability      | Uncommitted        |
     The  full  documentation  for  df is maintained as a Texinfo
     manual.  If the info and df programs are properly  installed
     at your site, the command

          info coreutils 'df invocation'

     should give you access to the complete manual.

     This   software   was   built   from   source  available  at   The   original
     community       source       was       downloaded       from

     Further information about this software can be found on  the
     open  source  community  website at

GNU coreutils 8.16   Last change: March 2012                    3