df(1) df(1)
NAME
df - report number of free disk blocks and files (disk free)
SYNOPSIS
df [option ...] [file ...]
DESCRIPTION
df can be used to display how many free disk blocks and inodes are
available on mounted or unmounted local file systems and on file sys-
tems mounted via NFS.
OPTIONS
No option specified:
df prints the number of free blocks and inodes in all mounted or
all specified file systems. Disk space is given out in 512 byte
blocks.
-F FSType
FSType is the type of file system on which to operate. This
option is only needed if the file system is unmounted.
FSType can be any of the following:
hs High Sierra file system
fdfs Pseudo file system for administering file descriptors
nfs File system mounted from a remote system (Network File
System)
proc Pseudo file system for accessing process data
ufs UNIX System V Release 4 file system
vxfs Veritas file system (default)
-b Prints the free disk space (in Kbytes). This option cannot be
combined with -o.
-e Prints the number of free inodes. This option cannot be combined
with -o, and it overrides the -l option.
-g Prints the entire statvfs structure for all mounted file systems
or for FSType or file. The output consists of 4 lines containing
the following information:
dir Name of the directory on which the file system
is mounted (the string dir does not appear in
the output)
device Associated special file (the string device does
not appear in the output)
Page 1 Reliant UNIX 5.44 Printed 11/98
df(1) df(1)
block size Block size of the file system
frag size Fragment size of the file system in units of 512
bytes
total blocks Total number of blocks in units of 512 bytes
free blocks Total number of free blocks in units of 512
bytes
available Number of free blocks for non-privileged users
in units of 512 bytes
total files Total number of inodes
free files Number of free inodes
filesys id File system identification number
name File system designation (the string name does
not appear in the output)
fstype File system type
flag File system flags
filename length Maximum length of file names
This option cannot be combined with -o, and it overrides options
-b, -e, -k, -l, -n and -v.
-k Prints the following information in columns for all mounted file
systems or for the specified file systems:
filesystem Special file associated with the file system
kbytes Total disk space, in Kbytes
used Used disk space, in Kbytes
avail Available disk space, in Kbytes
capacity Percentage of disk space used
mounted on Name of the directory on which the file system
is mounted
Note: The avail figure allows for the space available only for
the nonprivileged user.
This option cannot be combined with -o, and it overrides options
-b, -e, -l, -n and -v.
Page 2 Reliant UNIX 5.44 Printed 11/98
df(1) df(1)
-l df prints the number of free blocks and inodes for all locally
mounted file systems or for the specified file systems. The -l
option is set by default. It cannot be combined with -e or -o.
-n df prints the file system type name. This option cannot be com-
bined with -g, -k, -v or -t. If you combine -n with -o or -F, an
error message is printed.
-P df generates a portable format that can be incorporated into
automatic procedures (e.g. shell scripts). The following informa-
tion is printed in columns for all mounted file systems or for
the specified file systems:
Filesystem Special file associated with the file system
512-blocks or
1024-blocks Total disk space
Used Used disk space
Available Free disk space
Capacity Percentage of disk space used
Mounted on Name of the directory on which the file system
is mounted
Note: The Available figure allows for the space available only
for the nonprivileged user.
-t df prints the number of free blocks and files as well as the
total number of available blocks and files for each mounted or
specified file system.
-t overrides the -b option.
-V df expands the df command line and writes the completed command
to standard output, but does not execute the command. df com-
pletes the command line, adding information derived from
/etc/mnttab and /etc/vfstab to input provided by the user.
The added information relates to the option -F FSType and/or the
associated special file, depending on which of the two com-
ponents, if either, was specified on the command line.
If you enter df -V without other options and arguments, you will
be shown a list of df command lines indicating all mounted file
system types and the associated special filenames.
-v df prints the following information in columns for all mounted
file systems or for the specified file systems:
Page 3 Reliant UNIX 5.44 Printed 11/98
df(1) df(1)
Mount Dir Name of the directory on which the file system
is mounted
Filesystem Special file associated with the file system
blocks Total disk space, in 512-byte blocks
used Used disk space, in 512-byte blocks
free Free disk space, in 512-byte blocks
%used Percentage of disk space used
This option cannot be combined with -o, and it overrides options
-b, -e, -k, -l and -n.
-o specoption
There are specific options for the file system types ufs and
vxfs:
-o ufsoption
If the file system type is ufs, you can use a ufs-specific
option:
i df prints the following information in columns:
Filesystem Name of the associated special file
iused Number of used inodes
ifree Number of free inodes
%iused Percentage of inodes used
Mounted on Name of the directory on which the
file system is mounted
The only options with which -o i can be combined meaning-
fully are -F and -t.
-o vxfsoption
If the file system type is vxfs, you can use a vxfs-specific
option:
s Outputs the number of free memory areas of each size.
The lengths of free memory areas are always specified
in exponents of 2. The minimum length is one block, and
the maximum length cannot be greater than one assign-
ment unit.
The only options with which -o s can be combined meaning-
fully are -F and -t.
Page 4 Reliant UNIX 5.44 Printed 11/98
df(1) df(1)
-- If file begins with a dash (-), the end of the command-line
options must be marked with --.
file file is either the name of a file or a directory, or the name of
a special file containing a file system. When you specify a file
or a directory, df refers to the file system in which the file or
directory is contained. You can specify a number of names.
file not specified:
df examines all locally and remotely mounted file systems or all
file systems of type FSType.
ERROR MESSAGES
ufs usage: df [-F ufs] [genericoptions] [-o i] [directory|special]
ufs usage: df [-F vxfs] [genericoptions] [-o s] [directory|special]
An invalid argument was specified for ufsoption or vxfsoption with
the -o option. ufsoption can only be i, vxfsoption can only be s.
df: operation not applicable for FStype xxx
An unapplicable file system type (xxx) was specified for FStype with
df -F FStype -o i|s. The only types that can be specified with the -o
option are ufs or vxfs.
df: cannot stat file
Non-existent or invalid file (special file or directory).
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed. If LCMESSAGES is undefined or is defined
as the null string, it defaults to the value of LANG. If LANG is like-
wise undefined or null, the system acts as if it were not internation-
alized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
EXAMPLES
Example 1
Printing the associated file system types for all user directories:
$ df -n /h*
/home : ufs
/home2 : ufs
/home3 : ufs
Page 5 Reliant UNIX 5.44 Printed 11/98
df(1) df(1)
Example 2
The entire statvfs structure is to be output for the /stand file sys-
tem:
$ df -g /stand
/ (/dev/root ): 16384 block size 2048 frag size
139356 total blocks 83736 free blocks 69800 available
16384 total files 12812 free files 1048576 filesys id
ufs fstype 0x00000004 flag 255 filename length
FILES
/dev/iosn/*
Special files associated with the file systems
/etc/mnttab
Table of mounted file systems
/etc/vfstab
List of default parameters for each file system
/etc/fs/FSType/*
Commands for specific file system types
SEE ALSO
df(1-ucb), df(1-ufs), df(1-vxfs), du(1), statvfs(2).
Specific online call for a df manual page e.g. "man 1-ufs df".
Page 6 Reliant UNIX 5.44 Printed 11/98