source: x/installing/libinput.xml@ 2527a93

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 2527a93 was 2527a93, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to xorg-server-1.19.4.
Update to xkeyboard-config-2.22.
Update to mesa-17.2.2.
Update to libinput-1.8.3.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19309 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.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libinput-version "1.8.3">
8
9 <!ENTITY libinput-download-http "https://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz">
10 <!ENTITY libinput-download-ftp " ">
11 <!ENTITY libinput-md5sum "5265244853ad7cf41232b0d3ee805ab9">
12 <!ENTITY libinput-size "920 KB">
13 <!ENTITY libinput-buildsize "16 MB (add 8 MB for tests)">
14 <!ENTITY libinput-time "0.1 SBU (add 14 minutes for tests, not CPU dependent)">
15]>
16
17<sect2 id="libinput" xreflabel="libinput-&libinput-version;">
18 <?dbhtml filename="libinput.html"?>
19
20 <sect2info>
21 <othername>$LastChangedBy: renodr $</othername>
22 <date>$Date: 2015-09-14 17:42:53 -0500 (Mon, 14 Sep 2015) $</date>
23 </sect2info>
24
25 <title>libinput-&libinput-version;</title>
26
27 <indexterm zone="libinput">
28 <primary sortas="a-libinput">libinput</primary>
29 </indexterm>
30
31 <sect3 role="package">
32 <title>Introduction to libinput</title>
33
34 <para>
35 <application>libinput</application> is a library that handles
36 input devices for display servers and other applications that
37 need to directly deal with input devices.
38 </para>
39
40 &lfs81_checked;
41
42 <bridgehead renderas="sect4">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&libinput-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&libinput-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &libinput-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &libinput-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &libinput-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &libinput-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect4">libinput Dependencies</bridgehead>
77
78 <bridgehead renderas="sect5">Required</bridgehead>
79 <para role="required">
80 <xref linkend="libevdev"/> and
81 <xref linkend="mtdev"/>
82 </para>
83
84 <bridgehead renderas="sect5">Optional</bridgehead>
85 <para role="optional">
86 <xref linkend="check"/> and
87 <xref linkend="valgrind"/> (to run the tests),
88 <xref linkend="doxygen"/> and
89 <xref linkend="graphviz"/> (to build the documentation)
90 <xref linkend="gtk3"/> (to build the GUI event viewer),
91 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink> (required for tests), and
92 <ulink revision="sysv" url="https://sourceforge.net/projects/linuxwacom/files/libwacom/">libwacom</ulink>
93 <xref revision="systemd" linkend="libwacom"/>
94 </para>
95
96 <para condition="html" role="usernotes">
97 User Notes: <ulink url="&blfs-wiki;/libinput"/>
98 </para>
99 </sect3>
100
101 <sect3 role="installation">
102 <title>Installation of libinput</title>
103
104 <para>
105 Install <application>libinput</application> by running the following
106 commands:
107 </para>
108
109<screen><userinput>./configure $XORG_CONFIG \
110 --disable-libwacom \
111 --disable-debug-gui \
112 --disable-tests \
113 --disable-documentation \
114 --with-udev-dir=/lib/udev &amp;&amp;
115make</userinput></screen>
116
117 <note>
118 <para>If you want to run the tests, remove --disable-tests from the
119 <command>configure</command> command above. The external
120 library, libunwind, must be installed.</para>
121
122 <para> To run the tests for this package, valgrind requires a version of
123 the /lib/ld-2.23.so (or later) library with debugging symbols present.
124 Normally in LFS these debugging symbols are stripped at the end of
125 Chapter 6. To get this library, glibc must be rebuilt with the current
126 glibc version using the same compiler that was used to build LFS. The
127 ld-2.23.so can then be renamed to ld-2.23.so.dbg and copied to /lib.
128 Then a symlink needs to be changed:</para>
129
130 <screen role="nodump"><userinput>ln -sfv ld-2.23.so.dbg /lib/ld-linux-x86-64.so.2</userinput></screen>
131
132 <para>Adjust the above instruction as needed for a 32-bit system
133 or for a different version of glibc</para>
134
135 </note>
136
137 <para>
138 Running the testsuite for this package can cause problems.
139 It creates a number of dummy input devices on the currently
140 running system that can lead to crashing a local X server or
141 a desktop environment. If you understand the risks and have
142 the optional <xref linkend="check"/> and
143 <xref linkend="valgrind"/> packages installed, the regression
144 tests can be run as the <systemitem
145 class="username">root</systemitem> user with
146 <userinput>make check</userinput>. Note that depending on
147 the system configuration and hardware, some tests may fail.
148 </para>
149
150 <para>
151 Now, as the <systemitem class="username">root</systemitem> user:
152 </para>
153
154<screen role="root"><userinput>make install</userinput></screen>
155
156 <para>
157 If <xref linkend="doxygen"/> and <xref linkend="graphviz"/> were
158 present during the build, you can install the generated documentation
159 by running the following commands as the <systemitem
160 class="username">root</systemitem> user:
161 </para>
162
163<screen role="root"><userinput>install -v -dm755 $XORG_PREFIX/share/doc/libinput-&libinput-version; &amp;&amp;
164cp -rv doc/html/* $XORG_PREFIX/share/doc/libinput-&libinput-version;</userinput></screen>
165
166 </sect3>
167
168 <sect3 role="commands">
169 <title>Command Explanations</title>
170
171 <para>
172 <parameter>--disable-libwacom</parameter>: Remove this
173 option if you have the external library libwacom installed.
174 </para>
175
176 <para>
177 <parameter>--disable-debug-gui</parameter>: This switch
178 disables creation of a visual debug helper for libinput. Remove
179 if you want it, and you have <xref linkend="gtk3"/> installed.
180 </para>
181
182 <para>
183 <parameter>--disable-tests</parameter>: This switch disables compilation
184 of tests. Remove if you want to run the tests, and you have the external
185 library, libunwind, installed.
186 </para>
187
188 <para>
189 <parameter>--disable-documentation</parameter>: This switch disables
190 generation of the documentation. Remove if you want to generate it, and
191 you have <xref linkend="doxygen"/> and <xref linkend="graphviz"/>
192 installed.
193 </para>
194
195 <para>
196 <parameter>--with-udev-dir=/lib/udev</parameter>: This switch
197 specifies where UDev rules and hwdb files will be installed.
198 </para>
199
200 </sect3>
201
202 <sect3 role="content">
203 <title>Contents</title>
204
205 <segmentedlist>
206 <segtitle>Installed Programs</segtitle>
207 <segtitle>Installed Libraries</segtitle>
208 <segtitle>Installed Directories</segtitle>
209
210 <seglistitem>
211 <seg>
212 libinput,
213 libinput-debug-events, and
214 libinput-list-devices
215 </seg>
216 <seg>
217 libinput.so
218 </seg>
219 <seg>
220 $XORG_PREFIX/libexec/libinput and
221 $XORG_PREFIX/share/doc/libinput-&libinput-version;
222 </seg>
223 </seglistitem>
224 </segmentedlist>
225
226 <variablelist>
227 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
228 <?dbfo list-presentation="list"?>
229 <?dbhtml list-presentation="table"?>
230
231 <varlistentry id="libinput-debug-events">
232 <term><command>libinput-debug-events</command></term>
233 <listitem>
234 <para>
235 is a debug helper for <application>libinput</application>.
236 </para>
237 <indexterm zone="libinput libinput-debug-events">
238 <primary sortas="b-libinput-debug-events">libinput-debug-events</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 <varlistentry id="libinput-list-devices">
244 <term><command>libinput-list-devices</command></term>
245 <listitem>
246 <para>
247 lists local devices as recognized by
248 <application>libinput</application>.
249 </para>
250 <indexterm zone="libinput libinput-list-devices">
251 <primary sortas="b-libinput-list-devices">libinput-list-devices</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="libinput-lib">
257 <term><filename class="libraryfile">libinput.so</filename></term>
258 <listitem>
259 <para>
260 contains API functions for handling input devices.
261 </para>
262 <indexterm zone="libinput libinput-lib">
263 <primary sortas="c-libinput">libinput.so</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 </variablelist>
269
270 </sect3>
271
272</sect2>
Note: See TracBrowser for help on using the repository browser.