process_create - create a new process


#include <zircon/syscalls.h>

zx_status_t zx_process_create(zx_handle_t job,
                              const char* name, uint32_t name_len,
                              uint32_t options,
                              zx_handle_t* proc_handle, zx_handle_t* vmar_handle);


process_create() creates a new process.

Upon success, handles for the new process and the root of its address space are returned. The thread will not start executing until process_start() is called.

name is silently truncated to a maximum of ZX_MAX_NAME_LEN-1 characters.

When the last handle to a process is closed, the process is destroyed.

Process handles may be waited on and will assert the signal ZX_PROCESS_TERMINATED when the process exits.

job is the controlling job object for the new process, which will become a child of that job.


On success, process_create() returns ZX_OK, a handle to the new process (via proc_handle), and a handle to the root of its address space (via vmar_handle). In the event of failure, a negative error value is returned.


ZX_ERR_BAD_HANDLE job is not a valid handle.

ZX_ERR_WRONG_TYPE job is not a job handle.

ZX_ERR_ACCESS_DENIED job does not have the ZX_RIGHT_WRITE right (only when not ZX_HANDLE_INVALID).

ZX_ERR_INVALID_ARGS name, proc_handle, or vmar_handle was an invalid pointer, or options was non-zero.

ZX_ERR_NO_MEMORY (Temporary) Failure due to lack of memory.

ZX_ERR_BAD_STATE The job object is in the dead state.


handle_close, handle_duplicate, object_wait_one, object_wait_many, process_start, task_kill, thread_create, thread_exit, thread_start, job_create.