gdu - Man Page

• Interactively show the disk usage of the current directory: gdu
• Interactively show the disk usage of a given directory: gdu path/to/directory
• Interactively show the disk usage of all mounted disks: gdu --show-disks
• Interactively show the disk usage of the current directory but ignore some sub-directories: gdu --ignore-dirs path/to/directory1,path/to/directory2,...
• Ignore paths by regular expression: gdu --ignore-dirs-pattern '.*[abc]+'
• Ignore hidden directories: gdu --no-hidden
• Only print the result, do not enter interactive mode: gdu --non-interactive path/to/directory
• Do not show the progress in non-interactive mode (useful in scripts): gdu --no-progress path/to/directory

tldr.sh

gdu [flags] [directory_to_scan]

Pretty fast disk usage analyzer written in Go.

Gdu is intended primarily for SSD disks where it can fully utilize parallel processing. However HDDs work as well, but the performance gain is not so huge.

-h, --help[=false] help for gdu

-i, --ignore-dirs=[/proc,/dev,/sys,/run] Absolute paths to ignore (separated by comma)

-I,  --ignore-dirs-pattern

Absolute path patterns to ignore (separated by comma)

-X,  --ignore-from

Read absolute path patterns to ignore from file

-l, --log-file="/dev/null" Path to a logfile

-m,  --max-cores

Set max cores that GDU will use.

-c, --no-color[=false] Do not use colorized output

-x, --no-cross[=false] Do not cross filesystem boundaries

-H, --no-hidden[=false] Ignore hidden directories (beginning with dot)

-L, --follow-symlinks[=false] Follow symlinks for files, i.e. show the size of the file to which symlink points to (symlinks to directories are not followed)

-n, --non-interactive[=false] Do not run in interactive mode

-p, --no-progress[=false] Do not show progress in non-interactive mode

-u, --no-unicode[=false] Do not use Unicode symbols (for size bar)

-s, --summarize[=false] Show only a total in non-interactive mode

-d, --show-disks[=false] Show all mounted disks

-a, --show-apparent-size[=false] Show apparent size

-C, --show-item-count[=false] Show number of items in directory

-M, --show-mtime[=false] Show latest mtime of items in directory

--si[=false] Show sizes with decimal SI prefixes (kB, MB, GB) instead of binary prefixes (KiB, MiB, GiB)

--no-prefix[=false] Show sizes as raw numbers without any prefixes (SI or binary) in non-interactive mode

--no-mouse[=false] Do not use mouse

--no-delete[=false] Do not allow deletions

-f,  --input-file

Import analysis from JSON file. If the file is "-", read from standard input.

-o,  --output-file

Export all info into file as JSON. If the file is "-", write to standard output.

--config-file="$HOME/.gdu.yaml" Read config from file

--write-config[=false] Write current configuration to file (default is $HOME/.gdu.yaml)

-g, --const-gc[=false] Enable memory garbage collection during analysis with constant level set by GOGC

--enable-profiling[=false] Enable collection of profiling data and provide it on http://localhost:6060/debug/pprof/

--use-storage[=false] Use persistent key-value storage for analysis data (experimental)

-r, --read-from-storage[=false] Read analysis data from persistent key-value storage

-v, --version[=false] Print version

Files and directories may be prefixed by a one-character flag with following meaning:

!

An error occurred while reading this directory.

.

An error occurred while reading a subdirectory, size may be not correct.

@

File is symlink or socket.

H

Same file was already counted (hard link).

e

Directory is empty.