source: gnome/platform/gvfs.xml@ 1486180

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.4 9.0 9.1 bdubbs/svn kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 1486180 was 1b92dc5, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Add libusb as a required dep for gvfs. Thanks Roger

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

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