xref: /illumos-gate/usr/src/man/man1b/df.1b (revision 5d9d9091f564c198a760790b0bfa72c44e17912b)
te
Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
DF 1B "Sep 14, 1992"
NAME
df - display status of disk space on file systems
SYNOPSIS

/usr/ucb/df [-a] [-i] [-t type] [filesystem...]
 [filename...]
DESCRIPTION

The df utility displays the amount of disk space occupied by currently mounted file systems, the amount of used and available space, and how much of the file system's total capacity has been used.

If arguments to df are path names, df produces a report on the file system containing the named file. Thus `df .' shows the amount of space on the file system containing the current directory.

OPTIONS

The following options are supported: -a

Report on all filesystems including the uninteresting ones which have zero total blocks (that is, auto-mounter).

-i

Report the number of used and free inodes. Print ` * ' if no information is available.

-t type

Report on filesystems of a given type (for example, nfs or ufs).

EXAMPLES

Example 1 Using df

A sample of output for df looks like:

example% df
Filesystem kbytes used avail capacity Mounted on
sparky:/ 7445 4714 1986 70% /
sparky:/usr 42277 35291 2758 93% /usr

Note that used+avail is less than the amount of space in the file system (kbytes); this is because the system reserves a fraction of the space in the file system to allow its file system allocation routines to work well. The amount reserved is typically about 10%; this can be adjusted using tunefs (see tunefs(8)). When all the space on a file system except for this reserve is in use, only the super-user can allocate new files and data blocks to existing files. When a file system is overallocated in this way, df can report that the file system is more than 100% utilized.

FILES
/etc/mnttab

List of file systems currently mounted

/etc/vfstab

List of default parameters for each file system

SEE ALSO

du (1), mnttab (5), attributes (7), quot (8), tunefs (8)