source: x/installing/libinput.xml@ 0acce93

10.0 10.1 11.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0acce93 was 0acce93, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to libinput 1.7.0.
Update to ruby 2.4.1.

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

  • Property mode set to 100644
File size: 8.0 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.7.0">
8
9 <!ENTITY libinput-download-http "http://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz">
10 <!ENTITY libinput-download-ftp " ">
11 <!ENTITY libinput-md5sum "b6689bfacc1239082afd453216fc3d0e">
12 <!ENTITY libinput-size "904 KB">
13 <!ENTITY libinput-buildsize "26 MB (add 8 MB for tests)">
14 <!ENTITY libinput-time "0.3 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 &lfs80_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>, 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 --with-udev-dir=/lib/udev &amp;&amp;
112make</userinput></screen>
113
114 <note>
115 <para>If you want to run the tests, add --enable-tests to the
116 <command>configure</command> options above.</para>
117
118 <para> To run the tests for this package, valgrind requires a version of
119 the /lib/ld-2.23.so (or later) library with debugging symbols present.
120 Normally in LFS these debugging symbols are stripped at the end of
121 Chapter 6. To get this library, glibc must be rebuilt with the current
122 glibc version using the same compiler that was used to build LFS. The
123 ld-2.23.so can then be renamed to ld-2.23.so.dbg and copied to /lib.
124 Then a symlink needs to be changed:</para>
125
126 <screen role="nodump"><userinput>ln -sfv ld-2.23.so.dbg /lib/ld-linux-x86-64.so.2</userinput></screen>
127
128 <para>Adjust the above instruction as needed for a 32-bit system
129 or for a different version of glibc</para>
130
131 </note>
132
133 <para>
134 Running the testsuite for this package can cause problems.
135 It creates a number of dummy input devices on the currently
136 running system that can lead to crashing a local X server or
137 a desktop environment. If you understand the risks and have
138 the optional <xref linkend="check"/> and
139 <xref linkend="valgrind"/> packages installed, the regression
140 tests can be run as the <systemitem
141 class="username">root</systemitem> user with
142 <userinput>make check</userinput>. Note that depending on
143 the system configuration and hardware, some tests may fail.
144 </para>
145
146 <para>
147 Now, as the <systemitem class="username">root</systemitem> user:
148 </para>
149
150<screen role="root"><userinput>make install</userinput></screen>
151
152 <para>
153 If <xref linkend="doxygen"/> and <xref linkend="graphviz"/> were
154 present during the build, you can install the generated documentation
155 by running the following commands as the <systemitem
156 class="username">root</systemitem> user:
157 </para>
158
159<screen role="root"><userinput>install -v -dm755 $XORG_PREFIX/share/doc/libinput-&libinput-version; &amp;&amp;
160cp -rv doc/html/* $XORG_PREFIX/share/doc/libinput-&libinput-version;</userinput></screen>
161
162 </sect3>
163
164 <sect3 role="commands">
165 <title>Command Explanations</title>
166
167 <para>
168 <parameter>--disable-libwacom</parameter>: Remove this
169 option if you have the external library libwacom installed.
170 </para>
171
172 <para>
173 <parameter>--with-udev-dir=/lib/udev</parameter>: This switch
174 specifies where UDev rules and hwdb files will be installed.
175 </para>
176
177 </sect3>
178
179 <sect3 role="content">
180 <title>Contents</title>
181
182 <segmentedlist>
183 <segtitle>Installed Programs</segtitle>
184 <segtitle>Installed Libraries</segtitle>
185 <segtitle>Installed Directories</segtitle>
186
187 <seglistitem>
188 <seg>
189 libinput-debug-events and libinput-list-devices
190 </seg>
191 <seg>
192 libinput.so
193 </seg>
194 <seg>
195 $XORG_PREFIX/share/doc/libinput-&libinput-version;
196 </seg>
197 </seglistitem>
198 </segmentedlist>
199
200 <variablelist>
201 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
202 <?dbfo list-presentation="list"?>
203 <?dbhtml list-presentation="table"?>
204
205 <varlistentry id="libinput-debug-events">
206 <term><command>libinput-debug-events</command></term>
207 <listitem>
208 <para>
209 is a debug helper for <application>libinput</application>.
210 </para>
211 <indexterm zone="libinput libinput-debug-events">
212 <primary sortas="b-libinput-debug-events">libinput-debug-events</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="libinput-list-devices">
218 <term><command>libinput-list-devices</command></term>
219 <listitem>
220 <para>
221 lists local devices as recognized by
222 <application>libinput</application>.
223 </para>
224 <indexterm zone="libinput libinput-list-devices">
225 <primary sortas="b-libinput-list-devices">libinput-list-devices</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="libinput-lib">
231 <term><filename class="libraryfile">libinput.so</filename></term>
232 <listitem>
233 <para>
234 contains API functions for handling input devices.
235 </para>
236 <indexterm zone="libinput libinput-lib">
237 <primary sortas="c-libinput">libinput.so</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 </variablelist>
243
244 </sect3>
245
246</sect2>
Note: See TracBrowser for help on using the repository browser.