Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for tree (redhat section 1)

TREE(1) 						      General Commands Manual							   TREE(1)

NAME
tree - list contents of directories in a tree-like format.
SYNOPSIS
tree [ -adfgilnpqstuxACDFN ] [ -P pattern ] [ -I pattern ] [ directory ... ]
DESCRIPTION
Tree is a recursive directory listing program that produces a depth indented listing of files. Color is supported ala dircolors if the LS_COLORS environment variable is set, output is to a tty, and the -C flag is used. With no arguments, tree lists the files in the current directory. When directory arguments are given, tree lists all the files and/or directories found in the given directories each in turn. Upon completion of listing all files/directories found, tree returns the total number of files and/or directories listed. By default, when a symbolic link is encountered, the path that the symbolic link refers to is printed after the name of the link in the format: name -> real-path If the `-l' option is given and the symbolic link refers to an actual directory, then tree will follow the path of the symbolic link as if it were a real directory.
OPTIONS
Tree understands the following command line switches: -a All files are printed. By default tree does not print hidden files (those beginning with a dot `.'). In no event does tree print the file system constructs `.' (current directory) and `..' (previous directory). -d List directories only. -f Prints the full path prefix for each file. -i Makes tree not print the indentation lines, useful when used in conjunction with the -f option. -l Follows symbolic links if they point to directories, as if they were directories. -x Stay on the current file-system only. Ala find -xdev. -P pattern List only those files that match the wild-card pattern. Note: you must use the -a option to also consider those files beginning with a dot `.' for matching. Valid wildcard operators are `*' (any zero or more characters), `?' (any single character), `[...]' (any single character listed between brackets (optional - (dash) for character range may be used: ex: [A-Z]), and `[^...]' (any sin- gle character not listed in brackets). -I pattern Do not list those files that match the wild-card pattern. -p Print the protections for each file (as per ls -l). -s Print the size of each file along with the name. -u Print the username, or UID # if no username is available, of the file. -g Print the group name, or GID # if no group name is available, of the file. -D Print the date of the last modification time for the file listed. -F Append a `/' for directories, a `=' for socket files, a `*' for executable files and a `|' for FIFO's, as per ls -F -q Print non-printable characters in filenames as question marks instead of the default caret notation. -N Print non-printable characters as is instead of the default caret notation. -t Sort the output by last modification time instead of alphabetically. -n Turn colorization off always, over-ridden by the -C option. -C Turn colorization on always, unless the LS_COLORS environment variable is not set. Useful to colorize output to a pipe. -A Turn on ANSI line graphics hack when printing the indentation lines.
FILES
/etc/DIR_COLORS System color database. ~/.dircolors Users color database.
ENVIRONMENT
LS_COLORS Color information created by dircolors
AUTHOR
Steve Baker (ice@mama.indstate.edu)
BUGS
None known. Not heavily tested. Needs a few more options, ala ls.
SEE ALSO
dircolors(1L), ls(1L) UNIX Programmer's Manual TREE(1)