Bash.Builtin.Dirs (Bash v0.6.0)

Copy Markdown View Source

dirs [-clpv] [+N] [-N] Display directory stack.

Display the list of currently remembered directories. Directories find their way onto the list with the pushd command; you can get back up through the list with the popd command.

Options:

  • -c - clear the directory stack by deleting all of the elements
  • -l - do not print tilde-prefixed versions of directories relative to your home directory
  • -p - print the directory stack with one entry per line
  • -v - print the directory stack with one entry per line prefixed with its position in the stack

Arguments:

  • +N Displays the Nth entry counting from the left of the list shown by dirs when invoked without options, starting with zero.

  • -N Displays the Nth entry counting from the right of the list shown by dirs when invoked without options, starting with zero.

Exit Status: Returns success unless an invalid option is supplied or an error occurs.

Reference: https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html