OpenSolaris 2009.06 - man page for fchdir (opensolaris section 2)

Linux & Unix Commands - Search Man Pages

Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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 indicate 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 directory.

       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.11				   28 Dec 1996					 chdir(2)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 01:01 AM.

Unix & Linux Forums Content Copyright©1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?