listens for mouse events on the specified
and communicates them to the
Its purpose is to provide copy/paste functionality on the 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 selection; and
the middle button pastes. This behavior can be modified through the use of
right mouse button to paste.
The options are as follows:
- Indicate that the mouse has two buttons. In that case, the
right button pastes.
- 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.
- Use device as the display
control device. If omitted, wsmoused will use
the default value of /dev/ttyCcfg, which
controls the wsdisplay0 display
- Enable debugging messages.
- Do not become a daemon and instead run as a foreground
process. Useful for testing and debugging.
- Write the process ID of
wsmoused to the specified
- Print the type and the protocol of the mouse and exit.
- Assign the physical button
M to the logical button
N. 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 either of the assigned physical buttons is held down. Do not put
space around ‘
=’. Button numbers
start from one, assigned to the leftmost button.
- Use device to communicate
with the mouse. If this option is not present, the device opened is
/dev/wsmouse (the multiplexer device that
receives all mouse events from all wsmouse compatible mice on the system).
For a serial mouse, you have to explicitly specify the serial port, i.e.
device must be one of
- This option only applies to serial mice. It specifies the
protocol used by the serial mice. You may explicitly specify a type listed
below or use auto to let
wsmoused automatically select an appropriate
protocol for the given mouse, if the serial mouse respects the PnP COM
If this option is not specified, auto is
assumed. Under normal circumstances, you need to use this option only if
the mouse is not PnP compatible.
Valid protocol types for this option are the following:
- Microsoft serial mouse protocol. Most 2-button serial
mice use this protocol.
- Microsoft IntelliMouse protocol. Genius NetMouse, ASCII
Mie Mouse, Logitech MouseMan+, and FirstMouse+ use this protocol as
well. Other mice with a roller/wheel may be compatible with this
- MouseSystems 5-byte protocol. 3-button mice may use
- MM Series mouse protocol.
- Logitech mouse protocol. Note that this is for old
Logitech models. mouseman or
intellimouse should be specified for
- Logitech MouseMan and TrackMan protocol. Some 3-button
mice may be compatible with this protocol. Note that MouseMan+ and
FirstMouse+ use intellimouse protocol
rather than this one.
- ALPS GlidePoint protocol.
- Kensington ThinkingMouse protocol.
- Hitachi tablet protocol.
will happily coexist with the X Window
System, provided that the mouse device is supported by
mice do not have a
compatible driver, so wsmoused
has to be killed
before starting the X Window System.
To start wsmoused on the wsdisplay1
terminals, using a two-button serial mouse connected to
# wsmoused -2 -D /dev/ttyDcfg -p
To start wsmoused on the wsdisplay0
terminals, using /dev/wsmouse
with the left and
right buttons swapped (assuming a three button mouse):
# wsmoused -M 1=3 -M 3=1
daemon is a slightly modified version
of the moused daemon from the FreeBSD
by Michael Smith
⟨msmith@FreeBSD.org⟩. Both inherit code from the XFree