zx_process_create_shared

Summary

Create a new process that can share part of its address space with other processes.

Declaration

#include <zircon/syscalls.h>

zx_status_t zx_process_create_shared(zx_handle_t shared_proc,
                                     uint32_t options,
                                     const char* name,
                                     size_t name_size,
                                     zx_handle_t* proc_handle,
                                     zx_handle_t* restricted_vmar_handle);

Description

zx_process_create_shared() creates a new process that shares part of its address space with shared_proc. The created process will be added to the same job as shared_proc.

shared_proc must have been created with ZX_PROCESS_SHARED, or via zx_process_create_shared().

The address space of the created process is split in two: the shared portion which is shared with shared_proc, and the restricted portion which is private to the created process. Each thread in the process begins executing with the shared portion active.

For more detail, see zx_process_create().

Rights

shared_proc must be of type ZX_OBJ_TYPE_PROCESS and have ZX_RIGHT_MANAGE_PROCESS.

See zx_process_create().

Return value

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

For more detail, see zx_process_create().

Errors

ZX_ERR_INVALID_ARGS shared_proc is a valid handle, but pointed to a process that was not created via zx_process_create_shared(), or zx_process_create() with ZX_PROCESS_SHARED.

ZX_ERR_BAD_HANDLE shared_proc is not a valid handle.

ZX_ERR_WRONG_TYPE shared_proc is not a process handle.

ZX_ERR_BAD_STATE shared_proc is a valid handle but the shared state is no longer valid (likely due to all processes sharing the state terminating).

ZX_ERR_ACCESS_DENIED shared_proc does not have the ZX_RIGHT_MANAGE_PROCESS right (only when not ZX_HANDLE_INVALID).

For other errors, see zx_process_create().

See also

• zx_process_create()