Guardian Procedure Calls Reference Manual

USEREVENT_AWAKE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The USEREVENT_AWAKE_ procedure is used by an application to awaken a target process on
the same logical processor upon the occurrence of one or more application-defined user events.
The call immediately awakens the target process if it is blocked inside of the USEREVENT_WAIT_
procedure or one of the AWAITIO/FILE_COMPLETE_ family of procedures and waiting on that
event. Otherwise, the occurrence is posted and recognized when the application subsequently
queries or waits on the event.
To awaken the target process, the caller must be a privileged caller, a super group member, the
target process’ owner, or the target process owner’s group manager. To minimize the performance
overhead, this procedure does not use Safeguard or Security Event-Exit Process (SEEP) for security
authorization.
USEREVENT_AWAKE_ has two parameters: targetProcessPhandle and awakeMask. The
targetProcessPhandle parameter is the process handle of the process that needs to be
awakened with the awakeMask provided. The awakeMask parameter is a bit mask of events.
USEREVENT_AWAKE_ returns the outcome of the operation in the return value.
NOTE: The USEREVENT_AWAKE_ procedure is supported on systems running H06.27 and later
H-series RVUs and J06.16 and later J-series RVUs.
Syntax for C Programmers
#include <cextdecs(USEREVENT_AWAKE_)>
int16 USEREVENT_AWAKE_ ( int16 *targetProcessPhandle
,uint32 awakeMask );
Syntax for TAL Programmers
error := USEREVENT_AWAKE_ ( targetProcessPhandle ! i
,awakeMask ); ! i
Parameters
targetProcessPhandle
input
INT .EXT:ref:10
specifies a pointer to the process handle of the target process to awaken. The target process
must be on the same CPU as the caller.
1466 Guardian Procedure Calls (T-V)