MOUSED(8)           OpenBSD System Manager's Manual (i386)           MOUSED(8)

NAME
     moused - mouse daemon

SYNOPSIS
     moused [-3DPRcdfs] [-I pid_file] [-F rate] [-r resolution] [-S baudrate]
            [-C threshold] [-t protocol] [-m mousetype] [-M N=M] [-w N] [-z
            target] [-b buttons] -p device
     moused -i info -p device

DESCRIPTION
     moused listens for mouse events on the specified device and communicates
     them to the pcvt(4) driver through the /dev/pcvtctl interface.  Its pur-
     pose is to provide copy/paste functionality on the PC console.

     By default, the left mouse button is used to select text (in the familiar
     click-and-drag fashion), the right button is used to extend the selec-
     tion, and the middle button pastes.  This behavior can be modified
     through the use of -M, i.e., -M 2=3 maps the right mouse button to paste.

     The options are as follows:

     -3      Emulate the third (middle) button for 2-button mice.  It is emu-
             lated by pressing the left and right physical buttons simultane-
             ously.

     -C      Set double click speed as the maximum interval in msec between
             button clicks.  If omitted, the default value of 500 msec will be
             assumed.  This option will have effect only on the cut and paste
             operations in the text mode console.

     -D      Lower DTR on the serial port.  This option is valid only if
             mousesystems is selected as the protocol type.  The DTR line may
             need to be dropped for a 3-button mouse to operate in the
             mousesystems mode.

     -F rate
             Set the report rate (reports/sec) of the device, if supported.

     -I file
             Write the process ID of moused to the specified file. If omitted,
             the process ID will be stored in /var/run/moused.pid.

     -P      Do not start the Plug and Play COM device enumeration procedure
             when identifying the serial mouse.  If this option is given to-
             gether with the -i option, moused won't be able to print useful
             information for the serial mouse.

     -R      Lower RTS on the serial port.  This option is valid only if
             mousesystems is selected as the protocol type by the -t option
             below.  It is often used with the -D option above.  Both the RTS
             and DTR lines may need to be dropped for a 3-button mouse to op-
             erate in the mousesystems mode.  is selected as the protocol type
             by the mousesystems mode.

     -S baudrate
             Select the baudrate for the serial port (1200 to 9600). Not all
             serial mice support this option.

     -c      Some mice report middle button down events as if the left and
             right buttons are pressed.  This option handles this.



     -d      Enable debugging messages.

     -f      Do not become a daemon and instead run as a foreground process.
             Useful for testing and debugging.

     -i info
             Print specified information and quit.  Available pieces of infor-
             mation are:

             port   Device name, i.e., /dev/cua0[0-3] for a serial mouse,
                    /dev/lms0 for a logitech-style bus mouse, /dev/mms0 for a
                    microsoft-style bus mouse and /dev/psm0 for a PS/2 mouse.

             if     Physical interface: serial, bus, inport, or PS/2.

             type   Protocol type: one of the types supported by the -t op-
                    tion.

             model  Mouse model.  moused may not always be able to identify
                    the model.

             all    All of the above options.  Print device name, physical in-
                    terface, type, and model in this order, on a single line.

     -m mousetype
             Precise the model of the mouse.  For example, intellimouse can be
             specified for a PS/2 mouse with a wheel.

     -M N=M  Assign the physical button N to the logical button M. You may
             specify as many instances of this option as you like.  More than
             one physical button may be assigned to a logical button at the
             same time.  In this case the logical button will be down, if ei-
             ther of the assigned physical buttons is held down.  Do not put
             space around `='.

     -w N    Make the physical button N act as the wheel mode button.  While
             this button is pressed, X and Y axis movement is reported to be
             zero and the Y axis movement is mapped to Z axis.  You may fur-
             ther map the Z axis movement to virtual buttons by the -z option
             below.

     -z target
             Map Z axis (roller/wheel) movement to another axis or to virtual
             buttons.  Valid targets are:

             x, y  X or Y axis movement will be reported when Z axis movement
                   is detected.

             N     Report the virtual buttons N and N+1 down events respec-
                   tively when negative and positive Z axis movement is de-
                   tected.  There doesn't need to be physical buttons N and
                   N+1. Note that mapping to logical buttons is carried out
                   after mapping from the Z axis movement to the virtual but-
                   tons is done.

     -p port
             Use the device port to communicate with the mouse.  port must be
             one of /dev/cua0[0-3] for a serial mouse, /dev/lms0 for a log-
             itech-bus style mouse, /dev/mms0 for a microsoft-bus style mouse
             or /dev/psm0 for a PS/2 mouse.

     -r resolution
             Set the resolution of the device; in Dots Per Inch, or low,
             medium-low, medium-high, or high. This option may not be support-


             ed by all the devices.

     -s      Select a baudrate of 9600 for the serial line.  Not all serial
             mice support this option.

     -t type
             Specify the protocol type of the mouse attached to the port.  You
             may explicitly specify a type listed below or use auto to let
             moused to automatically select an appropriate protocol for the
             given mouse.  If this option is not specified, auto is assumed.
             Under normal circumstances, you need to use this option only if
             moused is unable to detect the protocol automatically.

             Note that if a protocol type is specified with this option, the
             -P option above is implied and Plug and Play COM device enumera-
             tion procedure will be disabled.

             Also note that if your mouse is attached to the PS/2 mouse port,
             you should always choose auto or ps/2, regardless of the brand
             and model of the mouse.  Likewise, if your mouse is attached to
             the bus mouse port, choose auto or busmouse. Serial mouse proto-
             cols will not work with these mice.

             Valid protocol types for this option are the following:

             For serial mice:

             microsoft      Microsoft serial mouse protocol.  Most 2-button
                            serial mice use this protocol.

             intellimouse   Microsoft IntelliMouse protocol.  Genius NetMouse,
                            ASCII Mie Mouse, Logitech MouseMan+, and First-
                            Mouse+ use use this protocol as well.  Other mice
                            with a roller/wheel may be compatible with this
                            protocol.

             mousesystems   MouseSystems 5-byte protocol.  3-button mice may
                            use this protocol.

             mmseries       MM Series mouse protocol.

             logitech       Logitech mouse protocol.  Note that this is for
                            old Logitech models mouseman or intellimouse
                            should be specified for newer models.

             mouseman       Logitech MouseMan and TrackMan protocol.  Some
                            3-button mice may be compatible with this protoco.
                            Note that MouseMan+ and FirstMouse+ use
                            intellimouse protocol rather than this one.

             glidepoint     ALPS GlidePoint protocol.

             thinkingmouse  Kensington ThinkingMouse protocol.

             mmhitab        Hitachi tablet protocol.

             For the Logitech-style and Microsoft-style bus mice:

             busmouse       This is the only protocol type available for the
                            bus style mice and should be specified for any bus
                            style mice, regardless of the brand.

             For the PS/2 mouse:

             ps/2           This is the only protocol type available for the
                            PS/2 mouse and should be specified for any PS/2
                            mice, regardless of the brand.

SEE ALSO
     pcvt(4)

HISTORY
     The moused daemon is a slightly modified version of the moused daemon
     from the FreeBSD project, written by Michael Smith <msmith@FreeBSD.org>.
     Both inherit code from the XFree Project.

OpenBSD 2.8                     August 30, 2000                              4
