Bash - popd (Builtin command)

About

popd removes entries from the directory stack. See dirs.

Syntax

With no arguments, removes the top directory from the stack, and performs a cd to the new top directory.

popd [-n] [+n] [-n]

where:

  • +n - Removes the nth entry counting from the left of the list shown by dirs, starting with zero.
  • -n - Removes the nth entry counting from the right of the list shown by dirs, starting with zero.
  • -n - Suppresses the normal change of directory when removing directories from the stack, so that only the stack is manipulated.

Return value

If the popd command is successful, a dirs is performed as well, and the return status is 0.

popd returns false if:

  • an invalid option is encountered,
  • the directory stack is empty,
  • a non-existent directory stack entry is specified,
  • or the directory change fails.

Example

  • popd +0 removes the first directory,
  • popd +1 the second.
  • popd -0 removes the last directory
  • popd -1 the next to last.

Go away and returns

# we are now in /
pushd /aDir/
# we are now in /aDir/
popd
# we are now back in the starting current directory /

Powered by ComboStrap