summaryrefslogtreecommitdiff
path: root/doc/ncdu.1
blob: e7a7375e2731982eb4df369cca643ad9c0d9b24f (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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
.TH NCDU 1 "September 10, 2008" "ncdu-svn" "ncdu manual"
.SH NAME
\fBncdu \fP- NCurses Disk Usage
.SH SYNOPSIS
.nf
.fam C
\fBncdu\fP [\fB-hqvx\fP] [\fB--exclude PATTERN\fP] [\fB-X FILE\fP] \fIdir\fP
.fam T
.fi
.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.
.PP
For a more detailed explanation of \fBncdu\fP, please check
http://dev.yorhel.nl/ncdu/
.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
.B
?
Show help + keys + about screen
.TP
.B
up/down
Cycle through the items
.TP
.B
right/enter
Open selected directory
.TP
.B
left
Go to parent directory
.TP
.B
n
Order by filename (press again for descending order)
.TP
.B
s
Order by filesize (press again for descending order)
.TP
.B
a
Toggle between showing disk usage and showing apparent size.
.TP
.B
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.
.TP
.B
t
Toggle dirs before files when sorting.
.TP
.B
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.
.TP
.B
p
Use powers of 1000 instead of 1024, press again to switch back
.TP
.B
h
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
.B
i
Show information about the current selected item.
.TP
.B
r
Refresh/recalculate the current directory.
.TP
.B
q
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)