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

System Functions (s and S) spt_fcntlx(2)
F_SETOWN Returns the value 0 (zero).
If the spt_fcntlx( ) function fails, the value -1 is returned, and errno is set to indicate the error.
ERRORS
If any of these conditions occur, the spt_fcntlx() function sets errno to the corresponding value:
[EAGAIN] The request parameter is F_SETLK, the type of lock (l_type)isshared
(F_RDLCK) or exclusive (F_WRLCK), and a segment of a file to be locked is
already exclusive-locked by another process.
The request parameter is F_SETLK, the type of lock is exclusive, and some por-
tion of a segment of a file to be locked is already shared-locked or exclusive-
locked by another process.
[EALREADY] Operation already in progress. An I/O operation started by a thread-aware func-
tion (such as spt_writez()) is in progress on a regular file and a function that is
process-blocking for regular files (such as read(), spt_read(),orspt_readx())
attempts to begin an I/O operation on the same open file.
[EBADF] One of these conditions exists:
• The request parameter is F_SETLK or F_SETLKW, the type of lock is
shared (F_RDLCK), and filedes is not a valid file descriptor open for
reading.
• The type of lock is exclusive (F_WRLCK), and filedes is not a valid file
descriptor open for writing.
• The filedes parameter is not a valid open file descriptor.
[ECONNRESET]
One of these conditions occurred:
• The transport-provider process for this socket is no longer available.
• The TCP/IP subsystem for this socket is no longer available.
• The connection was forcibly closed by the peer socket.
The file descriptor specified by the filedes parameter can only be closed.
[EFAULT] The argument2 parameter is an invalid address.
[EINTR] The request parameter is F_SETLKW, and the spt_fcntlx( ) function was inter-
rupted by a signal that was caught.
[EINVAL] One of these conditions exists:
• The request parameter is F_DUPFD, and the argument1 parameter is
negative or greater than or equal to the maximum number of opens per-
mitted.
• The request parameter is F_GETLK, F_SETLK
,orF_SETLKW,
and
the data pointed to by argument2 is invalid, or filedes refers to a file that
does not support locking.
527186-023 Hewlett-Packard Company 7−163