manual/gnumaniak/original/man1/df.1

   1 .\" Copyright Andries Brouwer, A. Wik 1998, Ragnar Hojland Espinosa 1998-2002
   2 .\"
   3 .\" This file may be copied under the conditions described
   4 .\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
   5 .\" that should have been distributed together with this file.
   6 .\"
   7 .TH DF 1 "18 June 2002" "GNU fileutils 4.1"
   8 .SH NAME
   9 df \- report filesystem disk space usage
  10 .SH SYNOPSIS
  11 .BI "df [" options "] [" file... ]
  12 .sp
  13 POSIX options:
  14 .B [\-kP]
  15 .sp
  16 GNU options (shortest form):
  17 .B [\-ahiklmvHPT]
  18 .BI "[\-t " fstype ]
  19 .BI "[\-x " fstype ]
  20 .B [\-\-block\-size=\fISIZE\fB]
  21 .B [\-\-no\-sync]
  22 .B [\-\-sync]
  23 .B "[\-\-help] [\-\-version] [\-\-]"
  24 .SH DESCRIPTION
  25 .B df
  26 reports the amount of disk space used and available on
  27 filesystems.
  28 .PP
  29 With no arguments,
  30 .B df
  31 reports the space used and available on all
  32 currently mounted filesystems (of all types).
  33 Otherwise,
  34 .B df
  35 reports on the filesystem containing each argument
  36 .IR file .
  37 .SH "POSIX DETAILS"
  38 The output is in 512-byte units by default, but in
  39 1024-byte units when the \-k option is given.
  40 The output format is undefined, unless the \-P option is given.
  41 If
  42 .I file
  43 is not a regular file, a directory or a FIFO, the result
  44 is unspecified.
  45 .SH "GNU DETAILS"
  46 If an argument
  47 .I file
  48 is a disk device file containing a mounted filesystem,
  49 .B df
  50 shows the space available on that filesystem rather
  51 than on the filesystem containing the device node.
  52 .SH "POSIX OPTIONS"
  53 .TP
  54 .B "\-k"
  55 Use 1024-byte units instead of the default 512-byte units.
  56 .TP
  57 .B "\-P"
  58 Output in six columns, with heading `Filesystem N-blocks
  59 Used Available Capacity Mounted on' (with N=512, but N=1024
  60 when the \-k option is given).
  61 .SH "GNU OPTIONS"
  62 .TP
  63 .B "\-a, \-\-all"
  64 Include in the listing filesystems that have a size of 0 blocks, or of type
  65 `ignore' or `auto' which are omitted by default.
  66 .TP
  67 .B "\-h, \-\-human-readable"
  68 Append a size letter such as \fBM\fR for megabytes to each size.
  69 Powers of 2 are used, not 10; \fBM\fR stands for 1,048,576 bytes.
  70 .TP
  71 .B "\-i, \-\-inodes"
  72 List inode usage information instead of block usage.
  73 .TP
  74 .B "\-k, \-\-kilobytes"
  75 Print sizes in 1024-byte blocks, overriding the default block size.
  76 .TP
  77 .B \-l, \-\-local
  78 List only local filesystems.
  79 .TP
  80 .B "\-m, \-\-megabytes"
  81 Print sizes in megabyte (1,048,576 bytes) blocks.
  82 .TP
  83 .BI "\-t " "fstype, " "\-\-type=" "fstype"
  84 List only filesystems of type
  85 .I fstype.
  86 Multiple types can be specified by giving multiple
  87 .B \-t
  88 options.  See \fB\-\-all\fR for ommited defaults.
  89 .TP
  90 .B "\-v"
  91 Ignored; for compatibility with System V versions of
  92 .B df.
  93 .TP
  94 .BI "\-x " "fstype, " "\-\-exclude\-type=" "fstype"
  95 Exclude filesystems of type
  96 .I fstype.
  97 Multiple filesystem types can be eliminated by giving multiple
  98 .B "\-x"
  99 options.  By default, no filesystem types are excluded.  See \fB\-\-all\fR
 100 for ommited defaults.
 101 .TP
 102 .B \-H, \-\-si
 103 Append a size letter such as \fBM\fR for megabytes to each size.  (SI
 104 is the International System of Units, which defines these letters)  Powers
 105 of 10 are used, not 2; \fBM\fR stands for 1,000,000 bytes.
 106 .TP
 107 .B "\-P, \-\-portability"
 108 Use the
 109 .SM POSIX
 110 output format.  This is like the default format
 111 except that a) the information about each filesystem is always
 112 printed on exactly one line; a mount device is never put on a line
 113 by itself.  This means that if the mount device name is more than
 114 20 characters long (e.g., for some network mounts), the columns
 115 are misaligned. b) Rounding is upwards. c) Column headers match POSIX.
 116 .TP
 117 .B "\-T, \-\-print\-type"
 118 Print each filesystem's type.  See
 119 .BR mount (8).
 120 .TP
 121 .B \-\-block\-size=\fISIZE
 122 Set the block size to \fISIZE\fR, overriding the value of the environment
 123 variables.
 124 .TP
 125 .B "\-\-no\-sync"
 126 Do not invoke
 127 .B sync(2)
 128 before getting any usage data.
 129 This may make
 130 .B df
 131 run significantly faster, but on some systems (notably SunOS)
 132 the results may be slightly out of date.  This is the default.
 133 .TP
 134 .B "\-\-sync"
 135 Invoke
 136 .B sync(2)
 137 before getting any usage data.  On some systems
 138 (notably SunOS), doing this yields more up to date results,
 139 but in general this option makes
 140 .B df
 141 much slower, especially when there are many or very busy filesystems.
 142 .SH "GNU STANDARD OPTIONS"
 143 .TP
 144 .B "\-\-help"
 145 Print a usage message on standard output and exit successfully.
 146 .TP
 147 .B "\-\-version"
 148 Print version information on standard output, then exit successfully.
 149 .TP
 150 .B "\-\-"
 151 Terminate option list.
 152 .SH BLOCK SIZE
 153 The default output file block size is 1024 bytes (or 512 if \fBPOSIXLY_CORRECT\fR).
 154 You may change this value by setting any of the following environment
 155 variables, which are overriden if a \fB\-\-block\-size=\fISIZE\fR is given.
 156 .TP
 157 In order of precedence:
 158 .BR DF_BLOCK_SIZE ", " BLOCK_SIZE ", " POSIXLY_CORRECT .
 159 .PP
 160 The values for these variables can be either a number, \fBhuman\-readable\fR, or
 161 \fBsi\fR.  Numbers may be followed by a size letter to specify a multiple of that
 162 size, and a \fBB\fR to select normal bytes or a \fBD\fR to select
 163 decimal "commercial" bytes.  For example `BLOCK_SIZE=1KB' is equal to
 164 `BLOCK_SIZE=1024' and `BLOCK_SIZE=1KD' is equal to `BLOCK_SIZE=1000'
 165
 166 The following letters are recognized (and used when printing with
 167 \fB\-\-human\-readable\fR or \fB\-\-si\fR)
 168 .TP
 169 .B k
 170 kilo: 2^10 = 1024 for \fB\-\-human-readable\fR, or 10^3 = 1000 for \fB\-\-si\fR
 171 .TP
 172 .B M
 173 Mega: 2^20 = 1,048,576 or 10^6 = 1,000,000
 174 .TP
 175 .B G
 176 Giga: 2^30 = 1,073,741,824 or 10^9 = 1,000,000,000
 177 .TP
 178 .B T
 179 Tera: 2^40 = 1,099,511,627,776 or 10^12 = 1,000,000,000,000
 180 .TP
 181 .B P
 182 Peta: 2^50 = 1,125,899,906,842,624 or 10^15 = 1,000,000,000,000,000
 183 .TP
 184 .B E
 185 Exa: 2^60 = 1,152,921,504,606,846,976 or 10^18 = 1,000,000,000,000,000,000
 186 .TP
 187 .B Z
 188 Zetta: 2^70 = 1,180,591,620,717,411,303,424 or 10^21 =
 189 1,000,000,000,000,000,000,000
 190 .TP
 191 .B Y
 192 Yotta: 2^80 = 1,208,925,819,614,629,174,706,176 or 10^24 =
 193 1,000,000,000,000,000,000,000,000
 194 .SH ENVIRONMENT
 195 The variables DF_BLOCK_SIZE, BLOCK_SIZE and POSIXLY_CORRECT determine the
 196 choice of the output file block size.
 197 The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
 198 usual meaning.
 199 .SH "CONFORMING TO"
 200 POSIX 1003.2
 201 .SH "SEE ALSO"
 202 .BR mount (8)
 203 .SH NOTES
 204 Disk usage is rounded upwards, free space downwards.
 205
 206 This page describes
 207 .B df
 208 as found in the fileutils-4.1 package;
 209 other versions may differ slightly. Mail corrections and additions to
 210 aeb@cwi.nl and aw@mail1.bet1.puv.fi and ragnar@ragnar-hojland.com
 211 Report bugs in the program to bug-fileutils@gnu.org.