[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 2
df Command
Purpose
Reports information about space on file systems. This document
describes the AIX df command as well as the System V version of df.
Syntax
df [ [ -P ] | [ -I |
-M | -i | -t |
-v ] ] [ -k ] [ -m ] [ -g ]
[ -s ] [FileSystem ... | File... ]
Description
The df command displays information
about total space and available space on a file system. The FileSystem parameter specifies the name of the device on which the file
system resides, the directory on which the file system is mounted, or the
relative path name of a file system. The File parameter
specifies a file or a directory that is not a mount point. If the File parameter is specified, the df command displays
information for the file system on which the file or directory resides. If
you do not specify the FileSystem or File parameter, the df command displays information
for all currently mounted file systems. File system statistics are displayed
in units of 512-byte blocks by default.
The df command gets file system
space statistics from the statfs system call. However,
specifying the -s flag gets the statistics from the
virtual file system (VFS) specific file system helper. If you do not specify
arguments with the -s flag and the helper fails to get
the statistics, the statfs system call statistics are
used. Under certain exceptional conditions, such as when a file system is
being modified while the df command is running, the
statistics displayed by the df command might not be
accurate.
Note
Some remote file systems, such as the Network File
System (NFS), do not provide all the information that the df command needs. The df command prints blanks
for statistics that the server does not provide.
Flags
-g |
Displays statistics in units of GB blocks. The output
values for the file system statistics would be in floating point numbers as
value of each unit in bytes is significantly high. |
-i |
Displays the number of free and used i-nodes for the file system;
this output is the default when the specified file system is mounted. |
-I |
Displays information on the total number of blocks, the used space,
the free space, the percentage of used space, and the mount point for the
file system. |
-k |
Displays statistics in units of 1024-byte blocks. |
-m |
Displays statistics in units of MB blocks. The output
values for the file system statistics would be in floating point numbers as
value of each unit in bytes is significantly high. |
-M |
Displays the mount point information for the file system in the second
column. |
-P |
Displays information on the file system in POSIX portable format.
When the -P flag is specified, the header line appears
similar to:
Filesystem 512-blocks Used Available Capacity Mounted on\n
If the -k, -m or -g flag is specified in addition to the -P flag, the column heading 512-blocks is replaced by the respective
units, depending on which of these flags is used with the -P flag.
File system statistics are displayed on one line in the
following order:
FileSystem, TotalSpace, UsedSpace,
FreeSpace, UsedPercentage, MountPoint |
-s |
Gets file system statistics from the VFS specific file system helper
instead of the statfs system call. Any arguments given
when using the -s flag must be a JFS or Enhanced JFS
filesystem mount point or device. The filesystem must also be listed in /etc/filesystems. |
-t |
Includes figures for total allocated space in the output. |
-v |
Displays all information for the specified file system. |
The values of the output parameters with the flags -m and -g would be rounded off to nearest second
decimal digit. If all or any two of the -k, -m and -g flags are specified, the last one specified
takes effect.
Exit Status
This command returns the following exit values:
0 |
Successful completion. |
>0 |
An error occurred. |
Examples
- To display information about all mounted file systems, enter:
df
If your system has the /, /usr, /site, and /usr/venus file
systems mounted, the output from the df command resembles
the following:
Filesystem 512-blocks Free %Used Iused %Iused Mounted on
/dev/hd0 19368 9976 48% 4714 5% /
/dev/hd1 24212 4808 80% 5031 19% /usr
/dev/hd2 9744 9352 4% 1900 4% /site
/dev/hd3 3868 3856 0% 986 0% /usr/venus
- To display information about /test file system in 1024-byte blocks, enter:
df -k /test
Filesystem 1024 blocks Free %Used Iused %Iused Mounted on
/dev/lv11 16384 15824 4% 18 1% /tmp/ravi1
This displays the file system statistics in 1024-byte disk blocks.
- To display information about /test file system in MB blocks, enter:
df -m /test
Filesystem MB blocks Free %Used Iused %Iused Mounted on
/dev/lv11 16.00 15.46 4% 18 1% /tmp/ravi1
This
displays file system statistics in MB disk blocks rounded off to nearest
2nd decimal digit.
- To display information about the /test file system
in GB blocks, enter:
df -g /test
Filesystem GB blocks Free %Used Iused %Iused Mounted on
/dev/lv11 0.02 0.02 0% 18 1% /tmp/ravi1
This displays file system statistics in GB disk blocks rounded off to nearest
2nd decimal digit.
- To display available space on the file system in which your current directory
resides, enter:
cd/
df .
The output from this command resembles the following:
Device 512-blocks free %used iused %iused Mounted on
/dev/hd4 19368 9976 48% 4714 5% /
Files
/etc/filesystems |
Lists the known file systems and defines their characteristics. |
/etc/vfs |
Contains descriptions of virtual file system types. |
Related Information
The fsck command.
The filesystems file.
The File Systems Overview
for System Management in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices explains file system types,
management, structure, and maintenance.
The Mounting Overview in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices explains
mounting files and directories, mount points, and automatic mounts.
System V df Command
Purpose
Reports number of free disk blocks and files.
Syntax
/usr/sysv/bin/df [ -a ] [ -l ] [ [ [ -e ]
[-g ] [ -n ] ] | [ [ -i ] [ -v ]
] | -t ] ] [FileSystem ...] [File ...]
Description
The df command displays information about total space
and available space on a file system. File system statistics are displayed
in units of 512-byte blocks
Flags
-a |
Performs the default operation and prints the mount
point, the device name, number of free blocks and number of used inodes (files). |
-e |
Print only the number of free files. |
-g |
Print the entire statvfs structure.
This option overrides the -a , -e, -i, -n, -t and -v options. The numbers for available, total, and free blocks
are reported in 512 byte blocks. |
-i |
Displays the total number of inodes, the number of free
inodes, the number of used inodes, and the percentage of inodes in use. |
-l |
Reports on local file systems only. |
-n |
Prints the type of filesystem. |
-t |
Causes total allocated block figures to be reported. |
-v |
Reports percent of blocks used as well as the number
of blocks used and free. |
Parameters
File |
The File parameter specifies
a file or a directory that is not a mount point. If the File parameter is specified, the df command displays
information for the file system on which the file or directory resides. |
FileSystem |
The FileSystem parameter specifies
the name of the device on which the file system resides, the directory on
which the file system is mounted, or the relative path name of a file system. |
Note
If the FileSystem or File parameter is not specified, the df command
displays information for all currently mounted file systems.
Exit Status
- 0
- The command completed successfully
- >0
- An error occurred.
Examples
- To display information about all mounted file systems, enter:
/usr/sysv/bin/df
The output looks similar to the following:
/ (/dev/hd4 ): 19656 blocks 1504 files
/usr (/dev/hd2 ): 1139904 blocks 20254 files
/var (/dev/hd9var ): 23096 blocks 512 files
/tmp (/dev/hd3 ): 2464 blocks 204 files
/home (/dev/hd1 ): 44208 blocks 146 files
/proc (/proc ): 0 blocks 0 files
/opt (/dev/hd10opt ): 13880 blocks 310 files
- To display information about the file system in which your current directory
resides, enter:
/usr/sysv/bin/df .
- To display the total number of inode, the number of free inodes and the
number of available inodes in all mounted file systems, enter:
/usr/sysv/bin/df -i
The output looks similar to the following:
Mount Dir Filesystem iused avail itotal %iused
/ /dev/hd4 1504 6688 8192 19%
/usr /dev/hd2 20254 127202 147456 14%
/var /dev/hd9var 512 3584 4096 13%
/tmp /dev/hd3 204 5940 6144 4%
/home /dev/hd1 146 14190 14336 2%
/proc /proc 0 0 0 0
/opt /dev/hd10opt 310 5834 6144 6%
- To display the total number of blocks , the number of used blocks and
the number of free blocks on a the /tmp file system,
enter:
/usr/sysv/bin/df -v /tmp
- To display the type of filesystem, enter:
/usr/sysv/bin/df -n
- To display inode information on all local filesystems, enter:
/usr/sysv/bin/df -i -l
- To display the statvfs structure information on all the filesystems, enter:
/usr/sysv/bin/df -g
- To display the number of free files on filesystems, enter:
/usr/sysv/bin/df -e
Files
/usr/sysv/bin/df |
Contains the System V df command. |
/etc/filesystems |
Contains filesystem information. |
Related Information
The /usr/bin/df command.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]