Provided by:
xserver-xorg-input-evdev_2.0.99+git20080912-0ubuntu5_i386 
NAME
evdev - Generic Linux input driver
SYNOPSIS
Section "InputDevice"
Identifier "devname"
Driver "evdev"
Option "Device" "devpath"
Option "Path" "path"
Option "Emulate3Buttons" "True"
Option "Emulate3Timeout" "50"
...
EndSection
DESCRIPTION
evdev is an Xorg input driver for Linux´s generic event devices. It
therefore supports all input devices that the kernel knows about,
including most mice and keyboards.
The evdev driver can serve as both a pointer and a keyboard input
device, and may be used as both the core keyboard and the core pointer.
Multiple input devices are supported by multiple instances of this
driver, with one Load directive for evdev in the Module section of your
xorg.conf for each input device that will use this driver.
SUPPORTED HARDWARE
In general, any input device that the kernel has a driver for can be
accessed through the evdev driver. See the Linux kernel documentation
for a complete list.
CONFIGURATION DETAILS
Please refer to xorg.conf(5) for general configuration details and for
options that can be used with all input drivers. This section only
covers configuration details specific to this driver.
The following driver Options are supported:
Option "Device" "string"
Specifies the device through which the device can be accessed.
This will generally be of the form "/dev/input/eventX", where X
is some integer. The mapping from device node to hardware is
system-dependent. This option is mandatory unless "Path" is
given, and there is no default setting.
Option "Path" "string"
Specifies the device through which the device can be accessed.
This will generally be of the form "/dev/input/by-path/xyz",
where xyz includes the name of the device. The mapping from
device node to hardware is system-dependent. This option has
precedence over the "Device" option but one of "Path" or
"Device" must be given.
Option "Emulate3Buttons" "boolean"
Enable/disable the emulation of the third (middle) mouse button
for mice which only have two physical buttons. The third button
is emulated by pressing both buttons simultaneously. Default:
on, until a middle mouse button event is registered.
Option "Emulate3Timeout" "integer"
Sets the timeout (in milliseconds) that the driver waits before
deciding if two buttons where pressed "simultaneously" when 3
button emulation is enabled. Default: 50.
Option "ButtonMapping" "string"
Sets the button mapping for this device. The mapping is a space-
separated list of button mappings that correspond in order to
the physical buttons on the device (i.e. the first number is the
mapping for button 1, etc.). The default mapping is "1 2 3 ...
32". A mapping of 0 deactivates the button. Multiple buttons can
have the same mapping. For example, a left-handed mouse with
deactivated scroll-wheel would use a mapping of "3 2 1 0 0".
Invalid mappings are ignored and the default mapping is used.
Buttons not specified in the user’s mapping use the default
mapping.
Option "DragLockButtons" "L1 B2 L3 B4"
Sets "drag lock buttons" that simulate holding a button down, so
that low dexterity people do not have to hold a button down at
the same time they move a mouse cursor. Button numbers occur in
pairs, with the lock button number occurring first, followed by
the button number that is the target of the lock button.
Option "DragLockButtons" "M1"
Sets a "master drag lock button" that acts as a "Meta Key"
indicating that the next button pressed is to be "drag locked".
Option "EmulateWheel" "boolean"
Enable/disable "wheel" emulation. Wheel emulation means
emulating button press/release events when the mouse is moved
while a specific real button is pressed. Wheel button events
(typically buttons 4 and 5) are usually used for scrolling.
Wheel emulation is useful for getting wheel-like behaviour with
trackballs. It can also be useful for mice with 4 or more
buttons but no wheel. See the description of the
EmulateWheelButton, EmulateWheelInertia, EmulateWheelTimeout,
XAxisMapping, and YAxisMapping options below. Default: off.
Option "EmulateWheelButton" "integer"
Specifies which button must be held down to enable wheel
emulation mode. While this button is down, X and/or Y pointer
movement will generate button press/release events as specified
for the XAxisMapping and YAxisMapping settings. Default: 4.
Option "EmulateWheelInertia" "integer"
Specifies how far (in pixels) the pointer must move to generate
button press/release events in wheel emulation mode. Default:
10.
Option "EmulateWheelTimeout" "integer"
Specifies the time in milliseconds the EmulateWheelButton must
be pressed before wheel emulation is started. If the
EmulateWheelButton is released before this timeout, the original
button press/release event is sent. Default: 200.
Option "XAxisMapping" "N1 N2"
Specifies which buttons are mapped to motion in the X direction
in wheel emulation mode. Button number N1 is mapped to the
negative X axis motion and button number N2 is mapped to the
positive X axis motion. Default: no mapping.
Option "YAxisMapping" "N1 N2"
Specifies which buttons are mapped to motion in the Y direction
in wheel emulation mode. Button number N1 is mapped to the
negative Y axis motion and button number N2 is mapped to the
positive Y axis motion. Default: "4 5"
Option "ReopenAttempts" "integer"
Number of reopen attempts after a read error occurs on the
device (e.g. after waking up from suspend). In between each
attempt is a 100ms wait. Default: 10.
AUTHORS
Kristian Høgsberg.
SEE ALSO
Xorg(1), xorg.conf(5), xorgconfig(1), Xserver(1), X(7), README.mouse.