source: general/sysutils/gpm/gpm-config.xml@ 563bc92

<sect2>
<title>Configuring <application><acronym>GPM</acronym></application></title>

<sect3><title>gpm init.d script</title>
<para>Install the <filename>/etc/rc.d/init.d/gpm</filename>
init script included in the
<xref linkend="intro-important-bootscripts"/> package.</para>

<screen><userinput><command>make install-gpm</command></userinput></screen>

</sect3>

<sect3><title>Config files</title>
<para><filename>/etc/sysconfig/mouse</filename>
This file contains the name of your mouse device and the protocol which
it uses.  To create this file, run the following:</para>

<screen><userinput><command>cat &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"</command> 
# Begin /etc/sysconfig/mouse

MDEVICE=<replaceable>[yourdevice]</replaceable>
PROTOCOL=<replaceable>[yourprotocol]</replaceable>

# End /etc/sysconfig/mouse
<command>EOF</command></userinput></screen>
</sect3>

<sect3><title>Configuration Information</title>

<para>Examples of values to set <envar>MDEVICE</envar> and
<envar>PROTOCOL</envar> to are</para>

<screen><userinput>MDEVICE=/dev/psaux
PROTOCOL=imps2</userinput></screen>

<para>A list of which protocol values are known can be found by running
<command>gpm -t -help</command>.  Your <envar>MDEVICE</envar> setting depends on
which type of mouse you have.  For example,
<filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is
COM1), <filename>/dev/input/mice</filename> is often used for
<acronym>USB</acronym> mice
and <filename>/dev/psaux</filename> for PS2 mice.  It is normally
thought not a good idea to link <filename>/dev/mouse</filename> to the relevant device, but
instead to reference it directly.</para>

</sect3>

</sect2>