OLD/gpm.txt

   1 TITLE:          Installation of GPM on LFS.
   2 LFS VERSION:    Any
   3 AUTHOR:         Marc Heerdink <marc_heerdink@softhome.net>
   4
   5 SYNOPSIS:
   6         Installation of gpm can be pretty difficult. This hint makes it a bit easier.
   7
   8 HINT:
   9 version 1.3 (12/26/2001)
  10
  11   The installation of GPM (General Purpose Mouse support) can be pretty hard
  12 when you use mawk. This hint is a guideline to install GPM in a few minutes.
  13 First, you'll have to get the sources for GPM if you don't already have them:
  14
  15  ftp://arcana.linux.it/pub/gpm/gpm-1.19.6.tar.gz
  16
  17 This location has been down for ages, though, so you may want to try this link:
  18
  19  ftp://ftp.schottelius.org/pub/linux/gpm/gpm-1.19.6.tar.bz2
  20
  21   Extract this file in /usr/src:
  22
  23  cd /usr/src &&
  24  tar xzvf /path/to/gpm-1.19.6.tar.gz
  25
  26   If the whole GPM installation would be this easy, there would be no need for
  27 a hint I suppose :) but we're approaching the more difficult part now... First,
  28 make sure you're in the /usr/src/gpm-1.19.6 directory. Then, we'll have to
  29 configure the beast:
  30
  31  ./configure --prefix=/usr
  32
  33   Configuration should give no problems. The compile stage is next, but this is
  34 the part where GPM goes wonky. Open /usr/src/gpm-1.19.6/Makefile and search for
  35 "SUBDIRS". Remove "doc" from the subdirs so this line looks like:
  36
  37 SUBDIRS = contrib
  38
  39 Now open src/gpm.c and type
  40
  41 #include <time.h>
  42
  43 on the first line. Now it's time to make GPM. Make sure you're in the
  44 /usr/src/gpm-1.19.6 directory and type:
  45
  46  make
  47
  48   This time, compilation should give you no trouble. Install GPM by typing:
  49
  50  make install
  51
  52   Because we removed the directory "doc" from the targets, the documentation
  53 wasn't installed. Mawk can't build the documentation, so you've got two choices
  54 left:
  55
  56 * Install gawk and rebuild gpm with the manpages
  57 * Get the manpages from:
  58
  59   http://www.linuxfromscratch.org/~gimli/gpm-manpages-1.19.6.tar.bz2
  60
  61   (These manpages were mailed to me by Manfred H. Winter <mahowi@gmx.net>, but
  62    there have been more people who submitted them to me. I just didn't have the
  63    time to make them available yet... :)
  64
  65   The only thing left to do is to install the info pages (they come pre-built
  66 with GPM):
  67
  68  cd doc &&
  69  install-info --dir-file=/usr/info/dir --info-file=gpm.info
  70
  71   You did it! You have installed GPM! Read the documentation (info gpm or man
  72 gpm) to find out how you can load the driver. Generally this will be something
  73 like:
  74
  75  gpm -t ps2 -m /dev/psaux
  76
  77 for PS/2 mice, and
  78
  79  gpm -t ms -m /dev/ttyS0
  80
  81 for Serial mice. If these don't work, consult the info page.
  82
  83 <and now, for something completely different>
  84
  85   Thanks to Spider <spider@wanfear.com> for reporting that a mirror site for
  86 the GPM ftp has been added to fmII, thanks to Manfred H. Winter
  87 <mahowi@gmx.net> and Andy Goth <unununium@openverse.com> for mailing me the
  88 manpages and thanks to Kevin Worthington <nofx_punkguy@linuxmail.org> for
  89 mailing me this:
  90
  91 ------------------------------------------------------------------------------
  92 OK, here goes, not really a huge deal, but I think it'd be helpful to the doc:
  93 to the end of /etc/init.d/rc add:
  94
  95 #
  96 #Starting gpm device
  97 #
  98 echo -n "Starting Console Mouse Device "
  99
 100 and follow by the last command you instructed, either:
 101
 102 gpm -t ps2 -m /dev/psaux
 103 OR
 104 gpm -t ms -m /dev/ttyS0
 105
 106 #End of gpm initialization
 107
 108 Let me know what you think. I know it's not the most elegant, but it gets things
 109 going. Please advice.
 110
 111 Thanks
 112 Kevin Worthington
 113 ------------------------------------------------------------------------------
 114
 115 I must admit that I didn't really look at it (no offence :) but it might be
 116 useful to some readers.
 117
 118   Pfff that was some hard work. I hope I won't have to update this anymore for
 119 the next 12 months or so :p
 120
 121 __END__
 122