CD(1)

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 7.0