raw/man1/df.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.022.
   2 .TH DF "1" "October 2003" "df (coreutils) 5.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 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 filesystem
  14 containing each file name argument.  If no file name is given, the
  15 space available on all currently mounted filesystems 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 filesystem,
  22 .B df
  23 shows the space available on that filesystem rather than on the
  24 filesystem containing the device node (which is always the root
  25 filesystem).  This version of
  26 .B df
  27 cannot show the space available on unmounted filesystems, because on
  28 most kinds of systems doing so requires very nonportable intimate
  29 knowledge of filesystem structures.
  30 .SH OPTIONS
  31 .PP
  32 Show information about the filesystem on which each FILE resides,
  33 or all filesystems 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 filesystems having 0 blocks
  39 .HP
  40 \fB\-B\fR, \fB\-\-block\-size\fR=\fISIZE\fR 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
  52 like \fB\-\-block\-size\fR=\fI1K\fR
  53 .TP
  54 \fB\-l\fR, \fB\-\-local\fR
  55 limit listing to local filesystems
  56 .TP
  57 \fB\-\-no\-sync\fR
  58 do not invoke sync before getting usage info (default)
  59 .TP
  60 \fB\-P\fR, \fB\-\-portability\fR
  61 use the POSIX output format
  62 .TP
  63 \fB\-\-sync\fR
  64 invoke sync before getting usage info
  65 .TP
  66 \fB\-t\fR, \fB\-\-type\fR=\fITYPE\fR
  67 limit listing to filesystems of type TYPE
  68 .TP
  69 \fB\-T\fR, \fB\-\-print\-type\fR
  70 print filesystem type
  71 .TP
  72 \fB\-x\fR, \fB\-\-exclude\-type\fR=\fITYPE\fR
  73 limit listing to filesystems not of type TYPE
  74 .TP
  75 \fB\-v\fR
  76 (ignored)
  77 .TP
  78 \fB\-\-help\fR
  79 display this help and exit
  80 .TP
  81 \fB\-\-version\fR
  82 output version information and exit
  83 .PP
  84 SIZE may be (or may be an integer optionally followed by) one of following:
  85 kB 1000, K 1024, MB 1,000,000, M 1,048,576, and so on for G, T, P, E, Z, Y.
  86 .SH AUTHOR
  87 Written by Torbjorn Granlund, David MacKenzie, Larry McVoy, and Paul Eggert.
  88 .SH "REPORTING BUGS"
  89 Report bugs to <bug-coreutils@gnu.org>.
  90 .SH COPYRIGHT
  91 Copyright \(co 2003 Free Software Foundation, Inc.
  92 .br
  93 This is free software; see the source for copying conditions.  There is NO
  94 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  95 .SH "SEE ALSO"
  96 The full documentation for
  97 .B df
  98 is maintained as a Texinfo manual.  If the
  99 .B info
 100 and
 101 .B df
 102 programs are properly installed at your site, the command
 103 .IP
 104 .B info df
 105 .PP
 106 should give you access to the complete manual.