> 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/pfind.9.md).

# pfind.9

`pfind` — 按编号定位进程

## 名称

`pfind`, `pfind_any`, `pfind_any_locked`

## 概要

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

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

```c
struct proc *
pfind(pid_t pid)

struct proc *
pfind_any(pid_t pid)

struct proc *
pfind_any_locked(pid_t pid)
```

## 描述

`pfind` 函数遍历系统中的进程列表，查找进程 ID 为 `pid` 的进程。如果进程存在且不处于僵尸状态，将返回指向该进程结构的指针。

`pfind_any` 接受 `pid` 作为参数。`pfind_any` 搜索 `allproc` 列表并返回第一个具有匹配 PID 的进程，其状态可以是 `PRS_ZOMBIE`。

`pfind_any_locked` 类似于 `pfind_any`，但它不锁定给定 `pid` 的进程哈希桶。相反，它断言相应的进程哈希桶已被锁定。

所有三个函数 `pfind`、`pfind_any` 和 `pfind_any_locked` 在返回前都锁定 `proc` 结构。

## 返回值

`pfind`、`pfind_any` 和 `pfind_any_locked` 成功时返回指向 `proc` 结构的指针，失败时返回 `NULL`。

## 参见

[pget(9)](/man/man9/pget.9.md), [pgfind(9)](/man/man9/pgfind.9.md)

## 作者

本手册页由 Evan Sarmiento <kaworu@sektor7.ath.cx> 编写。


---

# 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/pfind.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.