.TH "tpconfig" "1" "3.1.3" "" ""
.SH "NAME"
.LP 
tpconfig \- Configure touchpad devices
.SH "SYNOPSIS"
.LP 
\fBtpconfig\fP [ \fIOPTIONS\fP ]
.br 
.br
.SH "DESCRIPTION"
.LP 
This program can show or modify the configuration of several different
kinds of touchpad devices, including most Synaptics TouchPad devices
and the ALPS Glidepad/Stickpointer.
.LP
Options for all touchpads:
.TP
\fB--help\fP
Display a help summary and exit.
.TP
\fB-D\fP [\fIN\fP], \fB--debug\fP[=\fIN\fP]
Generate debugging output, where \fIN\fP of 1, 2, or 3 specifies the
debugging level.  If \fIN\fP is 0, debugging is turned off.  If
\fIN\fP is not given, it defaults to 1.
.TP
\fB-d\fP \fIDEVICE\fP, \fB--device\fP=\fIDEVICE\fP
Use \fIDEVICE\fP as the device file for the mouse.  If this option
isn't given, the device file /dev/psaux is used.
.TP
\fB--version\fP
Display the version and copyright information and exit.
.TP
\fB-i\fP, \fB--info\fP
Display the current touchpad configuration.
.TP
\fB-x\fP, \fB--reset\fP
Perform a software reset on the touchpad.
.LP
Options for all Synaptics TouchPads:
.TP
\fB-q\fP, \fB--quiet\fP, \fB--silent\fP
Suppress verbose output.
.TP
\fB-a\fP [\fIN\fP]
Display the packet mode.  With argument \fIN\fP, set the packet mode,
where \fIN\fP=0 means \fBrelative\fP and \fIN\fP=1 means
\fBabsolute\fP.
.TP
\fB--absolute\fP
Set the packet mode to \fBabsolute\fP.
.TP
\fB--relative\fP
Set the packet mode to \fBrelative\fP.
.TP
\fB-r\fP [\fIN\fP], \fB--rate\fP[=\fIN\fP]
Display the reporting rate.  With argument \fIN\fP, set the reporting
rate, where \fIN\fP=0 means \fBnormal\fP, and \fIN\fP=1 means
\fBhigh\fP.
.LP
Options for older Synaptics TouchPads only:
.TP
\fB-t\fP [\fIN\fP], \fB--tapmode\fP[=\fIN\fP]
Display the tapping mode.  With argument \fIN\fP, set the tapping
mode, where \fIN\fP=0 means \fBno tap gestures\fP, and \fIN\fP=1 means
\fBtap and drag\fP.
.TP
\fB-s\fP [\fIN\fP], \fB--sleep\fP[=\fIN\fP]
Display the sleep mode.  With argument \fIN\fP, set the sleep mode,
where \fIN\fP=0 means \fBdisable\fP, and \fIN\fP=1 means \fBenable\fP.
.LP
Options for newer Synaptics TouchPads only:
.TP
\fB-t\fP [\fIN\fP], \fB--tapmode\fP[=\fIN\fP]
Display the tapping mode.  With argument \fIN\fP, set the tapping
mode, where \fIN\fP=0 means \fBno tap gestures\fP, \fIN\fP=1 means
\fBtap-to-click only\fP, \fIN\fP=2 means \fBtap and non-locking
drag\fP, and \fIN\fP=3 means \fBtap and locking drag\fP.
.TP
\fB-2\fP, \fB--two-button\fP
Set two-button mode.
.TP
\fB-3\fP, \fB--three-button\fP
Set three-button mode.
.TP
\fB-c\fP [\fIN\fP], \fB--corner\fP[=\fIN\fP]
Display the corner-tap mode.  With argument \fIN\fP, set the
corner-tap mode, where \fIN\fP=0 means \fBdisable\fP, and \fIN\fP=1
means \fBenable\fP.
.TP
\fB-e\fP [\fIN\fP], \fB--edgemode\fP[=\fIN\fP]
Display edge motion.  With argument \fIN\fP, set edge motion, where
\fIN\fP=0 means \fBnever\fP, \fIN\fP=1 means \fBalways\fP, and
\fIN\fP=3 means \fBonly during drag\fP.
.TP
\fB-m\fP
Display which mouse button is simulated by corner taps.
.TP
\fB--middle-button\fP
Make corner taps simulate the middle mouse button.
.TP
\fB--right-button\fP
Make corner taps simulate the right mouse button.
.TP
\fB-z\fP [\fIN\fP], \fB--zthreshold\fP[=\fIN\fP]
Display the z threshold setting (tap sensitivity).  With argument
\fIN\fP, set the z threshold setting to \fIN\fP.
.TP
\fB--threshold\fP[=\fIN\fP]
(Same as \fB--zthreshold\fP.)
.LP
Options for ALPS touchpads:
.TP
\fB-r\fP, \fB--reset\fP
Reset ALPS device.
.TP
\fB-t\fP [\fIN\fP], \fB--tapmode\fP[=\fIN\fP]
Display the tapping mode.  With argument \fIN\fP, set the tapping
mode, where \fIN\fP=0 means \fBtapping disabled\fP, and \fIN\fP=1
means \fBtapping enabled\fP.
.SH "EXAMPLES"
.LP
Often it's desirable to disable tap mode, to prevent mouse events from
being generated when the hand brushes the touchpad:
.LP 
\fBtpconfig\fP \-\-tapmode=0
.LP 
.SH "AUTHORS"
.LP 
Bruce Kall <kall@compass.com>