summaryrefslogtreecommitdiff
path: root/doc/ncdu.1
blob: 8a3d91c79b4a600964758c2d5c7f1285ae897ffe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
.TH NCDU 1 "May 2, 2009" "ncdu-git" "ncdu manual"

.SH NAME
\fBncdu \fP- NCurses Disk Usage

.SH SYNOPSIS
\fBncdu\fP [\fB-hqvx\fP] [\fB--exclude PATTERN\fP] [\fB-X FILE\fP] \fIdir\fP

.SH DESCRIPTION
\fBncdu\fP (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.

.SH OPTIONS
.TP
\fB-h\fP
Print a small help message
.TP
\fB-q\fP
Quiet mode. While calculating disk space, \fBncdu\fP 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.
.TP
\fB-v\fP
Print version.
.TP
\fB-x\fP
Only count files and directories on the same
filesystem as the specified \fIdir\fP.
.TP
\fB--exclude\fP PATTERN
Exclude files that match PATTERN. This argument can
be added multiple times to add more patterns.
.TP
\fB-X\fP FILE, \fB--exclude-from\fP FILE
Exclude files that match any pattern in FILE. Patterns
should be seperated by a newline.

.SH KEYS
.TP
\fB?\fP
Show help + keys + about screen
.TP
\fBup, down j, k\fP
Cycle through the items
.TP
\fBright, enter, l\fP
Open selected directory
.TP
\fBleft, <, h\fP
Go to parent directory
.TP
\fBn\fP
Order by filename (press again for descending order)
.TP
\fBs\fP
Order by filesize (press again for descending order)
.TP
\fBa\fP
Toggle between showing disk usage and showing apparent size.
.TP
\fBd\fP
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.
.TP
\fBt\fP
Toggle dirs before files when sorting.
.TP
\fBg\fP
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.
.TP
\fBe\fP
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.
.TP
\fBi\fP
Show information about the current selected item.
.TP
\fBr\fP
Refresh/recalculate the current directory.
.TP
\fBq\fP
Quit

.SH AUTHOR
Written by Yoran Heling <projects@yorhel.nl>.

.SH BUGS
Infinite. Please contact the author if you find one.

.SH SEE ALSO
\fBdu\fP(1)