XDTREE(1L) XDTREE(1L)
NAME
xdtree - display directory tree structures
SYNOPSIS
xdtree [ -aDfghHNpsStvx ] [ -l level ] [ -c linelength ] [ directory...
]
DESCRIPTION
xdtree is an extension of dtree and displays a graphic representation
of the directory structure of each given directory and its children
either on the terminal stdout or on an X11 window, using the Motif
widgets (default). If no directories are specified, the current
directory is used. By default, only directories, not regular files,
are shown, and only their filenames are given. Various options add
additional information to the tree.
OPTIONS
-a Include files in the listing (excluding entries beginning with
'.').
-c linelength
Make linelength the length of each column of the printout. By
default, this is 14. Any entries longer than the column length
are truncated accordingly, and the last character that fits into
the column is replaced by an asterisk. This option only has an
effect if the -v option is specified.
-l level
Search only up to the specified level. (Maximum is 10).
-D List directories first. For each directory, its subdirectories
will be listed first, and then all of its other entries.
-f List files first. The reverse of -D.
-S Long listing. Display useful information to the right of each
entry: the name of the file's owner, its size in blocks, and its
mode.
-g Same as the -S option, except that the group name is used instead
of the owner name. If both the -S and -g options are used, both
the owner and group will be displayed.
-H Display a header at the top of the printout that gives the time
and date that the printout was made and a summary of the type of
information contained in the tree.
-N No sort. Entries are listed in the order they are read from the
directories.
- 1 - Formatted: November 6, 2025
XDTREE(1L) XDTREE(1L)
-p Include entries beginning with '.' (except '.' and '..').
-s Simplify the long listing: display the user id, size in blocks,
and octal mode of the file. This option implies the -S option
unless the -g option is specified.
-v Do not let column lengths vary; use the same width for each
column of output. The width defaults to 14 but can be set with
the -c option.
-x Do not cross file systems. xdtree will not cross over to a
subdirectory if it is on a different file system.
-h Will print a list of the options.
-t Terminal mode. In default mode xdtree will display the directory
tree structure in an X11 window. The -t option allows the tree
to be printed on the terminal stdout.
Under the X11 window mode, a button click on a tree node, makes
it the "active" node. The name of the "active" node always
appears at the top of the window, under the "quit" button. Below
the area where the name of the "active" node is shown, a table
displays the mode of the node, the group and user IDs, and its
size. Next to this menu are the file, directory, and Print-Tree
option buttons. There are five file options: view, topview,
edit, print, and remove. There are three directory options: show
subtree, list files, and list '../'. Thus, the -c, -S, -g, -s,
and -v options are meaningful only when the -t option is used.
However, the -S, -g, and -H options are accessible from the
toggle buttons in the Print-Tree options menu.
view Display the whole file on a scrolled window. Since the program
reads a file all at once, the wait may be significant for a very
large file. However, the option
topview
shows only the top of the file (2000 bytes).
edit Edit the file. xdtree first checks and executes the command
specified by the xdtree*editor: resource in .Xdefaults. If that
command is NULL, xdtree forks an hpterm window using the editor
command specified in the EDITOR environmental variable. If that
variable is not specified, it uses vi.
print
Print the file. It prints the file on the printer destination
specified by the xdtree*lpdest: resource in .Xdefaults. If that
variable is not specified it uses the default lp destination.
The same variable is also being used when the Print-Tree button
is selected.
- 2 - Formatted: November 6, 2025
XDTREE(1L) XDTREE(1L)
remove
Remove that file. The file icon is disabled and the file is
removed.
show subtree
Show the directory subtree starting from the selected "active"
directory node.
list files
List all files and directories for the "active" directory node.
This is equivalent to an "ls" command on that directory.
list ../
List the directories in the parent (top) directory. Allows the
user to traverse upwards the directory tree.
Print-Tree
Print the tree. This is equivalent to using the xdtree command
with the -t option and piping the output to your printer.
Except for the view and topview options, in all other cases a
click on the "quit" button of the "parent" will cause the
"parent" xdtree window to freeze until the selected command has
been executed or the "child" window has been killed. Then the
"parent" window will automatically die. Thus it is recommended
to kill "children" applications before you try to kill the
"parent".
On a color terminal, one can choose different colors to
distinguish between directories, files, and symbolic links. To
set up a simple color scheme for xdtree, put the following
entries in your ~/.Xdefaults file:
xdtree*geometry: 500x500
xdtree*quit.background: DarkSlateBlue
xdtree*dir.background: Red
xdtree*sym_link.background: Brown
xdtree*options.background: Red
A set of simple resources is also specified in /usr/lib/X11/app-
defaults/XDtree
AUTHOR
Dave Borman, Digital Unix Engineering Group, wrote the original dtree
program.
decvax!borman
Originally written at St. Olaf College, Northfield, MN.
Additions for the X11 windows display by K. Konstantinides, Hewlett-
Packard Laboratories. Copyright: Hewlett-Packard, 1990, and 1992.
e-mail:kk@hpkronos.hpl.hp.com
- 3 - Formatted: November 6, 2025
