Create a new process that can share part of its address space with other processes.
#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);
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().
shared_proc must be of type ZX_OBJ_TYPE_PROCESS and have ZX_RIGHT_MANAGE_PROCESS.
See zx_process_create().
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().
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().
