fchdir Subroutine

Purpose

Directory pointed to by the file descriptor becomes the current working directory.

Library

Standard C Library (libc.a)

Syntax

#include <unistd.h>

int fchdir (int Fildes)

Description

The fchdir subroutine causes the directory specified by the Fildes parameter to become the current working directory.

Parameter

Item Description
Fildes A file descriptor identifying an open directory obtained from a call to the open subroutine.

Return Values

Item Description
0 Successful completion
-1 Not successful and errno set to one of the following.

Error Codes

Item Description
EACCES Search access if denied.
EBADF The file referred to by Fildes is not an open file descriptor.
ENOTDIR The open file descriptor does not refer to a directory.