2012-01-18 11:34:46 +01:00
|
|
|
.TH ncdu 1 "Nov 3, 2011" "ncdu-1.8" "ncdu manual"
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
B<ncdu> - NCurses Disk Usage
|
|
|
|
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
B<ncdu> [I<options>] I<dir>
|
|
|
|
|
|
|
|
|
|
|
|
=head1 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.
|
|
|
|
|
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
|
|
|
=item -h
|
|
|
|
|
|
|
|
Print a short help message.
|
|
|
|
|
|
|
|
=item -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 connections.
|
|
|
|
|
|
|
|
=item -r
|
|
|
|
|
2011-09-09 08:51:37 +02:00
|
|
|
Read-only mode. This will disable the built-in file deletion feature.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item -v
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Print version.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item -x
|
|
|
|
|
|
|
|
Only count files and directories on the same filesystem as the specified
|
|
|
|
I<dir>.
|
|
|
|
|
|
|
|
=item --exclude I<PATTERN>
|
|
|
|
|
|
|
|
Exclude files that match I<PATTERN>. This argument can be added multiple times
|
|
|
|
to add more patterns.
|
|
|
|
|
|
|
|
=item -X I<FILE>, --exclude-from I<FILE>
|
|
|
|
|
|
|
|
Exclude files that match any pattern in I<FILE>. Patterns should be separated
|
|
|
|
by a newline.
|
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
|
|
|
|
=head1 KEYS
|
|
|
|
|
|
|
|
=over
|
|
|
|
|
|
|
|
=item ?
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Show help + keys + about screen
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item up, down j, k
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Cycle through the items
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item right, enter, l
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Open selected directory
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item left, <, h
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Go to parent directory
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item n
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Order by filename (press again for descending order)
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item s
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Order by filesize (press again for descending order)
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item a
|
|
|
|
|
2007-08-05 10:23:18 +00:00
|
|
|
Toggle between showing disk usage and showing apparent size.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item 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.
|
|
|
|
|
|
|
|
=item t
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Toggle dirs before files when sorting.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item 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.
|
|
|
|
|
|
|
|
=item 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 correct, make sure you haven't
|
|
|
|
enabled this option.
|
|
|
|
|
|
|
|
=item i
|
|
|
|
|
2007-08-05 10:23:18 +00:00
|
|
|
Show information about the current selected item.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item r
|
|
|
|
|
2007-07-29 14:53:12 +00:00
|
|
|
Refresh/recalculate the current directory.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=item q
|
|
|
|
|
2007-07-20 11:15:46 +00:00
|
|
|
Quit
|
2009-04-05 15:23:16 +02:00
|
|
|
|
2012-01-18 11:34:46 +01:00
|
|
|
=back
|
|
|
|
|
|
|
|
|
|
|
|
=head1 HARD LINKS
|
|
|
|
|
2010-08-13 11:28:32 +02:00
|
|
|
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.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
2010-08-13 11:28:32 +02:00
|
|
|
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.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
2010-08-13 11:28:32 +02:00
|
|
|
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
|
|
|
|
interface 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.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
2012-01-18 11:42:33 +01:00
|
|
|
ncdu 1.7 and later 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
|
2010-08-13 11:28:32 +02:00
|
|
|
directory, as some inodes may still be accessible from hard links outside it.
|
2009-04-05 15:23:16 +02:00
|
|
|
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=head1 BUGS
|
|
|
|
|
2010-08-13 11:28:32 +02:00
|
|
|
Directory hard links are not supported. They will not be detected as being hard
|
|
|
|
links, and will thus be scanned and counted multiple times.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
2010-08-13 11:28:32 +02:00
|
|
|
Some minor glitches may appear when displaying filenames that contain multibyte
|
|
|
|
or multicolumn characters.
|
2012-01-18 11:34:46 +01:00
|
|
|
|
2010-08-13 11:28:32 +02:00
|
|
|
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
|
|
|
|
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=head1 AUTHOR
|
|
|
|
|
2010-08-13 11:28:32 +02:00
|
|
|
Written by Yoran Heling <projects@yorhel.nl>.
|
2009-04-05 15:23:16 +02:00
|
|
|
|
2012-01-18 11:34:46 +01:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
L<du(1)>
|