CD(1) | General Commands Manual | CD(1)

# NAME

cd — change working directory

# SYNOPSIS

cd | directory

# DESCRIPTION

Directory 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`
  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 the `CDPATH` 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 from `CDPATH`, it will be printed to the standard output.
`HOME`
  If cd is invoked without arguments and the `HOME` environment variable exists and contains a directory name, that directory becomes the new working directory.

See csh(1) for more information on environment variables.
The cd utility exits 0 on success, and >0 if an error occurs.

# SEE ALSO

csh(1), pwd(1), sh(1), chdir(2)

# STANDARDS

The cd command is expected to be IEEE Std 1003.2 (“POSIX.2”) compatible.

June 5, 1993 | NetBSD 8.1