CD(1)                      OpenBSD Reference Manual                      CD(1)

NAME
     cd - change working directory

SYNOPSIS
     cd directory

DESCRIPTION
     directory is an absolute or relative pathname which becomes the new work-
     ing directory.  The interpretation of a relative pathname by cd depends
     on the CDPATH environment variable (see below).

     Note that cd is implemented as a built-in shell command and not as a
     stand-alone program.  Because each process has its own working directory,
     a separate cd utility would have no effect (it would change the directory
     and exit, leaving the working directory in the parent unchanged).  Dif-
     ferent shells may implement cd with features different from those de-
     scribed here.  Please consult the manual for your specific shell.

     The cd command exits 0 on success or >0 if an error occurred.

ENVIRONMENT
     The following environment variables affect the execution of cd:

     CDPATH  If the directory operand does not begin with a slash (`/') char-
             acter, 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 work-
             ing directory is set to the first matching directory found.  An
             empty string in place of a directory pathname represents the cur-
             rent 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 vari-
             able exists and contains a directory name, that directory becomes
             the new working directory.

     See environ(7) for more information on environment variables.

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

STANDARDS
     The cd command is expected to be IEEE Std1003.2 (``POSIX.2'') compatible.

OpenBSD 3.0                      June 5, 1993                                1
