Chapter 6: Bash Features

91

dirs [-clpv] [+N | -N]

Display the list of currently remembered directories. Directories are added to the list with the pushd command; the popd command removes directories from the list.

-c

Clears the directory stack by deleting all of the elements.

-l

Produces a listing using full pathnames; the default listing format uses a tilde to denote the home directory.

-p

Causes dirs to print the directory stack with one entry per line.

-v

Causes dirs to print the directory stack with one entry per line, prefixing each entry with its index in the stack.

+N

Displays the N th directory (counting from the left of the list printed by dirs when invoked without options), starting with zero.

-N

Displays the N th directory (counting from the right of the list printed by dirs when invoked without options), starting with zero. popd popd [-n] [+N | -N]

Remove the top entry from the directory stack, and cd to the new top directory.

When no arguments are given, popd removes the top directory from the stack and performs a cd to the new top directory. The elements are numbered from

0 starting at the first directory listed with dirs; that is, popd is equivalent to popd +0.

-n

Suppresses the normal change of directory when removing directo- ries from the stack, so that only the stack is manipulated.

+N

Removes the N th directory (counting from the left of the list printed by dirs), starting with zero.

-N

Removes the N th directory (counting from the right of the list printed by dirs), starting with zero. pushd pushd [-n] [+N | -N | dir]

Save the current directory on the top of the directory stack and then cd to dir.

With no arguments, pushd exchanges the top two directories.

-n

Suppresses the normal change of directory when adding directories to the stack, so that only the stack is manipulated.

+N

Brings the N th directory (counting from the left of the list printed by dirs, starting with zero) to the top of the list by rotating the stack.

-N

Brings the N th directory (counting from the right of the list printed by dirs, starting with zero) to the top of the list by rotating the stack.