source: x/installing/libinput.xml@ 0134954

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

Initial 7.10 tags; only 765 to go

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

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