Kickstart

Mark a FROZEN process as schedulable. Final step of the three-step process spawn sequence:

1. PSpawn creates a new FROZEN process and returns its handle.
2. AsInject fills the new process’s address space with parsed ELF data.
3. Kickstart marks the process as schedulable.

The argument struct is KickstartArgs, defined in spawn_args.h:

typedef struct
{
    uint32_t size;        /* sizeof(KickstartArgs); wrapper sets it */
    Handle taskHandle; // handle of the target task
    VirtAddr entry;      // entry point address in the target task's address space
    VirtAddr sp;         // stack pointer value for the target task
    uint32_t r0_val;      // value to set in register r0 of the target task
    uint32_t r1_val;      // value to set in register r1 of the target task
} KickstartArgs;

Pitfalls

Do not Kickstart a process whose address space has not been filled by AsInject, or it takes a prefetch abort and is killed. Ordinary processes cannot call AsInject; to spawn a child, message the init process.

Arguments

Returns

0 on success.

Errors

See also

• AsInject
• PSpawn