Overview
du (disk usage) adds up the space used by files and by every folder below the ones you name, and prints one line per folder: a size, a tab and the path. The size is disk space in blocks, which is usually larger than the length of the data, because a file uses whole blocks. Use ls -l or wc -c for the exact number of bytes.
Background
The du utility and its -a and -s options first appeared in Version 1 AT&T UNIX, according to the macOS manual. Today the name covers GNU du, the du that macOS ships, and the du applet in BusyBox. They agree on -s, -k, -h, -c and -d; the default unit and a few options differ.
Examples
Show the total for a folder with -s (summary), in kilobyte units with -k; cut keeps only the path to show the shape of the line:
du -sk logs | cut -f2
Show sizes in a readable form, such as 4.0K or 1.2M, with -h:
du -sh logs | grep -c '^[0-9.]*[BKMGT]*[[:space:]]logs$'
Show every file as well as every folder with -a:
du -a logs | cut -f2
List only the first level of folders below here with -d 1:
du -d 1 . | cut -f2
Add a grand total with -c:
du -c notes.txt app.log | tail -n 1 | cut -f2
Check that the size and the path are separated by a tab and that the size is a number:
du -sk logs | grep -c '^[0-9][0-9]*[[:space:]]logs$'
Options
-s
Print only a total for each argument, not a line for every folder below it.
-h
Print sizes with a unit suffix such as K, M or G, chosen for each line.
-k
Print sizes in units of 1024 bytes. Without it the unit differs between systems.
-c
Print a grand total as the last line.
-d
Show lines only down to this many levels below the argument, as in -d 1. -d 0 is the same as -s.
Common mistakes
du reports space used on disk, so a 34-byte file shows as 4K on most systems and the number can change with the file system. The default unit is not the same everywhere (see Portability), so use -k or -h when you compare or script. A hard-linked file is counted once, in the first place du meets it. du -sh * skips names that start with a dot, and sorts by name, not by size; pipe du -sk * to sort -n to find the largest.
Portability
The Common examples use -s, -k, -h, -a, -c and -d. GNU also accepts --max-depth and -b for bytes; macOS has no -b. The default unit is 512-byte blocks on macOS and 1024-byte blocks on GNU, unless POSIXLY_CORRECT or BLOCKSIZE changes it. The Common examples were executed on GNU coreutils 9.11, macOS system tools, and BusyBox 1.37.0 (see the development guide for the exact check). Their output only shows the shape of a line, because the sizes depend on the file system.
About BusyBox du
BusyBox bundles du as an applet, and anything beyond the common options depends on how it was built. This page's examples ran on BusyBox 1.37.0.
BusyBox notes
BusyBox du supports -s, -k, -h, -a, -c and -d. The GNU long options depend on the build.
References
Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.