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

FreeBSD Manual Pages

  
 
  

home | help
chdir(2)			 System	Calls			      chdir(2)

NAME
       chdir, fchdir - change working directory

SYNOPSIS
       #include	<unistd.h>

       int chdir(const char *path);

       int fchdir(int fildes);

DESCRIPTION
       The chdir() and fchdir()	functions cause	a directory pointed to by path
       or fildes to become the current working directory.  The starting	 point
       for path	searches for path names	not beginning with / (slash). The path
       argument	points to the path name	of a directory.	The fildes argument is
       an open file descriptor of a directory.

       For  a  directory  to become the	current	directory, a process must have
       execute (search)	access to the directory.

RETURN VALUES
       Upon successful completion, 0 is	returned. Otherwise, -1	 is  returned,
       the  current  working directory is unchanged, and errno is set to indi-
       cate the	error.

ERRORS
       The chdir() function will fail if:

       EACCES		       Search permission is denied for	any  component
			       of the path name.

       EFAULT		       The path	argument points	to an illegal address.

       EINTR		       A signal	was caught during the execution	of the
			       chdir() function.

       EIO		       An  I/O	error  occurred	 while reading from or
			       writing to the file system.

       ELOOP		       Too many	symbolic  links	 were  encountered  in
			       translating path.

       ENAMETOOLONG	       The   length   of  the  path  argument  exceeds
			       PATH_MAX, or the	length	of  a  path  component
			       exceeds	NAME_MAX  while	 _POSIX_NO_TRUNC is in
			       effect.

       ENOENT		       Either a	component of the path  prefix  or  the
			       directory  named	by path	does not exist or is a
			       null pathname.

       ENOLINK		       The path	argument points	to  a  remote  machine
			       and  the	 link  to  that	 machine  is no	longer
			       active.

       ENOTDIR		       A component of the path name is	not  a	direc-
			       tory.

       The fchdir() function will fail if:

       EACCES		       Search permission is denied for fildes.

       EBADF		       The   fildes  argument  is  not	an  open  file
			       descriptor.

       EINTR		       A signal	was caught during the execution	of the
			       fchdir()	function.

       EIO		       An  I/O	error  occurred	 while reading from or
			       writing to the file system.

       ENOLINK		       The fildes argument points to a remote  machine
			       and  the	 link  to  that	 machine  is no	longer
			       active.

       ENOTDIR		       The open	file descriptor	fildes does not	 refer
			       to a directory.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe		   |
       +-----------------------------+-----------------------------+

SEE ALSO
       chroot(2), attributes(5), standards(5)

SunOS 5.10			  28 Dec 1996			      chdir(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

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

home | help