- Unix Commands Reference
- Unix - Tutorial Home
- Selected Reading
- UPSC IAS Exams Notes
- Developer's Best Practices
- Questions and Answers
- Effective Resume Writing
- HR Interview Questions
- Computer Glossary
- Who is Who
tree - Unix, Linux Command
NAMEtree - list contents of directories in a tree-like format.
SYNOPSIStree [-adfgilnopqrstuxACDFNS] [-L level [-R]] [-H baseHREF] [-T title] [-o filename] [--nolinks] [-P pattern] [-I pattern] [--inodes] [--device] [--noreport] [--dirsfirst] [--version] [--help] [directory ...]
DESCRIPTIONTree 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.
OPTIONSTree understands the following command line switches:
|--help||Outputs a verbose usage listing.|
|Outputs the version of tree.|
|-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. Symbolic links that will result in recursion are avoided when detected.|
|-x||Stay on the current file-system only. Ala find -xdev.|
|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 single character not listed in brackets) and | separates alternate patterns.|
|Do not list those files that match the wild-card pattern.|
|Omits printing of the file and directory report at the end of the tree listing.|
|-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.|
|Prints the inode number of the file or directory|
|Prints the device number to which the file or directory belongs|
|-F||Append a / for directories, a = for socket files, a * for executable files and a | for FIFOs, 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.|
|-r||Sort the output in reverse alphabetic order.|
|-t||Sort the output by last modification time instead of alphabetically.|
|List directories before files.|
|-n||Turn colorization off always, over-ridden by the -C option.|
|-C||Turn colorization on always, using built-in color defaults if 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.|
|-S||Turn on ASCII line graphics (useful when using linux console mode fonts). This option is now equivalent to --charset=IBM437 and will eventually be depreciated.|
|Max display depth of the directory tree.|
|-R||Recursively cross down the tree each level directories (see -L option), and at each of them execute tree again adding -o 00Tree.html as a new option.|
|Turn on HTML output, including HTTP references. Useful for ftp sites. baseHREF gives the base ftp location when using HTML output. That is, the local directory may be /local/ftp/pub, but it must be referenced as ftp://hostname.organization.domain/pub (baseHREF should be ftp://hostname.organization.domain). Hint: dont use ANSI lines with this option, and dont give more than one directory in the directory list. If you wish to use colors via CCS stylesheet, use the -C option in addition to this option to force color output.|
|Sets the title and H1 header string in HTML output mode.|
|Set the character set to use when outputting HTML and for line drawing.|
|Turns off hyperlinks in HTML output.|
|Send output to filename.|
FILES/etc/DIR_COLORS System color database.
~/.dircolors Users color database.
ENVIRONMENTLS_COLORS Color information created by dircolors
TREE_CHARSET Character set for tree to use in HTML mode.
LC_CTYPE Locale for filename output.
AUTHORSteve Baker (email@example.com)
HTML output hacked by Francesc Rocher (firstname.lastname@example.org)
Charsets and OS/2 support by Kyosuke Tokoro (NBG01720@nifty.ne.jp)
BUGSTree does not prune "empty" directories when the -P and -I options are used. Tree prints directories as it comes to them, so cannot accumulate information on files and directories beneath the directory it is printing. Probably more.