NAME | SYNOPSIS | FEATURES | DESCRIPTION | LIMITATIONS | RETURN VALUE | ATTRIBUTES | SEE ALSO
#include <am/afexec.h>int astart(const KnCap *cactorcap);
RESTART_EXTENDED
The astart() call creates one thread in the c_actor specified by cactorcap. That thread executes the c_actor's text at the entry-point defined by the executable file header determined during the last use of the aload(2K) operation applied to that c_actor.
The cactorcap pointer indicates the capability of the c_actor to be activated.
Although unlikely, it is possible that you may want to start a number of threads at the actor's entry point by calling astart() repeatedly.
The astart() cannot act on a remote c_actor. If the capability specified refers to a remote actor, this call fails and returns the ENOTIMPLEMENTED error code.
Upon successful completion, these routines return 0. Otherwise they return -1 and set errno to indicate the following error condition:
The c_actor refered to by the given capability does not exist.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | LIMITATIONS | RETURN VALUE | ATTRIBUTES | SEE ALSO