path: root/usr.sbin/moused/moused.8

.\"	$OpenBSD: moused.8,v 1.3 2000/09/09 17:14:56 deraadt Exp $
.\"
.Dd August 30, 2000
.Dt MOUSED 8 i386
.Os
.Sh NAME
.Nm moused
.Nd
mouse daemon
.Sh SYNOPSIS
.Nm moused
.Op Fl 3DPRcdfs
.Op Fl I Ar pid_file
.Op Fl F Ar rate
.Op Fl r Ar resolution
.Op Fl S Ar baudrate
.Op Fl C Ar threshold
.Op Fl t Ar protocol
.Op Fl m Ar mousetype
.Op Fl M Ar N=M
.Op Fl w Ar N
.Op Fl z Ar target
.Op Fl b Ar buttons
.Ar -p Ar device
.Nm moused
.Ar -i Ar info
.Ar -p Ar device
.Sh DESCRIPTION
.Nm
listens for mouse events on the specified
.Ar device
and communicates them to the
.Xr pcvt 4
driver through the
.Pa /dev/pcvtctl
interface.
Its purpose is to provide copy/paste functionality on the PC console.
.Pp
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
.Fl M ,
i.e.,
.Fl M
.Ar 2=3
maps the right mouse button to paste.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl 3
Emulate the third (middle) button for 2-button mice.  It is emulated by pressing
the left and right physical buttons simultaneously.
.It Fl C
Set double click speed as the maximum interval in msec between button clicks.
Without this option, 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.
.It Fl D
Lower DTR on the serial port. This option is valid only if
.Pa mousesystems
is selected as the protocol type. The DTR line may need to be
dropped for a 3-button mouse to operate in the
.Pa mousesystems
mode.
.It Fl F Ar rate
Set the report rate (reports/sec) of the device if supported.
.It Fl I Ar file
Write the process id of the
.Pa moused
daemon in the specified file. Without this option, the process id will be stored
in
.Pa /var/run/moused.pid.
.It Fl P
Do not start the Plug and Play COM device enumeration procedure when identifying
the serial mouse.  If this option is given together with the
.Pa i
option, the
.Pa moused
command won't be able to print useful information for the serial mouse.
.It Fl R
Lower RTS on the serial port. This option is valid only if
.Pa mousesystems
is selected as the protocol type by the
.Pa -t
option below. It is often used with the
.Pa -D option above. Both RTS and DTR lines may need to be dropped for a
3-button mouse to operate in the
.Pa mousesystems
mode.
is selected as the protocol type by the
.Pa mousesystems
mode.
.It Fl S Ar baudrate
Select the baudrate for the serial port (1200 to 9600). Not all serial mice
support this option.
.It Fl c
Some mice report middle button down events as if the left and right buttons are
pressed. This option handles this.
.It Fl d
Enable debugging messages.
.It Fl f
Do not become a daemon and instead run as a foreground process. Useful for
testing and debugging.
.It Fl i Ar info
Print specified information and quit. Available pieces of information are :
.Bl -column -indent
.It port Ta Device name, i.e.,
.Pa /dev/cua0[0-3]
for a serial mouse,
.Pa /dev/lms0
for a logitech-style bus mouse,
.Pa /dev/mms0
for a microsoft-style bus mouse and
.Pa /dev/psm0
for a PS/2 mouse.
.It if Ta Physical interface : serial, bus, inport or PS/2.
.It type Ta Protocol type : one of the type supported by the
.Pa -t
option.
.It model Ta Mouse model. The
.Pa moused
command may not always be able to identify the model.
.It all Ta All of the above options. Print device name, physical interface, type
and model in this order, in one line.
.El
.It Fl m Ar mousetype
Precise the model of the mouse. For example,
.Pa IntelliMouse
can be specified for a PS/2 mouse with a wheel.
.It Fl M Ar N=M
Assign the physical button
.Pa N
to the logical button
.Pa 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 either of the assigned physical buttons
is held down.  Do not put space around `='.
.It Fl w Ar N
Make the physical button
.Ar 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 further map the Z axis movement to virtual buttons by the
.Fl z
option below.
.It Fl z Ar target
Map Z axis (roller/wheel) movement to another axis or to virtual buttons.
Valid
.Ar target
maybe:
.Bl -tag -compact -width x__
.It Ar x
.It Ar y
X or Y axis movement will be reported when the Z axis movement is detected.
.It Ar N
Report the virtual buttons
.Ar N
and
.Ar N+1
down events respectively when negative and positive Z axis movement
is detected.
There doesn't need to be physical buttons
.Ar N
and
.Ar N+1 .
Note that mapping to logical buttons is carried out after mapping
from the Z axis movement to the virtual buttons is done.
.El
.It Fl p Ar port
Use the device
.Pa port
to communicate with the mouse.
.Pa port
must be one of
.Pa /dev/cua0[0-3]
for a serial mouse,
.Pa /dev/lms0
for a logitech-bus style mouse,
.Pa /dev/mms0
for a microsoft-bus style mouse or
.Pa /dev/psm0
for a PS/2 mouse.
.It Fl r Ar resolution
Set the resolution of the device; in Dots Per Inch, or
.Pa low
,
.Pa medium-low
,
.Pa medium-high
or
.Pa high.
This option may not be supported by all the devices.
.It Fl s
Select a baudrate of 9600 for the serial line. Not all serial mice support this
option.
.It Fl t Ar type
Specify the protocol type of the mouse attached to the port. You may explicitly
specify a type listed below or use
.Pa auto
to let the
.Pa moused
command to automatically select an appropriate protocol for the given mouse. If
you entirely ommit this option in the command line,
.Pa auto
is assumed. Under normal circumstances, you need to use this option only if the
.Pa moused
command is unable to detect the protocol automatically.
.Pp
Note that if a protocol type is specified with this option, the
.Pa -P
option above is implied and Plug and Play COM device enumeration procedure will be disabled.
.Pp
Also note that if your mouse is attached to the PS/2 mouse port,
you should always choose
.Pa auto
or
.Pa ps/2 ,
regardless of the brand and model of the mouse. Likewise, if your mouse is
attached to the bus mouse port, choose
.Pa auto
or
.Pa busmouse .
Serial mouse protocols will not work with these mice.
.Pp
Valid protocol type for this option are the following:
.Pp
For serial mice:
.Bl -tag -width thinkingmouse
.It microsoft Ta Microsoft serial mouse protocol. Most 2-button serial mice use this protocol.
.It intellimouse Ta Microsoft IntelliMouse protocol. Genius NetMouse, ASCII Mie
Mouse, Logitech MouseMan+ and FirstMouse+ use this protocol too. Other mice
with a roller/wheel may be compatible with this protocol.
.It mousesystems Ta MouseSystems 5-byte protocol. 3-button mice may use this
protocol.
.It mmseries Ta MM Series mouse protocol.
.It logitech Ta Logitech mouse protocol. Note that this is for old Logitech
models.
.Pa mouseman
or
.Pa intellimouse
should be specified for newer models.
.It mouseman Ta Logitech MouseMan and TrackMan protocol. Some 3-button mice
may be compatible with this protocol. Note that MouseMan+ and FirstMouse+ use
.Pa intellimouse
protocol rather than this one.
.It glidepoint Ta  ALPS GlidePoint protocol.
.It thinkingmouse Ta Ta Kensington ThinkingMouse protocol.
.It mmhitab Ta Hitachi tablet protocol.
.El
.Pp
For the Logitech-style and Microsoft-style bus mouse:
.Bl -tag -indent
.It busmouse Ta 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.
.El
.Pp
For the PS/2 mouse:
.Bl -tag -indent
.It ps/2 Ta 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.
.Sh SEE ALSO
.Xr pcvt 4
.Sh HISTORY
This moused daemon is a slightly modified version of the moused daemon from the
FreeBSD project, written by Michael Smith <msmith@FreeBSD.org>. Both inherits of
code from the Xfree Project.