Please read the INSTALL file for installation instructions, particularly if you are installing on a non-Linux machine. This is a handy little utility to display a tree view of directories that I wrote some time ago and just added color support to. I've decided that since no one else has done something similar I would go ahead and release it, even though it's barely a 1st year CS student hack. I've found it damn handy to peruse a directory tree though, especially when someone is trying to hide something from you. The main distribution site for tree is here: http://oldmanprogrammer.net/code.php?src=tree Backup GIT sites are: https://gitlab.com/OldManProgrammer/unix-tree https://github.com/Old-Man-Programmer/tree Old site for as long as it lasts: http://mama.indstate.edu/users/ice/tree/ ftp://mama.indstate.edu/linux/tree/ If you don't like the way it looks let me know how you think it should be formatted. Feel free to suggest modifications and additions. Thanks go out so the following people who have helped bring tree to the pinnacle of perfection that it is: ;) Francesc Rocher - Added HTML output (-H). - Added options -o, -L and -R. Gerald Scheidl - Added -S option to print ASCII graphics lines for use under linux console when an alternate console font has been selected (might also work under DOS telnet). Guido Socher (and others) - Made tree more portable. Should compile under solaris. Mitja Lacen - Discovered bug where tree will segmentation fault on long pathnames. - Discovered in -L argument processing. Nathaniel Delage - Discovered problem with recursive symlink detection A. Karthik - Suggested option to remove file and directory report at end of tree listing. Roger Luethi - Spotted memory over-allocation bug in read_dir(). - Submitted several patches to fix various memory leaks. Daniel Lee - Reported that Tru64 defines TRUE/FALSE in sys/types.h (OSF1 standard?) Paolo Violini - Found bug in tree that caused it to seg-fault if 50 file arguments where given and directory coloring was turned on. Mitsuaki Masuhara - Discovered tree crashed on missing arguments. - Discovered that tree did not properly encode characters in filenames when used as URLs when using the -H option. - Fixed issue with --charset option processing. Johan Fredrik - Pointed out that tree did not list large files. Ted Tiberio - Submitted patch which fixed a compiler issue and cleaned up HTML and CSS code, applied CSS to all output, and fixed up HTML to 4.01 strict standards. David MacMahon - Added '|' support to the pattern matching routines. Dan Jacobson - Pointed out that -t did not sort properly for files with the same timestamp. - Suggested option to change HTML title and H1 string. - Suggested -r option for reversed alphanumeric sort ala 'ls -r'. Kyosuke Tokoro - Provided patch to support OS/2, fix HTML encoding, provide charset support. Added to authors list. Florian Ernst - Debian maintainer who pointed out problems and applied fire to feet to fix stuff. Jack Cuyler - Suggested -h option for human readable output for -s, ala ls -lh. Jonathon Cranford - Supplied patch to make tree under cygwin. Richard Houser - Provided patch to fix a colorization bug when dealing with special files and directories that seem to have an extension. Zurd (?) - Suggested removing trailing slash on user supplied directory names if -f option is used. John Nintendud - Pointed out broken HTML output in 1.5.1. Mark Braker - Suggested --filelimit option. Michael Vogt - Suggested -v option (version sort). Wang Quanhong - Provided build options for Solaris. Craig McDaniel - Provided build options and source mods for HP NonStop support. Christian Grigis - Noted that setlocale() should come before MB_CUR_MAX check. Kamaraju Kusumanchi - Submitted patch to remove compiler warnings for Solaris. Martin Nagy - Provided patch which fixes issue where indent may output more than it should when dirs[*] is not properly cleared before use. William C. Lathan III - Showed that tree was not properly quoting arguments to recursively called tree instances when using -R. Ulrich Eckhardt - Submitted patch for --si option. Tim Waugh (redhat) - Pointed out a potential memory leak in listdir(). Markus Schnalke - Tracked down bug where tree would print "argetm" before the filename of a symbolic link when the "target" option was specified for LINK in dircolors. Ujjwal Kumar - Suggested that tree backslash spaces like ls does for script use. Made output more like ls. Ivan Shmakov - Pointed out multiple CLI defenciencies (via Debian) Mantas Mikulnas - Provided patch to make tree more reliably detect the UTF-8 locale. Tim Mooney - Noticed S_ISDOOR/S_IFDOOR spelling mistake for under Solaris. Han Hui - Pointed out possible memory overflow in read_dir (path/lbuf not equal in size to pathsize/lbufsize.) Ryan Hollis - Pointed out problems with the Makefile w/ respect to OSX. Philipp M?ller - Provided patch for filesize sorting. Sascha Zorn - Pointed out that the HTML output was broken when -L 1 option was used. Alexandre Wendling - Pointed out that modern systems may use 32 bit uid/gids which could lead to a potential buffer overflow in the uid/gid to name mapping functions. Florian Sesser - Provided patch to add JSON support. Brian Mattern & Jason A. Donenfeld - Provided patch to add --matchdirs functionality. Jason A. Donenfeld - Added --caseinsentive, renamed --ignore-case option. - Bugged me a lot. Stephan Gabert - Found a bug where the wrong inode (and device) information would be printed for symbolic links. Nick Craig-Wood - Fixed issue where mbstowcs() fails to null terminate the string due to improper UTF-8 encoding leading to garbage being printed. Mantas Mikulėnas - Fixed issue with malformed multibyte string handling. Wagner Camarao - Pointed out that JSON size output ignored -h/--si flags John Lane, Tad, others - Fixed JSON output hanging commas Jacob Wahlgren - Improved command line switch error reporting. - Symbolic links not displayed if a -P pattern is active - Missing argument error reporting fixes on long format switches. Shawn Mehan - Update BINDIR in Makefile for MacOS X -- It is not allowed to install programs to /usr/bin on MacOS X any longer due to System Integrity Protection (SIP) Kirill Kolyshkin - Some man page fixes and cleanups Alyssa Ross - Suggested adding support for BSD's CLICOLOR and CLICOLOR_FORCE environment variables. Tomáš Beránek - Make sure we always use xmalloc / xrealloc Sergei Maximov - Make XML/HTML/JSON output mutually exclusive. Jonas Stein - Deprecate using local -DLINUX / -DCYGWIN and use the OS provided defines John A. Fedoruk - Suggested --filesfirst option. Michael Osipov - Optimized makefile, HP/UX support. Richard Mitchell - Suggested --metafirst option Paul Seyfert - Honor -n (no color) even if the CLICOLOR_FORCE environment variable is set Filips Romāns via Debian - Make tree colorization use reset (rs code in dir_colors,) not normal color when resetting attributes. Chentao Credungtao via Debian - Properly sort --fromfile input Jake Zimmerman (and others) - Suggest support for .gitignore files (--gitignore option) Eric Pruitt - Always HTML escape filenames in HTML output even when -C is used. Michiel Beijen (and others) - Suggest Support multiple -I and -P instances. - Suggest that / match directories in patterns (also Taylor Faubion) - Suggested to update MANPATH for OS X Michal Vasilek - Various Makefile fixes Josey Smith - Reported an error with * in the patchmatch code where *foo*bar would match *foo alone. Maxim Cournoyer - Reported HTML url output issue w/ 2.0.0-2.0.1 Kenta Arai - Reported Segfault with --filelimit option Ben Brown - Updates to the Makefile - Reported use after free error Erik Skultety - Reported same use after error Saniya Maheshwari / Mig-hub ? / Carlos Pinto - Reported various issues with --gitignore And many others whom I've failed to keep track of. I should have started this list years ago. - Steve Baker oldmanprogrammer.llc@gmail.com