manual/GNU_fileutils/original/man1/df.1

   1 ." DO NOT MODIFY THIS FILE!  It was generated by help2man 1.5.1.2.
   2 .TH DF 1 "November 1998" "GNU fileutils 4.0" "FSF"
   3 .SH NAME
   4 df \- report filesystem disk space usage
   5 .SH SYNOPSIS
   6 .B df
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH DESCRIPTION
   9 .PP
  10 This manual page
  11 documents the GNU version of
  12 .BR df .
  13 .B df
  14 displays the amount of disk space available on the filesystem
  15 containing each file name argument.  If no file name is given, the
  16 space available on all currently mounted filesystems is shown.  Disk
  17 space is shown in 1K blocks by default, unless the environment
  18 variable POSIXLY_CORRECT is set, in which case 512-byte blocks are
  19 used.
  20 .PP
  21 If an argument is the absolute file name of a disk device node containing a
  22 mounted filesystem,
  23 .B df
  24 shows the space available on that filesystem rather than on the
  25 filesystem containing the device node (which is always the root
  26 filesystem).  This version of
  27 .B df
  28 cannot show the space available on unmounted filesystems, because on
  29 most kinds of systems doing so requires very nonportable intimate
  30 knowledge of filesystem structures.
  31 .SH OPTIONS
  32 .PP
  33 Show information about the filesystem on which each FILE resides,
  34 or all filesystems by default.
  35 .TP
  36 \fB\-a\fR, \fB\-\-all\fR
  37 include filesystems having 0 blocks
  38 .TP
  39 \fB\-\-block\-size\fR=\fISIZE\fR
  40 use SIZE-byte blocks
  41 .TP
  42 \fB\-h\fR, \fB\-\-human\-readable\fR
  43 print sizes in human readable format (e.g., 1K 234M 2G)
  44 .TP
  45 \fB\-H\fR, \fB\-\-si\fR
  46 likewise, but use powers of 1000 not 1024
  47 .TP
  48 \fB\-i\fR, \fB\-\-inodes\fR
  49 list inode information instead of block usage
  50 .TP
  51 \fB\-k\fR, \fB\-\-kilobytes\fR
  52 like \fB\-\-block\-size\fR=\fI1024\fR
  53 .TP
  54 \fB\-l\fR, \fB\-\-local\fR
  55 limit listing to local filesystems
  56 .TP
  57 \fB\-m\fR, \fB\-\-megabytes\fR
  58 like \fB\-\-block\-size\fR=\fI1048576\fR
  59 .TP
  60 \fB\-\-no\-sync\fR
  61 do not invoke sync before getting usage info (default)
  62 .TP
  63 \fB\-P\fR, \fB\-\-portability\fR
  64 use the POSIX output format
  65 .TP
  66 \fB\-\-sync\fR
  67 invoke sync before getting usage info
  68 .TP
  69 \fB\-t\fR, \fB\-\-type\fR=\fITYPE\fR
  70 limit listing to filesystems of type TYPE
  71 .TP
  72 \fB\-T\fR, \fB\-\-print\-type\fR
  73 print filesystem type
  74 .TP
  75 \fB\-x\fR, \fB\-\-exclude\-type\fR=\fITYPE\fR
  76 limit listing to filesystems not of type TYPE
  77 .TP
  78 \fB\-v\fR
  79 (ignored)
  80 .TP
  81 \fB\-\-help\fR
  82 display this help and exit
  83 .TP
  84 \fB\-\-version\fR
  85 output version information and exit
  86 .SH "REPORTING BUGS"
  87 Report bugs to <bug-fileutils@gnu.org>.
  88 .SH "SEE ALSO"
  89 The full documentation for
  90 .B df
  91 is maintained as a Texinfo manual.  If the
  92 .B info
  93 and
  94 .B df
  95 programs are properly installed at your site, the command
  96 .IP
  97 .B info df
  98 .PP
  99 should give you access to the complete manual.