fchdir man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

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)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net