June 5, 1993 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.