MOUSE_DIAG(8)

NAME
Mouse_Diag is a simple utility that reads data directly from the PS/2 style pointing device and displays both the data stream and a translation corresponding to the type of Logitech Mouse event that it represents. It is designed to be used in conjunction with Enable_Logitech_Wheel to allow OEM versions of the Logitech FirstMouse+ to function fully under Xwindows and the standard console.

SYNOPSIS

Mouse_Diag /dev/device

DESCRIPTION
Mouse_Diag is designed to display the type of events that the mouse device is broadcasting. Currently the standard MouseManPlusPS2 protocol events are supported with the following references:

[ 0x00000008 ] : Mouse Button Release
[ 0x00000009 ] : Mouse Button 1 DOWN
[ 0x0000000a ] : Mouse Button 2 DOWN
[ 0x0000000c ] : Mouse Button 3 DOWN
[ 0x000fdec8 ] : Mouse Button Wheel Up
[ 0x0001d6c8 ] : Mouse Button Wheel Down
[ 0x00000108 ] : Mouse Right
[ 0x0000ff18 ] : Mouse Left
[ 0x00010008 ] : Mouse Up
[ 0x00ff0028 ] : Mouse Down
[ Other ] : Unknown Event

Events are three bytes long with low byte representing the first data passed on the port. For display purposes, events are padded with an extra zero byte and displayed as a long word.

If no /dev/device is specified the program will default to /dev/mouse.

OPTIONS
None

FILES

/dev/mouse
    Symbolic link to the character device which the mouse is connected to (normally /dev/psaux)

SEE ALSO

Enable_Logitech_Wheel (8), gpm (1), XF86Config (4)

BUGS

The Mouse_Diag program must be run as root since it will directly write to the mouse port. Additionally it should be run ONLY from the console and with gpm disabled (to disable gpm on most systems issue /etc/rc.d/init.d/gpm stop. The utillity should not be run from an Xterm or while an X server has control over the port.

The program is compiled with a limit on the number of events it will process before self terminating. This feature is present as a failsafe to prevent certain deadlock and race conditions which can occur if the diagnostic is run without disabling gpm or while in Xwindows.

AUTHOR

A. Norman Dept. of Physics College of William & Mary Email: norman@physics.wm.edu
WWW: http://www.physics.wm.edu/ norman/.