Manual browser: cd(1)

CD(1) General Commands Manual CD(1)


cdchange working directory


cd directory


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).


The following environment variables affect the execution of cd:
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.
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.


The cd command is expected to be IEEE Std 1003.2 (“POSIX.2”) compatible.
June 5, 1993 NetBSD 7.0