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

# vm\_map\_find.9

`vm_map_find` — 在映射中查找空闲区域，并可选地映射一个 vm\_object

## 名称

`vm_map_find`

## 概要

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

int
vm_map_find(vm_map_t map, vm_object_t object, vm_ooffset_t offset,
    vm_offset_t *addr, vm_size_t length, vm_offset_t max_addr,
    int find_space, vm_prot_t prot, vm_prot_t max, int cow)
```

## 描述

`vm_map_find` 函数尝试在目标 `map` 中查找具有给定 `length` 的空闲区域。如果找到空闲区域，`vm_map_find` 通过调用 [vm\_map\_insert(9)](/man/man9/vm_map_insert.9.md) 创建 `object` 的映射。

参数 `offset`、`prot`、`max` 和 `cow` 在创建映射时（仅当找到空闲区域时）原封不动地传递给 [vm\_map\_insert(9)](/man/man9/vm_map_insert.9.md)。

如果 `object` 非 `NULL`，调用者在调用此函数之前必须增加该对象的引用计数，以计入新的条目。

如果 `max_addr` 非零，它指定映射的上界。仅当能找到完全位于 `max_addr` 之下的空闲区域时，映射才会成功。

`find_space` 参数指定在搜索所请求长度的空闲区域时要使用的策略。对于除 `VMFS_NO_SPACE` 外的所有值，将调用 [vm\_map\_findspace(9)](/man/man9/vm_map_findspace.9.md) 来定位起始地址大于或等于 `*addr` 的所请求长度的空闲区域。支持以下策略：

**`VMFS_NO_SPACE`** 仅当在给定地址 `*addr` 处存在所请求长度的空闲区域时，映射才会成功。

**`VMFS_ANY_SPACE`** 只要存在空闲区域，映射就会成功。

**`VMFS_SUPER_SPACE`** 只要存在起始地址位于超级页边界上的空闲区域，映射就会成功。如果 `object` 非 `NULL` 且已由超级页支持，则映射将需要相对于现有超级页对齐的空闲区域，而不是起始地址位于超级页边界上的空闲区域。

**`VMFS_OPTIMAL_SPACE`** 只要存在空闲区域，映射就会成功。但是，如果 `object` 非 `NULL` 且已由超级页支持，此策略将尝试查找到相对于现有超级页对齐的空闲区域。

**`VMFS_ALIGNED_SPACE`** (`n`) 只要存在在 2^`n` 边界上对齐的空闲区域，映射就会成功。

## 实现说明

此函数通过调用 [vm\_map\_lock(9)](/man/man9/vm_map_lock.9.md) 获取 `map` 上的锁，并持有该锁直到函数返回。

空闲区域的搜索定义为从地址 `addr` 起的首次适配（first-fit）。

## 返回值

`vm_map_find` 函数在映射成功创建时返回 `KERN_SUCCESS`。如果找不到空间，或 `find_space` 为 `VMFS_NO_SPACE` 且给定地址 `addr` 已被映射，则返回 `KERN_NO_SPACE`。如果发现的范围无效，则返回 `KERN_INVALID_ADDRESS`。

## 参见

[vm\_map(9)](/man/man9/vm_map.9.md), [vm\_map\_findspace(9)](/man/man9/vm_map_findspace.9.md), [vm\_map\_insert(9)](/man/man9/vm_map_insert.9.md), [vm\_map\_lock(9)](/man/man9/vm_map_lock.9.md)

## 作者

本手册页由 Bruce M Simpson <bms@spc.org> 编写。


---

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