PMS(4)                OpenBSD Programmer's Manual (i386)                PMS(4)

NAME
     pms - PS/2 auxiliary port mouse driver

SYNOPSIS
     pms0 at pckbd? irq 12

DESCRIPTION
     This driver provides an interface to a PS/2 auxiliary port mice.  The
     driver offers two modes of operation, both a raw and the old style trans-
     lated input stream.  The translating portion of the driver provides Bus-
     Mouse codes; in raw mode no translations are performed.  The pms driver
     provides three ioctls for getting mouse status and changing modes.  They
     are defined in the following include:

           #include <machine/mouse.h>

     The MOUSEIOCREAD ioctl is used to read the current mouse stats, and takes
     the struct mouseinfo as an argument to store the data in.

     The MOUSEIOCSRAW ioctl puts the device into raw mode, if it is not al-
     ready, and the MOUSEIOCSCOOKED ioctl puts it into translated (or cooked)
     mode.  If the mode of the pms device driver changes, all pending but not
     yet read input is flushed.

     In translated mode, the pms driver also supports ``Intellimouse'' de-
     vices, with the wheel acting as a third button.  The kernel must current-
     ly be compiled with

     option INTELLIMOUSE

     specified in the config file, and the X server can be configured to use
     the translated mode of the driver.  (The output of the translated mode is
     Busmouse compatible.)  Otherwise, the mouse works as a normal, two but-
     ton, PS/2 device.

NOTES
     The translated mode of this driver is being deprecated. The raw device
     /dev/psm0 should be used in /etc/XF86Config with the PS/2 protocol, or
     one of its variants (IMPS/2 for MS Intellimouse, ThinkingMousePS/2 for
     Kensington Thinking Mouse).

FILES
     /dev/psm0  PS/2 mouse device file, defaulting to raw mode
     /dev/pms0  PS/2 mouse device file, defaulting to translating mode

SEE ALSO
     lms(4), mms(4), XF86Config(4)

OpenBSD 2.8                    October 10, 1999                              1
