zx_process_create_shared

总结

创建一个可与其他进程共享其部分地址空间的新进程。

声明

#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() 会创建一个新进程,将其部分地址空间与 shared_proc 共享。创建的进程将添加到与 shared_proc 相同的作业中。

shared_proc 必须是使用 ZX_PROCESS_SHARED 或通过 zx_process_create_shared() 创建的。

已创建进程的地址空间一分为二:与 shared_proc 共享的共享部分,以及创建的进程专用的受限部分。进程中的每个线程都开始执行,且共享部分处于活跃状态。

如需了解详情,请参阅 zx_process_create()

权限

shared_proc 必须是 ZX_OBJ_TYPE_PROCESS 类型,并且具有 ZX_RIGHT_MANAGE_PROCESS

请参见zx_process_create()

返回值

操作成功后,zx_process_create_shared() 会返回 ZX_OK、新进程的句柄(通过 proc_handle)和指向其受限地址空间根目录的句柄(通过 restricted_vmar_handle)。如果失败,则返回负数错误值。

如需了解详情,请参阅 zx_process_create()

错误

ZX_ERR_INVALID_ARGS shared_proc 是有效的句柄,但指向的进程并非通过 zx_process_create_shared()zx_process_create() 使用 ZX_PROCESS_SHARED 创建。

ZX_ERR_BAD_HANDLE shared_proc 不是有效的句柄。

ZX_ERR_WRONG_TYPE shared_proc 不是进程句柄。

ZX_ERR_BAD_STATE shared_proc 是有效的句柄,但共享状态不再有效(可能是因为所有进程共享状态终止)。

ZX_ERR_ACCESS_DENIED shared_proc 没有 ZX_RIGHT_MANAGE_PROCESS 权限(仅当不是 ZX_HANDLE_INVALID 时)。

如果看到其他错误,请参阅 zx_process_create()

另请参阅