man/df.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH DF "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 df \- report file system disk space usage
   5 .SH SYNOPSIS
   6 .B df
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH DESCRIPTION
   9 This manual page
  10 documents the GNU version of
  11 .BR df .
  12 .B df
  13 displays the amount of disk space available on the file system
  14 containing each file name argument.  If no file name is given, the
  15 space available on all currently mounted file systems is shown.  Disk
  16 space is shown in 1K blocks by default, unless the environment
  17 variable POSIXLY_CORRECT is set, in which case 512-byte blocks are
  18 used.
  19 .PP
  20 If an argument is the absolute file name of a disk device node containing a
  21 mounted file system,
  22 .B df
  23 shows the space available on that file system rather than on the
  24 file system containing the device node (which is always the root
  25 file system).  This version of
  26 .B df
  27 cannot show the space available on unmounted file systems, because on
  28 most kinds of systems doing so requires very nonportable intimate
  29 knowledge of file system structures.
  30 .SH OPTIONS
  31 .PP
  32 Show information about the file system on which each FILE resides,
  33 or all file systems by default.
  34 .PP
  35 Mandatory arguments to long options are mandatory for short options too.
  36 .TP
  37 \fB\-a\fR, \fB\-\-all\fR
  38 include dummy file systems
  39 .TP
  40 \fB\-B\fR, \fB\-\-block\-size\fR=\fISIZE\fR
  41 use SIZE\-byte blocks
  42 .TP
  43 \fB\-h\fR, \fB\-\-human\-readable\fR
  44 print sizes in human readable format (e.g., 1K 234M 2G)
  45 .TP
  46 \fB\-H\fR, \fB\-\-si\fR
  47 likewise, but use powers of 1000 not 1024
  48 .TP
  49 \fB\-i\fR, \fB\-\-inodes\fR
  50 list inode information instead of block usage
  51 .TP
  52 \fB\-k\fR
  53 like \fB\-\-block\-size\fR=\fI1K\fR
  54 .TP
  55 \fB\-l\fR, \fB\-\-local\fR
  56 limit listing to local file systems
  57 .TP
  58 \fB\-\-no\-sync\fR
  59 do not invoke sync before getting usage info (default)
  60 .TP
  61 \fB\-P\fR, \fB\-\-portability\fR
  62 use the POSIX output format
  63 .TP
  64 \fB\-\-sync\fR
  65 invoke sync before getting usage info
  66 .TP
  67 \fB\-t\fR, \fB\-\-type\fR=\fITYPE\fR
  68 limit listing to file systems of type TYPE
  69 .TP
  70 \fB\-T\fR, \fB\-\-print\-type\fR
  71 print file system type
  72 .TP
  73 \fB\-x\fR, \fB\-\-exclude\-type\fR=\fITYPE\fR
  74 limit listing to file systems not of type TYPE
  75 .TP
  76 \fB\-v\fR
  77 (ignored)
  78 .TP
  79 \fB\-\-help\fR
  80 display this help and exit
  81 .TP
  82 \fB\-\-version\fR
  83 output version information and exit
  84 .PP
  85 SIZE may be (or may be an integer optionally followed by) one of following:
  86 kB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.
  87 .SH AUTHOR
  88 Written by Torbjorn Granlund, David MacKenzie, and Paul Eggert.
  89 .SH "REPORTING BUGS"
  90 Report bugs to <bug\-coreutils@gnu.org>.
  91 .SH COPYRIGHT
  92 Copyright \(co 2007 Free Software Foundation, Inc.
  93 .br
  94 This is free software.  You may redistribute copies of it under the terms of
  95 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
  96 There is NO WARRANTY, to the extent permitted by law.
  97 .SH "SEE ALSO"
  98 The full documentation for
  99 .B df
 100 is maintained as a Texinfo manual.  If the
 101 .B info
 102 and
 103 .B df
 104 programs are properly installed at your site, the command
 105 .IP
 106 .B info df
 107 .PP
 108 should give you access to the complete manual.