diff options
Diffstat (limited to 'file_cmds/df/df.1')
-rw-r--r-- | file_cmds/df/df.1 | 217 |
1 files changed, 217 insertions, 0 deletions
diff --git a/file_cmds/df/df.1 b/file_cmds/df/df.1 new file mode 100644 index 0000000..4560ab9 --- /dev/null +++ b/file_cmds/df/df.1 @@ -0,0 +1,217 @@ +.\" Copyright (c) 1989, 1990, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)df.1 8.3 (Berkeley) 5/8/95 +.\" $FreeBSD: src/bin/df/df.1,v 1.18.2.7 2002/04/22 22:17:36 keramida Exp $ +.\" +.Dd May 8, 1995 +.Dt DF 1 +.Os +.Sh NAME +.Nm df +.Nd display free disk space +.Sh SYNOPSIS +.Nm df +.Oo +.Fl b | h | H | k | +.Fl m | g | P +.Oc +.Op Fl ailn +.Op Fl t +.Op Fl T Ar type +.Op Ar file | filesystem ... +.Sh LEGACY SYNOPSIS +.Nm df +.Oo +.Fl b | h | H | k | +.Fl m | P +.Oc +.Op Fl ailn +.Op Fl t Ar type +.Op Fl T Ar type +.Op Ar file | filesystem ... +.Sh DESCRIPTION +The +.Nm df +utility +displays statistics about the amount of free disk space on the specified +.Ar filesystem +or on the filesystem of which +.Ar file +is a part. +Values are displayed in 512-byte per block counts. +If neither a file or a filesystem operand is specified, +statistics for all mounted filesystems are displayed +(subject to the +.Fl t +option below). +.Pp +The following options are available: +.Bl -tag -width Ds +.It Fl a +Show all mount points, including those that were mounted with the MNT_IGNORE +flag. +.It Fl b +Use (the default) 512-byte blocks. +This is only useful as a way to override an +.Ev BLOCKSIZE +specification from the environment. +.It Fl g +Use 1073741824-byte (1-Gbyte) blocks rather than the default. +Note that this overrides the +.Ev BLOCKSIZE +specification from the environment. +.It Fl H +"Human-readable" output. Use unit suffixes: Byte, Kilobyte, Megabyte, +Gigabyte, Terabyte and Petabyte in order to reduce the number of +digits to three or less using base 10 for sizes. +.It Fl h +"Human-readable" output. Use unit suffixes: Byte, Kilobyte, Megabyte, +Gigabyte, Terabyte and Petabyte in order to reduce the number of +digits to three or less using base 2 for sizes. +.It Fl i +Include statistics on the number of free inodes. This option is now the default to conform to +.St -susv3 +Use +.Fl P +to suppress this output. +.It Fl k +Use 1024-byte (1-Kbyte) blocks, rather than the default. +Note that this overrides the +.Ev BLOCKSIZE +specification from the environment. +.It Fl l +Only display information about locally-mounted filesystems. +.It Fl m +Use 1048576-byte (1-Mbyte) blocks rather than the default. Note that +this overrides the +.Ev BLOCKSIZE +specification from the environment. +.It Fl n +Print out the previously obtained statistics from the filesystems. +This option should be used if it is possible that one or more +filesystems are in a state such that they will not be able to provide +statistics without a long delay. +When this option is specified, +.Nm df +will not request new statistics from the filesystems, but will respond +with the possibly stale statistics that were previously obtained. +.It Fl P +Use (the default) 512-byte blocks. +This is only useful as a way to override an +.Ev BLOCKSIZE +specification from the environment. +.It Fl T +Only print out statistics for filesystems of the specified types. +More than one type may be specified in a comma separated list. +The list of filesystem types can be prefixed with +.Dq no +to specify the filesystem types for which action should +.Em not +be taken. +For example, the +.Nm df +command: +.Bd -literal -offset indent +df -T nonfs,mfs +.Ed +.Pp +lists all filesystems except those of type +.Tn NFS +and +.Tn MFS . +The +.Xr lsvfs 1 +command can be used to find out the types of filesystems +that are available on the system. +.It Fl t +If used with no arguments, +this option is a no-op +(Mac OS X already prints the total allocated-space figures). +If used with an argument, it acts like +.Fl T , +but this usage is deprecated and should not be relied upon. +.El +.Sh ENVIRONMENT +.Bl -tag -width BLOCKSIZE +.It Ev BLOCKSIZE +If the environment variable +.Ev BLOCKSIZE +is set, the block counts will be displayed in units of that size block. +.El +.Sh BUGS +The +.Fl n +and +.Fl t +flags are ignored if a file or filesystem is specified. +.Sh LEGACY DESCRIPTION +The "capacity" percentage is normally rounded up to the next higher integer. +In legacy mode, it is rounded down to the next lower integer. +.Pp +When the +.Fl P +option and the +.Fl k +option are used together, +sizes are reported in 1024-blocks. +In legacy mode, when the +.Fl P +option and +.Fl k +option are used together, +the last option specified dictates the reported block size. +.Pp +The +.Fl t +option is normally a no-op +(Mac OS X already prints the total allocated-space figures). +In legacy mode, it is equivalent to +.Fl T . +.Pp +For more information about legacy mode, see +.Xr compat 5 . +.Sh SEE ALSO +.Xr lsvfs 1 , +.Xr quota 1 , +.Xr fstatfs 2 , +.Xr getfsstat 2 , +.Xr statfs 2 , +.Xr getmntinfo 3 , +.Xr compat 5 , +.Xr fstab 5 , +.Xr mount 8 , +.Xr quot 8 +.Sh HISTORY +A +.Nm df +command appeared in +.At v1 . |