NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
#include <exec/chExec.h>int svGetInvoker(KnCap *actorcap);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
CORE
The svGetInvoker() function places the capability of the execution actor prior to the execution of the current handler in the value pointed to by actorcap.
When called outside the execution of a handler (connected by svTrapConnect(2K), svExcHandler(2K), svAbortHandler(2K), svMsgHandler(2K) or svLapCreate(2K)) or during execution of an IPC message handler for a remote ipcCall(2K), svGetInvoker() will return K_EINVAL.
The svGetInvoker() function should not be called from within an interrupt handler.
This call is restricted to SUPERVISOR threads.
On successful completion, a value of 0 is returned. Otherwise, a negative error code is returned.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
svTrapConnect(2K), svExcHandler(2K), svAbortHandler(2K), svMsgHandler(2K), svLapCreate(2K), ipcCall(2K), lapInvoke(2K)
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO