---
name: "ums"
section: "4"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["linux", "freebsd", "openbsd"]
url: "https://new.carta.tech/ums"
---

# ums(4)

USB mouse driver

## NAME

**ums** – USB mouse driver

## SYNOPSIS

**device** **hid** **device** **uhci** **device** **ohci** **device** **usb** **device** **ums**

In [loader.conf(5)](/loader.conf/5.md): **ums\_load="YES"**

## DESCRIPTION

The **ums** driver provides support for mice that attach to the USB port. Supported are mice with any number of buttons and mice with a wheel.

The */dev/ums0* device presents the mouse as a *sysmouse* or *mousesystems* type device. See [moused(8)](/moused/8.md) for an explanation of these mouse types.

## SYSCTL VARIABLES

The following variables are available as both [sysctl(8)](/sysctl/8.md) variables and [loader(8)](/loader/8.md) tunables:

- *hw.usb.ums.debug*

  Debug output level, where 0 is debugging disabled and larger values increase debug message verbosity. Default is 0.

## FILES

- */dev/ums0*

  blocking device node

## EXAMPLES

Use the first USB mouse on the system as your console mouse:

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

To be able to use the USB mouse under X, change the "Pointer" section in **xorg.conf** to the following:

```
Device /dev/ums0
```

```
Protocol Auto
```

If you want to be able to use the mouse in both virtual consoles as well as in X change it to:

```
Device /dev/sysmouse
```

```
Protocol Auto
```

## SEE ALSO

[ohci(4)](/ohci/4.md), [sysmouse(4)](/sysmouse/4.md), [uhci(4)](/uhci/4.md), [usb(4)](/usb/4.md), [xorg.conf(5)](/xorg.conf/5.md) (*ports/x11/xorg*), [moused(8)](/moused/8.md)

## AUTHORS

The **ums** driver was written by Lennart Augustsson ⟨*augustss@cs.chalmers.se*⟩ for NetBSD and was adopted for FreeBSD by MAEKAWA Masahide ⟨*bishop@rr.iij4u.or.jp*⟩.

This manual page was written by Nick Hibma ⟨*n\_hibma@FreeBSD.org*⟩ with input from Kazutaka YOKOTA ⟨*yokota@zodiac.mech.utsunomiya-u.ac.jp*⟩.