NAME

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

SYNOPSIS

       du | xdu [options]

DESCRIPTION

       Xdu  is  a  program  for  displaying  a  graphical tree of disk space utilization as reported by the UNIX
       utility "du".  The user can navigate through the tree structure and change the  order  of  the  displayed
       information.   The  window  is  divided up into several columns, each of which is one level deeper in the
       directory hierarchy (from left to right).  Boxes are drawn for each directory.  The  amount  of  vertical
       space occupied by each box is directly proportional to the amount of disk space consumed by it and all of
       its  children.   The  name  of each directory and the amount of data are displayed provided that there is
       enough space within its box.  Any space at the "bottom" of a box not covered by its children to the right
       represents the space consumed by files in that directory (as opposed to space from its children).

       There are several command line options available.  Equivalent resources (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 on a directory box.  If the left most
       box is selected, the display will move up one level (assuming you are not already at the root).   If  any
       other  box  is  selected,  it  will be placed against the left edge of the window 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 happens from the current root node down,
       so  it  is  possible  to sort one subtree differently than another by clicking into it, doing a sort, and
       going back 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 the data 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 size from this node on down, and the precentage that total represents
              of all of the data given to xdu.  Subsequent lines show the size  and  name  information  for  all
              children  of this node in the order they are currently sorted in.  This allows tiny directories to
              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 all be rebound  by  translations  to  suit  the
       individual.  The action functions 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 to one of: alpha, ralpha (reverse
              alphabetical), size (largest to smallest), rsize (smallest to largest), first (as originally  read
              in), last (opposite of original data), reverse (reverse whatever sort 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 following in 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 right mouse button print the directory
       information message.

RESOURCES

       The following resources are supported with some sample values.

       XDu*foreground:          yellow
       XDu*background:          blue4
       XDu*window.width:   600
       XDu*window.height:  480
       XDu*help*foreground:     green
       XDu*help*background:     red4
       XDu.ncol:      5
       XDu.font:      -*-helvetica-bold-r-normal--14-*
       XDu.showsize:       False
       XDu.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 until the mouse is moved out of and back  into
       the window.  I have been told that putting the following in your resources file may fix this.

       <window manager name>.FocusLenience: True

SEE ALSO

       du(1)

AUTHOR

       Phillip C. Dykstra
       <phil@arl.army.mil>

                                                       X11                                                XDU(1)