NAME
df_hfs: df — report number of free CDFS, HFS, or NFS file system disk blocks
SYNOPSIS
/usr/bin/df
[-F
FStype]
[-befgiklntv]
[-B]
[-o
specific_options]
[-V]
[special|directory]...
DESCRIPTION
The
df
command displays the number of free 512-byte blocks and free inodes
available for file systems
by examining the counts kept in the superblock or superblocks.
If a
special
or a
directory
is not specified,
the free space on all mounted file systems is displayed.
If the arguments to
df
are path names,
df
reports on the file systems containing the named files.
If the argument to
df
is a
special
of an unmounted file system,
the free space in the unmounted file system is displayed.
Options
df
recognizes the following options:
- -b
Report only the number of kilobytes (KB) free.
- -B
Report the total number of blocks allocated for swapping to the file system
as well as the number of blocks free for swapping to the file system.
This option is supported on HFS file systems only.
- -e
Report the number of files free.
- -f
Report only the actual count of the blocks in the free list
(free inodes are not reported).
When this option is specified,
df
reports on raw devices.
- -F FStype
Report only on the
FStype
file system type (see
fstyp(1M)).
For the purposes of this manpage,
FStype
can be one of
cdfs,
hfs,
and
nfs,
for the CDFS, HFS, and NFS file systems, respectively.
- -g
Report the entire structure described in
statvfs(2).
- -i
Report the total number of inodes,
the number of free inodes,
number of used inodes,
and the percentage of inodes in use.
- -k
Report the allocation in kilobytes (KB).
- -l
Report on local file systems only.
- -n
Report the file system name.
If used with no other options,
display a list of mounted file system types.
- -o specific_options
Specify options specific to the HFS file system type.
specific_options
is a comma-separated list of suboptions.
The available suboption is:
- i
Report the number of used and free inodes.
- -t
Report the total allocated block figures and the number of free blocks.
- -v
Report the percentage of blocks used,
the number of blocks used,
and the number of blocks free.
This option cannot be used with other options.
- -V
Echo the completed command line, but perform no other action.
The command line is generated
by incorporating the user-specified options
and other information derived from
/etc/fstab.
This option allows the user to verify the command line.
When
df
is used on an HFS file system,
the file space reported is the space available to the ordinary user,
and does not include the reserved file space specified by
fs_minfree.
Unreported reserved blocks are available only to users who have
appropriate privileges.
See
tunefs(1M)
for information about
fs_minfree.
When
df
is used on NFS file systems,
the number of inodes is displayed as -1 .
This is due to superuser access restrictions over NFS.
EXAMPLES
Report the number of free disk blocks for all mounted file systems:
Report the number of free disk blocks for all mounted HFS file systems:
Report the number of free files for all mounted NFS file systems:
Report the total allocated block figures and the number of free blocks,
for all mounted file systems:
Report the total allocated block figures and the number of free blocks,
for the file system mounted as
/usr:
WARNINGS
df
does not account for:
Disk space reserved for swap space,
Space used for the HFS boot block (8K bytes, 1 per file system),
HFS superblocks (8K bytes each, 1 per disk cylinder),
HFS cylinder group blocks (1K-8K bytes each, 1 per cylinder group),
Inodes (currently 128 bytes reserved for each inode).
Non-HFS file systems may have other items
that this command does not account for.
The
-b
option, from prior releases, has been replaced by the
-B
option.
FILES
- /dev/dsk/*
File system devices.
- /etc/fstab
Static information about the file systems
- /etc/mnttab
Mounted file system table
STANDARDS CONFORMANCE
df: SVID2, XPG2, XPG3