Changeset 20e3223


Ignore:
Timestamp:
05/07/2005 09:39:51 AM (17 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 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, ken/refactor-virt, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
343bcdb
Parents:
bff9ad6b
Message:

Tagged gpm.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3999 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed
  • general/sysutils/gpm.xml

    rbff9ad6b r20e3223  
    55  %general-entities;
    66
    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">
    1313]>
    1414
    1515<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 &amp;&amp;
     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 &amp;&amp;
    7184patch -Np1 -i ../gpm-&gpm-version;-silent-1.patch &amp;&amp;
    7285LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
    73 make</command></userinput></screen>
    74 
    75 <para>Now, as the root user:</para>
    76 
    77 <screen><userinput role='root'><command>make install &amp;&amp;
    78 cp conf/gpm-root.conf /etc &amp;&amp;
    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>
     86make</userinput></screen>
     87
     88    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     89
     90<screen role="root"><userinput>make install &amp;&amp;
     91cp -v conf/gpm-root.conf /etc &amp;&amp;
     92ldconfig</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>
    88102
    89103<!-- <para><command>ldconfig -n -l </command>: During installation, gpm outputs a
    90104message to run the above command to create the proper library links.</para> -->
    91105
    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 &gt; /etc/sysconfig/mouse &lt;&lt; "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 &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"
     137<literal># Begin /etc/sysconfig/mouse
    120138
    121139MDEVICE="<replaceable>[yourdevice]</replaceable>"
     
    123141GPMOPTS="<replaceable>[additional options]</replaceable>"
    124142
    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>
     144EOF</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"
    143167PROTOCOL="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>
     168GPMOPTS=""</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>
    226269
    227270</sect1>
Note: See TracChangeset for help on using the changeset viewer.