NAME
cd
—
change working directory
SYNOPSIS
cd |
[directory] |
DESCRIPTION
Sincecd
affects the current shell execution
environment, it is always provided as a shell regular built-in. For more
information consult the manual page for the shell in use.
The directory operand is an absolute or
relative pathname which becomes the new working directory. The
interpretation of a relative pathname by cd
depends
on the CDPATH
environment variable (see below).
ENVIRONMENT
The following environment variables affect the execution of
cd
:
CDPATH
- A colon-separated list of pathnames that refer to directories. If the
directory operand does not begin with a slash
(‘
/
’) character, and the first component is not dot (‘.
’) or dot-dot (‘..
’),cd
searches for the directory relative to each directory named in theCDPATH
variable, in the order listed. The new working directory is set to the first matching directory found. An empty string in place of a directory pathname represents the current directory. If the new working directory was derived fromCDPATH
, it will be printed to the standard output. HOME
- If
cd
is invoked without arguments and theHOME
environment variable exists and contains a directory name, that directory becomes the new working directory. OLDPWD
- Set to the previous working directory after a directory change. Not supported by csh(1).
PWD
- Set to the current working directory.
EXIT STATUS
The cd
utility exits 0 on success,
and >0 if an error occurs.
SEE ALSO
STANDARDS
The cd
command is expected to be
IEEE Std 1003.2 (“POSIX.2”)
compatible.