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

mknod(2) OSS System Calls Reference Manual
NOTES
Use the mkfifo( ) function instead of the mknod( ) function to create a FIFO when you need to
port an application to a UNIX system that does not support XPG4 Version 2.
RETURN VALUES
Upon successful completion, 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 mknod( ) function
sets errno to the corresponding value:
[EACCES] A component of the pathname prefix denies search permission, or write permis-
sion is denied on the parent directory of the file to be created.
[EEXIST] The named file exists.
[EFAULT] The path parameter points outside the process’s allocated address space.
[EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt.
[EINVAL] One of the following conditions exists:
• The value S_IFBLK was specified for the mode parameter.
• A value other than 0 (zero) was specified for the device parameter when
a value other than S_IFCHR was specified for the mode parameter.
• An invalid value was specified for the device parameter when the value
S_IFCHR was specified for the mode parameter.
• The mode parameter specifies a file type of S_IFDIR but the path
parameter specifies a pathname of the form /G/vol.
• The mode parameter specifies a file type of S_IFIFO but the path
parameter specifies a pathname in /G (the Guardian file system).
[EIO] During an access of the file system, an I/O error occurred.
[ELOOP] Too many symbolic links were encountered in resolving the value of the path
parameter.
[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 pathname pointed to by the path parameter
The pathconf( ) function can be called to obtain the applicable limits.
[ENOENT] One of the following conditions exists:
• The named directory does not exist.
4−30 Hewlett-Packard Company 527186-003