solaris - df (1)
NAME
df - report number of free disk blocks and files
SYNOPSIS
/usr/bin/df [ -F FSType ] [ -abegklntV ]
[ -o FSType-specific_options ]
[ directory | block_device | resource ... ]
/usr/xpg4/bin/df [ -F FSType ] [ -abegklnPtV ]
[ -o FSType-specific_options ]
[ directory | block_device | resource ... ]
AVAILABILITY
/usr/bin/df
SUNWcsu
/usr/xpg4/bin/df
SUNWxcu4
DESCRIPTION
The df command displays the amount of disk space occupied by
mounted or unmounted file systems, directories, or mounted
resources, the amount of used and available space, and how
much of the file system's total capacity has been used.
directory represents a valid directory name. If directory
is specified, df reports on the file system that contains
directory. block_device represents a block special device
(for example, /dev/dsk/c1d0s7); if block_device is speci-
fied, the corresponding file system need not be mounted.
resource is an NFS resource name.
Used without operands or options, df reports on all mounted
file systems.
OPTIONS
The following options are supported:
-a Report on all filesystems including ones
whose entries in /etc/mnttab (see mnttab(4))
have the ignore option set.
-b Print the total number of kilobytes free.
-e Print only the number of files free.
-F FSType Specify the FSType on which to operate.
This is only needed if the file system is
unmounted. The FSType should be specified
here or be determinable from /etc/vfstab (see
vfstab(4)) have the by matching the direc-
tory, block_device, or resource with an entry
in the table, or by consulting
/etc/default/fs. See default_fs(4).
-g Print the entire statvfs(2) structure. This
option is used only for mounted file systems.
It cannot be used with the -o option. This
option will override the -b, -e, -k, -n, -P,
and -t options.
-k Print 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 unpriviledged users,
and the percentage of normally available
space that is currently allocated to all
files on the file system. This option will
override the -b, -e, -n, and -t options.
-l Report on local file systems only. This
option is used only for mounted file systems.
It cannot be used with the -o option.
-n Print 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
Specify FSType-specific options. These
options are comma-separated, with no inter-
vening spaces. See the manual page for the
FSType-specific command for details.
-P Same as -k except in 512-byte units.
-t Print full listings with totals. This option
will override the -b, -e, and -n options.
-V Echo the complete set of file system specific
command lines, but do not execute them. The
command line is generated by using the
options and operands provided by the user and
adding to them information derived from
/etc/mnttab, /etc/vfstab, or /etc/default/fs.
This option may be used to verify and vali-
date the command line.
OPERANDS
The following operands are supported:
directory represents a valid directory name. df
reports on the file system that contains
directory.
block_device represents a block special device (for exam-
ple, /dev/dsk/c1d0s7); the corresponding file
system need not be mounted.
resource represents an NFS resource name.
EXAMPLES
The following example writes portable information about the
/usr file system:
example% /usr/xpg4/bin/df -P /usr
Assuming that /usr/src is part of the /usr file system, the
following will do the same as the previous example:
example% /usr/xpg4/bin/df -P /usr/src
ENVIRONMENT
See environ(5) for descriptions of the following environment
variables that affect the execution of df: 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
LOCAL: The default partition for a command
if no FSType is specified.
/etc/mnttab mount table
/etc/vfstab list of default parameters for each file sys-
tem
SEE ALSO
find(1), mount(1M), statvfs(2), default_fs(4), mnttab(4),
vfstab(4), environ(5)
Manual pages for the FSType-specific modules of df.
NOTES
The -F option is intended for use with unmounted file sys-
tems.
This command may not be supported for all FSTypes.