summaryrefslogtreecommitdiff
path: root/doc/ncdu.1
blob: 4f7836fa0b76b2cd55fd9325db20a189700b75db (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
118
119
120
121
122
123
124
125
126
127
128
129
130
." Text automatically generated by txt2man
.TH NCDU 1 "July 21, 2007" "ncdu-1.2" "ncdu manual"
.SH NAME
\fBncdu \fP- NCurses Disk Usage
.SH SYNOPSIS
.nf
.fam C
\fBncdu\fP [\fB-ahqvx\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
If \fIdir\fP is specified, \fBncdu\fP will automatically start
calculating the disk size. Otherwise, you will be prompted
with a small configuration window.
.PP
For a more detailed explanation of \fBncdu\fP, please check
http://dev.yorhel.nl/ncdu/
.SH OPTIONS
.TP
\fB-a\fP
Apparent sizes. Normally, \fBncdu\fP would calculate the
disk usage of each file, setting \fB-a\fP will tell \fBncdu\fP
to simply calculate the actual size of the files.
.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
.SS  SETTINGS WINDOW
.TP
.B
up/down/tab
Cycle through the form fields.
.TP
.B
Enter
Post form
.SS  CALCULATING WINDOW
.TP
.B
q
Quit
.SS  BROWSER
.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
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' 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
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)