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.
The created process's initial ZX_PROP_PROCESS_* properties will match those of the
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 and
ZX_RIGHT_GET_PROPERTY.
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().