ISETLOCKWAIT(3)
HP-UX
NAME
isetlockwait, igetlockwait − will set/return the current state of the lockwait flag
SYNOPSIS
#include <sicl.h>
int isetlockwait(INST id, int flag);
int igetlockwait(INST id, int flag);
DESCRIPTION
isetlockwait controls whether a call to ilock will cause a hang or generate an error if the device is locked by another user. If flag is non-zero, then all operations to a device/interface locked by another user will hang (wait) for the lock to be freed (default). If flag is (0), the operation will return an error.
getlockwait will store a (1) into flag if hang (wait) mode is enabled, and will store a (0) if no-wait (generate error) mode is enabled.
RETURN VALUE
isetlockwait, and igetlockwait return a (0) on success, or a non-zero error code if an error was encountered.
ERRORS
isetlockwait, igetlockwait fail under the following circumstances, and sets the return value to one of the following values:
[I_ERR_NORSRC] Out of system resources
[I_ERR_NOINTF] Interface is not active
[I_ERR_NODEV] Device is not active
[I_ERR_BADID] The INST id is invalid
SEE ALSO
igeterrno(3), igeterrstr(3), ilock(3)
AUTHOR
isetlockwait, igetlockwait were developed by HP.
Hewlett-Packard Company — September 29, 1999