task_kill - Kill the provided task (job, process, or thread).
#include <zircon/syscalls.h> zx_status_t zx_task_kill(zx_handle_t handle);
This asynchronously kills the given process, thread or job and its children recursively, until the entire task tree rooted at handle is dead.
It is possible to wait for the task to be dead via the ZX_TASK_TERMINATED signal. When the procedure completes, as observed by the signal, the task and all its children are considered to be in the dead state and most operations will no longer succeed.
If handle is a job and the syscall is successful, the job cannot longer be used to create new processes.
handle must have ZX_RIGHT_DESTROY.
On success, zx_task_kill() returns ZX_OK. If a process or thread uses this syscall to kill itself, this syscall does not return.
When using this syscall on a process, the return code for the process is -1 as reported by object_get_info() via the ZX_INFO_PROCESS topic.
ZX_ERR_BAD_HANDLE handle is not a valid handle.
ZX_ERR_WRONG_TYPE handle is not a task handle.
ZX_ERR_ACCESS_DENIED handle does not have the ZX_RIGHT_DESTROY right.