%
% gpm.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel GPM %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{GPM - Console Mouse Support}
\index{GPM}
\index{Mouse}


\section{Allgemein}

   Das GPM-Paket stellt die Unterst"utzung f"ur eine Maus auf der
   Console zur Verf"ugung.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{llll}
    & x. &  System administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}lll}
    & x. & Hardware administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & x. &  GPM console mouse administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}llll}
    & 1. &  View documentation \\
    & 2. &  Edit configuration \\
    & 3. &  Advanced configuration file handling \\
    & 4. &  Show status \\
    & 5. &  Stop service \\
    & 6. &  Start service \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration wird "uber den Men"upunkt \glqq{}Edit configuration\grqq{}
    ge"andert.

\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, welche "uber das Men"u zug"anglich ist,
    sind folgende Parameter vorhanden; wer sie von Hand editieren will,
    findet sie unter \\
    \texttt{/etc/config.d/gpm}



\section{Die Parameter}

\begin{description}


\config{START\_GPM}
{START\_GPM}
{STARTGPM}
{
    F"ur die Aktivierung des GPM muss diese Variable
    lediglich auf den Wert 'yes' gestellt werden. Die Einstellung
    'no' schaltet GPM ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_GPM='no'}
}


\config{GPM\_MOUSE\_DEVICE}
{GPM\_MOUSE\_DEVICE}
{GPMMOUSEDEVICE}
{
    Hier wird das Device angegeben auf dem die Maus l"auft

    G"ultige Werte: /dev/input/mice, /dev/psaux

    Standardeinstellung: \texttt{GPM\_MOUSE\_DEVICE='/dev/input/mice'}
}


\config{GPM\_MOUSE\_TYPE}
{GPM\_MOUSE\_TYPE}
{GPMMOUSETYPE}
{
    Hier wird der Typ der Maus angegeben

    G"ultige Werte: exps2, imps2, ms, ...

    \begin{tabular}{llll}
    & acecad     & Acecad tablet absolute mode(Sumagrapics MM-Series mode) \\
    & bare       & Unadorned ms protocol. Needed with some 2-buttons mice \\
    & bm         & Microsoft busmice and compatible devices \\
    & brw        & Fellowes Browser - 4 buttons (and a wheel) (dual protocol?) \\
    & cal        & Calcomp UltraSlate \\
    & calr       & Calcomp UltraSlate - relative mode \\
    & etouch     & EloTouch touch-screens (only button-1 events by now) \\
    & evdev      & Linux Event Device \\
    & exps2      & IntelliMouse Explorer (ps2) - 3 buttons wheel unused \\
    & js         & Joystick mouse emulation \\
    & genitizer  & Genitizer tablet in relative mode \\
    & gunze      & Gunze touch-screens (only button-1 events by now) \\
    & imps2      & Microsoft Intellimouse (ps2)-autodetect 2/3 buttons wheel unused \\
    & logi       & Used in some Logitech devices (only serial) \\
    & logim      & Turn logitech into Mouse-Systems-Compatible \\
    & mm         & MM series. Probably an old protocol \\
    & mman       & The 'MouseMan' and similar devices \\
    & ms         & The original ms protocol with a middle-button extension \\
    & ms3        & Microsoft Intellimouse (serial) - 3 buttons wheel unused \\
    & ms+        & Like 'ms' but allows dragging with the middle button \\
    & ms+lr      & 'ms+' but you can reset m by pressing lr (see man page) \\
    & msc        & Mouse-Systems-Compatible (5bytes). Most 3-button mice \\
    & mtouch     & MicroTouch touch-screens (only button-1 events by now) \\
    & ncr        & Ncr3125pen found on some laptops \\
    & netmouse   & Genius NetMouse (ps2) - 2 buttons and 2 buttons 'up'/'down' \\
    & pnp        & Plug and pray. New mice may not run with '-t ms' \\
    & ps2        & Busmice of the ps/2 series. Most busmice actually \\
    & sun        & 'msc' protocol but only 3 bytes per packet \\
    & summa      & Summagraphics or Genius tablet absolute mode(MM-Series) \\
    & syn        & The 'Synaptics' serial TouchPad \\
    & synps2     & The 'Synaptics' PS/2 TouchPad \\
    & twid       & Twidddler keyboard \\
    & sxxxaa     & The DEC VSXXX-AA/GA serial mouse on DEC workstations \\
    & wacom      & Wacom Protocol IV Tablets: Pen+Mouse relative+absolute mode \\
    & wp         & Genius WizardPad tablet \\
    \end{tabular}

    Standardeinstellung: \texttt{GPM\_MOUSE\_TYPE='imps2'}
}

\config{GPM\_PARAM}
{GPM\_PARAM}
{GPMPARAM}
{
    Hier k"onnen zus"atzliche Optionen angegeben werden die
    das Verhalten der Maus steuern, wenn vorhanden.

    G"ultige Werte: Optionen f"ur das jeweilige Mausmodell

    Standardeinstellung: \texttt{GPM\_PARAM='{}'}
}
\end{description}
