MAN page from Mandrake Other xdu-3.0-3.i386.rpm

XDU

Section: User Commands (1)
Updated: X11
Index

NAME

xdu - display the output of "du" in an X window

SYNOPSIS

du | xdu [options]

DESCRIPTION

Xduis a program for displaying a graphical tree of disk spaceutilization as reported by the UNIX utility "du". Theuser can navigate through the tree structure and changethe order of the displayed information. The windowis divided up into several columns, each of which is one leveldeeper in the directory hierarchy (from left to right). Boxesare drawn for each directory. The amount of vertical spaceoccupied by each box is directly proportional to the amount ofdisk space consumed by it and all of its children. The name ofeach directory and the amount of data are displayed providedthat there is enough space within its box. Any space at the"bottom" of a box not covered by its children to the rightrepresents the space consumed by files in that directory(as opposed to space from its children).

There are several command line options available. Equivalentresources (if any) are shown with each option.

+s: (.showsize: true)display sizes (the default).
-s: (.showsize: false)don't display sizes.
-c num: display num columns.
-a: (.order: alpha)sorts display alphabetically.
-ra: (.order: ralpha)sorts display reverse alphabetically.
-n: (.order: size)sorts display numerically (largest first).
-rn: (.order: rsize)sorts display reverse numerically (smallest first).
-fg color: (.foregound)determines the color of the text and lines.
-bg color: (.background)determines the color of the background.
-rv: reverse video (for monochrome displays)

In addition to these the usual toolkit options such as-rv, -font, -display, -geometry, are supported.

MOUSE ACTIONS

The user can move up or down the tree by clicking the left mouse ona directory box. If the left most box is selected, the display willmove up one level (assuming you are not already at the root). If anyother box is selected, it will be placed against the left edge of thewindow and the display will be rescaled appropriately.At any time the middle mouse will bring you back to the root.Clicking the right mouse will exit the program.

KEYSTROKES

Several keystroke commands are supported. Note that all sorting happensfrom the current root node down, so it is possible to sort one subtreedifferently than another by clicking into it, doing a sort, and goingback up to the parent.

1-9,0: sets the number of columns in the display (0 = 10).
a: alphabetical sort.
n: numerical sort (largest first).
f: first-in-first-out sort (this is the order thedata was read into the program).
l: last-in-first-out sort.
r: reverse sense of sort.
s: toggle size display.
h: display a popup help window.
i: display information about the current root node to standard out.The first line shows the path within the tree, the total sizefrom this node on down, and the precentage that total representsof all of the data given to xdu. Subsequent lines show thesize and name information for all children of this node in theorder they are currently sorted in. This allows tiny directoriesto be seen that otherwise could not be labled on the display,and also allows for cutting and pasting of the information.
/: goto the root.
q: (or Escape)exit the program.

ACTIONS

All mouse and keyboard events trigger actions so they can allbe rebound by translations to suit the individual. The actionfunctions are:

reset(): goes to the root node.
goto(): moves down into the directory currently under the mouse(and is thus probably only useful bound to a mouse button).
quit(): exits the program.
reorder(type): sorts the display from the current root node down according toone of: alpha, ralpha (reverse alphabetical), size (largest tosmallest), rsize (smallest to largest), first (as originally readin), last (opposite of original data), reverse (reverse whateversort mode is currently selected).
size(): toggles size display on/off
ncol(num): sets the number of columns to num.
info(): displays directory information as described in the KEYBOARD section.
help(): displays a popup help window.

As an example of rebinding these, you could put the followingin your resources file:

XDu*translations: #override\n\          <Key>X: reorder(reverse)\n\      <Btn3Down>: info()

to make the 'x' key reverse the current sort order and the rightmouse button print the directory information message.

RESOURCES

The following resources are supported with some sample values.

XDu*foreground:         yellowXDu*background:         blue4XDu*window.width:       600XDu*window.height:      480XDu*help*foreground:    greenXDu*help*background:    red4XDu.ncol:               5XDu.font:               -*-helvetica-bold-r-normal--14-*XDu.showsize:           FalseXDu.order:              size

EXAMPLE

cd /usr/src
du > /tmp/du.out
xdu -n /tmp/du.out

BUGS

On some machines keyboard input may not be accepted by xdu untilthe mouse is moved out of and back into the window. I have beentold that putting the following in your resources file may fixthis.

<window manager name>.FocusLenience: True

AUTHOR

Phillip C. Dykstra
<philAATTarl.army.mil>

This document was created byman2html,using the manual pages.

XDU