Return to pms.4 CVS log

Up to [cvs.NetBSD.org] / src / share / man / man4

Annotation of src/share/man/man4/pms.4, Revision 1.10

1.10    ! grant       1: .\" $NetBSD: pms.4,v 1.9 2003/01/06 11:29:01 wiz Exp $
1.1       drochner    2: .\"
                      3: .\" Copyright (c) 1993 Christopher G. Demetriou
                      4: .\" All rights reserved.
1.5       wiz         5: .\"
1.1       drochner    6: .\" Redistribution and use in source and binary forms, with or without
                      7: .\" modification, are permitted provided that the following conditions
                      8: .\" are met:
                      9: .\" 1. Redistributions of source code must retain the above copyright
                     10: .\"    notice, this list of conditions and the following disclaimer.
                     11: .\" 2. Redistributions in binary form must reproduce the above copyright
                     12: .\"    notice, this list of conditions and the following disclaimer in the
                     13: .\"    documentation and/or other materials provided with the distribution.
                     14: .\" 3. All advertising materials mentioning features or use of this software
                     15: .\"    must display the following acknowledgement:
1.3       cgd        16: .\"          This product includes software developed for the
1.10    ! grant      17: .\"          NetBSD Project.  See http://www.NetBSD.org/ for
1.3       cgd        18: .\"          information about NetBSD.
1.1       drochner   19: .\" 4. The name of the author may not be used to endorse or promote products
1.3       cgd        20: .\"    derived from this software without specific prior written permission.
1.5       wiz        21: .\"
1.1       drochner   22: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
                     23: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
                     24: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
                     25: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
                     26: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
                     27: .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
                     28: .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
                     29: .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
                     30: .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
                     31: .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
1.5       wiz        32: .\"
1.3       cgd        33: .\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
1.1       drochner   34: .\"
                     35: .Dd March 12, 1997
                     36: .Dt PMS 4
                     37: .Os
                     38: .Sh NAME
                     39: .Nm pms
                     40: .Nd PS/2 auxiliary port mouse driver
                     41: .Sh SYNOPSIS
                     42: .Cd pckbc* at isa?
                     43: .Cd pms* at pckbc?
                     44: .Cd wsmouse* at pms?
                     45: .Sh DESCRIPTION
                     46: The
                     47: .Nm
1.7       christos   48: driver provides an interface to PS/2 auxiliary port mice within the
1.1       drochner   49: .Xr wscons 4
                     50: framework. Parent device in terms of the autoconfiguration framework is
                     51: .Xr pckbc 4 ,
                     52: the PC keyboard controller.
                     53: .Dq pms
1.7       christos   54: is a generic driver which supports mice using common variants of the PS/2
                     55: protocol, including wheel mice of the
1.1       drochner   56: .Dq IntelliMouse
1.7       christos   57: breed.  Wheel movements are mapped to a third (z-) axis.  The driver is
                     58: believed to work with both 3-button and 5-button mice with scroll wheels.
                     59: Mice which use other protocol extensions are not currently supported, but
                     60: might be if protocol documentation could be found.
1.1       drochner   61: Mouse related data are accessed by
                     62: .Xr wsmouse 4
                     63: devices.
1.7       christos   64: .Pp
                     65: The
                     66: .Nm
                     67: driver has been updated to attempt to renegotiate mouse protocol after seeing
                     68: suspicious or defective mouse protocol packets, or unusual delays in the
                     69: middle of a packet; this should improve the chances that a mouse will recover
                     70: after being switched away or reset (for instance, by a console switch).
1.1       drochner   71: .Sh SEE ALSO
1.6       wiz        72: .Xr pckbc 4 ,
1.1       drochner   73: .Xr ums 4 ,
1.6       wiz        74: .Xr wsmouse 4
1.7       christos   75: .Sh AUTHORS
                     76: The
                     77: .Nm
                     78: driver was originally written by Christopher G. Demetriou.  The changes to
                     79: merge the
                     80: .Dq IntelliMouse
                     81: protocol in, and reset the mouse in the event of protocol problems, were
                     82: contributed by Peter Seebach.  Special thanks to Ray Trent, at Synaptics,
                     83: who contributed valuable insight into how to identify bogus mouse data.
1.8       wiz        84: .Sh BUGS
                     85: It is possible for the driver to mistakenly negotiate the non-scroll-wheel
                     86: protocol, after which it is unlikely to recover until the device is closed
                     87: and reopened.