mirror of
https://github.com/freebsd/freebsd-src.git
synced 2024-12-05 14:29:28 +00:00
126 lines
4.3 KiB
Groff
126 lines
4.3 KiB
Groff
.\" 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
|
|
.\" $Id: df.1,v 1.5 1996/12/11 10:01:49 jkh Exp $
|
|
.\"
|
|
.Dd May 8, 1995
|
|
.Dt DF 1
|
|
.Os BSD 4
|
|
.Sh NAME
|
|
.Nm df
|
|
.Nd display free disk space
|
|
.Sh SYNOPSIS
|
|
.Nm df
|
|
.Op Fl ink
|
|
.Op Fl t Ar type
|
|
.Op Ar file | Ar filesystem ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
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 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 i
|
|
Include statistics on the number of free inodes.
|
|
.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 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 t
|
|
Only print out statistics for filesystems of the specified types.
|
|
The recognized types are:
|
|
ufs, nfs, mfs, lfs, msdos, fdesc, portal, kernfs, procfs, afs, isofs,
|
|
iso9660fs, cdfs, and cd9660,
|
|
along with the aggregates:
|
|
all (the default),
|
|
local (ufs, mfs, lfs, msdos, cd9660),
|
|
and misc (fdesc, portal, kernfs, procfs).
|
|
The names isofs, iso9660fs, cdfs, and cd9660 are aliases to each other
|
|
all of them refering to the same type of file system.
|
|
The string ``no'' may be prepended to a type to get its complement
|
|
(e.g. ``nonfs'' to get non-NFS filesystems). The first
|
|
.Fl t
|
|
option overrides the default, additional such options will add to
|
|
(or subtract from) the current set of types; e.g. either
|
|
``df -t ufs -t lfs''
|
|
or
|
|
``df -t local -t nomfs''
|
|
will display statistics for UFS and LFS filesystems.
|
|
.El
|
|
.Sh ENVIRONMENT VARIABLES
|
|
.Bl -tag -width BLOCKSIZE
|
|
.It Ev BLOCKSIZE
|
|
If the environmental 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 SEE ALSO
|
|
.Xr quota 1 ,
|
|
.Xr statfs 2 ,
|
|
.Xr fstatfs 2 ,
|
|
.Xr getfsstat 2 ,
|
|
.Xr getmntinfo 3 ,
|
|
.Xr fstab 5 ,
|
|
.Xr mount 8 ,
|
|
.Xr quot 8
|
|
.Sh HISTORY
|
|
A
|
|
.Nm df
|
|
command appeared in
|
|
.At v1 .
|