tail head cat sleep
QR code linking to this page

Manual Pages  — UMS


ums – USB mouse driver



To compile this driver into the kernel, place the following lines in your kernel configuration file: device ums device uhci device ohci device usb

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):



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) for an explanation of these mouse types.


  blocking device node


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


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


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

This manual page was written by Nick Hibma <Mt n_hibma@FreeBSD.org> with input from Kazutaka YOKOTA <Mt yokota@zodiac.mech.utsunomiya-u.ac.jp>.

UMS (4) November 27, 2006

tail head cat sleep
QR code linking to this page

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

Our grievance is not just against Unix itself, but against the cult of Unix zealots who defend and nurture it. They take the heat, disease, and pestilence as givens, and, as ancient shamans did, display their wounds, some self-inflicted, as proof of their power and wizardry. We aim, through bluntness and humor, to show them that they pray to a tin god, and that science, not religion, is the path to useful and friendly technology.
— The Unix Haters' handbook