locus_create
locus_create
Creates a new
locus.
Signature
Status locus_create(
Capref locus,
Vaddr start,
Bool suspend )
Arguments
- locus - Specifies which capref the capability for the new locus
should be stored under.
- start - Specifies the container address at which the new locus
should begin execution.
- suspend - TRUE if the locus should start in the suspended state,
FALSE if it is to start in the ready state.
Semantics
This call creates a new locus in the same host
container
as the calling locus. When the new locus starts executing it will do so at the
address specified by start. The suspend argument determines
whether the locus is created in the suspended or ready to execute state. Ready
to execute loci will begin execution as soon as they are scheduled. Suspended
loci must explicitly be resumed via a call to
locus_resume.
The master permission group for the new locus is linked to a
capability
which may be referenced by locus.
Status
Fails if locus is an invalid capref.
Fails if a new locus cannot be created.
See Also
Capabilities
Containers
Loci
locus_resume