source: gnome/platform/gvfs.xml@ 9287960

10.0 10.1 11.0 11.1 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 9287960 was 9287960, checked in by Pierre Labastie <pieere@…>, 4 years ago

Fix dependencies and meson switches for gvfs

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

  • Property mode set to 100644
File size: 16.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 gvfs-download-http "&gnome-download-http;/gvfs/1.36/gvfs-&gvfs-version;.tar.xz">
8 <!ENTITY gvfs-download-ftp "&gnome-download-ftp;/gvfs/1.36/gvfs-&gvfs-version;.tar.xz">
9 <!ENTITY gvfs-md5sum "216d461c5e96e2cea74253be407af6dc">
10 <!ENTITY gvfs-size "1.2 MB">
11 <!ENTITY gvfs-buildsize "40 MB">
12 <!ENTITY gvfs-time "0.1 SBU (Using parallelism=4)">
13]>
14
15<sect1 id="gvfs" xreflabel="Gvfs-&gvfs-version;">
16 <?dbhtml filename="gvfs.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Gvfs-&gvfs-version;</title>
24
25 <indexterm zone="gvfs">
26 <primary sortas="a-Gvfs">Gvfs</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Gvfs</title>
31
32 <para>
33 The <application>Gvfs</application> package is a userspace virtual
34 filesystem designed to work with the I/O abstractions of GLib's GIO
35 library.
36 </para>
37
38 &lfs82_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&gvfs-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&gvfs-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &gvfs-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &gvfs-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &gvfs-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &gvfs-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Gvfs Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="dbus"/> and
79 <xref linkend="glib2"/>
80 </para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended" revision="sysv">
84 <xref linkend="gcr"/>,
85 <xref linkend="gtk3"/>,
86 <xref linkend="libcdio"/>,
87 <xref linkend="libgudev"/>,
88 <xref linkend="libsecret"/>,
89 <xref linkend="libsoup"/>, and
90 <xref linkend="udisks2"/>
91 </para>
92 <para role="recommended" revision="systemd">
93 <xref linkend="gcr"/>,
94 <xref linkend="gtk3"/>,
95 <xref linkend="libcdio"/>,
96 <xref linkend="libgdata"/>,
97 <xref linkend="libgudev"/>,
98 <xref linkend="libsecret"/>,
99 <xref linkend="libsoup"/>,
100 <xref linkend="systemd"/>, and
101 <xref linkend="udisks2"/>
102 </para>
103
104 <bridgehead renderas="sect4">Optional</bridgehead>
105 <para role="optional" revision="sysv">
106 <xref linkend="apache"/>,
107 <xref linkend="avahi"/>,
108 <xref linkend="bluez"/>,
109 <xref linkend="dbus-glib"/>,
110 <xref linkend="fuse2"/>,
111 <xref linkend="gtk-doc"/>,
112 <xref linkend="libarchive"/>,
113 <xref linkend="libgcrypt"/>,
114 <xref linkend="libxml2"/>,
115 <xref linkend="libxslt"/>,
116 <xref linkend="openssh"/>,
117 <xref linkend="samba"/>,
118 <ulink url="&gnome-download-http;/gnome-online-accounts">GNOME Online Accounts</ulink>,
119 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
120 <ulink url="http://www.gphoto.org/">libgphoto2</ulink>,
121 <ulink url="http://www.libimobiledevice.org/">libimobiledevice</ulink>,
122 <ulink url="http://sourceforge.net/projects/libmtp/">libmtp</ulink>,
123 <ulink url="https://github.com/sahlberg/libnfs/">libnfs</ulink>, and
124 <ulink url="http://twistedmatrix.com/trac/">Twisted</ulink>,
125 </para>
126
127 <para role="optional" revision="systemd">
128 <xref linkend="apache"/>,
129 <xref linkend="avahi"/>,
130 <xref linkend="bluez"/>,
131 <xref linkend="dbus-glib"/>,
132 <xref linkend="fuse2"/>,
133 <xref linkend="gnome-online-accounts"/>,
134 <xref linkend="gtk-doc"/>,
135 <xref linkend="libarchive"/>,
136 <xref linkend="libgcrypt"/>,
137 <xref linkend="libxml2"/>,
138 <xref linkend="libxslt"/>,
139 <xref linkend="openssh"/>,
140 <xref linkend="samba"/>,
141 <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
142 <ulink url="http://www.gphoto.org/">libgphoto2</ulink>,
143 <ulink url="http://www.libimobiledevice.org/">libimobiledevice</ulink>,
144 <ulink url="http://libmtp.sourceforge.net/">libmtp</ulink>,
145 <ulink url="https://github.com/sahlberg/libnfs/">libnfs</ulink>, and
146 <ulink url="http://twistedmatrix.com/trac/">Twisted</ulink>
147 </para>
148<!--
149 <bridgehead renderas="sect4">Optional (Runtime)</bridgehead>
150 <para role="optional">
151 <xref role="runtime" linkend="obex-data-server"/>
152 </para>
153-->
154 <para condition="html" role="usernotes">User Notes:
155 <ulink url="&blfs-wiki;/gvfs"/>
156 </para>
157 </sect2>
158
159 <sect2 role="installation">
160 <title>Installation of Gvfs</title>
161
162 <para>
163 Install <application>Gvfs</application> by running the following
164 commands:
165 </para>
166
167<screen revision='sysv'><userinput>mkdir build &amp;&amp;
168cd build &amp;&amp;
169
170meson --prefix=/usr \
171 --sysconfdir=/etc \
172 -Dfuse=false \
173 -Dgphoto2=false \
174 -Dafc=false \
175 -Dbluray=false \
176 -Dnfs=false \
177 -Dmtp=false \
178 -Dsmb=false \
179 -Dtmpfilesdir=no \
180 -Dlogind=false \
181 -Ddnssd=false \
182 -Dgoa=false \
183 -Dgoogle=false \
184 -Dsystemduserunitdir=no &amp;&amp;
185ninja</userinput></screen>
186
187<screen revision='systemd'><userinput>mkdir build &amp;&amp;
188cd build &amp;&amp;
189
190meson --prefix=/usr \
191 --sysconfdir=/etc \
192 -Dfuse=false \
193 -Dgphoto2=false \
194 -Dafc=false \
195 -Dbluray=false \
196 -Dnfs=false \
197 -Dmtp=false \
198 -Dsmb=false \
199 -Ddnssd=false \
200 -Dgoa=false \
201 -Dgoogle=false &amp;&amp;
202ninja</userinput></screen>
203
204 <para>
205 This package does not come with at test suite.
206 </para>
207
208 <para>
209 Now, as the <systemitem class="username">root</systemitem> user:
210 </para>
211
212<screen role="root"><userinput>ninja install</userinput></screen>
213
214 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
215 href="../../xincludes/gsettings-destdir.xml"/>
216 </sect2>
217
218 <sect2 role="commands">
219 <title>Command Explanations</title>
220
221 <para>
222 <parameter>-D&lt;option&gt;=false</parameter>: These switches are
223 required if the corresponding optional dependency is not installed.
224 Remove those where you have installed the corresponding application and
225 wish to use it with <application>Gvfs</application>. The dnssd option
226 requires avahi and both goa/google require GNOME Online Accounts.
227 </para>
228
229 <para revision="sysv">
230 <parameter>-Dtmpfilesdir=no -Dsystemduserunitdir=no</parameter>: These
231 switches provide systemd directory locations. Setting them to
232 <quote>no</quote> disables the dependency on systemd and logind.
233 </para>
234
235 <para>
236 <option>-Dcdda=false</option>: This switch is required if libcdio is not
237 installed. The cdda backend is useless on machines without a CDROM/DVD
238 drive.
239 </para>
240
241 </sect2>
242
243 <sect2 role="content">
244 <title>Contents</title>
245
246 <segmentedlist>
247 <segtitle>Installed Programs</segtitle>
248 <segtitle>Installed Library</segtitle>
249 <segtitle>Installed Directories</segtitle>
250
251 <seglistitem>
252 <seg>
253 gvfs-cat, gvfs-copy, gvfs-info, gvfs-less, gvfs-ls, gvfs-mime,
254 gvfs-mkdir, gvfs-monitor-dir, gvfs-monitor-file, gvfs-mount,
255 gvfs-move, gvfs-open, gvfs-rename, gvfs-rm, gvfs-save,
256 gvfs-set-attribute, gvfs-trash, and gvfs-tree
257 </seg>
258 <seg>
259 libgvfscommon.so,
260 libgvfsdaemon.so and
261 some under /usr/lib/gio/modules/
262 </seg>
263 <seg>
264 /usr/include/gvfs-client and
265 /usr/{lib,share}/gvfs
266 </seg>
267 </seglistitem>
268 </segmentedlist>
269
270 <variablelist>
271 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
272 <?dbfo list-presentation="list"?>
273 <?dbhtml list-presentation="table"?>
274
275 <varlistentry id="gvfs-cat">
276 <term><command>gvfs-cat</command></term>
277 <listitem>
278 <para>
279 concatenates the given files and prints them
280 to the standard output.
281 </para>
282 <indexterm zone="gvfs gvfs-cat">
283 <primary sortas="b-gvfs-cat">gvfs-cat</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 <varlistentry id="gvfs-copy">
289 <term><command>gvfs-copy</command></term>
290 <listitem>
291 <para>
292 copies a file from one URI location to another.
293 </para>
294 <indexterm zone="gvfs gvfs-copy">
295 <primary sortas="b-gvfs-copy">gvfs-copy</primary>
296 </indexterm>
297 </listitem>
298 </varlistentry>
299
300 <varlistentry id="gvfs-info">
301 <term><command>gvfs-info</command></term>
302 <listitem>
303 <para>
304 shows information about the given locations.
305 </para>
306 <indexterm zone="gvfs gvfs-info">
307 <primary sortas="b-gvfs-info">gvfs-info</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="gvfs-less">
313 <term><command>gvfs-less</command></term>
314 <listitem>
315 <para>
316 executes <command>less</command> using the VFS as the
317 input preprocesor, so less can access any resource accessible
318 by any of the <application>Gvfs</application> backends.
319 </para>
320 <indexterm zone="gvfs gvfs-less">
321 <primary sortas="b-gvfs-less">gvfs-less</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="gvfs-ls">
327 <term><command>gvfs-ls</command></term>
328 <listitem>
329 <para>
330 lists information about the given locations.
331 </para>
332 <indexterm zone="gvfs gvfs-ls">
333 <primary sortas="b-gvfs-ls">gvfs-ls</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 <varlistentry id="gvfs-mime">
339 <term><command>gvfs-mime</command></term>
340 <listitem>
341 <para>
342 is used to query information about applications that are
343 registered to handle a mime-type, or set the default
344 handler for a mime-type.
345 </para>
346 <indexterm zone="gvfs gvfs-mime">
347 <primary sortas="b-gvfs-mime">gvfs-mime</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="gvfs-mkdir">
353 <term><command>gvfs-mkdir</command></term>
354 <listitem>
355 <para>
356 creates a directory specified by an URI.
357 </para>
358 <indexterm zone="gvfs gvfs-mkdir">
359 <primary sortas="b-gvfs-mkdir">gvfs-mkdir</primary>
360 </indexterm>
361 </listitem>
362 </varlistentry>
363
364 <varlistentry id="gvfs-monitor-dir">
365 <term><command>gvfs-monitor-dir</command></term>
366 <listitem>
367 <para>
368 prints information about file creation, deletion, file content and
369 attribute changes and mount and unmount operations inside the
370 specified directories.
371 </para>
372 <indexterm zone="gvfs gvfs-monitor-dir">
373 <primary sortas="b-gvfs-monitor-dir">gvfs-monitor-dir</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377
378 <varlistentry id="gvfs-monitor-file">
379 <term><command>gvfs-monitor-file</command></term>
380 <listitem>
381 <para>
382 prints information about creation, deletion, content and attribute
383 changes and mount and unmount operations affecting the monitored files.
384 </para>
385 <indexterm zone="gvfs gvfs-monitor-file">
386 <primary sortas="b-gvfs-monitor-file">gvfs-monitor-file</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="gvfs-mount">
392 <term><command>gvfs-mount</command></term>
393 <listitem>
394 <para>
395 provides commandline access to various aspects of GIOs mounting
396 functionality.
397 </para>
398 <indexterm zone="gvfs gvfs-mount">
399 <primary sortas="b-gvfs-mount">gvfs-mount</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403
404 <varlistentry id="gvfs-move">
405 <term><command>gvfs-move</command></term>
406 <listitem>
407 <para>
408 moves a file from one URI location to another.
409 </para>
410 <indexterm zone="gvfs gvfs-move">
411 <primary sortas="b-gvfs-move">gvfs-move</primary>
412 </indexterm>
413 </listitem>
414 </varlistentry>
415
416 <varlistentry id="gvfs-open">
417 <term><command>gvfs-open</command></term>
418 <listitem>
419 <para>
420 opens files with the default application that is registered
421 to handle files of that type.
422 </para>
423 <indexterm zone="gvfs gvfs-open">
424 <primary sortas="b-gvfs-open">gvfs-open</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="gvfs-rename">
430 <term><command>gvfs-rename</command></term>
431 <listitem>
432 <para>
433 changes the name of a file or directory.
434 </para>
435 <indexterm zone="gvfs gvfs-rename">
436 <primary sortas="b-gvfs-rename">gvfs-rename</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="gvfs-rm">
442 <term><command>gvfs-rm</command></term>
443 <listitem>
444 <para>
445 removes a file.
446 </para>
447 <indexterm zone="gvfs gvfs-rm">
448 <primary sortas="b-gvfs-rm">gvfs-rm</primary>
449 </indexterm>
450 </listitem>
451 </varlistentry>
452
453 <varlistentry id="gvfs-save">
454 <term><command>gvfs-save</command></term>
455 <listitem>
456 <para>
457 reads from the standard input and saves the data to
458 the given location.
459 </para>
460 <indexterm zone="gvfs gvfs-save">
461 <primary sortas="b-gvfs-save">gvfs-save</primary>
462 </indexterm>
463 </listitem>
464 </varlistentry>
465
466 <varlistentry id="gvfs-set-attribute">
467 <term><command>gvfs-set-attribute</command></term>
468 <listitem>
469 <para>
470 sets attributes on files.
471 </para>
472 <indexterm zone="gvfs gvfs-set-attribute">
473 <primary sortas="b-gvfs-set-attribute">gvfs-set-attribute</primary>
474 </indexterm>
475 </listitem>
476 </varlistentry>
477
478 <varlistentry id="gvfs-trash">
479 <term><command>gvfs-trash</command></term>
480 <listitem>
481 <para>
482 sends files or directories to the "Trashcan".
483 </para>
484 <indexterm zone="gvfs gvfs-trash">
485 <primary sortas="b-gvfs-trash">gvfs-trash</primary>
486 </indexterm>
487 </listitem>
488 </varlistentry>
489
490 <varlistentry id="gvfs-tree">
491 <term><command>gvfs-tree</command></term>
492 <listitem>
493 <para>
494 lists the contents of the given directories recursively,
495 in a tree-like format.
496 </para>
497 <indexterm zone="gvfs gvfs-tree">
498 <primary sortas="b-gvfs-tree">gvfs-tree</primary>
499 </indexterm>
500 </listitem>
501 </varlistentry>
502
503 <varlistentry id="libgvfscommon">
504 <term><filename class="libraryfile">libgvfscommon.so</filename></term>
505 <listitem>
506 <para>
507 contains the common API functions used in
508 <application>Gvfs</application> programs.
509 </para>
510 <indexterm zone="gvfs libgvfscommon">
511 <primary sortas="c-libgvfscommon">libgvfscommon.so</primary>
512 </indexterm>
513 </listitem>
514 </varlistentry>
515
516 </variablelist>
517
518 </sect2>
519
520</sect1>
Note: See TracBrowser for help on using the repository browser.