> 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/man4/agp.4.md). # agp.4 `agp` — 加速图形端口（AGP）的通用接口 ## 名称 `agp` ## 概要 `device agp` ## 弃用通知 `agp` 驱动计划在 FreeBSD 16.0 中移除。 ## 描述 `agp` 驱动提供控制以下设备的统一、抽象方法： **Ali:** M1541、M1621 和 M1671 host 到 AGP 桥 **AMD:** 751、761 和 762 host 到 AGP 桥 **ATI:** RS100、RS200、RS250 和 RS300 AGP 桥 **Intel:** i820、i840、i845、i850 和 i860 host 到 AGP 桥 **Intel:** i810、i810-DC100、i810E、i815、830M、845G、845M、852GM、852GME、855GM、855GME、865G、915G 和 915GM SVGA 控制器 **Intel:** 82443BX、82443GX、82443LX、82815、82820、82830、82840、82845、82845G、82850、82855、82855GM、82860、82865、82875P、E7205 和 E7505 host 到 AGP 桥 **NVIDIA:** nForce 和 nForce2 AGP 控制器 **SiS:** 530、540、550、620、630、645、645DX、648、650、651、655、661、730、735、740、741、745、746、760 和 5591 host 到 AGP 桥 **VIA:** 3296、82C597、82C598、82C691、82C694X、82C8363、8235、8237、8361、8367、8371、8377、8501、8601、862x、8633、8653、8703、8753、8754、8763、8783、KT880、PM800、PM880、PN800、PN880、PT880、XM266 和 XN266 host 到 PCI 桥 `agp` 最常见的应用是在 Intel i81x 控制器上运行 X(7)（`ports/x11/xorg-docs`）。 ## IOCTL 可在 **`/dev/agpgart`** 上执行以下 ioctl(2) 操作，它们定义于 `#include ` ```sh typedef struct _agp_info { agp_version version; /* 驱动版本 */ uint32_t bridge_id; /* 桥厂商/设备 */ uint32_t agp_mode; /* 桥模式信息 */ off_t aper_base; /* 孔径基址 */ size_t aper_size; /* 孔径大小 */ size_t pg_total; /* 最大页数（交换 + 系统） */ size_t pg_system; /* 最大页数（系统） */ size_t pg_used; /* 当前已用页数 */ } agp_info; ``` ```sh typedef struct _agp_setup { uint32_t agp_mode; /* 桥模式信息 */ } agp_setup; ``` `#include ` ```sh typedef struct _agp_allocate { int key; /* 分配标签 */ size_t pg_count; /* 页数 */ uint32_t type; /* 0 == 普通，其他由设备定义 */ uint32_t physical; /* 设备专用（某些设备 * 需要 gatt 表背后实际页面的 * 物理地址） */ } agp_allocate; ``` ```sh typedef struct _agp_bind { int key; /* 分配标签 */ off_t pg_start; /* 起始填充页 */ } agp_bind; ``` ```sh typedef struct _agp_unbind { int key; /* 分配标签 */ uint32_t priority; /* 换出优先级 */ } agp_unbind; ``` **`AGPIOC_INFO`** 返回 `agp` 系统的状态。结果为指向以下结构的指针： **`AGPIOC_ACQUIRE`** 为此客户端获取 AGP 芯片组的控制权。如果 AGP 芯片组已被另一客户端获取，返回 Er EBUSY。 **`AGPIOC_RELEASE`** 释放对 AGP 芯片组的控制。这不会取消绑定或释放任何已分配的内存，如有必要由客户端负责处理。 **`AGPIOC_SETUP`** 以相关模式启用 AGP 硬件。此 ioctl(2) 接受以下结构：模式位定义于 **`AGPIOC_ALLOCATE`** 分配适合映射到 AGP 孔径的物理内存。此 ioctl(2) 接受以下结构：返回已分配内存的句柄。 **`AGPIOC_DEALLOCATE`** 释放与传入句柄关联的先前分配的内存。 **`AGPIOC_BIND`** 将已分配内存绑定到 AGP 孔径的给定偏移处。如果内存已绑定或偏移不在 AGP 页边界，返回 Er EINVAL。此 ioctl(2) 接受以下结构：分配标签是 `AGPIOC_ALLOCATE` 返回的句柄。 **`AGPIOC_UNBIND`** 从 AGP 孔径取消绑定内存。如果内存未绑定，返回 Er EINVAL。此 ioctl(2) 接受以下结构： ## 文件 **`/dev/agpgart`** AGP 设备节点。 ## 参见 X(7) (`ports/x11/xorg`) ## 历史 `agp` 驱动首次出现于 FreeBSD 4.1。 --- # 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/man4/agp.4.md?ask=&goal= ``` `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.