df



DF(1)                            User Commands                           DF(1)




NAME

       df - report filesystem disk space usage


SYNOPSIS

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


DESCRIPTION

       This  manual  page  documents  the  GNU version of df.  df displays the
       amount of disk space available on the filesystem containing  each  file
       name  argument.   If  no file name is given, the space available on all
       currently mounted filesystems 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 contain-
       ing a mounted filesystem, df shows the space available on that filesys-
       tem rather than on the filesystem containing the device node (which  is
       always  the root filesystem).  This version of df cannot show the space
       available on unmounted filesystems, because on most  kinds  of  systems
       doing  so  requires  very  nonportable intimate knowledge of filesystem
       structures.


OPTIONS

       Show information about the filesystem on which each  FILE  resides,  or
       all filesystems by default.

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

       -a, --all
              include filesystems having 0 blocks

       -B, --block-size=SIZE use SIZE-byte blocks

       -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

       -l, --local
              limit listing to local filesystems

       --no-sync
              do not invoke sync before getting usage info (default)

       -P, --portability
              use the POSIX output format

       --sync invoke sync before getting usage info

       -t, --type=TYPE
              limit listing to filesystems of type TYPE

       -T, --print-type
              print filesystem type

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

       -v     (ignored)

       --help display this help and exit

       --version
              output version information and exit

       SIZE may be (or may be an integer optionally followed by) one  of  fol-
       lowing: kB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T,
       P, E, Z, Y.


AUTHOR

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


REPORTING BUGS

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


COPYRIGHT

       Copyright © 2004 Free Software Foundation, Inc.
       This is free software; see the source for copying conditions.  There is
       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.


SEE ALSO

       The full documentation for df is maintained as a  Texinfo  manual.   If
       the  info and df programs are properly installed at your site, the com-
       mand

              info coreutils df

       should give you access to the complete manual.



df (coreutils) 5.2.1               July 2005                             DF(1)

Man(1) output converted with man2html