du(1) [opendarwin man page]
DU(1) BSD General Commands Manual DU(1) NAME
du -- display disk usage statistics SYNOPSIS
du [-H | -L | -P] [-I mask] [-a | -s | -d depth] [-c] [-h | -k] [-x] [file ...] DESCRIPTION
The du utility displays the file system block usage for each file argument and for each directory in the file hierarchy rooted in each direc- tory argument. If no file is specified, the block usage of the hierarchy rooted in the current directory is displayed. If the -k flag is specified, the number of 1024-byte blocks used by the file is displayed, otherwise getbsize(3) is used to determine the preferred block size. Partial numbers of blocks are rounded up. The options are as follows: -H Symbolic links on the command line are followed, symbolic links in file hierarchies are not followed. -L Symbolic links on the command line and in file hierarchies are followed. -I mask Ignore files and directories matching the specified mask. -P No symbolic links are followed. This is the default. -a Display an entry for each file in a file hierarchy. -h "Human-readable" output. Use unit suffixes: Byte, Kilobyte, Megabyte, Gigabyte, Terabyte and Petabyte -r Generate messages about directories that cannot be read, files that cannot be opened, and so on. This is the default case. This option exists solely for conformance with X/Open Portability Guide Issue 4 (``XPG4''). -s Display an entry for each specified file. (Equivalent to -d 0) -d depth Display an entry for all files and directories depth directories deep. -c Display a grand total. -k Display block counts in 1024-byte (1-Kbyte) blocks. -x File system mount points are not traversed. The du utility counts the storage used by symbolic links and not the files they reference unless the -H or -L option is specified. If either the -H or -L options are specified, storage used by any symbolic links which are followed is not counted or displayed. Files having multiple hard links are counted (and displayed) a single time per du execution. ENVIRONMENT
BLOCKSIZE If the environment variable BLOCKSIZE is set, and the -k option is not specified, the block counts will be displayed in units of that size block. If BLOCKSIZE is not set, and the -k option is not specified, the block counts will be displayed in 512-byte blocks. SEE ALSO
df(1), fts(3), symlink(7), quot(8) HISTORY
A du command appeared in Version 1 AT&T UNIX. BSD
April 1, 1994 BSD
Check Out this Related Man Page
DU(1) BSD General Commands Manual DU(1) NAME
du -- display disk usage statistics SYNOPSIS
du [-H | -L | -P] [-a | -d depth | -s] [-cghkmnrx] [file ...] DESCRIPTION
The du utility displays the file system block usage for each file argument and for each directory in the file hierarchy rooted in each direc- tory argument. If no file is specified, the block usage of the hierarchy rooted in the current directory is displayed. The options are as follows: -H Symbolic links on the command line are followed. (Symbolic links encountered in the tree traversal are not followed.) -L All symbolic links are followed. -P No symbolic links are followed. -a Display an entry for each file in the file hierarchy. -c Display the grand total after all the arguments have been processed. -d Display an entry files and directories depth directories deep. -g If the -g flag is specified, the number displayed is the number of gigabyte (1024*1024*1024 bytes) blocks. -h If the -h flag is specified, the numbers will be displayed in "human-readable" format. Use unit suffixes: B (Byte), K (Kilobyte), M (Megabyte), G (Gigabyte), T (Terabyte) and P (Petabyte). -k By default, du displays the number of blocks as returned by the stat(2) system call, i.e. 512-byte blocks. If the -k flag is speci- fied, the number displayed is the number of kilobyte (1024 bytes) blocks. Partial numbers of blocks are rounded up. -m If the -m flag is specified, the number displayed is the number of megabyte (1024*1024 bytes) blocks. -n Ignore files and directories with user "nodump" flag (UF_NODUMP) set. -r Generate warning messages about directories that cannot be read. This is the default behaviour. -s Display only the grand total for the specified files. -x Filesystem mount points are not traversed. du counts the storage used by symbolic links and not the files they reference unless the -H or -L option is specified. If either the -H or -L options are specified, storage used by any symbolic links which are followed is not counted or displayed. The -H, -L and -P options over- ride each other and the command's actions are determined by the last one specified. Files having multiple hard links are counted (and displayed) a single time per du execution. ENVIRONMENT
BLOCKSIZE If the environment variable BLOCKSIZE is set, and the -g, -h, -k, and -m options are not specified, the block counts will be dis- played in units of that size block. SEE ALSO
df(1), chflags(2), fts(3), getbsize(3), symlink(7), quot(8) HISTORY
A du command appeared in Version 6 AT&T UNIX. BSD
September 24, 2006 BSD