xenocara/driver/xf86-input-vmmouse
matthieu ebe1c2048b Disable linking of libi386 too (linking do libamd64 was already disabled,
but I manage to commit the incomplete version). Noticed by sthen@. Thanks.
2017-01-22 21:23:51 +00:00
..
fdi Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
man Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
shared Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
src Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
tools Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
aclocal.m4 regen 2016-10-11 22:14:30 +00:00
ChangeLog Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
config.guess Update xf86-input-vmmouse to 13.0.0 2014-01-03 09:41:23 +00:00
config.h.in Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
config.sub Update xf86-input-vmmouse to 13.0.0 2014-01-03 09:41:23 +00:00
configure Disable linking of libi386 too (linking do libamd64 was already disabled, 2017-01-22 21:23:51 +00:00
configure.ac Disable linking of libi386 too (linking do libamd64 was already disabled, 2017-01-22 21:23:51 +00:00
COPYING Update to xf86-input-vmmouse 12.6.10. No functionnal change. 2010-08-22 12:11:57 +00:00
depcomp Update xf86-input-vmmouse to 13.0.0 2014-01-03 09:41:23 +00:00
INSTALL Update to xf86-input-vmmouse 12.7.0. 2011-04-25 14:10:23 +00:00
install-sh Update xf86-input-vmmouse to 13.0.0 2014-01-03 09:41:23 +00:00
ltmain.sh Update to xf86-input-vmmouse 12.8.0 2012-05-13 20:48:40 +00:00
Makefile.am Update xf86-input-vmmouse to 13.0.0 2014-01-03 09:41:23 +00:00
Makefile.bsd-wrapper
Makefile.in Update to xf86-input-vmmouse 13.1.0 2017-01-21 18:40:20 +00:00
missing Update xf86-input-vmmouse to 13.0.0 2014-01-03 09:41:23 +00:00
README update to xf86-input-vmmouse 12.6.3. 2009-05-03 14:11:13 +00:00

VMMouse
-------

The VMMouse driver enables support for the special VMMouse protocol
that is provided by VMware virtual machines to give absolute pointer
positioning. 

Installing the driver will improve the user experience when using the 
mouse to interact with the guest operating system. In particular, use of 
the driver improves mouse "lag", provides mouse speed and acceleration 
consistent with the user's host operating system, and enables the 
auto-grab/ungrab feature in VMware products without requiring the VMware 
toolbox application.

Using the driver
----------------

Assuming you have built and installed the driver in the standard way
for autotools based packages (see INSTALL), or the driver was already
installed by your distro, using it is simply a matter of changing the
driver used for the mouse input device from "mouse" to "vmmouse".

The vmmouse driver is capable of falling back to the standard "mouse"
driver if a VMware virtual machine is not detected. This allows for
dual-booting of an operating system from a virtual machine to real hardware
without having to edit xorg.conf every time.

Implementation
--------------

The following is not necessary reading for anyone who wants to use the
driver, but should help anyone who wants to understand how it works or
who wants to write a driver for a different target, whether it's another
operating system, a linux kernel input driver or even gpm.

The driver is composed of three different layers:

1) The vmmouse protocol layer (vmmouse_proto.[c|h])
   - This provides the call to read and write the port over which 
     the vmmouse packets are transfered.

2) The vmmouse client layer (vmmouse_client.[c|h])
   - This builds on top of the protocol layer to provide higher
     level calls for enabling/disabling the vmmouse mechanism
     and for reading data.
   - A new driver for a different target would use this interface.

3) The Xorg vmmouse driver (vmmouse.c)
   - This is the actual Xorg specific part of the driver.
   - Note that interrupts indicating the presence of mouse data
     are still transmitted on the PS/2 port so it is necessary
     to be set up to receive those interrupts like a standard
     PS/2 driver, but the actual data on the PS/2 port is ignored.

vmmouse_detect
--------------

A simple program to detect whether the vmmouse device is present.
It is used by the HAL callout script to automatically detect a
vmmouse device.

Returns 0 if we are running in a virtual machine where the vmmouse
device is present.

Returns 1 otherwise (either we are not in a VM or the vmmouse device
was disabled).