GPM-1.20.7
      
      
        
          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!
        
        
          This package is known to build and work properly using an LFS-7.10
          platform.
        
        
          Package Information
        
        
        
          User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/GPM
        
       
      
        
          Installation of GPM
        
        
          Install GPM by running the
          following commands:
        
        
./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-1.20.7/support &&
install -v -m644    doc/support/*                     \
                    /usr/share/doc/gpm-1.20.7/support &&
install -v -m644    doc/{FAQ,HACK_GPM,README*}        \
                    /usr/share/doc/gpm-1.20.7
       
      
        
          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
        
        
        
          
            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
         
        
          
            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.
          
         
       
      
        
          Contents
        
        
          
            
              Installed Programs:
              disable-paste, display-buttons,
              display-coords, get-versions, gpm, gpm-root, hltest, mev, and
              mouse-test
            
            
              Installed Library:
              libgpm.{so.a}
            
            
              Installed Directory:
              /usr/share/doc/gpm-1.20.7
            
           
         
        
          
            Short Descriptions
          
          
            
            
              
                | 
                    disable-paste
                   | 
                    is a security mechanism used to disable the paste buffer.
                   | 
              
                | 
                    display-buttons
                   | 
                    is a simple program that reports the mouse buttons being
                    pressed and released.
                   | 
              
                | 
                    display-coords
                   | 
                    is a simple program that reports the mouse coordinates.
                   | 
              
                | 
                    get-versions
                   | 
                    is used to report the GPM library and server versions.
                   | 
              
                | 
                    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.
                   | 
            
          
         
       
      
        Last updated on 2016-08-27 10:00:09 -0700