df(1M) System Administration Commands df(1M)NAMEdf - displays number of free disk blocks and free files
SYNOPSIS
/usr/bin/df [-F FSType] [-abeghklntVvZ]
[-o FSType-specific_options]
[block_device | directory | file | resource ...]
/usr/xpg4/bin/df [-F FSType] [-abeghklnPtVZ]
[-o FSType-specific_options]
[block_device | directory | file | resource ...]
DESCRIPTION
The df utility displays the amount of disk space occupied by mounted or
unmounted file systems, the amount of used and available space, and how
much of the file system's total capacity has been used. The file system
is specified by device, or by referring to a file or directory on the
specified file system.
Used without operands or options, df reports on all mounted file sys‐
tems.
df may not be supported for all FSTypes.
If df is run on a networked mount point that the automounter has not
yet mounted, the file system size will be reported as zero. As soon as
the automounter mounts the file system, the sizes will be reported cor‐
rectly.
OPTIONS
The following options are supported for both /usr/bin/df and
/usr/xpg4/bin/df:
-a
Reports on all file systems including ones whose entries in
/etc/mnttab (see mnttab(4)) have the ignore option set.
-b
Prints the total number of kilobytes free.
-e
Prints only the number of files free.
-F FSType
Specifies the FSType on which to operate. The -F option is intended
for use with unmounted file systems. The FSType should be specified
here or be determinable from /etc/vfstab (see vfstab(4)) by match‐
ing the directory, block_device, or resource with an entry in the
table, or by consulting /etc/default/fs. See default_fs(4).
-g
Prints the entire statvfs(2) structure. This option is used only
for mounted file systems. It can not be used with the -o option.
This option overrides the -b, -e, -k, -n, -P, and -t options.
-h
Like -k, except that sizes are in a more human readable format. The
output consists of one line of information for each specified file
system. This information includes the file system name, the total
space allocated in the file system, the amount of space allocated
to existing files, the total amount of space available for the cre‐
ation of new files by unprivileged users, and the percentage of
normally available space that is currently allocated to all files
on the file system. All sizes are scaled to a human readable for‐
mat, for example, 14K, 234M, 2.7G, or 3.0T. Scaling is done by
repetitively dividing by 1024.
This option overrides the -b, -e, -g, -k, -n, -t, and -V options.
This option only works on mounted filesystems and can not be used
together with -o option.
-k
Prints the allocation in kbytes. The output consists of one line of
information for each specified file system. This information
includes the file system name, the total space allocated in the
file system, the amount of space allocated to existing files, the
total amount of space available for the creation of new files by
unprivileged users, and the percentage of normally available space
that is currently allocated to all files on the file system. This
option overrides the -b, -e, -n, and -t options.
-l
Reports on local file systems only. This option is used only for
mounted file systems. It can not be used with the -o option.
-n
Prints only the FSType name. Invoked with no operands, this option
prints a list of mounted file system types. This option is used
only for mounted file systems. It can not be used with the -o
option.
-o FSType-specific_options
Specifies FSType-specific options. These options are comma-sepa‐
rated, with no intervening spaces. See the manual page for the
FSType-specific command for details.
-t
Prints full listings with totals. This option overrides the -b, -e,
and -n options.
-V
Echoes the complete set of file system specific command lines, but
does not execute them. The command line is generated by using the
options and operands provided by the user and adding to them infor‐
mation derived from /etc/mnttab, /etc/vfstab, or /etc/default/fs.
This option may be used to verify and validate the command line.
-Z
Displays mounts in all visible zones. By default, df only displays
mounts located within the current zone. This option has no effect
in a non-global zone.
/usr/bin/df
The following option is supported for /usr/bin/df only:
-v
Like -k, except that sizes are displayed in multiples of the small‐
est block size supported by each specified file system.
The output consists of one line of information for each file sys‐
tem. This one line of information includes the following:
o the file system's mount point
o the file system's name
o the total number of blocks allocated to the file system
o the number of blocks allocated to existing files
o the number of blocks available for the creation of new
files by unprivileged users
o the percentage of blocks in use by files
/usr/xpg4/bin/df
The following option is supported for /usr/xpg4/bin/df only:
-P
Same as -h except in 512-byte units.
OPERANDS
The df utility interprets operands according to the following prece‐
dence: block_device, directory, file, resource. The following operands
are supported:
block_device
Represents a block special device (for example, /dev/dsk/c1d0s7).
directory
Represents a valid directory name. df reports on the file system
that contains directory.
file
Represents a valid file name. df reports on the file system that
contains file.
resource
Represents an NFS resource name.
USAGE
See largefile(5) for the description of the behavior of df when encoun‐
tering files greater than or equal to 2 Gbyte ( 2^31 bytes).
EXAMPLES
Example 1 Executing the df command
The following example shows the df command and its output:
example% /usr/bin/df
/ (/dev/dsk/c0t0d0s0 ): 287530 blocks 92028 files
/system/contract (ctfs ): 0 blocks 2147483572 files
/system/object (objfs ): 0 blocks 2147483511 files
/usr (/dev/dsk/c0t0d0s6 ): 1020214 blocks 268550 files
/proc (/proc ): 0 blocks 878 files
/dev/fd (fd ): 0 blocks 0 files
/etc/mnttab (mnttab ): 0 blocks 0 files
/var/run (swap ): 396016 blocks 9375 files
/tmp (swap ): 396016 blocks 9375 files
/opt (/dev/dsk/c0t0d0s5 ): 381552 blocks 96649 files
/export/home (/dev/dsk/c0t0d0s7 ): 434364 blocks 108220 files
where the columns represent the mount point, device (or "filesystem",
according to df -k), free blocks, and free files, respectively. For
contract file systems, /system/contract is the mount point, ctfs is the
contract file system (used by SMF) with 0 free blocks and
2147483582(INTMAX-1) free files. For object file systems, /sys‐
tem/object is the mount point, objfs is the object file system (see
objfs(7FS)) with 0 free blocks and 2147483511 free files.
Example 2 Writing Portable Information About the /usr File System
The following example writes portable information about the /usr file
system:
example% /usr/xpg4/bin/df -P /usr
Example 3 Writing Portable Information About the /usr/src file System
Assuming that /usr/src is part of the /usr file system, the following
example writes portable information :
example% /usr/xpg4/bin/df -P /usr/src
Example 4 Using df to Display Inode Usage
The following example displays inode usage on all ufs file systems:
example%/usr/bin/df -F ufs -o i
ENVIRONMENT VARIABLES
SYSV3
This variable is used to override the default behavior of df and
provide compatibility with INTERACTIVE UNIX System and SCO UNIX
installation scripts. As the SYSV3 variable is provided for compat‐
ibility purposes only, it should not be used in new scripts.
When set, any header which normally displays "files" will now display
"nodes". See environ(5) for descriptions of the following environment
variables that affect the execution of df: LANG, LC_ALL, LC_CTYPE,
LC_MESSAGES, and NLSPATH.
EXIT STATUS
The following exit values are returned:
0
Successful completion.
>0
An error occurred.
FILES
/dev/dsk/*
Disk devices
/etc/default/fs
Default local file system type. Default values can be set for the
following flags in /etc/default/fs. For example: LOCAL=ufs, where
LOCAL is the default partition for a command if no FSType is speci‐
fied.
/etc/mnttab
Mount table
/etc/vfstab
List of default parameters for each file system
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
/usr/bin/df
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcs │
└─────────────────────────────┴─────────────────────────────┘
/usr/xpg4/bin/df
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWxcu4 │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│Standard │See standards(5). │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOfind(1), df_ufs(1M), mount(1M), statvfs(2), default_fs(4), mnttab(4),
vfstab(4), attributes(5), environ(5), largefile(5), standards(5),
objfs(7FS)NOTES
If UFS logging is enabled on a file system, the disk space used for the
log is reflected in the df report. The log is allocated from free
blocks on the file system, and it is sized approximately 1 Mbyte per 1
Gbyte of file system, up to 256 Mbytes. The log size may be larger (up
to a maximum of 512 Mbytes) depending on the number of cylinder groups
present in the file system.
SunOS 5.11 30 Nov 2009 df(1M)