Open System Services System Calls Reference Manual (G06.25+, H06.03+)

chdir(2) OSS System Calls Reference Manual

RETURN VALUES

Upon successful completion, the chdir() function returns the value 0 (zero). Otherwise, the

value -1 is returned, and errno is set to indicate the error.

ERRORS

If any of these conditions occurs, the chdir() function sets errno to the corresponding value:

[EACCES] The requested current working directory is not accessible because search permis-

sion is denied for a component of the pathname.

[EFAULT] The path parameter is an invalid address.

[EFSBAD] The ﬁleset catalog for one of the ﬁlesets involved in the operation is corrupt.

[EIO] A physical input or output error occurred.

[ELOOP] Too many symbolic links were encountered in translating the pathname.

[ENAMETOOLONG]

One of these is too long:

• The pathname pointed to by the path parameter

• A component of the pathname pointed to by the path parameter

• The intermediate result of pathname resolution when a symbolic link is

part of the path parameter

The pathconf( ) function can be called to obtain the applicable limits.

[ENOENT] One of these conditions exists:

• The named directory does not exist.

• The speciﬁed pathname is an empty string.

• The speciﬁed pathname cannot be mapped to a valid Guardian ﬁlename.

• The speciﬁed pathname points to the name of a Guardian process that is

not of subtype 30.

• The path parameter names a symbolic link, but the directory to which it

refers does not exist.

• The path parameter speciﬁes a ﬁle on a remote HP NonStop node, but

communication with the remote node has been lost.

[ENOROOT] One of these conditions exists:

• The root ﬁleset of the local node (ﬁleset 0) is not in the STARTED state.

• The current root ﬁleset for the speciﬁed ﬁle is unavailable. The OSS

name server for the ﬁleset might have failed.

• The speciﬁed ﬁle is on a remote HP NonStop node, and communication

with the remote name server has been lost.

1−12 Hewlett-Packard Company 527186-003