Changeset 20e3223
- Timestamp:
- 05/07/2005 09:39:51 AM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 343bcdb
- Parents:
- bff9ad6b
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
general/sysutils/gpm.xml
rbff9ad6b r20e3223 5 5 %general-entities; 6 6 7 <!ENTITY gpm-download-http " ">8 <!ENTITY gpm-download-ftp "ftp://arcana.linux.it/pub/gpm/gpm-&gpm-version;.tar.bz2">9 <!ENTITY gpm-md5sum "2c63e827d755527950d9d13fe3d87692">10 <!ENTITY gpm-size "556 KB">11 <!ENTITY gpm-buildsize "6.7 MB">12 <!ENTITY gpm-time "0.09 SBU">7 <!ENTITY gpm-download-http " "> 8 <!ENTITY gpm-download-ftp "ftp://arcana.linux.it/pub/gpm/gpm-&gpm-version;.tar.bz2"> 9 <!ENTITY gpm-md5sum "2c63e827d755527950d9d13fe3d87692"> 10 <!ENTITY gpm-size "556 KB"> 11 <!ENTITY gpm-buildsize "6.7 MB"> 12 <!ENTITY gpm-time "0.09 SBU"> 13 13 ]> 14 14 15 15 <sect1 id="gpm" xreflabel="GPM-&gpm-version;"> 16 <sect1info> 17 <othername>$LastChangedBy$</othername> 18 <date>$Date$</date> 19 </sect1info> 20 <?dbhtml filename="gpm.html"?> 21 <title><acronym>GPM</acronym>-&gpm-version;</title> 22 <indexterm zone="gpm"> 23 <primary sortas="a-GPM">GPM</primary></indexterm> 24 25 <sect2> 26 <title>Introduction to <application><acronym>GPM</acronym></application></title> 27 28 <para>The <application><acronym>GPM</acronym></application> (General 29 Purpose Mouse daemon) package contains a mouse server for the console 30 and <command>xterm</command>. It not only provides cut and paste support 31 generally, but its library component is used by various software such as 32 <application>Links</application> to provide mouse support to the 33 application. It is useful on desktops, especially if following 34 (Beyond) Linux From Scratch instructions; it's often much easier (and 35 less error prone) to cut and paste between two console windows than to 36 type everything by hand!</para> 37 38 <sect3><title>Package information</title> 39 <itemizedlist spacing='compact'> 40 <listitem><para>Download (HTTP): <ulink 41 url="&gpm-download-http;"/></para></listitem> 42 <listitem><para>Download (FTP): <ulink 43 url="&gpm-download-ftp;"/></para></listitem> 44 <listitem><para>Download MD5 sum: &gpm-md5sum;</para></listitem> 45 <listitem><para>Download size: &gpm-size;</para></listitem> 46 <listitem><para>Estimated disk space required: 47 &gpm-buildsize;</para></listitem> 48 <listitem><para>Estimated build time: 49 &gpm-time;</para></listitem></itemizedlist> 50 </sect3> 51 52 <sect3><title>Additional downloads</title> 53 <itemizedlist spacing='compact'> 54 <listitem><para>Recommended Patch: <ulink 55 url="&patch-root;/gpm-&gpm-version;-segfault-1.patch"/></para></listitem> 56 <listitem><para>Recommended Patch: <ulink 57 url="&patch-root;/gpm-&gpm-version;-silent-1.patch"/></para></listitem> 58 </itemizedlist> 59 </sect3> 60 61 </sect2> 62 63 <sect2> 64 <title>Installation of <application><acronym>GPM</acronym></application></title> 65 66 <para>Install <application><acronym>GPM</acronym></application> by running 67 the following commands: 68 </para> 69 70 <screen><userinput><command>patch -Np1 -i ../gpm-&gpm-version;-segfault-1.patch && 16 <?dbhtml filename="gpm.html"?> 17 18 <sect1info> 19 <othername>$LastChangedBy$</othername> 20 <date>$Date$</date> 21 </sect1info> 22 23 <title>GPM-&gpm-version;</title> 24 25 <indexterm zone="gpm"> 26 <primary sortas="a-GPM">GPM</primary> 27 </indexterm> 28 29 <sect2 role="package"> 30 <title>Introduction to GPM</title> 31 32 <para>The <application>GPM</application> (General Purpose Mouse 33 daemon) package contains a mouse server for the console and 34 <command>xterm</command>. It not only provides cut and paste support 35 generally, but its library component is used by various software such as 36 <application>Links</application> to provide mouse support to the application. 37 It is useful on desktops, especially if following (Beyond) Linux From Scratch 38 instructions; it's often much easier (and less error prone) to cut and paste 39 between two console windows than to type everything by hand!</para> 40 41 <bridgehead renderas="sect3">Package Information</bridgehead> 42 <itemizedlist spacing="compact"> 43 <listitem> 44 <para>Download (HTTP): <ulink url="&gpm-download-http;"/></para> 45 </listitem> 46 <listitem> 47 <para>Download (FTP): <ulink url="&gpm-download-ftp;"/></para> 48 </listitem> 49 <listitem> 50 <para>Download MD5 sum: &gpm-md5sum;</para> 51 </listitem> 52 <listitem> 53 <para>Download size: &gpm-size;</para> 54 </listitem> 55 <listitem> 56 <para>Estimated disk space required: &gpm-buildsize;</para> 57 </listitem> 58 <listitem> 59 <para>Estimated build time: &gpm-time;</para> 60 </listitem> 61 </itemizedlist> 62 63 <bridgehead renderas="sect3">Additional Downloads</bridgehead> 64 <itemizedlist spacing='compact'> 65 <listitem> 66 <para>Recommended Patch: <ulink 67 url="&patch-root;/gpm-&gpm-version;-segfault-1.patch"/></para> 68 </listitem> 69 <listitem> 70 <para>Recommended Patch: <ulink 71 url="&patch-root;/gpm-&gpm-version;-silent-1.patch"/></para> 72 </listitem> 73 </itemizedlist> 74 75 </sect2> 76 77 <sect2 role="installation"> 78 <title>Installation of GPM</title> 79 80 <para>Install <application>GPM</application> by running 81 the following commands:</para> 82 83 <screen><userinput>patch -Np1 -i ../gpm-&gpm-version;-segfault-1.patch && 71 84 patch -Np1 -i ../gpm-&gpm-version;-silent-1.patch && 72 85 LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc && 73 make</command></userinput></screen> 74 75 <para>Now, as the root user:</para> 76 77 <screen><userinput role='root'><command>make install && 78 cp conf/gpm-root.conf /etc && 79 ldconfig</command></userinput></screen> 80 </sect2> 81 82 <sect2> 83 <title>Command explanations</title> 84 85 <para><command>LDFLAGS="-lm"</command>: The math library 86 must be linked with <command>gpm</command>, as ceil() is used in some cursor 87 scrolling logic.</para> 86 make</userinput></screen> 87 88 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 89 90 <screen role="root"><userinput>make install && 91 cp -v conf/gpm-root.conf /etc && 92 ldconfig</userinput></screen> 93 94 </sect2> 95 96 <sect2 role="commands"> 97 <title>Command Explanations</title> 98 99 <para><command>LDFLAGS="-lm"</command>: The math library 100 must be linked with <command>gpm</command>, as ceil() is used in 101 some cursor scrolling logic.</para> 88 102 89 103 <!-- <para><command>ldconfig -n -l </command>: During installation, gpm outputs a 90 104 message to run the above command to create the proper library links.</para> --> 91 105 92 </sect2> 93 94 <sect2> 95 <title>Configuring <application><acronym>GPM</acronym></application></title> 96 97 <sect3 id="gpm-init"><title>gpm init.d script</title> 98 <indexterm zone="gpm gpm-init"> 99 <primary sortas="f-gpm-init">gpm</primary></indexterm> 100 101 <para>Install the <filename>/etc/rc.d/init.d/gpm</filename> 102 init script included in the 103 <xref linkend="intro-important-bootscripts"/> package.</para> 104 105 <screen><userinput role='root'><command>make install-gpm</command></userinput></screen> 106 </sect3> 107 108 <sect3 id="gpm-config"><title>Config files</title> 109 110 <para><filename>/etc/gpm-root.conf</filename> and 111 <filename>~/.gpm-root</filename>: The default and individual user 112 <command>gpm-root</command> configuration files.</para> 113 114 <para><filename>/etc/sysconfig/mouse</filename>: 115 This file contains the name of your mouse device and the protocol which 116 it uses. To create this file, run the following as the root user:</para> 117 118 <screen><userinput role='root'><command>cat > /etc/sysconfig/mouse << "EOF"</command> 119 # Begin /etc/sysconfig/mouse 106 </sect2> 107 108 <sect2 role="configuration"> 109 <title>Configuring GPM</title> 110 111 <sect3 id="gpm-init"> 112 <title>Boot Script</title> 113 114 <indexterm zone="gpm gpm-init"> 115 <primary sortas="f-gpm-init">gpm</primary> 116 </indexterm> 117 118 <para>Install the <filename>/etc/rc.d/init.d/gpm</filename> init script 119 included in the <xref linkend="intro-important-bootscripts"/> package.</para> 120 121 <screen role="root"><userinput>make install-gpm</userinput></screen> 122 123 </sect3> 124 125 <sect3 id="gpm-config"> 126 <title>Config Files</title> 127 128 <para><filename>/etc/gpm-root.conf</filename> and 129 <filename>~/.gpm-root</filename>: The default and individual user 130 <command>gpm-root</command> configuration files.</para> 131 132 <para><filename>/etc/sysconfig/mouse</filename>: 133 This file contains the name of your mouse device and the protocol which 134 it uses. To create this file, run the following as the root user:</para> 135 136 <screen role="root"><userinput>cat > /etc/sysconfig/mouse << "EOF" 137 <literal># Begin /etc/sysconfig/mouse 120 138 121 139 MDEVICE="<replaceable>[yourdevice]</replaceable>" … … 123 141 GPMOPTS="<replaceable>[additional options]</replaceable>" 124 142 125 # End /etc/sysconfig/mouse 126 <command>EOF</command></userinput></screen> 127 128 <indexterm zone="gpm gpm-config"> 129 <primary sortas="e-AA.gpm-root">~/.gpm-root</primary></indexterm> 130 <indexterm zone="gpm gpm-config"> 131 <primary sortas="e-etc-gpm-root.conf">/etc/gpm-root.conf</primary></indexterm> 132 <indexterm zone="gpm gpm-config"> 133 <primary sortas="e-etc-sysconfig-mouse">/etc/sysconfig/mouse</primary> 134 </indexterm> 135 </sect3> 136 137 <sect3><title>Configuration Information</title> 138 139 <para>Examples of values to set <envar>MDEVICE</envar>, 140 <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para> 141 142 <screen><userinput>MDEVICE="/dev/psaux" 143 # End /etc/sysconfig/mouse</literal> 144 EOF</userinput></screen> 145 146 <indexterm zone="gpm gpm-config"> 147 <primary sortas="e-AA.gpm-root">~/.gpm-root</primary> 148 </indexterm> 149 150 <indexterm zone="gpm gpm-config"> 151 <primary sortas="e-etc-gpm-root.conf">/etc/gpm-root.conf</primary> 152 </indexterm> 153 154 <indexterm zone="gpm gpm-config"> 155 <primary sortas="e-etc-sysconfig-mouse">/etc/sysconfig/mouse</primary> 156 </indexterm> 157 158 </sect3> 159 160 <sect3> 161 <title>Configuration Information</title> 162 163 <para>Examples of values to set <envar>MDEVICE</envar>, 164 <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para> 165 166 <screen><literal>MDEVICE="/dev/psaux" 143 167 PROTOCOL="imps2" 144 GPMOPTS=""</userinput></screen> 145 146 <para>A list of which protocol values are known can be found by running 147 <command>gpm -t -help</command>. The <envar>MDEVICE</envar> setting 148 depends on which type of mouse you have. For example, 149 <filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is 150 COM1), <filename>/dev/input/mice</filename> is often used for 151 <acronym>USB</acronym> mice and <filename>/dev/psaux</filename> for PS2 152 mice. <envar>GPMOPTS</envar> is the 'catch all' for any 153 additional options that are needed for your hardware.</para> 154 </sect3> 155 156 </sect2> 157 158 <sect2> 159 <title>Contents</title> 160 161 <segmentedlist> 162 <segtitle>Installed Programs</segtitle> 163 <seglistitem> 164 <seg>disable-paste, gpm, gpm-root, hltest, mev and mouse-test</seg> 165 </seglistitem> 166 </segmentedlist> 167 168 <variablelist> 169 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 170 <?dbfo list-presentation="list"?> 171 172 <varlistentry id="disable-paste"> 173 <term><command>disable-paste</command></term> 174 <listitem><para>is a security mechanism used to disable the paste buffer.</para> 175 <indexterm zone="gpm disable-paste"> 176 <primary sortas="b-disable-paste">disable-paste</primary></indexterm> 177 </listitem> 178 </varlistentry> 179 180 <varlistentry id="gpm-prog"> 181 <term><command>gpm</command></term> 182 <listitem><para>is a cut and paste utility and mouse server for virtual 183 consoles.</para> 184 <indexterm zone="gpm gpm-prog"> 185 <primary sortas="b-gpm">gpm</primary></indexterm> 186 </listitem> 187 </varlistentry> 188 189 <varlistentry id="gpm-root"> 190 <term><command>gpm-root</command></term> 191 <listitem><para>is a default handler for <command>gpm</command>. It is used to 192 draw menus on the root window.</para> 193 <indexterm zone="gpm gpm-root"> 194 <primary sortas="b-gpm-root">gpm-root</primary></indexterm> 195 </listitem> 196 </varlistentry> 197 198 <varlistentry id="hltest"> 199 <term><command>hltest</command></term> 200 <listitem><para>is a simple sample application using the high-level library, 201 meant to be read by programmers trying to use the high-level library.</para> 202 <indexterm zone="gpm hltest"> 203 <primary sortas="b-hltest">hltest</primary></indexterm> 204 </listitem> 205 </varlistentry> 206 207 <varlistentry id="mev"> 208 <term><command>mev</command></term> 209 <listitem><para>is a program to report mouse events.</para> 210 <indexterm zone="gpm mev"> 211 <primary sortas="b-mev">mev</primary></indexterm> 212 </listitem> 213 </varlistentry> 214 215 <varlistentry id="mouse-test"> 216 <term><command>mouse-test</command></term> 217 <listitem><para>is a tool for determining the mouse type and device it's 218 attached to.</para> 219 <indexterm zone="gpm mouse-test"> 220 <primary sortas="b-mouse-test">mouse-test</primary></indexterm> 221 </listitem> 222 </varlistentry> 223 </variablelist> 224 225 </sect2> 168 GPMOPTS=""</literal></screen> 169 170 <para>A list of which protocol values are known can be found by running 171 <command>gpm -t -help</command>. The <envar>MDEVICE</envar> setting 172 depends on which type of mouse you have. For example, 173 <filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is 174 COM1), <filename>/dev/input/mice</filename> is often used for 175 USB mice and <filename>/dev/psaux</filename> for PS2 176 mice. <envar>GPMOPTS</envar> is the 'catch all' for any 177 additional options that are needed for your hardware.</para> 178 179 </sect3> 180 181 </sect2> 182 183 <sect2 role="content"> 184 <title>Contents</title> 185 186 <segmentedlist> 187 <segtitle>Installed Programs</segtitle> 188 <segtitle>Installed Libraries</segtitle> 189 <segtitle>Installed Directories</segtitle> 190 191 <seglistitem> 192 <seg>disable-paste, gpm, gpm-root, hltest, mev, and mouse-test</seg> 193 <seg>None</seg> 194 <seg>None</seg> 195 </seglistitem> 196 </segmentedlist> 197 198 <variablelist> 199 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 200 <?dbfo list-presentation="list"?> 201 <?dbhtml list-presentation="table"?> 202 203 <varlistentry id="disable-paste"> 204 <term><command>disable-paste</command></term> 205 <listitem> 206 <para>is a security mechanism used to disable the paste buffer.</para> 207 <indexterm zone="gpm disable-paste"> 208 <primary sortas="b-disable-paste">disable-paste</primary> 209 </indexterm> 210 </listitem> 211 </varlistentry> 212 213 <varlistentry id="gpm-prog"> 214 <term><command>gpm</command></term> 215 <listitem> 216 <para>is a cut and paste utility and mouse server for virtual consoles.</para> 217 <indexterm zone="gpm gpm-prog"> 218 <primary sortas="b-gpm">gpm</primary> 219 </indexterm> 220 </listitem> 221 </varlistentry> 222 223 <varlistentry id="gpm-root"> 224 <term><command>gpm-root</command></term> 225 <listitem> 226 <para>is a default handler for <command>gpm</command>. It is used to 227 draw menus on the root window.</para> 228 <indexterm zone="gpm gpm-root"> 229 <primary sortas="b-gpm-root">gpm-root</primary> 230 </indexterm> 231 </listitem> 232 </varlistentry> 233 234 <varlistentry id="hltest"> 235 <term><command>hltest</command></term> 236 <listitem> 237 <para>is a simple sample application using the high-level library, 238 meant to be read by programmers trying to use the high-level library.</para> 239 <indexterm zone="gpm hltest"> 240 <primary sortas="b-hltest">hltest</primary> 241 </indexterm> 242 </listitem> 243 </varlistentry> 244 245 <varlistentry id="mev"> 246 <term><command>mev</command></term> 247 <listitem> 248 <para>is a program to report mouse events.</para> 249 <indexterm zone="gpm mev"> 250 <primary sortas="b-mev">mev</primary> 251 </indexterm> 252 </listitem> 253 </varlistentry> 254 255 <varlistentry id="mouse-test"> 256 <term><command>mouse-test</command></term> 257 <listitem> 258 <para>is a tool for determining the mouse type and device it's 259 attached to.</para> 260 <indexterm zone="gpm mouse-test"> 261 <primary sortas="b-mouse-test">mouse-test</primary> 262 </indexterm> 263 </listitem> 264 </varlistentry> 265 266 </variablelist> 267 268 </sect2> 226 269 227 270 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.