| // Copyright 2017 The Fuchsia Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #pragma once |
| |
| #include <zircon/compiler.h> |
| #include <zircon/syscalls/object.h> |
| #include <zircon/types.h> |
| |
| __BEGIN_CDECLS |
| |
| // Tries to get a handle to the task with the specified koid. |
| // Return values: |
| // ZX_OK: The task was found: |*out| is a handle to it, and |*type| indicates |
| // whether it's a job, process, or thread |
| // (ZX_OBJ_TYPE_JOB/PROCESS/THREAD). The caller is responsible for closing |
| // the handle. |
| // ZX_ERR_NOT_FOUND: Could not find a task with the specified koid. |
| // ZX_ERR_INVALID_ARGS: |type| or |out| is NULL. |
| // Will fail if the calling process does not have the rights to access the root |
| // job. |
| zx_status_t get_task_by_koid( |
| zx_koid_t koid, zx_obj_type_t* type, zx_handle_t* out); |
| // TODO(dbort): Add a "desired type" so we don't walk every thread in the |
| // system just to find a job. |
| |
| __END_CDECLS |
