source: general/sysutils/colord.xml@ 2b872a2

10.0 10.1 11.0 11.1 11.2 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 2b872a2 was 2b872a2, checked in by Fernando de Oliveira <fernando@…>, 8 years ago

Update to colord-1.2.6.Update to LVM2.2.02.113.
Update to libgusb-0.2.1.
Update to dbus-1.8.12.
Update to libwnck-3.14.0.
Update to notification-daemon-3.14.1.

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

  • Property mode set to 100644
File size: 10.1 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 "http://www.freedesktop.org/software/colord/releases/colord-&colord-version;.tar.xz">
9 <!ENTITY colord-download-ftp " ">
10 <!ENTITY colord-md5sum "ec1ad709bac22963877dbf48381ec34c">
11 <!ENTITY colord-size "1.2 MB">
12 <!ENTITY colord-buildsize "32 MB (additional 3 MB to build and install the API documentation, and 3 MB for the tests)">
13 <!ENTITY colord-time "0.5 SBU (additional 0.1 SBU to build and install the API documentation, and 0.2 SBU for the 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 &lfs76_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="libgusb"/>,
94 <xref linkend="gobject-introspection"/>,
95 <xref linkend="polkit"/>,
96 <xref linkend="udev-extras"/> (for GUdev), and
97 <xref linkend="vala"/>
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <xref linkend="gnome-desktop"/> and
103 <ulink url="http://www.freedesktop.org/software/colord/releases/">
104 colord-gtk</ulink> (to build the example tools),
105 <xref linkend="docbook-utils"/>,
106 <xref linkend="gtk-doc"/>,
107 <xref linkend="libxslt"/>,
108 <xref linkend="sane"/>,
109 <xref linkend="valgrind"/> (required for the tests),
110 <ulink url="http://www.argyllcms.com/">ArgllCMS</ulink>, and
111 <ulink url="http://bash-completion.alioth.debian.org/">Bash Completion</ulink>,
112 </para>
113
114 <para condition="html" role="usernotes">User Notes:
115 <ulink url="&blfs-wiki;/colord"/>
116 </para>
117 </sect2>
118
119 <sect2 role="installation">
120 <title>Installation of Colord</title>
121
122 <para>
123 There should be a dedicated user and group to take control
124 of the <command>colord</command> daemon after it is started.
125 Issue the following commands as the
126 <systemitem class="username">root</systemitem> user:
127 </para>
128
129<screen role="root"><userinput>groupadd -g 71 colord &amp;&amp;
130useradd -c "Color Daemon Owner" -d /var/lib/colord -u 71 \
131 -g colord -s /bin/false colord</userinput></screen>
132
133 <para>
134 Install <application>Colord</application> by running the following
135 commands:
136 </para>
137
138<screen><userinput>./configure --prefix=/usr \
139 --sysconfdir=/etc \
140 --localstatedir=/var \
141 --with-daemon-user=colord \
142 --enable-vala \
143 --enable-systemd-login=no \
144 --disable-argyllcms-sensor \
145 --disable-bash-completion \
146 --disable-static \
147 --with-systemdsystemunitdir=no &amp;&amp;
148make</userinput></screen>
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 To test the results, issue: <command>make -k check</command>. For unknown
158 reasons, some tests may fail. Note that system-wide
159 <application>D-Bus</application> daemon must be running or the tests
160 will fail.
161 </para>
162
163 </sect2>
164
165 <sect2 role="commands">
166 <title>Command Explanations</title>
167
168 <para>
169 <parameter>--with-daemon-user=colord</parameter>: This
170 switch is used so the <command>colord</command> daemon
171 will run as an unprivileged user instead of
172 <systemitem class="username">root</systemitem> user.
173 </para>
174
175 <para>
176 <parameter>--enable-vala</parameter>: This switch enables
177 building of the Vala bindings. Remove if you don't
178 have <xref linkend="vala"/> installed.
179 </para>
180
181 <para>
182 <parameter>--enable-systemd-login=no</parameter>: This parameter fixes
183 building without <application>systemd</application>, which is not part
184 of LFS/BLFS. If you use <application>systemd</application>,
185 replace "no" by "yes".
186 </para>
187
188 <para>
189 <parameter>--disable-argyllcms-sensor</parameter>: Disables <ulink
190 url="http://www.argyllcms.com/">ArgllCMS</ulink> sensor driver.
191 </para>
192
193 <para>
194 <parameter>--disable-bash-completion</parameter>: This switch
195 disables <application>Bash Completion</application>
196 support for <application>Colord</application> apps.
197 </para>
198
199 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
200 href="../../xincludes/static-libraries.xml"/>
201
202 <para>
203 <parameter>--with-systemdsystemunitdir=no</parameter>: Disables
204 attempting to build with systemd libraries.
205 </para>
206
207 <para>
208 <option>--enable-gtk-doc</option>: Use this switch if
209 <application>GTK-Doc</application> is installed and you wish to build
210 and install the API documentation.
211 </para>
212
213 <para>
214 <option>--disable-gusb</option>: Use this switch if you don't have
215 <application>libgusb</application> installed.
216 </para>
217
218 <para>
219 <option>--disable-gudev</option>: Use this switch if you don't have GUdev
220 installed.
221 </para>
222
223 <para>
224 <option>--disable-polkit</option>: Use this switch if you don't have
225 <application>Polkit</application> installed.
226 </para>
227
228 </sect2>
229
230 <sect2 role="content">
231 <title>Contents</title>
232
233 <segmentedlist>
234 <segtitle>Installed Programs</segtitle>
235 <segtitle>Installed Libraries</segtitle>
236 <segtitle>Installed Directories</segtitle>
237
238 <seglistitem>
239 <seg>
240 cd-create-profile, cd-fix-profile, cd-iccdump, cd-it8, colord,
241 colord-sane, colord-session, and colormgr
242 </seg>
243 <seg>
244 libcolord.so, libcolordprivate.so, and libcolorhug.so
245 </seg>
246 <seg>
247 /usr/include/colord-1,
248 /usr/lib/colord-plugins,
249 /usr/lib/colord-sensors,
250 /usr/share/color,
251 /usr/share/colord,
252 /usr/share/gtk-doc/html/colord and
253 /var/lib/colord
254 </seg>
255 </seglistitem>
256 </segmentedlist>
257
258 <variablelist>
259 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
260 <?dbfo list-presentation="list"?>
261 <?dbhtml list-presentation="table"?>
262
263 <varlistentry id="cd-create-profile">
264 <term><command>cd-create-profile</command></term>
265 <listitem>
266 <para>
267 is a Color Manager Profile Creation Tool.
268 </para>
269 <indexterm zone="colord cd-create-profile">
270 <primary sortas="b-cd-create-profile">cd-create-profile</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="cd-fix-profile">
276 <term><command>cd-fix-profile</command></term>
277 <listitem>
278 <para>
279 is a tool used to fix metadata in ICC profiles.
280 </para>
281 <indexterm zone="colord cd-fix-profile">
282 <primary sortas="b-cd-fix-profile">cd-fix-profile</primary>
283 </indexterm>
284 </listitem>
285 </varlistentry>
286
287 <varlistentry id="cd-it8">
288 <term><command>cd-it8</command></term>
289 <listitem>
290 <para>
291 is a Color Manager Testing Tool.
292 </para>
293 <indexterm zone="colord cd-it8">
294 <primary sortas="b-cd-it8">cd-it8</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="colormgr">
300 <term><command>colormgr</command></term>
301 <listitem>
302 <para>
303 is a text-mode program that allows you to interact with colord
304 on the command line.
305 </para>
306 <indexterm zone="colord colormgr">
307 <primary sortas="b-colormgr">colormgr</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="libcolord">
313 <term><filename class="libraryfile">libcolord.so</filename></term>
314 <listitem>
315 <para>
316 contains the <application>Colord</application> API functions.
317 </para>
318 <indexterm zone="colord libcolord">
319 <primary sortas="c-libcolord">libcolord.so</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 </variablelist>
325
326 </sect2>
327
328</sect1>
Note: See TracBrowser for help on using the repository browser.