synclient

NAME

synclient - query and modify Synaptics TouchPad driver for XOrg/XFree86 server parameters on the fly.

SYNTAX

synclient [-m interval]
synclient [-hlV?] [var1=value1 [var2=value2] ...]

DESCRIPTION

This program lets you change your Synaptics TouchPad driver for XOrg/XFree86 server parameters while X is running if you enabled SHMConfig "on" in your XOrg/XFree86 configuration.
WARNING: This is not secure if you are in an untrusted multiuser
environment. . All local users can change the parameters at any time.

OPTIONS

-m interval
monitor changes to the touchpad state. . Interval specifies how often (in ms) to poll the touchpad state. . Whenever a change in the touchpad state is detected, one line of output is generated that describes the current state of the touchpad. . The following data is included in the output.
time
Time in seconds since the logging was started.
x,y
The x/y coordinates of the finger on the touchpad. . The origin is in the upper left corner.
z
The "pressure" value. . Pressing the finger harder on the touchpad typically produces a larger value. . Note that most touchpads don't measure the real pressure though. . Instead, capacitance is usually measured, which is correlated to the contact area between the finger and the touchpad. . Since more pressure usually means a larger contact area, the reported pressure value is at least indirectly related to the real pressure.
f
The number of fingers currently touching the touchpad. . Note that only some touchpads can report more than one finger. . Generally, synaptics touchpads can, but ALPS touchpads can't.
w
The w value is a measurement of the finger width. . This is only supported by some synaptics touchpads. . Touchpads that can't measure the finger width typically report a faked constant value when a finger is touching the touchpad.
l,r,u,d,m,multi
The state of the left, right, up, down, middle and multi buttons. . Zero means not pressed, one means pressed. . Not all touchpads have all these buttons. . If a button doesn't exist, the value is always reported as 0.
gl,gm,gr
Some touchpads have a "guest device". . This is typically a pointing stick located in the middle of the keyboard. . Some guest devices have physical buttons, or can detect button presses when tapping on the pointing stick. . Such button events are reported as "guest left", "guest middle" or "guest right".
gdx,gdy
Pointer movements from the guest device are reported as relative x/y positions, called gdx and gdy.
-h
Show detected hardware properties.
-l
List current user settings.
-V
Print version number and exit.
-?
Show the help message.
var=value
Set user parameter var to value.

FILES

/etc/X11/xorg.conf
/etc/X11/XF86Config-4

EXAMPLES

To disable EdgeMotionSpeed:
synclient EdgeMotionSpeed=0
To monitor touchpad events:
synclient -m 100

AUTHORS

Peter Osterlund <petero2@telia.com> and many others.
This man page was written by Mattia Dongili <malattia@debian.org>

SEE ALSO

syndaemon(1), synaptics(5)