xref: /netbsd-src/share/man/man4/ums.4 (revision 7cec841687f393a2d702dcaff6f70292296d3a5d)
1.\" $NetBSD: ums.4,v 1.12 2021/06/07 03:04:50 dholland Exp $
2.\"
3.\" Copyright (c) 1999, 2001 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Lennart Augustsson.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd June 6, 2021
31.Dt UMS 4
32.Os
33.Sh NAME
34.Nm ums
35.Nd USB mouse and touchpanel support
36.Sh SYNOPSIS
37.Cd "ums*     at uhidev? reportid ?"
38.Cd "wsmouse* at ums?"
39.Sh DESCRIPTION
40The
41.Nm
42driver provides support for USB mice and touchpanels.
43Access to the movement data is through the
44.Xr wsmouse 4
45driver.
46.Pp
47Be aware that many USB mice will, if the mouse device is not open,
48detach and reattach themselves repeatedly at regular intervals
49(usually around one minute) causing spam on the console and the system
50log.
51This is apparently intentional behavior on the part of the hardware
52manufacturers.
53The best workaround is to keep the mouse device open, either via
54X11, or, if not using the window system, by running
55.Xr wsmoused 8 .
56.Sh SEE ALSO
57.Xr uhidev 4 ,
58.Xr usb 4 ,
59.Xr wsmouse 4
60.Sh HISTORY
61The
62.Nm
63driver
64appeared in
65.Nx 1.4 .
66Touchpanel support was added in
67.Nx 5.1 .
68