Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

mknod(2) OSS System Calls Reference Manual
When S_IFDIR is specified for the mode parameter, a specification of /G/vol for the path param-
eter causes the function call to fail and errno to be set to [EINVAL].
If any other file type value is used for the mode parameter of a file in /G, the function call fails
and errno is set to the value of [EINVAL].
The file access permissions S_ISUID, S_ISGID, and S_ISVTX are ignored when you are creat-
ing files in the Guardian file system.
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.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit OSS applications.
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
4−56 Hewlett-Packard Company 527186-023