Difference between revisions of "GPM"
(I added the package description from BLFS.) |
(I added the "Contents" section from BLFS.) |
||
| Line 1: | Line 1: | ||
{| style="text-align: left; background-color: AliceBlue;" | {| style="text-align: left; background-color: AliceBlue;" | ||
| − | |- | + | |-valign="top" |
!Download Source: | !Download Source: | ||
| ftp://arcana.linux.it/pub/gpm/gpm-1.20.1.tar.bz2 | | ftp://arcana.linux.it/pub/gpm/gpm-1.20.1.tar.bz2 | ||
| − | |- | + | |-valign="top" |
!Required Patch: | !Required Patch: | ||
| http://svn.cross-lfs.org/svn/repos/patches/gpm/gpm-1.20.1-segfault-1.patch | | http://svn.cross-lfs.org/svn/repos/patches/gpm/gpm-1.20.1-segfault-1.patch | ||
| − | |- | + | |-valign="top" |
!Required Patch: | !Required Patch: | ||
| http://svn.cross-lfs.org/svn/repos/patches/gpm/gpm-1.20.1-silent-1.patch | | http://svn.cross-lfs.org/svn/repos/patches/gpm/gpm-1.20.1-silent-1.patch | ||
| Line 33: | Line 33: | ||
cp -v conf/gpm-root.conf /etc && | cp -v conf/gpm-root.conf /etc && | ||
ldconfig | ldconfig | ||
| + | |||
| + | === Command Explanations === | ||
| + | |||
| + | '''LDFLAGS="-lm"''': The math library must be linked with '''gpm''', as ceil() is used in some cursor scrolling logic. | ||
== Multilib == | == Multilib == | ||
| Line 114: | Line 118: | ||
GPMOPTS="" | 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. | + | 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. | ||
| + | |} | ||
Revision as of 11:54, 14 December 2006
| Download Source: | ftp://arcana.linux.it/pub/gpm/gpm-1.20.1.tar.bz2 |
|---|---|
| Required Patch: | http://svn.cross-lfs.org/svn/repos/patches/gpm/gpm-1.20.1-segfault-1.patch |
| Required Patch: | http://svn.cross-lfs.org/svn/repos/patches/gpm/gpm-1.20.1-silent-1.patch |
Contents
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!
Dependencies
Non-Multilib
Compile the package:
patch -Np1 -i ../gpm-1.20.1-segfault-1.patch && patch -Np1 -i ../gpm-1.20.1-silent-1.patch && ./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-1.20.1-segfault-1.patch &&
patch -Np1 -i ../gpm-1.20.1-silent-1.patch &&
CC="gcc ${BUILD32}" ./configure --prefix=/usr --sysconfdir=/etc &&
LDFLAGS="-lm" make
Install the package
make install && ldconfig
N32
Compile the package:
patch -Np1 -i ../gpm-1.20.1-segfault-1.patch &&
patch -Np1 -i ../gpm-1.20.1-silent-1.patch &&
CC="gcc ${BUILDN32}" ./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-1.20.1-segfault-1.patch &&
patch -Np1 -i ../gpm-1.20.1-silent-1.patch &&
CC="gcc ${BUILD64}" ./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 blfs-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
| Installed Programs: | disable-paste, gpm, gpm-root, hltest, mev, and mouse-test |
|---|---|
| Installed Libraries: | libgpm.{so.a} |
| Installed Directories: | None |
Short Descriptions
| disable-paste | is a security mechanism used to disable the paste buffer. |
|---|---|
| gpm | is a cut and paste utility and mouse server for virtual consoles. |
| gpm-root | is a default handler for gpm. It is used to draw menus on the root window. |
| hltest | is a simple sample application using the high-level library, meant to be read by programmers trying to use the high-level library. |
| mev | is a program to report mouse events. |
| mouse-test | is a tool for determining the mouse type and device it's attached to. |
| libgpm.{so.a} | contains the API functions to access the GPM daemon. |
