IWAITHDLR(3)
HP-UX
NAME
iwaithdlr − suspends process until enabled SRQ or enabled interrupt is processed
SYNOPSIS
#include <sicl.h>
int iwaithdlr (long timeout);
DESCRIPTION
iwaithdlr causes the process to suspend until either an enabled SRQ or enabled interrupt condition occurs and the relevant handler is executed. Once the handler executes, this routine will return and the program continues executing. If timeout is non-zero, then this routine terminates and generates an error after the timeout period expires. The timeout value is specified in milliseconds. If a timeout of zero is specified, this routine will not terminate until an interrupt occurs.
The state of global event handling as set by iintron and iintroff is ignored by this command. If an iintroff was done, iwaithdlr still acts as if global interrupts are enabled for the duration of the call.
NOTE: This routine has its own timeout parameter because the value associated with itimeout is for a particular session only. Since the iwaithdlr routine waits for SRQ’s or interrupts on any and all sessions, we must specify the timeout value that the routine should use.
RETURN VALUE
The iwaithdlr routine returns 0 if successful, or a non-zero value if an error is encountered.
SEE ALSO
iintroff(3), ionsrq(3), igetonsrq(3), ionintr(3), igetonintr(3), isetintr(3)
AUTHOR
iwaithdlr were developed by HP.
Hewlett-Packard Company — May 05, 1994