CHDIR

Section: Linux Programmer's Manual (2)
Updated: 15 April 1995
Index Return to Main Contents
 

NAME

chdir, fchdir - change working directory  

SYNOPSIS

#include <unistd.h>

int chdir(const char *path);
int fchdir(int fd);  

DESCRIPTION

chdir changes the current directory to that specified in path.

fchdir is identical to chdir, only that the directory is given as an open file descriptor.  

RETURN VALUE

On success, zero is returned. On error, -1 is returned, and errno is set appropriately.  

ERRORS

Depending on the file system, other errors can be returned. The more general errors are listed below:

EPERM
The process does not have execute permission on the directory.
EFAULT
path points outside your accessible address space.
ENAMETOOLONG
path is too long.
EBADF
The fd is not a valid file descriptor.
ENOENT
The file does not exist.
ENOMEM
Insufficient kernel memory was available.
ENOTDIR
A component of the path prefix is not a directory.
EACCES
Search permission is denied on a component of the path prefix.
ELOOP
path contains a circular reference (i.e., via a symbolic link)
 

SEE ALSO

getcwd(3), chroot(2)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:25:13 GMT, March 22, 2025