NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | LIMITATIONS | RETURN VALUE | ATTRIBUTES | SEE ALSO
#include <afexec.h>int astart(const KnCap *cactorcap);
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.
The astart() call creates one thread in the process specified by cactorcap. That thread executes the process'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 process.
The cactorcap pointer indicates the capability of the process 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 process. 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 process refered to by the given capability does not exist.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Deprecated |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | LIMITATIONS | RETURN VALUE | ATTRIBUTES | SEE ALSO