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