File: xdiskusage.1

package info (click to toggle)
xdiskusage 1.48-10.1
  • links: PTS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, sid, stretch, wheezy
  • size: 444 kB
  • ctags: 590
  • sloc: cpp: 5,910; sh: 152; makefile: 103
file content (186 lines) | stat: -rw-r--r-- 6,315 bytes parent folder | download | duplicates (2)
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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
.\"Man page for xdiskusage, by Bill Spitzak.
.TH xdiskusage 1 "4 Sep 2003"
.SH NAME
\fIxdiskusage\fR - Graphical display of disk usage
.SH SYNOPSIS
.B xdiskusage
[-a] [-d[isplay] host:n.n] [-g[eometry] WxH+X+Y]
[-t[itle] windowtitle] [-n[ame] classname] [-i[conic]]
[-fg color] [-bg color] [-bg2 color] [directory...] [file...]
.SH DESCRIPTION
.I xdiskusage
displays the output of "du" in an X window, allowing you to
compare visually the space occupied by files and directories.

.SH USAGE

Typing "xdiskusage dir" where "dir" is a folder causes "du" to be
run on that folder and the result displayed.  If the named file is
a symbolic link it is dereferenced before being sent to du. The "-a"
switch, if given, is passed to "du" to cause all files to be measured.

Typing "xdiskusage file" where "file" is not a folder makes
xdiskusage parse that file as though it was "du" output and display
the result.

You can type several file and folder names and get several display
windows.

If no files are named, you can pipe the output from another program to
xdiskusage. If stdin is not a terminal xdiskusage will parse it as "du"
output and display the result. For instance "du -k . | xdiskusage".

Typing just "xdiskusage" brings up the disk browser described here:

.SH DISK BROWSER

By default xdiskusage presents you with a list of all the disks
mounted on your system (it found these by running "df").  Click one of
these names and it will scan the entire disk (by running "du") and
present a graphical display of how much space all the files are taking
on that disk.

You can click on several disks (or on the same disk multiple times,
for instance if you have changed the files stored on it) and get
multiple display windows.

The "rescan" button reruns "df" to get a new list of disks.  You need
to do this if you mount or unmount a disk, or to see new usage
percentages.

The (C) button shows you the copyright and license.

You can type a filename into the input field on the bottom and type
Enter. If the name is a directory, xdiskusage will attempt to run "du"
on it and display the result. If the name is a file it is assumed to
be "du" output and it is parsed and displayed.

The "all files" button sends the -a switch to "du" causing it to list
the space for every file on the disk.  This can significantly increase
the time it takes to scan.

.SH DISPLAY

Each white box represents a folder.  It's size is equal to the sum
of all it's contents (all sub-folders and files).  To the right of
each box are stacked the boxes for the sub-folders (and files if
the "all files" switch was given).

If you selected a disk from the disk browser, some extra boxes are
added to show information learned from df:

  "(free)" is the free space reported by df.

  "(permission denied)" is space that df said was used but du did not
  report. Besides permission errors when running du, this may also be
  the result of a file deleted from its containing folder, but still
  in use by a program, so its space is not reclaimed yet. Mounted
  loopback filesystems (ISO image just checked before burning, then
  deleted while still mounted) are common examples.

  "(inodes)" is the difference between the total size of the disk and
  the used + available space reported by du, this is overhead used by
  the file system.

The left-most box is the "current root". One of the boxes is outlined
in red, this is the "current node".

Clicking on any box makes it the current node. The arrow keys can also
be used to navigate you around. Hitting return makes the current node
be the current root: putting it on the left edge and blowing it up to
the height of the window and scaling all it's contents the same. The
left arrow can be used to move the root and current node back up, or
you can type '/' to move just the root, leaving the current node where
it is.

To dismiss any window type Escape.

.SH MENU ITEMS

There is a pop-up menu on the right-hand mouse button.  Every item on
the menu has a keyboard shortcut.  The menu items are:

.B In (right arrow)
go to the first child of the current folder.

.B Next (down arrow)
go down to brother of current folder.

.B Previous (up arrow)
go up to the brother of current folder.

.B Out (left arrow)
go to parent of current folder.

.B Root out (slash)
move the root of the window up to it's parent.

.B Hide (h)
remove this node from the display and scale rest up to fit

.B Unhide (H)
Recursively turn off the hide flag from all children

.B Sort/Largest (s)
sort largest size at the top

.B Sort/Smallest (r)
sort smallest size at the top

.B Sort/Alphabetical (a)
sort in alphabetical order

.B Sort/Reverse Alphabetical (z)
sort in backwards alphabetical order

.B Sort/Unsorted (u)
sort in the order read from du.

.B Columns/2-11 (2-9,0,1)
arrange display to have N columns.

.B Copy to Clipboard (c)
the pathname of the current node is put in the X clipboard (you
can then paste it into a shell command).

.B Print (p)
The current display is printed.  The output is Encapsulated
PostScript.  It will either run it through lpr (or any command you
choose) or send it to a file.

.SH BUGS

Gets confused by "df" output on some platforms, requiring
platform-specific code.

.SH ACKNOWLEDGEMENTS

This program was inspired by, and the user interface design copied
from, the "xdu" program written by Phillip C. Dykstra.
<dykstra at ieee dot org> <phil at arl dot army dot mil>

Stephane Gourichon contributed many suggested improvements.
<stephane dot gourichon at lip6 dot fr>

.SH COPYRIGHT

Copyright (C) 2003 Bill Spitzak

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
USA.

.SH AUTHORS

Written by Bill Spitzak		spitzak at dee two dot com