Help Desk
Division of Information Technology Home
 

Using Utree

Using UTREE Publication Number SFSXXXXX, A,
June 1994

Utree is a Unix screen oriented file system browser. The Utree program helps you manage your files and directories stored in your account in a screen oriented manner. In the tree screen, you traverse through your directories or files with arrow keys, change to any directory and issue file management commands on your files or directories. If you change to a directory, Utree displays all the files in this directory in a file screen. In the file screen you move through the file list with the arrow keys and issue file management commands.


Utree Help

You get online information about Utree by typing the Unix command "man utree" at the Unix command line. Alternatively, you can access help information by typing "h" while in the Utree program.


Utree Help Accessing Utree

You access Utree by typing "utree -ac" at the Unix command prompt. The -a option instructs Utree to display all the files in all directories including files that begin with a dot (.), which are normally ignored. The -c option instructs Utree to not display and update a clock every second. You can obtain a list of Utree command line options by typing "utree -h" at the Unix command prompt.

You traverse through your directories and files in Utree's screens with the following keys:

Right Arrow Move forward
Left Arrow Move backward
Up Arrow Move up
Down Arrow Move down
Enter Select and/or accept

Utree screens are divided into three regions. The top screen line, called the echo line, is used to display messages and to enter input. The second screen line, called the help line, displays help messages and Utree menu choices. The rest of the screen displays information about directories and files.


Utree Help Tree Screen and Commands

The tree screen is the initial screen displayed when you enter Utree; it displays the contents of your HOME directory. The current directory is highlighted and the bottom screen displays the files in the current directory. The tree menu shows the names of the tree screen commands, and the keystrokes to invoke a command are marked with uppercase letters.

All commands on the tree screen can be issued in lowercase or uppercase letters. Commands in lowercase letters affect the current directory only. Commands in uppercase letters affect the subtree in the current directory or all tagged files in the subtree in the current directory.

CR or SPACE Display the contents of the current directory.
c,C (Chdir) Move (c) into a directory or copy (C) all tagged files (with the t command) in the subtree. Before you move to a directory you are requested for the name of the directory.
f,F (Find) Find (f) files in the current directory or subtree (F) matching a file pattern you specified. If a file is found, you may tag the file (with the t command), change to the directory containing the file or continue the search process.
g,G (Grep) Search for a user specified pattern in the files in the current directory or subtree. If a file is found, you may tag the file (with the t command), change to the directory containing the file or continue the search process.
i (Info) Display information about the current directory: access rights, modification time and the disk usage of the current directory or subtree.
l,L (List) List (l) files in the current directory or subtree matching a file pattern you specified or list (L) all tagged files in the subtree.
m,M (Mkdir) Create (m) a new directory in the current directory or move (M) all tagged files to another directory.
q (Quit) Leave the tree screen and exit Utree.
r,R (Rmdir) Remove (r) the current directory or all (R) tagged files in the subtree.
s (Stat) Switch to the status screen and display information about the current directory.


Utree Help File Screen and Commands

The file screen displays all the files and subdirectories of the current directory. The current file is highlighted. The file menu displays the names of the file screen commands and the keystrokes to invoke a command are marked with uppercase letters.

All commands in the file screen can be issued in lowercase or uppercase letters. Commands in lowercase letters affect the current file only. Commands in uppercase letters affect all tagged (selected) files.

q,CR,SPACE (Quit) Leave the file screen and return to the tree screen.
h,? (Help) Help information about file screen commands.
c,C (Copy) Copy (c) the current file or tagged (C) files. You are requested for a destination file or directory where to copy the file or tagged files.
e,E (Edit) Edit (e) the current file or tagged (E) files.
f (Find) Find files matching a file pattern you specify.
g,G (Grep) Search (g) for a pattern in the current file or tagged (G) files based on a file pattern and search pattern you specify.
i,I Display (i) information about the current file or tagged (I) files.
l,L (List) List (l) files matching a file pattern you specified or all (L) tagged files.
m,M (Move) Move or rename (m) the current file or tagged (M) files. You are requested for the new file name or a destination directory where to move the current file or tagged files.
n Change the sort criteria from lexical order to modification time order or vice versa and resort the file list.
p,P (Print) Print (p) out the current file or tagged (P) files to the central printer.
r,R (Remove) Remove (r) the current file or tagged (R) files. You are asked if you really want to remove the current file or tagged files.
s,S (Stat) Switch (s) to the status screen and display information about the current or tagged (S) files.
v,V (View) View (v) the contents of the current file or tagged (V) files.
x,X Execute (x) the current file or tagged (X) files.

TOP OF PAGE

HOME
Site Home | What We Do | Help Desk | Account Services | Software | Hardware | Network
Telephone Services | Training | Computer Labs | Web Publishing | Policies | Sitemap | Contact Us

San Francisco State University

Last Modified: 20 Jan 1996
doit@sfsu.edu