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

FreeBSD Manual Pages

  
 
  

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

NAME
       chdir, fchdir - change working directory

SYNOPSIS
DESCRIPTION
       and  cause  a directory pointed to by path or fildes to become the cur-
       rent working directory, the starting point for path  searches  of  path
       names  not  beginning with path points to the path name of a directory.
       fildes is an open file descriptor of a directory.

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

RETURN VALUE
       Upon  successful	 completion,  a	 value of 0 is returned.  Otherwise, a
       value of	-1 is returned and is set to indicate the error.

ERRORS
       fails and the current working directory remains	unchanged  if  one  or
       more of the following are true:

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

       [ENOENT]			The named directory does not exist.

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

       [EFAULT]			path  points  outside  the  allocated  address
				space of the process.  The reliable  detection
				of this	error is implementation	dependent.

       [ENOENT]			path is	null.

       [ENAMETOOLONG]		The  length of the specified path name exceeds
				bytes, or the length of	 a  component  of  the
				path name exceeds bytes	while is in effect.

       [ELOOP]			Too  many  symbolic  links were	encountered in
				translating the	path name.

       fails and the current working directory remains	unchanged  if  one  or
       more of the following are true:

       [EACCES]			Search permission is denied for	fildes.

       [EBADF]			fildes is not an open file descriptor.

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

AUTHOR
       and were	developed by AT&T Bell Laboratories and	HP.

SEE ALSO
       cd(1), chroot(2).

STANDARDS CONFORMANCE
								      chdir(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | AUTHOR | SEE ALSO | STANDARDS CONFORMANCE

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

home | help