1 files changed, 195 insertions, 0 deletions
diff --git a/man1/df.1 b/man1/df.1
new file mode 100644
index 000000000..3c5a32693
--- /dev/null
+++ b/man1/df.1
@@ -0,0 +1,195 @@
+.\" Copyright Andries Brouwer, Ragnar Hojland Espinosa and A. Wik, 1998.
+.\"
+.\" This file may be copied under the conditions described
+.\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
+.\" that should have been distributed together with this file.
+.\"
+.TH DF 1 1998-11 "GNU fileutils 4.0"
+.SH NAME
+df \- report filesystem disk space usage
+.SH SYNOPSIS
+.BI "df [" options "] [" file... ]
+.sp
+POSIX options:
+.B "[\-kP] [\-\-]"
+.sp
+GNU options (shortest form):
+.B [\-ahHiklmPv]
+.BI "[\-t " fstype ]
+.BI "[\-x " fstype ]
+.BI "[\-\-block\-size=" size ]
+.B [\-\-print\-type]
+.B [\-\-no\-sync]
+.B [\-\-sync]
+.B "[\-\-help] [\-\-version] [\-\-]"
+.SH DESCRIPTION
+.B df
+reports the amount of disk space used and available on
+filesystems.
+.PP
+With no arguments,
+.B df
+reports the space used and available on all
+currently mounted filesystems (of all types).
+Otherwise,
+.B df
+reports on the filesystem containing each argument
+.IR file .
+.SH "POSIX DETAILS"
+The output is in 512-byte units by default, but in
+1024-byte units when the \-k option is given.
+The output format is undefined, unless the \-P option is given.
+If
+.I file
+is not a regular file, a directory or a FIFO, the result
+is unspecified.
+.SH "GNU DETAILS"
+The output is in 1024-byte units (when no units are
+specified by options), unless the environment variable
+.B POSIXLY_CORRECT
+is set, in which case POSIX is followed.
+.PP
+If an argument
+.I file
+is a disk device file containing a mounted filesystem,
+.B df
+shows the space available on that filesystem rather
+than on the filesystem containing the device node.
+.SH "POSIX OPTIONS"
+.TP
+.B "\-k"
+Use 1024-byte units instead of the default 512-byte units.
+.TP
+.B "\-P"
+Output in six columns, with heading `Filesystem N-blocks
+Used Available Capacity Mounted on' (with N=512, but N=1024
+when the \-k option is given).
+.TP
+.B "\-\-"
+Terminate option list.
+.SH "GNU OPTIONS"
+.TP
+.B "\-a, \-\-all"
+Include in the listing filesystems that have a size of 0 blocks,
+which are omitted by default.  Such filesystems are typically
+special-purpose pseudo-filesystems, such as automounter entries.
+Also, filesystems of type "ignore" or "auto", supported by some
+operating systems, are only included if this option is specified.
+.TP
+.BI "\-\-block\-size=" size
+Print sizes in blocks of
+.I size
+bytes. (New but broken in fileutils-4.0.)
+.TP
+.B "\-h, \-\-human\-readable"
+Append a size letter such as
+.B M
+for binary megabytes (`mebibytes') to each size.
+.TP
+.B "\-H, \-\-si"
+Do the same as for
+.BR \-h ,
+but use the official SI units (with powers of 1000 instead of 1024,
+so that M stands for 1000000 instead of 1048576).
+(New in fileutils-4.0.)
+.TP
+.B "\-i, \-\-inodes"
+List inode usage information instead of block usage.  An inode
+(short for index node) contains information about a file such
+as its owner, permissions, timestamps, and location on the disk.
+.TP
+.B "\-k, \-\-kilobytes"
+Print sizes in 1024-byte blocks.
+.TP
+.B "\-l, \-\-local"
+Limit the output to local filesystems only.
+(New in fileutils-4.0.)
+.TP
+.B "\-m, \-\-megabytes"
+Print sizes in binary megabyte (that's 1048576 bytes) blocks.
+Note that the four options \-h, \-H, \-k, \-m are mutually exclusive
+and only the last one is effective; for example, it is not the case
+that giving both the \-\-si and \-m options would result in output
+in (actual, 1000000-byte) megabytes. [The interpretation of blocksizes
+is also influenced by the environment variable BLOCK_SIZE, but this
+does not work in the fileutils-4.0 version.]
+.TP
+.B "\-\-no\-sync"
+Do not invoke the
+.B sync
+system call before getting any usage data.
+This may make
+.B df
+run significantly faster, but on some systems (notably SunOS)
+the results may be slightly out of date.  This is the default.
+.TP
+.B "\-P, \-\-portability"
+Use the
+.SM POSIX
+output format.  This is like the default format
+except that the information about each filesystem is always
+printed on exactly one line; a mount device is never put on a line
+by itself.  This means that if the mount device name is more than
+20 characters long (e.g., for some network mounts), the columns
+are misaligned.
+.TP
+.B "\-\-sync"
+Invoke the
+.B sync
+system call before getting any usage data.  On some systems 
+(notably SunOS), doing this yields more up to date results,
+but in general this option makes
+.B df
+much slower, especially when there are many or very busy filesystems.
+.TP
+.BI "\-t " "fstype, " "\-\-type=" "fstype"
+Limit the listing to filesystems of type
+.IR fstype .
+Multiple filesystem types can be specified by giving multiple
+.B \-t
+options. By default, nothing is omitted.
+.TP
+.B "\-T, \-\-print\-type"
+Print each filesystem's type.
+The types given are those reported by the system
+(and are found in a system-dependent way, for example by reading
+.IR /etc/mtab ).
+See also
+.BR mount (8).
+.TP
+.BI "\-x " "fstype, " "\-\-exclude\-type=" "fstype"
+Limit the listing to filesystems not of type
+.I fstype.
+Multiple filesystem types can be eliminated by giving multiple
+.B "\-x"
+options.  By default, no filesystem types are omitted.
+.TP
+.B "\-v"
+Ignored; for compatibility with System V versions of
+.B df.
+.SH "GNU STANDARD OPTIONS"
+.TP
+.B "\-\-help"
+Print a usage message on standard output and exit successfully.
+.TP
+.B "\-\-version"
+Print version information on standard output, then exit successfully.
+.TP
+.B "\-\-"
+Terminate option list.
+.SH ENVIRONMENT
+The variable POSIXLY_CORRECT determines the choice of unit.
+If it is not set, and the variable BLOCKSIZE has a value starting
+with `HUMAN', then behaviour is as for the \-h option,
+unless overridden by \-k or \-m options.
+The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
+usual meaning.
+.SH "CONFORMING TO"
+POSIX 1003.2
+.SH "SEE ALSO"
+.BR mount (8)
+.SH NOTES
+This page describes
+.B df
+as found in the fileutils-4.0 package;
+other versions may differ slightly.