Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

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

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 work- ing 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 direc- tory. 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)


All times are GMT -4. The time now is 02:26 PM.

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