source: gnome/platform/gvfs.xml

trunk
Last change on this file was 1809e6e, checked in by Douglas R. Reno <renodr@…>, 2 weeks ago

gvfs: Add an optional external dependency on libmsgraph.

Also updated the command explanation to note that if you want OneDrive
support (for folks like me) that you need libmsgraph installed if you
remove -Donedrive=false
  • Property mode set to 100644
File size: 8.0 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 gvfs-download-http "&gnome-download-http;/gvfs/1.54/gvfs-&gvfs-version;.tar.xz">
8 <!ENTITY gvfs-download-ftp " ">
9 <!ENTITY gvfs-md5sum "f2c1db236533c19cb3c3e0a468aac59a">
10 <!ENTITY gvfs-size "1.2 MB">
11 <!ENTITY gvfs-buildsize "29 MB">
12 <!ENTITY gvfs-time "0.2 SBU (using parallelism=4)">
13]>
14
15<sect1 id="gvfs" xreflabel="Gvfs-&gvfs-version;">
16 <?dbhtml filename="gvfs.html"?>
17
18
19 <title>Gvfs-&gvfs-version;</title>
20
21 <indexterm zone="gvfs">
22 <primary sortas="a-Gvfs">Gvfs</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Gvfs</title>
27
28 <para>
29 The <application>Gvfs</application> package is a userspace virtual
30 filesystem designed to work with the I/O abstractions of GLib's GIO
31 library.
32 </para>
33
34 &lfs121_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&gvfs-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&gvfs-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &gvfs-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &gvfs-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &gvfs-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &gvfs-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69<!--
70 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
71 <itemizedlist spacing="compact">
72 <listitem>
73 <para>
74 Required patch:
75 <ulink url="&patch-root;/gvfs-&gvfs-version;-fix_security_vulnerabilities-1.patch"/>
76 </para>
77 </listitem>
78 </itemizedlist>
79-->
80 <bridgehead renderas="sect3">Gvfs Dependencies</bridgehead>
81
82 <bridgehead renderas="sect4">Required</bridgehead>
83 <para role="required">
84 <xref linkend="dbus"/>,
85 <xref linkend="glib2"/>,
86 <xref linkend="gcr4"/>,
87 <xref linkend="libusb"/>, and
88 <xref linkend="libsecret"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="gtk3"/>,
94 <xref linkend="libcdio"/>,
95 <xref linkend="libgudev"/>,
96 <xref linkend="libsoup3"/>,
97 <phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
98 <phrase revision="systemd"><xref role='runtime' linkend="systemd"/>
99 (runtime),</phrase> and
100 <xref linkend="udisks2"/>
101 </para>
102
103 <bridgehead renderas="sect4">Optional</bridgehead>
104 <para role="optional">
105 <xref linkend="apache"/>,
106 <xref linkend="avahi"/>,
107 <xref linkend="bluez"/>,
108 <xref linkend="fuse3"/>,
109 <xref linkend="gnome-online-accounts"/>,
110 <xref linkend="gtk-doc"/>,
111 <xref linkend="libarchive"/>,
112 <xref linkend="libgcrypt"/>,
113 <xref linkend="libgdata"/>,
114 <xref linkend="libxml2"/>,
115 <xref linkend="libxslt"/>,
116 <xref linkend="openssh"/>,
117 <xref linkend="samba"/>,
118 <ulink url="&gnome-download-http;/gnome-desktop-testing/">gnome-desktop-testing</ulink> (for tests),
119 <ulink url="https://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
120 <ulink url="http://www.gphoto.org/">libgphoto2</ulink>,
121 <ulink url="https://www.libimobiledevice.org/">libimobiledevice</ulink>,
122 <ulink url="https://gitlab.gnome.org/GNOME/msgraph">libmsgraph</ulink>,
123 <ulink url="https://libmtp.sourceforge.net/">libmtp</ulink>,
124 <ulink url="https://github.com/sahlberg/libnfs/">libnfs</ulink>, and
125 <ulink url="https://twisted.org/">Twisted</ulink>
126 </para>
127
128 </sect2>
129
130 <sect2 role="installation">
131 <title>Installation of Gvfs</title>
132
133 <para>
134 Install <application>Gvfs</application> by running the following
135 commands:
136 </para>
137
138<screen revision='sysv'><userinput>mkdir build &amp;&amp;
139cd build &amp;&amp;
140
141meson setup \
142 --prefix=/usr \
143 --buildtype=release \
144 -Donedrive=false \
145 -Dfuse=false \
146 -Dgphoto2=false \
147 -Dafc=false \
148 -Dbluray=false \
149 -Dnfs=false \
150 -Dmtp=false \
151 -Dsmb=false \
152 -Dtmpfilesdir=no \
153 -Ddnssd=false \
154 -Dgoa=false \
155 -Dgoogle=false \
156 -Dsystemduserunitdir=no .. &amp;&amp;
157ninja</userinput></screen>
158
159<screen revision='systemd'><userinput>mkdir build &amp;&amp;
160cd build &amp;&amp;
161
162meson setup \
163 --prefix=/usr \
164 --buildtype=release \
165 -Donedrive=false \
166 -Dfuse=false \
167 -Dgphoto2=false \
168 -Dafc=false \
169 -Dbluray=false \
170 -Dnfs=false \
171 -Dmtp=false \
172 -Dsmb=false \
173 -Ddnssd=false \
174 -Dgoa=false \
175 -Dgoogle=false .. &amp;&amp;
176ninja</userinput></screen>
177
178 <para>
179 The test suite requires <application>gnome-desktop-testing</application>,
180 which is beyond the scope of BLFS.
181 </para>
182
183 <para>
184 Now, as the <systemitem class="username">root</systemitem> user:
185 </para>
186
187<screen role="root"><userinput>ninja install</userinput></screen>
188
189 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
190 href="../../xincludes/gsettings-destdir.xml"/>
191 </sect2>
192
193 <sect2 role="commands">
194 <title>Command Explanations</title>
195
196 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
197 href="../../xincludes/meson-buildtype-release.xml"/>
198
199 <para>
200 <parameter>-D&lt;option&gt;=false</parameter>: These switches are
201 required if the corresponding dependency is not installed.
202 Remove those where you have installed the corresponding application and
203 wish to use it with <application>Gvfs</application>. The dnssd option
204 requires avahi and both goa and google require GNOME Online Accounts.
205 The google option also requires libgdata. The onedrive support requires
206 the libmsgraph package.
207 </para>
208
209 <para revision="sysv">
210 <parameter>-Dtmpfilesdir=no</parameter>
211 <parameter>-Dsystemduserunitdir=no</parameter>: These
212 switches provide systemd directory locations. Setting them to
213 <quote>no</quote> disables the dependency on systemd and logind.
214 </para>
215
216 <para>
217 <option>-Dcdda=false</option>: This switch is required if libcdio is not
218 installed. The cdda backend is useless on machines without a CDROM/DVD
219 drive.
220 </para>
221
222 </sect2>
223
224 <sect2 role="content">
225 <title>Contents</title>
226
227 <segmentedlist>
228 <segtitle>Installed Programs</segtitle>
229 <segtitle>Installed Library</segtitle>
230 <segtitle>Installed Directories</segtitle>
231
232 <seglistitem>
233 <seg>
234 None
235 </seg>
236 <seg>
237 libgvfscommon.so,
238 libgvfsdaemon.so and
239 some under /usr/lib/gio/modules/
240 </seg>
241 <seg>
242 /usr/include/gvfs-client and
243 /usr/{lib,share}/gvfs
244 </seg>
245 </seglistitem>
246 </segmentedlist>
247
248 <variablelist>
249 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
250 <?dbfo list-presentation="list"?>
251 <?dbhtml list-presentation="table"?>
252
253 <varlistentry id="libgvfscommon">
254 <term><filename class="libraryfile">libgvfscommon.so</filename></term>
255 <listitem>
256 <para>
257 contains the common API functions used in
258 <application>Gvfs</application> programs
259 </para>
260 <indexterm zone="gvfs libgvfscommon">
261 <primary sortas="c-libgvfscommon">libgvfscommon.so</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 </variablelist>
267
268 </sect2>
269
270</sect1>
Note: See TracBrowser for help on using the repository browser.