Module Name: src
Committed By: dholland
Date: Mon Jun 7 03:04:50 UTC 2021
Modified Files:
src/share/man/man4: ums.4
Log Message:
Mention in ums(4) that a lot of usb mice detach/reattcah when not in use.
Prompted by PR 56209 but not related to the actual problem there.
To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man4/ums.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/ums.4
diff -u src/share/man/man4/ums.4:1.11 src/share/man/man4/ums.4:1.12
--- src/share/man/man4/ums.4:1.11 Wed Sep 6 14:47:35 2017
+++ src/share/man/man4/ums.4 Mon Jun 7 03:04:50 2021
@@ -1,4 +1,4 @@
-.\" $NetBSD: ums.4,v 1.11 2017/09/06 14:47:35 ryoon Exp $
+.\" $NetBSD: ums.4,v 1.12 2021/06/07 03:04:50 dholland Exp $
.\"
.\" Copyright (c) 1999, 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd September 6, 2017
+.Dd June 6, 2021
.Dt UMS 4
.Os
.Sh NAME
@@ -43,6 +43,16 @@ driver provides support for USB mice and
Access to the movement data is through the
.Xr wsmouse 4
driver.
+.Pp
+Be aware that many USB mice will, if the mouse device is not open,
+detach and reattach themselves repeatedly at regular intervals
+(usually around one minute) causing spam on the console and the system
+log.
+This is apparently intentional behavior on the part of the hardware
+manufacturers.
+The best workaround is to keep the mouse device open, either via
+X11, or, if not using the window system, by running
+.Xr wsmoused 8 .
.Sh SEE ALSO
.Xr uhidev 4 ,
.Xr usb 4 ,
