NAME

zkChdir - change working directory

SYNOPSIS

#include "zkUnistd.h"

int zkChdir(const char *path);

DESCRIPTION

The zkChdir() function causes the directory named by the pathname pointed to by the path argument to become the current working directory.

RETURN VALUE

Upon successful completion, 0 is returned. Otherwise, -1 is returned, the current working directory remains unchanged and errno is set to indicate the error.

ERRORS

The zkChdir() function will fail if:

[EACCES]
Search permission is denied for any component of the pathname.
[ELOOP]
Too many symbolic links were encountered in resolving path.
[ENAMETOOLONG]
The path argument exceeds {PATH_MAX} in length or a pathname component is longer than {NAME_MAX}.
[ENOENT]
A component of path does not name an existing directory or path is an empty string.
[ENOTDIR]
A component of the pathname is not a directory.

The zkChdir() function may fail if:

[ENAMETOOLONG]
Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {PATH_MAX}.