[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    df(1M) manual page Table of Contents

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 specified, 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 directory, 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 cannot be used with the -o option.
-o FSType-specific_options
Specify FSType-specific options. These options are comma-separated, with no intervening 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 validate 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 example, /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:
  1. 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 system

    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 systems.

    This command may not be supported for all FSTypes.

    Table of Contents