GPM

2010-01-06T02:37:47Z

Ryan12: updated download link

{| style="text-align: left; background-color: AliceBlue;"
|-valign="top"
!Download Source:
| http://www.nico.schottelius.org/software/gpm/archives/gpm-{{GPM-Version}}.tar.bz2
|-valign="top"
!Required Patch:
| http://svn.cross-lfs.org/svn/repos/patches/gpm/gpm-{{GPM-Version}}-silent-1.patch
|-valign="top"
|}

----

{{Package-Introduction|The GPM (general purpose mouse) daemon is a mouse server for applications running on the Linux console.|http://unix.schottelius.org/gpm/}}

== Dependencies ==

== Non-Multilib ==

Compile the package:

patch -Np1 -i ../gpm-{{GPM-Version}}-silent-1.patch &&
CC="gcc -fPIC" ./configure --prefix=/usr --sysconfdir=/etc &&
LDFLAGS="-lm" make

Install the package

make install &&
cp -v conf/gpm-root.conf /etc &&
ldconfig

=== Command Explanations ===

'''LDFLAGS="-lm"''': The math library must be linked with '''gpm''', as ceil() is used in some cursor scrolling logic.

== Multilib ==

=== 32Bit ===

Compile the package:

patch -Np1 -i ../gpm-{{GPM-Version}}-silent-1.patch &&
CC="gcc ${BUILD32} -fPIC" ./configure --prefix=/usr --sysconfdir=/etc &&
LDFLAGS="-lm" make

Install the package

make install &&
ldconfig

=== N32 ===

Compile the package:

patch -Np1 -i ../gpm-{{GPM-Version}}-silent-1.patch &&
CC="gcc ${BUILDN32} -fPIC" ./configure --prefix=/usr \
--sysconfdir=/etc --libdir=/usr/lib32 &&
LDFLAGS="-lm" make

Install the package

make install &&
ldconfig

=== 64Bit ===

Compile the package:

patch -Np1 -i ../gpm-{{GPM-Version}}-silent-1.patch &&
CC="gcc ${BUILD64} -fPIC" ./configure --prefix=/usr \
--sysconfdir=/etc --libdir=/usr/lib64 &&
LDFLAGS="-lm" make

Install the package

make install &&
cp -v conf/gpm-root.conf /etc &&
ldconfig

== Configuring ==

=== BootScript ===

Install the /etc/rc.d/init.d/gpm init script included in the [[bootscripts]] package.

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 which 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

=== Configuration Information ===

Examples of values to set MDEVICE, PROTOCOL, and GPMOPTS to are:

MDEVICE="/dev/psaux"
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.

= Contents =

{| style="text-align: left;"
|-valign="top"
! Installed Programs:
| disable-paste, gpm, gpm-root, hltest, mev, and mouse-test
|-valign="top"
! Installed Libraries:
| libgpm.{so.a}
|-valign="top"
! Installed Directories:
| None
|}

=== Short Descriptions ===

{| style="text-align: left;"
|-valign="top"
! disable-paste
| is a security mechanism used to disable the paste buffer.
|-valign="top"
! gpm
| is a cut and paste utility and mouse server for virtual consoles.
|-valign="top"
! gpm-root
| is a default handler for '''gpm'''. It is used to draw menus on the root window.
|-valign="top"
! hltest
| is a simple sample application using the high-level library, meant to be read by programmers trying to use the high-level library.
|-valign="top"
! mev
| is a program to report mouse events.
|-valign="top"
! mouse-test
| is a tool for determining the mouse type and device it's attached to.
|-valign="top"
! libgpm.{so.a}
| contains the API functions to access the GPM daemon.
|}

[[Category:General Utilities]]

CBLFS - User contributions [en]

GPM