source: general/sysutils/colord.xml@ 780a799a

10.0 10.1 11.0 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 780a799a was 780a799a, checked in by Fernando de Oliveira <fernando@…>, 8 years ago

Updates to colord 1.0.6, libwebp 0.4.0., libtasn1 3.4, gdk-pixbuf-2.30.3.

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

  • Property mode set to 100644
File size: 9.2 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 "9bd8a1f117742c31d195a09092ca3066">
11 <!ENTITY colord-size "1.1 MB">
12 <!ENTITY colord-buildsize "30 MB (additional 3 MB to rebuild and install
13 the API documentation, and 3 MB for the tests)">
14 <!ENTITY colord-time "0.4 SBU">
15]>
16
17<sect1 id="colord" xreflabel="Colord-&colord-version;">
18 <?dbhtml filename="colord.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Colord-&colord-version;</title>
26
27 <indexterm zone="colord">
28 <primary sortas="a-Colord">Colord</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Colord</title>
33
34 <para>
35 <application>Colord</application> is a system activated daemon that
36 maps devices to color profiles. It is used by
37 <application>GNOME Color Manager</application> for system integration
38 and use when there are no users logged in.
39 </para>
40
41 &lfs74_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&colord-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&colord-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &colord-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &colord-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &colord-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &colord-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Colord Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="glib2"/>,
82 <xref linkend="intltool"/>,
83 <xref linkend="lcms2"/>,
84 <xref linkend="sqlite"/>, and
85 <xref linkend="dbus"/>
86 </para>
87
88 <bridgehead renderas="sect4">Required (for the tests)</bridgehead>
89 <para role="required">
90 <ulink url="http://www.valgrind.org/">Valgrind</ulink>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <xref linkend="libgusb"/>,
96 <xref linkend="udev-extras"/> (for GUdev),
97 <xref linkend="polkit"/>,
98 <xref linkend="gobject-introspection"/>, and
99 <xref linkend="vala"/>
100 </para>
101
102 <bridgehead renderas="sect4">Optional</bridgehead>
103 <para role="optional">
104 <ulink url="bash-completion.alioth.debian.org">Bash Completion</ulink>,
105 <ulink url="http://www.freedesktop.org/software/colord/releases/">
106 colord-gtk</ulink> and <xref linkend="gnome-desktop"/>
107 (To build the example tools),
108 <xref linkend="docbook-utils"/>,
109 <xref linkend="gtk-doc"/> and
110 <xref linkend="sane"/>
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><userinput>./configure --prefix=/usr \
138 --sysconfdir=/etc \
139 --localstatedir=/var \
140 --libexecdir=/usr/lib/colord \
141 --with-daemon-user=colord \
142 --enable-vala \
143 --disable-bash-completion \
144 --disable-systemd-login \
145 --disable-static &amp;&amp;
146make</userinput></screen>
147
148 <para>
149 Now, as the <systemitem class="username">root</systemitem> user:
150 </para>
151
152<screen role="root"><userinput>make install</userinput></screen>
153
154 <para>
155 To test the results, issue: <command>make -k check</command>. For unknown
156 reasons, one test (cd-self-test) fails. Note that system-wide
157 <application>D-Bus</application> daemon must be running or the tests will
158 fail.
159 </para>
160
161 </sect2>
162
163 <sect2 role="commands">
164 <title>Command Explanations</title>
165
166 <para>
167 <parameter>--with-daemon-user=colord</parameter>: This
168 switch is used so the <command>colord</command> daemon
169 will run as an unprivileged user instead of
170 <systemitem class="username">root</systemitem> user.
171 </para>
172
173 <para>
174 <parameter>--enable-vala</parameter>: This switch enables
175 building of the Vala bindings. Remove if you don't
176 have <xref linkend="vala"/> installed.
177 </para>
178
179 <para>
180 <parameter>--disable-bash-completion</parameter>: This switch
181 disables <application>Bash Completion</application>
182 support for <application>Colord</application> apps.
183 </para>
184
185 <para>
186 <parameter>--disable-systemd-login</parameter>: This switch
187 prevents <command>configure</command> to look for
188 <application>Systemd</application> libraries since
189 <application>Systemd</application> is not part of
190 LFS or BLFS.
191 </para>
192
193 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
194 href="../../xincludes/static-libraries.xml"/>
195
196 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
197 href="../../xincludes/gtk-doc-rebuild.xml"/>
198
199 <para>
200 <option>--disable-gusb</option>: Use this switch if you don't have
201 <application>libgusb</application> installed.
202 </para>
203
204 <para>
205 <option>--disable-gudev</option>: Use this switch if you don't have GUdev
206 installed.
207 </para>
208
209 <para>
210 <option>--disable-polkit</option>: Use this switch if you don't have
211 <application>Polkit</application> installed.
212 </para>
213
214 </sect2>
215
216 <sect2 role="content">
217 <title>Contents</title>
218
219 <segmentedlist>
220 <segtitle>Installed Programs</segtitle>
221 <segtitle>Installed Libraries</segtitle>
222 <segtitle>Installed Directories</segtitle>
223
224 <seglistitem>
225 <seg>
226 cd-create-profile, cd-fix-profile, cd-iccdump, colord,
227 colord-sane, colord-session, and colormgr
228 </seg>
229 <seg>
230 libcolordprivate.so, libcolord.so, libcolorhug.so and
231 several under /usr/lib/colord-plugin
232 </seg>
233 <seg>
234 /usr/include/colord-1,
235 /usr/lib/colord,
236 /usr/lib/colord-plugins,
237 /usr/lib/colord-sensors,
238 /usr/share/color,
239 /usr/share/colord,
240 /usr/share/gtk-doc/html/colord and
241 /var/lib/colord
242 </seg>
243 </seglistitem>
244 </segmentedlist>
245
246 <variablelist>
247 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
248 <?dbfo list-presentation="list"?>
249 <?dbhtml list-presentation="table"?>
250
251 <varlistentry id="cd-create-profile">
252 <term><command>cd-create-profile</command></term>
253 <listitem>
254 <para>
255 is a Color Manager Profile Creation Tool.
256 </para>
257 <indexterm zone="colord cd-create-profile">
258 <primary sortas="b-cd-create-profile">cd-create-profile</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="cd-fix-profile">
264 <term><command>cd-fix-profile</command></term>
265 <listitem>
266 <para>
267 is a tool used to fix metadata in ICC profiles.
268 </para>
269 <indexterm zone="colord cd-fix-profile">
270 <primary sortas="b-cd-fix-profile">cd-fix-profile</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="colormgr">
276 <term><command>colormgr</command></term>
277 <listitem>
278 <para>
279 is a text-mode program that allows you to interact with colord
280 on the command line.
281 </para>
282 <indexterm zone="colord colormgr">
283 <primary sortas="b-colormgr">colormgr</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="libcolord">
289 <term><filename class="libraryfile">libcolord.so</filename></term>
290 <listitem>
291 <para>
292 contains the <application>Colord</application> API functions.
293 </para>
294 <indexterm zone="colord libcolord">
295 <primary sortas="c-libcolord">libcolord.so</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 </variablelist>
301
302 </sect2>
303
304</sect1>
Note: See TracBrowser for help on using the repository browser.