source: archive/colord.xml@ 1accff3c

10.0 10.1 11.0 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 1accff3c was 1accff3c, checked in by DJ Lucas <dj@…>, 4 years ago

Remove colord-1.2. Fixes #9642.

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

  • Property mode set to 100644
File size: 10.7 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 colord-download-http
8 "https://www.freedesktop.org/software/colord/releases/colord-&colord-version;.tar.xz">
9 <!ENTITY colord-download-ftp " ">
10 <!ENTITY colord-md5sum "80b106ba18a43c7eeaf2d9a2b8c5725b">
11 <!ENTITY colord-size "1.2 MB">
12 <!ENTITY colord-buildsize "37 MB (without tests)">
13 <!ENTITY colord-time "0.4 SBU (without tests)">
14]>
15
16<sect1 id="colord" xreflabel="Colord-&colord-version;">
17 <?dbhtml filename="colord.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Colord-&colord-version;</title>
25
26 <indexterm zone="colord">
27 <primary sortas="a-Colord">Colord</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Colord</title>
32
33 <para>
34 <application>Colord</application> is a system activated daemon that
35 maps devices to color profiles. It is used by
36 <application>GNOME Color Manager</application> for system integration
37 and use when there are no users logged in.
38 </para>
39
40 &lfs81_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&colord-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&colord-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &colord-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &colord-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &colord-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &colord-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Colord Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="dbus"/>,
81 <xref linkend="glib2"/>,
82 <xref linkend="lcms2"/>, and
83 <xref linkend="sqlite"/>
84 </para>
85
86 <bridgehead renderas="sect4">Required (for the tests)</bridgehead>
87 <para role="required">
88 <xref linkend="valgrind"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="gobject-introspection"/>,
94 <xref linkend="libgudev"/>,
95 <xref linkend="libgusb"/>,
96 <xref linkend="polkit"/>,<phrase revision="sysv"> and</phrase>
97 <phrase revision="systemd"><xref linkend="systemd"/>, and</phrase>
98 <xref linkend="vala"/>
99 </para>
100
101 <bridgehead renderas="sect4">Optional</bridgehead>
102 <para role="optional">
103 <xref linkend="docbook-utils"/>,
104 <xref linkend="gnome-desktop"/> and
105 <xref linkend="colord-gtk"/> (to build the example tools),
106 <xref linkend="gtk-doc"/>,
107 <xref linkend="libxslt"/>,
108 <xref linkend="sane"/>,
109 <ulink url="http://www.argyllcms.com/">ArgllCMS</ulink>, and
110 <ulink url="http://bash-completion.alioth.debian.org/">Bash Completion</ulink>,
111 </para>
112
113 <para condition="html" role="usernotes">User Notes:
114 <ulink url="&blfs-wiki;/colord"/>
115 </para>
116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of Colord</title>
120
121 <para>
122 There should be a dedicated user and group to take control
123 of the <command>colord</command> daemon after it is started.
124 Issue the following commands as the
125 <systemitem class="username">root</systemitem> user:
126 </para>
127
128<screen role="root"><userinput>groupadd -g 71 colord &amp;&amp;
129useradd -c "Color Daemon Owner" -d /var/lib/colord -u 71 \
130 -g colord -s /bin/false colord</userinput></screen>
131
132 <para>
133 Install <application>Colord</application> by running the following
134 commands:
135 </para>
136
137<screen revision="sysv"><userinput>./configure --prefix=/usr \
138 --sysconfdir=/etc \
139 --localstatedir=/var \
140 --with-daemon-user=colord \
141 --enable-vala \
142 --enable-systemd-login=no \
143 --disable-argyllcms-sensor \
144 --disable-bash-completion \
145 --disable-static \
146 --with-systemdsystemunitdir=no &amp;&amp;
147make</userinput></screen>
148
149<screen revision="systemd"><userinput>./configure --prefix=/usr \
150 --sysconfdir=/etc \
151 --localstatedir=/var \
152 --with-daemon-user=colord \
153 --enable-vala \
154 --disable-argyllcms-sensor \
155 --disable-bash-completion \
156 --disable-static &amp;&amp;
157make</userinput></screen>
158
159 <para>
160 Now, as the <systemitem class="username">root</systemitem> user:
161 </para>
162
163<screen role="root"><userinput>make install</userinput></screen>
164
165 <para>
166 To test the results, issue: <command>make -k check</command>. For unknown
167 reasons, some tests may fail. Note that the system-wide
168 <application>D-Bus</application> daemon must be running or the tests
169 will fail.
170 </para>
171
172 </sect2>
173
174 <sect2 role="commands">
175 <title>Command Explanations</title>
176
177 <para>
178 <parameter>--with-daemon-user=colord</parameter>: This
179 switch is used so the <command>colord</command> daemon
180 will run as an unprivileged user instead of
181 <systemitem class="username">root</systemitem> user.
182 </para>
183
184 <para>
185 <parameter>--enable-vala</parameter>: This switch enables
186 building of the Vala bindings. Remove if you don't
187 have <xref linkend="vala"/> installed.
188 </para>
189
190 <para revision="sysv">
191 <parameter>--enable-systemd-login=no</parameter>: This parameter fixes
192 building without <application>systemd</application>, which is not part
193 of LFS/BLFS. If you use <application>systemd</application>,
194 replace "no" by "yes".
195 </para>
196
197 <para>
198 <parameter>--disable-argyllcms-sensor</parameter>: Disables <ulink
199 url="http://www.argyllcms.com/">ArgllCMS</ulink> sensor driver.
200 </para>
201
202 <para>
203 <parameter>--disable-bash-completion</parameter>: This switch
204 disables <application>Bash Completion</application>
205 support for <application>Colord</application> apps.
206 </para>
207
208 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
209 href="../../xincludes/static-libraries.xml"/>
210
211 <para revision="sysv">
212 <parameter>--with-systemdsystemunitdir=no</parameter>: Disables
213 attempting to build with systemd libraries.
214 </para>
215
216 <para>
217 <option>--enable-gtk-doc</option>: Use this switch if
218 <application>GTK-Doc</application> is installed and you wish to build
219 and install the API documentation.
220 </para>
221
222 <para>
223 <option>--disable-gusb</option>: Use this switch if you don't have
224 <application>libgusb</application> installed.
225 </para>
226
227 <para>
228 <option>--disable-udev</option>: Use this switch if you don't have GUdev
229 installed.
230 </para>
231
232 <para>
233 <option>--disable-polkit</option>: Use this switch if you don't have
234 <application>Polkit</application> installed.
235 </para>
236
237 </sect2>
238
239 <sect2 role="content">
240 <title>Contents</title>
241
242 <segmentedlist>
243 <segtitle>Installed Programs</segtitle>
244 <segtitle>Installed Libraries</segtitle>
245 <segtitle>Installed Directories</segtitle>
246
247 <seglistitem>
248 <seg>
249 cd-create-profile, cd-fix-profile, cd-iccdump, cd-it8, and colormgr
250 </seg>
251 <seg>
252 libcolord.so, libcolordprivate.so, and libcolorhug.so
253 </seg>
254 <seg>
255 /usr/include/colord-1,
256 /usr/lib/colord-{plugins,sensors},
257 /usr/share/color{,d},
258 /usr/share/gtk-doc/html/colord, and
259 /var/lib/colord
260 </seg>
261 </seglistitem>
262 </segmentedlist>
263
264 <variablelist>
265 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
266 <?dbfo list-presentation="list"?>
267 <?dbhtml list-presentation="table"?>
268
269 <varlistentry id="cd-create-profile">
270 <term><command>cd-create-profile</command></term>
271 <listitem>
272 <para>
273 is a Color Manager Profile Creation Tool.
274 </para>
275 <indexterm zone="colord cd-create-profile">
276 <primary sortas="b-cd-create-profile">cd-create-profile</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280
281 <varlistentry id="cd-fix-profile">
282 <term><command>cd-fix-profile</command></term>
283 <listitem>
284 <para>
285 is a tool used to fix metadata in ICC profiles.
286 </para>
287 <indexterm zone="colord cd-fix-profile">
288 <primary sortas="b-cd-fix-profile">cd-fix-profile</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="cd-iccdump">
294 <term><command>cd-iccdump</command></term>
295 <listitem>
296 <para>
297 dumps the contents of an ICC profile as human readable text.
298 </para>
299 <indexterm zone="colord cd-iccdump">
300 <primary sortas="b-cd-iccdump">cd-iccdump</primary>
301 </indexterm>
302 </listitem>
303 </varlistentry>
304
305 <varlistentry id="cd-it8">
306 <term><command>cd-it8</command></term>
307 <listitem>
308 <para>
309 is a Color Manager Testing Tool.
310 </para>
311 <indexterm zone="colord cd-it8">
312 <primary sortas="b-cd-it8">cd-it8</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 <varlistentry id="colormgr">
318 <term><command>colormgr</command></term>
319 <listitem>
320 <para>
321 is a text-mode program that allows you to interact with colord
322 on the command line.
323 </para>
324 <indexterm zone="colord colormgr">
325 <primary sortas="b-colormgr">colormgr</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 <varlistentry id="libcolord">
331 <term><filename class="libraryfile">libcolord.so</filename></term>
332 <listitem>
333 <para>
334 contains the <application>Colord</application> API functions.
335 </para>
336 <indexterm zone="colord libcolord">
337 <primary sortas="c-libcolord">libcolord.so</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 </variablelist>
343
344 </sect2>
345
346</sect1>
Note: See TracBrowser for help on using the repository browser.