df(1M)


df (generic), dfspace -- report number of free disk blocks and files/free disk space

Synopsis

df [-F FSType] [-begiklntVP] [current_options] [-o specific_options]
[directory | special | resource. . .]

dfspace [-F FSType]

Description

The df command prints the allocation portions of the generic superblock for mounted or unmounted file systems, directories or mounted resources. directory represents a valid directory name. If directory is specified, df reports on the device that contains the directory. special represents a special device (for example, /dev/dsk/*f1, where ``*'' is implementation dependent). resource is a NFS resource name. If arguments to df are pathnames, df produces a report on the file system containing the named file.

The df command reports sizes in 512 byte blocks. It will report 2 blocks less free space, rather than 1 block, since the file uses one system block of 1-24 bytes.

The directory /etc/fscmd.d/TYPE contains programs for each filesystem type; df invokes the appropriate binary. /etc/fscmd.d is linked to /etc/fs.

current_options are options supported by the s5-specific module of df. Other FSTypes do not necessarily support these options. specific_options indicate suboptions specified in a comma-separated list of suboptions and/or keyword-attribute pairs for interpretation by the FSType-specific module of the command.

Command options

The generic options are:

-F
Specify the FSType on which to operate. This is only needed if the file system is unmounted. The FSType should be specified here or are determined from /etc/vfstab by matching the ``mount_point'', special, or resource with an entry in the table.

-b
Print only the number of kilobytes free.

-e
Print only the number of files free.

-g
Print the entire statvfs structure. Used only for mounted file systems. Cannot be used with current_options or with the -o option. This option overrides the -b, -e, -k, -n, and -t options. The numbers for available, total, and free blocks are reported in 512 byte blocks.

-i
Display the total number of inodes, the number of free inodes, the number of used inodes, and the percentage of inodes in use.

-k
Print allocation in kilobytes.

-l
Report on local file systems only. Used only for mounted file systems. Can not be used with current_options or with the -o option.

-n
Print only the FSType name. Invoked with no arguments this option prints a list of mounted file system types. Used only for mounted file systems. Can not be used with current_options or with the -o option.

-t
Causes total allocated block figures to be reported as well as number of free blocks.

-V
Echo the complete command line, but do not execute the command. The command line is generated by using the options and arguments provided by the user and adding to them information derived from /etc/mnttab or /etc/vfstab. This option should be used to verify and validate the command line.

-P
Format output to follow POSIX.2 standards. Does so by giving headings and information on devices and filesystems.

-o
Specify FSType-specific options.

-v
Reports percent of blocks used as well as the number of blocks used and free. The -v option cannot be used with other options.

If no arguments or options are specified, the free space on all local and remotely mounted file systems is printed.

dfspace is a shell script that uses the df command. dfspace reports the available disk space for all mounted file systems with the exception of pseudo file systems such as /proc. dfspace reports the free disk space in mega bytes and also as a percentage of total disk space.

Without arguments, dfspace reports the free disk space on all file systems.

The option for dfspace is:

-F FSType
find free disk space on FSType file system.

Files

/dev/dsk/*

/etc/mnttab
list of filesystems currently mounted

/etc/vfstab
list of default parameters for each file system

References

df_sfs(1M), df_s5(1M), df_ufs(1M), df_vxfs(1M), mnttab(4), mount(1M), statvfs(2), vfstab(4)

Notices

The -F option is intended for use with unmounted file systems, except for the bfs FSType. df -F bfs is not supported when /stand is not mounted.

This command may not be supported for all FSTypes.

If options -g or -n are used when there are remotely mounted resources, df will try to determine the remote resource's file system type. If it can be determined, df will print the file system type; otherwise, it will print unknown.

For NFS-mounted file systems, the df command may show -1 for one or more fields. This is due to an NFS protocol deficiency which will be addressed in a future release.

This command has been updated to handle files greater than 2GB.


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.