Package: installation-guide Version: 20060726 Tags: patch Anders Lennartsson brought it to my attention that the information about gpm in the installation guide is terribly out-of-date. I think the following is a lot more helpful. Thanks, Peter, with "gpm co-maintainer" hat Index: manual/en/appendix/files.xml =================================================================== --- manual/en/appendix/files.xml (revisione 44084) +++ manual/en/appendix/files.xml (copia locale) @@ -120,46 +120,63 @@ <para> -The mouse can be used in both the Linux console (with gpm) and the X window -environment. The two uses can be made compatible if the gpm repeater is used -to allow the signal to flow to the X server as shown: +The mouse can be used in both the Linux console (with gpm) and the X +window environment. Normally, this is a simple matter of installing +<filename>gpm</filename> and the X server itself. Both should be +configured to use <filename>/dev/input/mice</filename> as the mouse +device. The correct mouse protocol is named +<userinput>exps2</userinput> in gpm, and +<userinput>ExplorerPS/2</userinput> in X. The respective configuration +files are <filename>/etc/gpm.conf</filename> and +<filename>/etc/X11/xorg.conf</filename>. -<informalexample><screen> -mouse => /dev/psaux => gpm => /dev/gpmdata -> /dev/mouse => X - /dev/ttyS0 (repeater) (symlink) - /dev/ttyS1 -</screen></informalexample> +</para><para> -Set the repeater protocol to be raw (in <filename>/etc/gpm.conf</filename>) while -setting X to the original mouse protocol in <filename>/etc/X11/XF86Config</filename> -or <filename>/etc/X11/XF86Config-4</filename>. +Certain kernel modules must be loaded in order for your mouse to work. +In most cases the correct modules are autodetected, but not always for +old-style serial and bus mice, which are quite rare except on very old +computers. (Serial mice usually have a 9-hole D-shaped connector; bus +mice have an 8-pin round connector, not to be confused with the 6-pin +round connector of a PS/2 mouse or the 4-pin round connector of an ADB +mouse.) Summary of Linux kernel modules needed for different mouse +types: -</para><para> +<informaltable><tgroup cols="2"><thead> +<row> + <entry>Module</entry> + <entry>Description</entry> +</row> +</thead><tbody> -This approach to use gpm even in X has advantages when the mouse is -unplugged inadvertently. Simply restarting gpm with +<row> + <entry>sermouse</entry> + <entry>Most serial mice</entry> +</row> -<informalexample><screen> -# /etc/init.d/gpm restart -</screen></informalexample> +<row> + <entry>logibm</entry> + <entry>Bus mouse connected to Logitech adapter card</entry> +</row> -will re-connect the mouse in software without restarting X. +<row> + <entry>inport</entry> + <entry>Bus mouse connected to ATI or Microsoft InPort card</entry> +</row> -</para><para> +<row> + <entry>psmouse</entry> + <entry>PS/2 mice (should be autodetected)</entry> +</row> -If gpm is disabled or not installed for some reason, make sure to set X to -read directly from a mouse device such as /dev/psaux. For details, refer -to the 3-Button Mouse mini-Howto at -<filename>/usr/share/doc/HOWTO/en-txt/mini/3-Button-Mouse.gz</filename>, -<userinput>man gpm</userinput>, -<filename>/usr/share/doc/gpm/FAQ.gz</filename>, and -<ulink url="&url-xorg;current/doc/html/mouse.html">README.mouse</ulink>. +<row> + <entry>usbhid</entry> + <entry>USB mice (should be autodetected)</entry> +</row> -</para><para arch="powerpc"> +</tbody></tgroup></informaltable> -For PowerPC, in <filename>/etc/X11/XF86Config</filename> or -<filename>/etc/X11/XF86Config-4</filename>, set the mouse device to -<userinput>"/dev/input/mice"</userinput>. +To load a kernel module, run <userinput>modconf</userinput>, and look +in the category <userinput>kernel/drivers/input/mouse</userinput>. </para><para arch="powerpc">
Attachment:
signature.asc
Description: Digital signature