%general-entities; ]> $LastChangedBy$ $Date$ GPM-&gpm-version; GPM Introduction to GPM The GPM (General Purpose Mouse daemon) package contains a mouse server for the console and xterm. It not only provides cut and paste support generally, but its library component is used by various software such as Links to provide mouse support to the application. It is useful on desktops, especially if following (Beyond) Linux From Scratch instructions; it's often much easier (and less error prone) to cut and paste between two console windows than to type everything by hand! &lfs7a_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &gpm-md5sum; Download size: &gpm-size; Estimated disk space required: &gpm-buildsize; Estimated build time: &gpm-time; Additional Downloads Required patch: User Notes: Installation of GPM Install GPM by running the following commands: patch -Np1 -i ../gpm-&gpm-version;-fix_build_failures-1.patch && ./autogen.sh && ./configure --prefix=/usr --sysconfdir=/etc && make This package does not come with a test suite. Now, as the root user: make install && install-info --dir-file=/usr/share/info/dir \ /usr/share/info/gpm.info && ln -sfv libgpm.so.2.1.0 /usr/lib/libgpm.so && install -v -m644 conf/gpm-root.conf /etc && install -v -m755 -d /usr/share/doc/gpm-&gpm-version;/support && install -v -m644 doc/support/* \ /usr/share/doc/gpm-&gpm-version;/support && install -v -m644 doc/{FAQ,HACK_GPM,README*} \ /usr/share/doc/gpm-&gpm-version; Command Explanations ./autogen.sh: This command creates the missing configure script. install-info ...: This package installs an .info file, but does not update the system dir file. This command makes the update. ln -v -sfn libgpm.so.2.1.0 /usr/lib/libgpm.so: This command is used to create (or update) the .so symlink to the library. Configuring GPM <phrase revision="sysv">Boot Script</phrase> <phrase revision="systemd">Systemd Unit</phrase> gpm Install the /etc/rc.d/init.d/gpm init script included in the package. To start the gpm daemon at boot, install the systemd unit from the package by running the following command as the root user: make install-gpm Config Files /etc/gpm-root.conf and ~/.gpm-root: The default and individual user gpm-root configuration files. /etc/sysconfig/mouse: This file contains the name of your mouse device and the protocol it uses. To create this file, run the following as the root user: cat > /etc/sysconfig/mouse << "EOF" # Begin /etc/sysconfig/mouse MDEVICE="<yourdevice>" PROTOCOL="<yourprotocol>" GPMOPTS="<additional options>" # End /etc/sysconfig/mouse EOF ~/.gpm-root /etc/gpm-root.conf /etc/sysconfig/mouse Configuration Information Examples of values to set MDEVICE, PROTOCOL, and GPMOPTS to are: MDEVICE="/dev/input/mice" PROTOCOL="imps2" GPMOPTS="" A list of which protocol values are known can be found by running gpm -m [device] -t -help. The MDEVICE setting depends on which type of mouse you have. For example, /dev/ttyS0 for a serial mouse (on Windows this is COM1), /dev/input/mice is often used for USB mice and /dev/psaux for PS2 mice. GPMOPTS is the 'catch all' for any additional options that are needed for your hardware. GPM is by default started with the following parameters: -m /dev/input/mice -t imps2. If the mentioned parameters don't suit your needs, you can override them by running the following the following commands as the root user: install -v -dm755 /etc/systemd/system/gpm.service.d echo "ExecStart=/usr/sbin/gpm <list of parameters>" > /etc/systemd/system/gpm.service.d/99-user.conf Contents Installed Programs Installed Library Installed Directory disable-paste, display-buttons, display-coords, get-versions, gpm, gpm-root, hltest, mev, and mouse-test libgpm.{so.a} /usr/share/doc/gpm-&gpm-version; Short Descriptions disable-paste is a security mechanism used to disable the paste buffer. disable-paste display-buttons is a simple program that reports the mouse buttons being pressed and released. display-buttons display-coords is a simple program that reports the mouse coordinates. display-coords get-versions is used to report the GPM library and server versions. get-versions gpm is a cut and paste utility and mouse server for virtual consoles. gpm gpm-root is a default handler for gpm. It is used to draw menus on the root window. gpm-root hltest is a simple sample application using the high-level library, meant to be read by programmers trying to use the high-level library. hltest mev is a program to report mouse events. mev mouse-test is a tool for determining the mouse type and device it's attached to. mouse-test libgpm.{so.a} contains the API functions to access the GPM daemon. libgpm.{so,a}