- NetBSD Manual Pages
DU(1) NetBSD General Commands Manual DU(1)
Powered by man-cgi (2021-03-02).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
du -- display disk usage statistics
du [-H | -L | -P] [-a | -d depth | -s] [-cghikmnrx] [file ...]
The du utility displays the file system usage for each file argument and
for each directory in the file hierarchy rooted in each directory argu-
ment. 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 pro-
-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 (Kilo-
byte), M (Megabyte), G (Gigabyte), T (Terabyte) and P (Petabyte).
-i Output inode usage instead of blocks. All "human-readable"
options are ignored.
-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
specified, 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)
-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 ref-
erence 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 fol-
lowed is not counted or displayed. The -H, -L and -P options override
each other and the command's actions are determined by the last one spec-
Files having multiple hard links are counted (and displayed) a single
time per du execution.
BLOCKSIZE If the environment variable BLOCKSIZE is set, and the -g, -h,
-k, and -m options are not specified, the block counts will be
displayed in units of that size block.
The du utility exits 0 on success, and >0 if an error occurs.
df(1), chflags(2), fts(3), getbsize(3), symlink(7), quot(8)
A du command appeared in Version 1 AT&T UNIX.
NetBSD 9.1 September 1, 2019 NetBSD 9.1