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

# VOP\_GETACL.9

`VOP_GETACL` — 检索 vnode 的访问控制列表

## 名称

`VOP_GETACL`

## 概要

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

int
VOP_GETACL(struct vnode *vp, acl_type_t type, struct acl *aclp,
    struct ucred *cred, struct thread *td)
```

## 描述

此 vnode 调用可用于从文件或目录检索访问控制列表（ACL）。

其参数为：

**`vp`** 文件或目录的 vnode。

**`type`** 要检索的 ACL 类型。

**`aclp`** 指向用于接收 ACL 数据的 ACL 结构的指针。

**`cred`** 用于授权请求的用户凭据。

**`td`** 请求 ACL 的线程。

`cred` 指针可以为 `NULL`，以指示在可能的情况下不执行访问控制检查。此 cred 设置可用于允许内核授权活动进程可能不被允许执行的 ACL 检索。

vnode ACL 接口定义了文件和目录 ACL 接口的语法，而非语义。关于内核中 ACL 管理的更多信息，请参见 [acl(9)](/man/man9/acl.9.md)。

## 锁定

vnode 在入口时将被锁定，并在返回时应保持锁定状态。

## 返回值

如果 `aclp` 指针将指向有效的 ACL，则返回零。否则，返回适当的错误代码。

## 错误

**\[`EINVAL`]** 传递的 ACL 类型对此 vnode 无效。

**\[`EACCES`]** 调用者没有适当的权限。

**\[`ENOMEM`]** 没有足够的内存来满足请求。

**\[`EOPNOTSUPP`]** 文件系统不支持 `VOP_GETACL`。

## 参见

[acl(9)](/man/man9/acl.9.md), [vnode(9)](/man/man9/vnode.9.md), [VOP\_ACLCHECK(9)](/man/man9/vop_aclcheck.9.md), [VOP\_SETACL(9)](/man/man9/vop_setacl.9.md)

## 作者

本手册页由 Robert Watson 编写。


---

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