Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
cd(1)				 User Commands				 cd(1)

NAME
       cd, chdir, pushd, popd, dirs - change working directory

SYNOPSIS
       /usr/bin/cd [directory]

   sh
       cd [argument]

       chdir [argument]

   csh
       cd [dir]

       chdir [dir]

       pushd [+n | dir]

       popd [+ n]

       dirs [-l]

   ksh
       cd [arg]

       cd old new

DESCRIPTION
   /usr/bin/cd
       The /usr/bin/cd utility changes the current directory in	the context of
       the cd utility only. This is in contrast	to the version built into  the
       shell,  as  described  below. /usr/bin/cd has no	effect on the invoking
       process but can be used to determine whether or not a  given  directory
       can be set as the current directory.

   sh
       The Bourne shell	built-in cd changes the	current	directory to argument.
       The shell parameter HOME	is the default argument. The  shell  parameter
       CDPATH  defines	the search path	for the	directory containing argument.
       Alternative directory names are separated by a colon (:).  The  default
       path  is	 <null>	(specifying the	current	directory). Note:  The current
       directory is specified by a null	path name, which  can  appear  immedi-
       ately  after  the  equal	 sign or between the colon delimiters anywhere
       else in the path	list. If argument begins with `/', `.',	or `.. ',  the
       search  path  is	 not  used.  Otherwise,	 each directory	in the path is
       searched	for argument. cd must have execute (search) permission in  ar-
       gument.	Because	 a  new	process	is created to execute each command, cd
       would be	ineffective if it were written as a normal command; therefore,
       it  is  recognized by and is internal to	the shell. (See	pwd(1),	sh(1),
       and chdir(2)).

       chdir is	just another way to call cd.

   csh
       If dir is not specified,	the C shell built-in  cd  uses	the  value  of
       shell  parameter	 HOME as the new working directory. If dir specifies a
       complete	path starting with ` / ', ` . ', or ` .. ',  dir  becomes  the
       new  working  directory.	 If neither case applies, cd tries to find the
       designated directory relative to	one of the paths specified by the  CD-
       PATH  shell  variable. CDPATH   has the same syntax as, and similar se-
       mantics to, the PATH shell variable. cd must have execute (search) per-
       mission	in  dir. Because a new process is created to execute each com-
       mand, cd	would be ineffective if	it were	written	as a  normal  command;
       therefore,  it  is  recognized  by and is internal to the C-shell. (See
       pwd(1), sh(1), and chdir(2)).

       chdir changes the shell's working directory to directory	dir. If	no ar-
       gument  is given, change	to the home directory of the user. If dir is a
       relative	pathname not found in the current directory, check for	it  in
       those  directories listed in the	cdpath variable. If dir	is the name of
       a shell variable	whose value starts with	a /, change to	the  directory
       named by	that value.

       pushd  will  push  a  directory onto the	directory stack. With no argu-
       ments, exchange the top two elements.

       +n    Rotate the	n'th entry to the top of the stack and cd to it.

       dir   Push the current working directory	onto the stack and  change  to
	     dir.

       popd pops the directory stack and cd to the new top directory. The ele-
       ments of	the directory stack are	numbered from 0	starting at the	top.

       +n    Discard the n'th entry in the stack.

       dirs will print the directory stack, most recent	to the left; the first
       directory shown is the current directory. With the -l argument, produce
       an unabbreviated	printout; use of the ~ notation	is suppressed.

   ksh
       The Korn	shell built-in cd command can be in either of two  forms.   In
       the first form it changes the current directory to arg. If arg is - the
       directory is changed to the previous  directory.	  The  shell  variable
       HOME  is	the default arg. The variable PWD is set to the	current	direc-
       tory.  The shell	variable CDPATH	defines	the search path	for the	direc-
       tory  containing	 arg.  Alternative  directory names are	separated by a
       colon (:). The default path is <null> (specifying  the  current	direc-
       tory).  Note  that  the	current	 directory is specified	by a null path
       name, which can appear immediately after	the equal sign or between  the
       colon delimiters	anywhere else in the path list.	If arg begins with a `
       / ', ` .	', or `	.. ', then the search path  is	not  used.  Otherwise,
       each directory in the path is searched for arg.

       The  second form	of cd substitutes the string new for the string	old in
       the current directory name, PWD and tries to change to this new	direc-
       tory.

       The  cd	command	 may not be executed by	rksh. Because a	new process is
       created to execute each command,	cd would be  ineffective  if  it  were
       written	as a normal command; therefore,	it is recognized by and	is in-
       ternal to the Korn shell. (See pwd(1), sh(1), and chdir(2)).

OPERANDS
       The following operands are supported:

       directory
	     An	absolute or relative pathname of the  directory	 that  becomes
	     the new working directory.	The interpretation of a	relative path-
	     name by cd	depends	on the CDPATH environment variable.

OUTPUT
       If a non-empty directory	name from CDPATH is used, an absolute pathname
       of  the new working directory will be written to	the standard output as
       follows:

	      "%s\n", <new directory>

       Otherwise, there	will be	no output.

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following	environment  variables
       that affect the execution of cd:	LC_CTYPE, LC_MESSAGES, and NLSPATH.

	      CDPATH
		    A colon-separated list of pathnames	that refer to directo-
		    ries. If the directory operand does	not begin with a slash
		    (  /  )  character,	 and the first component is not	dot or
		    dot-dot, cd	will search for	directory relative to each di-
		    rectory named in the CDPATH	variable, in the order listed.
		    The	new working directory will be set to the first	match-
		    ing	 directory found. An empty string in place of a	direc-
		    tory pathname represents the current directory. If	CDPATH
		    is	not  set,  it  will  be	treated	as if it were an empty
		    string.

	      HOME  The	name of	the home directory, used when no directory op-
		    erand is specified.

	      PWD   A pathname of the current working directory, set by	cd af-
		    ter	it has changed to that directory.

EXIT STATUS
       The following exit values are returned by cd:

       0     The directory was successfully changed.

       >0    An	error occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       csh(1), ksh(1), pwd(1), sh(1), chdir(2),	attributes(5), environ(5)

SunOS 5.9			  26 Mar 2001				 cd(1)

NAME | SYNOPSIS | DESCRIPTION | OPERANDS | OUTPUT | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=cd&sektion=1&manpath=SunOS+5.9>

home | help