di(1) di(1) Name di - disk information Synopsis di [-Aahlnt] [-b block-size] [-d display-size] [-f format] [-i ignore- fstyp-list] [-I include-fstyp-list] [-s sort-type] [-w block-width] [-W inode-width] [-x level] [file(1,n) [...]] mi Description di Displays usage information on mounted filesystems. Block values are reported in(1,8) megabytes (1024k bytes) by default, but may be changed. If file(1,n) is specified, the usage information for the partition on which file(1,n) is located is printed. Unless the -a flag is specified, certain mounted filesystems will not normally be displayed. Filesystems that have a total block count of 0 will not be dis- played. Filesystems that have a mount(2,8) option of 'ignore' set(7,n,1 builtins) will not be displayed. Filesystems that are automounted, and are duplicates of an existing filesystem are not displayed. (May not work on all systems). mi Displays the mounted filesystem information. Several switches may be specified to control the output of di and mi: -A Print all fields (used for debugging). Mount points and special device names are printed at full width. The -a flag is set. -a Prints all mounted devices (normally, those with 0 total blocks are not printed - e.g. /dev/proc(5,n), /dev/fd). -b block-size Change the base block size from 1024 (default) to the size spec- ified. block-size may be one of: k - 1024 bytes, d - 1000 bytes, or a specific size. -d display-size Display the blocks in(1,8) units(1,7) specified by display-size. display- size may be one of: p - posix (512 bytes), k - kilobytes, m - megabytes, g - gigabytes, t - terabytes, P - petabytes, E - exabytes, Z - zettabytes, Y - yottabytes, h - Scaled alter- native 1, H - Scaled alternative 2, or a specific value to use as the block size. Block display sizes greater than 1024 bytes are displayed with a preci- sion of one decimal place after the radix. The Scaled alternatives scale the sizes displayed and appends a suffix (e.g. 48.0k, 3.4M). With scaled alternative 1, sizes within a line may scale to different units. Scaled alternative 2 scales all the sizes in(1,8) each individual line to the same unit size (the largest needed). -f format Use the specified format string(3,n) format. Format strings are described below. -g Display sizes in(1,8) gigabytes. An alias for -dg. -h Print out the usage for di -H Display partition sizes in(1,8) scaled alternative 2 format. An alias for -dH. -i ignore-fstype-list Ignore the file(1,n) system types listed in(1,8) ignore-fstyp-list. The list is a comma separated list of file(1,n) system types. e.g. -i nfs,rfs -I include-fstype-list Include only the file(1,n) system types listed in(1,8) include-fstyp-list. The list is a comma separated list of file(1,n) system types. e.g. -I nfs,rfs -k Display sizes in(1,8) Kbytes. An alias for -dk. -l Display only local file(1,n) systems. This option is not fully implemented for all systems as of version(1,3,5) 1.17. -m Display sizes in(1,8) megabytes. An alias for -dm. -n Do not print a header line above the list of file(1,n) systems. Use- ful when parsing the output of di. -s sort-type Use sort-type to sort(1,3) the output. The output of di is normally sorted by name. The output may be left unsorted (-s n command line switch(1,n)) i.e. as it appears in(1,8) the mount(2,8) table or may be sorted by the special device name (-s s command line switch(1,n)). If the -s r command line switch(1,n) is used, the sort(1,3) order will be reversed. If file(1,n) is specifed on the command line, no sorting is done. -t Print a totals line below the list of file(1,n) systems. Memory filesystems (tmpfs, memfs) are not added to the totals. -w block-width Set the print width for block values. Default is eight. -W inode-width Set the print width for inode values. Default is seven. -x level Set the program's debugging level to debug-level. Format strings The output of di may be specified via a format string. This string(3,n) may be given either via the -f command line switch(1,n) or by the DIFMT environ- ment variable. The format string(3,n) may specify the following columns: m Print the name of the mount(2,8) point. M Print the name of the mount(2,8) point, at full length. The mount(2,8) point is formatted to the maximum width necessary for the long- est mount(2,8) point name. b Print the total number of Kbytes on the file(1,n) system. See also the -d option. B Print the total number of Kbytes on the file(1,n) system available for use by normal users. See also the -d option. u Print the number of Kbytes in(1,8) use on the file(1,n) system (actual number of kbytes used = total - free). See also the -d option. c Print the number of Kbytes not available for use by normal users(1,5) (total - available). See also the -d option. f Print the number of free (unused) Kbytes on the file(1,n) system. See also the -d option. v Print the number of Kbytes available for use by normal users. See also the -d option. p Print the percentage of Kbytes not available for use by normal users(1,5) (number of kbytes not available for use / total disk space). See also the -d option. 1 Print the percentage of total Kbytes in(1,8) use (actual number of kbytes used / total disk space). See also the -d option. 2 Print the percentage of Kbytes in(1,8) use, BSD-style. Represents the percentage of user-available space in(1,8) use. Note that values over 100% are possible (actual number of kbytes used / disk space available to non-root users(1,5)). See also the -d option. i Print the total number of file(1,n) slots (inodes) that can be cre- ated on the file(1,n) system. U Print the number of file(1,n) slots in(1,8) use. F Print the number of file(1,n) slots available. P Print the percentage of file(1,n) slots in(1,8) use. s Print the file(1,n) system name (special device or remote mount(2,8) point). S Print the file(1,n) system name (special device or remote mount(2,8) point), at full length. The file(1,n) system name is formatted to the maximum width necessary for the longest file(1,n) system name. t Print the file(1,n) system type. T Print the file(1,n) system type at full length. The file(1,n) system type is formatted to the maximum width necessary for the longest file(1,n) system type. I Print the time(1,2,n) the filesystem was mounted. This column is not supported on all systems. O Print the filesystem mount(2,8) options. The default format string(3,n) for di is smbuvpT. The default format string(3,n) for mi is MSTIO. The format string(3,n) may also contain any other character not listed above. The character will be printed as is. e.g. di -f 'mbuvp|iUFP' will print the character '|' between the disk usage and the file(1,n) slot usage. The command sequence (Bourne Shell): di -f 'mbuvp miUFP' will print two lines of data for each filesystem. Examples Various df equivalent format strings for System V release 4 are: /usr/bin/df -v di -dp -f msbuf1 /usr/bin/df -k di -dk -f sbcvpm /usr/ucb/df di -dk -f sbuv2m If you like your numbers to add up/calculate the percentage correctly, try one of the following format strings: di -f SMbuf1T di -f SMbcvpT di -f SMBuv2T Environment Variables The DIFMT environment variable may be used to specify the default dis- play format string. The GNU df POSIXLY_CORRECT, and DF_BLOCK_SIZE and the BSD BLOCKSIZE environment variables are honored. Note For filesystems that do not report available blocks (e.g. System V release 3), the number of available blocks is considered to be the num- ber of free blocks. WARNING Do not replace your system's df command with this program. You will in(1,8) all likelihood break your installation procedures. See Also df(1), fstab(5), getmnt(2), getmntinfo(2), mnttab(4), mount(2,8)(1M) statfs(2), statvfs(2) Bugs Send bug reports to: di-bugs@gentoo.com Author This program is Copyright 1994-2002 by Brad Lanam. Brad Lanam, Walnut Creek, CA (bll@gentoo.com) 12 January 2003 di(1)