dirs built-in command for tcsh: Print the directory stack
Format
- dirs [-l] [-n|-v]
- dirs -S|-L [file name]
- dirs -c
Description
dirs used alone prints the directory stack in the following
format: The top of the stack is at the left and the first directory
in the stack is the current directory. For example:
> cd <========== # Change to home dir
> pushd /bin <== # Change dir to /bin and add /bin to dir stack
/bin ~
> pushd /tmp <== # Change dir to /tmp and add /tmp to dir stack
/tmp /bin ~
> dirs <======== # Display current dir stack
/tmp /bin ~
> dirs -l <===== # Display in expanded (long) format
/tmp /bin /u/erinf
> dirs -v <===== # Display in verbose format
0 /tmp
1 /bin
2 ~
> popd <======== # Change dir back to /bin and remove /tmp from dir stack
/bin ~
>pwd
/bin
Note: dir=directory
Options
- –l
- Output is expanded explicitly to home or the path name of the home directory for the user.
- -n
- Entries are wrapped before they reach the edge of the screen.
- -v
- Entries are printed one per line, preceded by their stack positions.
If more than one of -n or -v is given, -v takes precedence.
- -S
- Saves the directory stack to file name as a series of cd and pushd commands.
- -L
- The tcsh shell sources file name, which is presumably a directory
stack file saved by the -S option or the savedirs mechanism.
In either case, dirsfile is used if file name
is not given and ~/.cshdirs is used if
dirsfile is unset.
Login shells do the equivalent of dirs -L on startup and, if savedirs is set, you should issue dirs -S before exiting. Because only ~/.tcshrc is normally sourced before ~/.cshdirs, dirsfile should be set in ~/.tcshrc instead of ~/.login.
- –c
- Clear the directory stack.
Related information
tcsh