blob: 6183b219a1eaa2552bf1f607f1a8347d14ecbf0a [file] [log] [blame]
// 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>
// 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.