> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man9/pget.9.md).

# pget(9)

`pget` — 按编号定位进程

## 名称

`pget`

## 概要

```c
#include <sys/param.h>
```

```c
#include <sys/proc.h>
```

```c
int
pget(pid_t pid, int flags, struct proc **pp)
```

## 描述

此函数接受 `pid` 作为参数，它可以是进程 ID 或线程 ID，并在 `*pp` 中填写指向 `proc` 结构的指针。在后一种情况下，将查找拥有指定线程的进程。该操作通过调用 [pfind(9)](/man/man9/pfind.9.md) 函数执行。找到的进程以锁定状态返回。对于 `PGET_HOLD` 情况，以未锁定（但被持有）状态返回。`pget` 函数可以根据 `flags` 参数执行额外操作。

`flags` 参数是以下某些子集的逻辑或：

**`PGET_HOLD`** 如果设置，找到的进程将被持有并解锁。

**`PGET_CANSEE`** 如果设置，将检查找到的进程的可见性。参见 [p\_cansee(9)](/man/man9/p_cansee.9.md)。

**`PGET_CANDEBUG`** 如果设置，将检查找到的进程的可调试性。参见 [p\_candebug(9)](/man/man9/p_candebug.9.md)。

**`PGET_ISCURRENT`** 如果设置，将检查找到的进程是否匹配当前进程上下文。

**`PGET_NOTWEXIT`** 如果设置，将检查找到的进程是否未设置进程标志 `P_WEXIT`。

**`PGET_NOTINEXEC`** 如果设置，将检查找到的进程是否未设置进程标志 `P_INEXEC`。

**`PGET_NOTID`** 如果设置，对于大于 `PID_MAX` 的值，不将 `pid` 假定为线程 ID。

**`PGET_WANTREAD`** 如果设置，将检查找到的进程以确保调用者可以对其结构进行读取访问。这是 (`PGET_HOLD | PGET_CANDEBUG | PGET_NOTWEXIT`) 的简写。

## 返回值

如果以指定方式找到进程，则返回零，否则返回适当的错误代码。

## 参见

[p\_candebug(9)](/man/man9/p_candebug.9.md), [p\_cansee(9)](/man/man9/p_cansee.9.md), [pfind(9)](/man/man9/pfind.9.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man9/pget.9.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.