OLDPWD (path)

Return the home directory for the current session user

Description

OLDPWD return the previous directory.

This variable exists to support POSIX, however the idiomatic way to access this same data is via $PWDHIST.

This is a reserved variable so it cannot be changed.

Detail

Comparison With PWDHIST

PWDHIST is an array that holds the entire PWD history rather than just the previously accessed path.

OLDPWD reads PWDHIST, so if PWDHIST is overwritten, this will affect the value of OLDPWD as well.

Error Handling

If a previous directory cannot be determined, then OLDPWD will error. For example:

» cd $OLDPWD
Error in `cd` (0,1): cannot assign value to $OLDPWD: already at oldest entry in $PWDHIST
                   > Expression: cd $OLDPWD
                   >           :          ^
                   > Character : 9

See Also


This document was generated from gen/variables/OLDPWD_doc.yaml.

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Wed Jan 15 23:07:50 UTC 2025 against commit b4c4296b4c429617fd41527ea0efef33c52c15ef2b64972.

Current version is 6.4.2063 (develop) which has been verified against tests cases.