133 lines
5.2 KiB
Text
133 lines
5.2 KiB
Text
ncdu(1) ncdu manual ncdu(1)
|
||
|
||
|
||
|
||
NAME
|
||
ncdu - NCurses Disk Usage
|
||
|
||
|
||
SYNOPSIS
|
||
ncdu [-hqvx] [--exclude PATTERN] [-X FILE] dir
|
||
|
||
|
||
DESCRIPTION
|
||
ncdu (NCurses Disk Usage) is a curses-based version of the well-known 'du', and
|
||
provides a fast way to see what directories are using your disk space.
|
||
|
||
|
||
OPTIONS
|
||
-h Print a small help message
|
||
|
||
-q Quiet mode. While calculating disk space, ncdu will update the screen 10
|
||
times a second by default, this will be decreased to once every 2 seconds
|
||
in quiet mode. Use this feature to save bandwidth over remote connec‐
|
||
tions.
|
||
|
||
-r Read-only mode. This will disable the built-in file deletion feature.
|
||
|
||
-v Print version.
|
||
|
||
-x Only count files and directories on the same filesystem as the specified
|
||
dir.
|
||
|
||
--exclude PATTERN
|
||
Exclude files that match PATTERN. This argument can be added multiple
|
||
times to add more patterns.
|
||
|
||
-X FILE, --exclude-from FILE
|
||
Exclude files that match any pattern in FILE. Patterns should be sepa‐
|
||
rated by a newline.
|
||
|
||
|
||
KEYS
|
||
? Show help + keys + about screen
|
||
|
||
up, down j, k
|
||
Cycle through the items
|
||
|
||
right, enter, l
|
||
Open selected directory
|
||
|
||
left, <, h
|
||
Go to parent directory
|
||
|
||
n Order by filename (press again for descending order)
|
||
|
||
s Order by filesize (press again for descending order)
|
||
|
||
a Toggle between showing disk usage and showing apparent size.
|
||
|
||
d Delete the selected file or directory. An error message will be shown
|
||
when the contents of the directory do not match or do not exist anymore
|
||
on the filesystem.
|
||
|
||
t Toggle dirs before files when sorting.
|
||
|
||
g Toggle between showing percentage, graph, both, or none. Percentage is
|
||
relative to the size of the current directory, graph is relative to the
|
||
largest item in the current directory.
|
||
|
||
e Show/hide 'hidden' or 'excluded' files and directories. Please note that
|
||
even though you can't see the hidden files and directories, they are
|
||
still there and they are still included in the directory sizes. If you
|
||
suspect that the totals shown at the bottom of the screen are not cor‐
|
||
rect, make sure you haven't enabled this option.
|
||
|
||
i Show information about the current selected item.
|
||
|
||
r Refresh/recalculate the current directory.
|
||
|
||
q Quit
|
||
|
||
|
||
HARD LINKS
|
||
Every disk usage analysis utility has its own way of (not) counting hard links.
|
||
There does not seem to be any universally agreed method of handling hard links,
|
||
and it is even inconsistent among different versions of ncdu. This section
|
||
explains what each version of ncdu does.
|
||
|
||
ncdu 1.5 and below does not support any hard link detection at all: each link is
|
||
considered a separate inode and its size is counted for every link. This means
|
||
that the displayed directory sizes are incorrect when analyzing directories
|
||
which contain hard links.
|
||
|
||
ncdu 1.6 has basic hard link detection: When a link to a previously encountered
|
||
inode is detected, the link is considered to have a file size of zero bytes.
|
||
Its size is not counted again, and the link is indicated in the browser inter‐
|
||
face with a 'H' mark. The displayed directory sizes are only correct when all
|
||
links to an inode reside within that directory. When this is not the case, the
|
||
sizes may or may not be correct, depending on which links were considered as
|
||
"duplicate" and which as "original". The indicated size of the topmost directory
|
||
(that is, the one specified on the command line upon starting ncdu) is always
|
||
correct.
|
||
|
||
ncdu 1.7 has improved hard link detection. Each file that has more than two
|
||
links has the "H" mark visible in the browser interface. Each hard link is
|
||
counted exactly once for every directory it appears in. The indicated size of
|
||
each directory is therefore, correctly, the sum of the sizes of all unique
|
||
inodes that can be found in that directory. Note, however, that this may not
|
||
always be same as the space that will be reclaimed after deleting the directory,
|
||
as some inodes may still be accessible from hard links outside it.
|
||
|
||
|
||
BUGS
|
||
Directory hard links are not supported. They will not be detected as being hard
|
||
links, and will thus be scanned and counted multiple times.
|
||
|
||
Some minor glitches may appear when displaying filenames that contain multibyte
|
||
or multicolumn characters.
|
||
|
||
Please report any other bugs you may find at the bug tracker, which can be found
|
||
on the web site at http://dev.yorhel.nl/ncdu
|
||
|
||
|
||
AUTHOR
|
||
Written by Yoran Heling <projects@yorhel.nl>.
|
||
|
||
|
||
SEE ALSO
|
||
du(1)
|
||
|
||
|
||
|
||
ncdu-1.8 Nov 3, 2011 ncdu(1)
|