source: general/sysutils/udisks2.xml@ e1cd0c1

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since e1cd0c1 was e1cd0c1, checked in by Pierre Labastie <pieere@…>, 8 months ago

qca-2.3.2
udisks-2.9.2
phonon-backend-vlc-0.11.2
libsamplerate-0.2.1
libsndfile-1.0.31

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24180 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 udisks2-download-http "https://github.com/storaged-project/udisks/releases/download/udisks-&udisks2-version;/udisks-&udisks2-version;.tar.bz2">
8 <!ENTITY udisks2-download-ftp " ">
9 <!ENTITY udisks2-md5sum "1f8a9ca98a63ecc9e48ffd08309d0492">
10 <!ENTITY udisks2-size "1.6 MB">
11 <!ENTITY udisks2-buildsize "52 MB (with tests)">
12 <!ENTITY udisks2-time "0.3 SBU (with tests)">
13]>
14
15<sect1 id="udisks2" xreflabel="UDisks-&udisks2-version;">
16 <?dbhtml filename="udisks2.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>UDisks-&udisks2-version;</title>
24
25 <indexterm zone="udisks2">
26 <primary sortas="a-UDisks2">UDisks2</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to UDisks</title>
31
32 <para>
33 The <application>UDisks</application> package provides a daemon,
34 tools and libraries to access and manipulate disks and storage
35 devices.
36 </para>
37
38 &lfs10_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&udisks2-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&udisks2-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &udisks2-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &udisks2-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &udisks2-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &udisks2-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">UDisks Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="libatasmart"/>,
79 <xref linkend="libblockdev"/>,
80 <xref linkend="libgudev"/>,
81 <xref linkend="libxslt"/>, and
82 <xref linkend="polkit"/>
83 </para>
84
85 <bridgehead renderas="sect4">Required at runtime</bridgehead>
86 <para role="required">
87 <xref role="runtime" linkend="btrfs-progs"/>,
88 <phrase revision="sysv"><xref role="runtime" linkend="dbus"/>,</phrase>
89 <xref role="runtime" linkend="dosfstools"/>,
90 <xref role="runtime" linkend="gptfdisk"/>,
91 <xref role="runtime" linkend="mdadm"/>, and
92 <xref role="runtime" linkend="xfsprogs"/>
93 </para>
94
95 <bridgehead renderas="sect4">Recommended</bridgehead>
96 <para role="recommended">
97 <phrase revision="systemd"><xref linkend="systemd"/></phrase>
98 <phrase revision="sysv"><xref linkend="elogind"/></phrase>
99 </para>
100
101 <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
102 <para role="optional">
103 <xref linkend="gobject-introspection"/>
104 </para>
105
106 <bridgehead renderas="sect4">Optional</bridgehead>
107 <para role="optional">
108 <xref linkend="dbus-python"/> (for the integration tests),
109 <xref linkend="gtk-doc"/>,
110 <xref linkend="lvm2"/>,
111 <xref linkend="ntfs-3g"/>,
112 <xref linkend="pygobject3"/> (for the integration tests),
113 <ulink url="https://github.com/relan/exfat">exFAT</ulink>, and
114 <ulink url="https://github.com/sahlberg/libiscsi">libiscsi</ulink>
115 </para>
116
117 <para condition="html" role="usernotes">
118 User Notes: <ulink url="&blfs-wiki;/udisks2"/>
119 </para>
120 </sect2>
121
122 <sect2 role="installation">
123 <title>Installation of UDisks</title>
124
125<!-- Applied upstream in version 2.9.0.
126 <para>
127 First, fix a regression caused by glib-2.64:
128 </para>
129
130<screen><userinput remap="pre">sed -i '/stdout_channel = g/a g_io_channel_set_encoding (job->child_stdout_channel, NULL, NULL);' src/udisksspawnedjob.c &amp;&amp;
131sed -i '/stderr_channel = g/a g_io_channel_set_encoding (job->child_stderr_channel, NULL, NULL);' src/udisksspawnedjob.c</userinput></screen>
132-->
133
134 <para>
135 Install <application>UDisks</application> by running the following
136 commands:
137 </para>
138
139<screen><userinput>./configure --prefix=/usr \
140 --sysconfdir=/etc \
141 --localstatedir=/var \
142 --disable-static &amp;&amp;
143make</userinput></screen>
144
145 <para>
146 To test the results, issue: <command>make check</command>. A more
147 thorough test can be run with <command>make ci</command>. You must first
148 create the directories
149 <filename class="directory">/var/run/udisks2</filename> and
150 <filename class="directory">/var/lib/udisks2</filename>, and the optional
151 python modules should be present.
152 </para>
153
154 <para>
155 Now, as the <systemitem class="username">root</systemitem> user:
156 </para>
157
158<screen role="root"><userinput>make install</userinput></screen>
159 </sect2>
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
165 href="../../xincludes/static-libraries.xml"/>
166
167 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
168 href="../../xincludes/gtk-doc-rebuild.xml"/>
169
170 </sect2>
171
172 <sect2 role="content">
173 <title>Contents</title>
174
175 <segmentedlist>
176 <segtitle>Installed Programs</segtitle>
177 <segtitle>Installed Library</segtitle>
178 <segtitle>Installed Directories</segtitle>
179
180 <seglistitem>
181 <seg>
182 udisksctl and umount.udisks2
183 </seg>
184 <seg>
185 libudisks2.so
186 </seg>
187 <seg>
188 /etc/udisks2,
189 /usr/include/udisks2,
190 /usr/libexec/udisks2,
191 /usr/share/gtk-doc/html/udisks2, and
192 /var/{lib,run}/udisks2
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="udisksctl">
203 <term><command>udisksctl</command></term>
204 <listitem>
205 <para>
206 is a command-line program used to interact with the
207 <command>udisksd</command> daemon.
208 </para>
209 <indexterm zone="udisks2 udisksctl">
210 <primary sortas="b-udisksctl">udisksctl</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215<!-- Removed since the user shouldn't use this, and it is in /usr/libexec
216 <varlistentry id="udisksd">
217 <term><command>udisksd</command></term>
218 <listitem>
219 <para>
220 is the <application>UDisks</application> daemon itself.
221 </para>
222 <indexterm zone="udisks2 udisksd">
223 <primary sortas="b-udisksd">udisksd</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227-->
228 <varlistentry id="umountudisks2">
229 <term><command>umount.udisks2</command></term>
230 <listitem>
231 <para>
232 is a command-line program used to unmount file systems
233 that have been mounted by the
234 <application>UDisks</application> daemon.
235 </para>
236 <indexterm zone="udisks2 umountudisks2">
237 <primary sortas="b-umountudisks2">umount.udisks2</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="libudisks2">
243 <term><filename class="libraryfile">libudisks2.so</filename></term>
244 <listitem>
245 <para>
246 contains the <application>UDisks</application> API functions.
247 </para>
248 <indexterm zone="udisks2 libudisks2">
249 <primary sortas="c-libudisks2">libudisks2.so</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 </variablelist>
255
256 </sect2>
257
258</sect1>
Note: See TracBrowser for help on using the repository browser.