Open System Services Library Calls Reference Manual (G06.27+, H06.04+)

OSS Library Calls (i - m) mk
fifo(3)
Use From the Guardian Environment
The mkfifo( ) function is one of a set of functions that have the following effects when the first of
them is called from the Guardian environment:
• Two Guardian file system file numbers (not necessarily the next two available) are allo-
cated for the root directory and the current working directory. These file numbers cannot
be closed by calling the Guardian FILE_CLOSE_ procedure.
• 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 of mkfifo(), the value 0 (zero) is returned. Otherwise, the value -1 is
returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the new file is not created and the mkfifo( ) function
sets errno to the corresponding value:
[EACCES] A component of the pathname prefix denies search (execute) permission, or write
permission is denied on the parent directory of the FIFO to be created.
[EEXIST] The named file exists.
[EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt.
[EINVAL] One of the following conditions occurred:
• The call attempted to create a FIFO within the Guardian file system (that
is, within G).
• The program supplied an invalid value for the mode parameter.
[EIO] During access of the file system, an I/O error occurred.
[ELOOP] Too many symbolic links were encountered in translating the path parameter.
[ENAMETOOLONG]
One of the following is too long:
• The length of 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 conditions exists:
• A component of the pathname prefix does not exist.
• The path parameter points to an empty string.
527187-004 Hewlett-Packard Company 4−129