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

# vm\_map\_protect.9

`vm_map_protect` — 将保护位应用到虚拟内存区域

## 名称

`vm_map_protect`

## 概要

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

int
vm_map_protect(vm_map_t map, vm_offset_t start, vm_offset_t end,
    vm_prot_t new_prot, vm_prot_t new_maxprot, int flags)
```

## 描述

`vm_map_protect` 函数设置映射 `map` 中由 `start` 和 `end` 界定的地址区域的保护位和最大保护位。

如果 `flags` 参数设置了 `VM_MAP_PROTECT_SET_PROT` 位，则有效保护设置为 `new_prot`。

如果 `flags` 参数设置了 `VM_MAP_PROTECT_SET_MAXPROT` 位，则最大保护设置为 `new_maxprot`。未包含在 `new_maxprot` 中的保护位将从现有条目中清除。

`new_prot` 和 `new_maxprot` 指定的值不允许包含范围内每个条目的现有 `max_protection` 中未设置的任何保护位。如果违反此条件，操作将失败。例如，这防止了将只读文件的共享映射从只读升级为读写。

指定的范围不得包含子映射。

## 实现说明

该函数通过调用 [vm\_map\_lock(9)](/man/man9/vm_map_lock.9.md) 在执行期间获取 `map` 上的锁。此外，映射上影响指定范围的任何正在进行的锁定操作都会导致 `vm_map_protect` 睡眠，等待其完成。

## 返回值

**`KERN_SUCCESS`** 指定的保护位设置成功。

**`KERN_INVALID_ARGUMENT`** 在范围内遇到子映射条目。

**`KERN_PROTECTION_FAILURE`** `new_prot` 或 `new_maxprot` 的值超过了范围内某个条目的 `max_protection`。

**`KERN_PROTECTION_FAILURE`** 映射不允许同时设置写和执行权限，但 `new_prot` 同时设置了 `VM_PROT_WRITE` 和 `VM_PROT_EXECUTE`。

**`KERN_RESOURCE_SHORTAGE`** 写时复制映射从只读转换为读写，但没有足够的交换空间来支持复制的页面。

**`KERN_OUT_OF_BOUNDS`** 请求同时更新新保护和新最大保护，但指定的 `new_prot` 不是 `new_maxprot` 的子集。

## 参见

[vm\_map(9)](/man/man9/vm_map.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_protect.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.