Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

OSS Library Calls (i - m) mk
fifo(3)
For more information about ACLs, see the acl(5) reference page. |
Use on Guardian Objects
Attempting to create a FIFO within the Guardian file system (that is, within G) fails with errno
set to [EINVAL].
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.
527187-007 Hewlett-Packard Company 4−129