NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
#include <exec/chExec.h>int svGetInvoker(KnCap *actorcap);
CORE
The svGetInvoker function returns the capability of the execution actor prior to the execution of the current handler to the value pointed to by actorcap.
When called outside the execution of a handler (connected by svTrapConnect(2K), svExcHandler(2K), svAbortHandler(2K), svMsgHandler(2K), 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.
Upon 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 | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO