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

mkdir(2) OSS System Calls Reference Manual
• The current working directory is assigned from the VOLUME attribute of the Guardian
environment =_DEFAULTS DEFINE.
• The use of static memory by the process increases slightly.
These effects occur only when the first of the set of functions is called. The effects are not cumu-
lative.
RETURN VALUES
Upon successful completion, the mkdir() function returns the value 0 (zero). If the function call
fails, the value -1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the directory is not created and the mkdir() function
sets errno to the corresponding value:
[EACCES] Creating the requested directory requires writing in a directory with a mode that
denies write permission, or search permission is denied on the parent directory of
the directory to be created.
[EEXIST] The named file already exists.
[EFAULT] The path parameter is an invalid address.
[EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt.
[EINVAL] One of the following conditions exists:
• The program supplied an invalid value for the mode parameter.
• The pathname supplied in the call attempts to create a directory in the
Guardian file system, but the pathname cannot be mapped to a valid
Guardian subvolume name.
[EIO] A physical input or output error has occurred.
[ELOOP] Too many symbolic links were encountered in translating path.
[ENAMETOOLONG]
One of the following 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 the following is true:
• A component of the prefix of the pathname pointed to by the path param-
eter does not exist.
• The path parameter points to an empty string.
• The path parameter names a symbolic link, but the file to which it refers
does not exist.
4−24 Hewlett-Packard Company 527186-003