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 command in all shells and not
     as a stand-alone program.  Because each process has its own working di-
     rectory, a separate cd utility would have no effect (it would change the
     directory and exit, leaving the working directory in the parent un-
     changed).  Different shells may implement cd with features different from
     those described here.  Please consult the manual for your specific shell.

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.

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

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