> 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/ums.4.md).

# ums.4

`ums` — USB 鼠标驱动

## 名称

`ums`

## 概要

要将此驱动编译进内核，请将以下行加入你的内核配置文件：

> device ums device hid device uhci device ohci device usb

或者，要在引导时以模块方式加载该驱动，请将以下行加入 loader.conf(5)：

```sh
ums_load="YES"
```

## 描述

`ums` 驱动为连接到 USB 端口的鼠标提供支持。支持任意数量按键的鼠标以及带滚轮的鼠标。

**/dev/ums0** 设备将鼠标呈现为 `sysmouse` 或 `mousesystems` 类型设备。有关这些鼠标类型的说明，请参见 [moused(8)](/man/man8/moused.8.md)。

## SYSCTL 变量

以下变量既可作为 [sysctl(8)](/man/man8/sysctl.8.md) 变量，也可作为 [loader(8)](/man/man8/loader.8.md) 可调参数使用：

**`hw.usb.ums.debug`** 调试输出级别，0 表示禁用调试，更大的值会增加调试消息的详细程度。默认值为 0。

## 文件

**/dev/ums0** 阻塞型设备节点

## 实例

将系统上的第一个 USB 鼠标作为控制台鼠标使用：

```sh
moused -p /dev/ums0 -t auto
```

要在 X 下使用 USB 鼠标，请将 `xorg.conf` 中的 "Pointer" 段修改为如下内容：

```sh
Device /dev/ums0
```

```sh
Protocol Auto
```

如果你希望同时在虚拟控制台和 X 中使用鼠标，请将其改为：

```sh
Device /dev/sysmouse
```

```sh
Protocol Auto
```

## 参见

[ohci(4)](/man/man4/ohci.4.md), [sysmouse(4)](/man/man4/sysmouse.4.md), [uhci(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/uhci.4.md), [usb(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/usb.4.md), xorg.conf(5) (**ports/x11/xorg**), [moused(8)](/man/man8/moused.8.md)

## 作者

`xorg.conf` 驱动由 Lennart Augustsson <augustss@cs.chalmers.se> 为 NetBSD 编写，并由 MAEKAWA Masahide <bishop@rr.iij4u.or.jp> 移植到 FreeBSD。

本手册页由 Nick Hibma <n_hibma@FreeBSD.org> 编写，Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp> 提供了输入。


---

# 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/ums.4.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.