psm - Sync psm(4) with FreeBSD
[dragonfly.git] / share / man / man4 / psm.4
index e0cf031..29a5d8c 100644 (file)
@@ -27,7 +27,7 @@
 .\" $FreeBSD: src/share/man/man4/psm.4,v 1.24.2.9 2002/12/29 16:35:38 schweikh Exp $
 .\" $DragonFly: src/share/man/man4/psm.4,v 1.7 2008/05/02 02:05:05 swildner Exp $
 .\"
-.Dd April 1, 2000
+.Dd October 15, 2010
 .Dt PSM 4
 .Os
 .Sh NAME
@@ -343,6 +343,27 @@ It has no effect unless the
 .Em HOOKRESUME
 flag is set as well.
 .El
+.Sh LOADER TUNABLES
+Extended support for Synaptics touchpads can be enabled by setting
+.Va hw.psm.synaptics_support
+to
+.Em 1
+at boot-time.
+This will enable
+.Nm
+to handle packets from guest devices (sticks) and extra buttons.
+.Pp
+Tap and drag gestures can be disabled by setting
+.Va hw.psm.tap_enabled
+to
+.Em 0
+at boot-time.
+Currently, this is only supported on Synaptics touchpads with Extended
+support disabled. The behaviour may be changed after boot by setting
+the sysctl with the same name and by restarting
+.Xr moused 8
+using
+.Pa /etc/rc.d/moused .
 .Sh IOCTLS
 There are a few
 .Xr ioctl 2
@@ -433,6 +454,36 @@ Microsoft Ballpoint mouse
 Microsoft IntelliMouse
 .El
 .Pp
+.It Dv MOUSE_SYN_GETHWINFO Ar synapticshw_t *synhw
+Retrieves extra information associated with Synaptics Touchpads.
+Only available when
+.Va hw.psm.synaptics_support
+has been enabled.
+.Bd -literal
+typedef struct synapticshw {
+    int infoMajor;     /* major hardware revision */
+    int infoMinor;     /* minor hardware revision */
+    int infoRot180;    /* touchpad is rotated */
+    int infoPortrait;  /* touchpad is a portrait */
+    int infoSensor;    /* sensor model */
+    int infoHardware;  /* hardware model */
+    int infoNewAbs;    /* supports the newabs format */
+    int capPen;                /* can detect a pen */
+    int infoSimpleC;   /* supports simple commands */
+    int infoGeometry;  /* touchpad dimensions */
+    int capExtended;   /* supports extended packets */
+    int capSleep;      /* can be suspended/resumed */
+    int capFourButtons;        /* has four buttons */
+    int capMultiFinger;        /* can detect multiple fingers */
+    int capPalmDetect; /* can detect a palm */
+    int capPassthrough;        /* can passthrough guest packets */
+} synapticshw_t;
+.Ed
+.Pp
+See the
+.Em Synaptics TouchPad Interfacing Guide
+for more information about the fields in this structure.
+.Pp
 .It Dv MOUSE_GETMODE Ar mousemode_t *mode
 The command gets the current operation parameters of the mouse
 driver.
@@ -779,6 +830,10 @@ Clicking any button without moving the mouse may also work.
 .Xr sysmouse 4 ,
 .Xr moused 8 ,
 .Xr syslogd 8
+.Rs
+.%T Synaptics TouchPad Interfacing Guide
+.%U http://www.synaptics.com/
+.Re
 .\".Sh HISTORY
 .Sh AUTHORS
 .An -nosplit