source: general/sysutils/gpm.xml@ 343bcdb

10.0 10.1 11.0 11.1 11.2 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 krejzi/svn lazarus nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 343bcdb was 343bcdb, checked in by Manuel Canales Esparcia <manuel@…>, 18 years ago

Tagged hdparm.xml

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

  • Property mode set to 100644
File size: 8.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
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">
13]>
14
15<sect1 id="gpm" xreflabel="GPM-&gpm-version;">
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;
84patch -Np1 -i ../gpm-&gpm-version;-silent-1.patch &amp;&amp;
85LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
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>
102
103<!-- <para><command>ldconfig -n -l </command>: During installation, gpm outputs a
104message to run the above command to create the proper library links.</para> -->
105
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
135 <systemitem class="username">root</systemitem> user:</para>
136
137<screen role="root"><userinput>cat &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"
138<literal># Begin /etc/sysconfig/mouse
139
140MDEVICE="<replaceable>[yourdevice]</replaceable>"
141PROTOCOL="<replaceable>[yourprotocol]</replaceable>"
142GPMOPTS="<replaceable>[additional options]</replaceable>"
143
144# End /etc/sysconfig/mouse</literal>
145EOF</userinput></screen>
146
147 <indexterm zone="gpm gpm-config">
148 <primary sortas="e-AA.gpm-root">~/.gpm-root</primary>
149 </indexterm>
150
151 <indexterm zone="gpm gpm-config">
152 <primary sortas="e-etc-gpm-root.conf">/etc/gpm-root.conf</primary>
153 </indexterm>
154
155 <indexterm zone="gpm gpm-config">
156 <primary sortas="e-etc-sysconfig-mouse">/etc/sysconfig/mouse</primary>
157 </indexterm>
158
159 </sect3>
160
161 <sect3>
162 <title>Configuration Information</title>
163
164 <para>Examples of values to set <envar>MDEVICE</envar>,
165 <envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para>
166
167<screen><literal>MDEVICE="/dev/psaux"
168PROTOCOL="imps2"
169GPMOPTS=""</literal></screen>
170
171 <para>A list of which protocol values are known can be found by running
172 <command>gpm -t -help</command>. The <envar>MDEVICE</envar> setting
173 depends on which type of mouse you have. For example,
174 <filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is
175 COM1), <filename>/dev/input/mice</filename> is often used for
176 USB mice and <filename>/dev/psaux</filename> for PS2
177 mice. <envar>GPMOPTS</envar> is the 'catch all' for any
178 additional options that are needed for your hardware.</para>
179
180 </sect3>
181
182 </sect2>
183
184 <sect2 role="content">
185 <title>Contents</title>
186
187 <segmentedlist>
188 <segtitle>Installed Programs</segtitle>
189 <segtitle>Installed Libraries</segtitle>
190 <segtitle>Installed Directories</segtitle>
191
192 <seglistitem>
193 <seg>disable-paste, gpm, gpm-root, hltest, mev, and mouse-test</seg>
194 <seg>None</seg>
195 <seg>None</seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="disable-paste">
205 <term><command>disable-paste</command></term>
206 <listitem>
207 <para>is a security mechanism used to disable the paste buffer.</para>
208 <indexterm zone="gpm disable-paste">
209 <primary sortas="b-disable-paste">disable-paste</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="gpm-prog">
215 <term><command>gpm</command></term>
216 <listitem>
217 <para>is a cut and paste utility and mouse server for virtual consoles.</para>
218 <indexterm zone="gpm gpm-prog">
219 <primary sortas="b-gpm">gpm</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="gpm-root">
225 <term><command>gpm-root</command></term>
226 <listitem>
227 <para>is a default handler for <command>gpm</command>. It is used to
228 draw menus on the root window.</para>
229 <indexterm zone="gpm gpm-root">
230 <primary sortas="b-gpm-root">gpm-root</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="hltest">
236 <term><command>hltest</command></term>
237 <listitem>
238 <para>is a simple sample application using the high-level library,
239 meant to be read by programmers trying to use the high-level library.</para>
240 <indexterm zone="gpm hltest">
241 <primary sortas="b-hltest">hltest</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="mev">
247 <term><command>mev</command></term>
248 <listitem>
249 <para>is a program to report mouse events.</para>
250 <indexterm zone="gpm mev">
251 <primary sortas="b-mev">mev</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="mouse-test">
257 <term><command>mouse-test</command></term>
258 <listitem>
259 <para>is a tool for determining the mouse type and device it's
260 attached to.</para>
261 <indexterm zone="gpm mouse-test">
262 <primary sortas="b-mouse-test">mouse-test</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 </variablelist>
268
269 </sect2>
270
271</sect1>
Note: See TracBrowser for help on using the repository browser.