glfs/gnome/platform/gvfs.xml
Pierre Labastie e1e58be454 Remove all ftp urls
neither firefox nor epiphany can download them, and they are not
well maintained, because rarely tested.
This is WIP because the "(HTTP)" part of "Download (HTTP)" will
need to be removed too.
But let's see what users think first...
2023-10-15 21:43:08 +02:00

266 lines
7.8 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gvfs-download-http "&gnome-download-http;/gvfs/1.52/gvfs-&gvfs-version;.tar.xz">
<!ENTITY gvfs-download-ftp " ">
<!ENTITY gvfs-md5sum "dc2809b21d27b02ebe5bb9aa2b9f1c1e">
<!ENTITY gvfs-size "1.2 MB">
<!ENTITY gvfs-buildsize "25 MB">
<!ENTITY gvfs-time "0.2 SBU (using parallelism=4)">
]>
<sect1 id="gvfs" xreflabel="Gvfs-&gvfs-version;">
<?dbhtml filename="gvfs.html"?>
<title>Gvfs-&gvfs-version;</title>
<indexterm zone="gvfs">
<primary sortas="a-Gvfs">Gvfs</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Gvfs</title>
<para>
The <application>Gvfs</application> package is a userspace virtual
filesystem designed to work with the I/O abstractions of GLib's GIO
library.
</para>
&lfs120_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&gvfs-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&gvfs-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &gvfs-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &gvfs-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &gvfs-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &gvfs-time;
</para>
</listitem>
</itemizedlist>
<!--
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Required patch:
<ulink url="&patch-root;/gvfs-&gvfs-version;-fix_security_vulnerabilities-1.patch"/>
</para>
</listitem>
</itemizedlist>
-->
<bridgehead renderas="sect3">Gvfs Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="dbus"/>,
<xref linkend="glib2"/>,
<xref linkend="libusb"/>, and
<xref linkend="libsecret"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="gcr"/>,
<xref linkend="gtk3"/>,
<xref linkend="libcdio"/>,
<xref linkend="libgudev"/>,
<xref linkend="libsoup3"/>,
<phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
<phrase revision="systemd"><xref role='runtime' linkend="systemd"/>
(runtime),</phrase> and
<xref linkend="udisks2"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="apache"/>,
<xref linkend="avahi"/>,
<xref linkend="bluez"/>,
<xref linkend="fuse3"/>,
<xref linkend="gnome-online-accounts"/>,
<xref linkend="gtk-doc"/>,
<xref linkend="libarchive"/>,
<xref linkend="libgcrypt"/>,
<xref linkend="libgdata"/>,
<xref linkend="libxml2"/>,
<xref linkend="libxslt"/>,
<xref linkend="openssh"/>,
<xref linkend="samba"/>,
<ulink url="&gnome-download-http;/gnome-desktop-testing/">gnome-desktop-testing</ulink> (for tests),
<ulink url="https://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
<ulink url="http://www.gphoto.org/">libgphoto2</ulink>,
<ulink url="https://www.libimobiledevice.org/">libimobiledevice</ulink>,
<ulink url="https://libmtp.sourceforge.net/">libmtp</ulink>,
<ulink url="https://github.com/sahlberg/libnfs/">libnfs</ulink>, and
<ulink url="https://twisted.org/">Twisted</ulink>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of Gvfs</title>
<para>
Install <application>Gvfs</application> by running the following
commands:
</para>
<screen revision='sysv'><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup \
--prefix=/usr \
--buildtype=release \
-Dfuse=false \
-Dgphoto2=false \
-Dafc=false \
-Dbluray=false \
-Dnfs=false \
-Dmtp=false \
-Dsmb=false \
-Dtmpfilesdir=no \
-Ddnssd=false \
-Dgoa=false \
-Dgoogle=false \
-Dsystemduserunitdir=no .. &amp;&amp;
ninja</userinput></screen>
<screen revision='systemd'><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup \
--prefix=/usr \
--buildtype=release \
-Dfuse=false \
-Dgphoto2=false \
-Dafc=false \
-Dbluray=false \
-Dnfs=false \
-Dmtp=false \
-Dsmb=false \
-Ddnssd=false \
-Dgoa=false \
-Dgoogle=false .. &amp;&amp;
ninja</userinput></screen>
<para>
The test suite requires <application>gnome-desktop-testing</application>,
which is beyond the scope of BLFS.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gsettings-destdir.xml"/>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/meson-buildtype-release.xml"/>
<para>
<parameter>-D&lt;option&gt;=false</parameter>: These switches are
required if the corresponding dependency is not installed.
Remove those where you have installed the corresponding application and
wish to use it with <application>Gvfs</application>. The dnssd option
requires avahi and both goa and google require GNOME Online Accounts.
The google option also requires libgdata.
</para>
<para revision="sysv">
<parameter>-Dtmpfilesdir=no -Dsystemduserunitdir=no</parameter>: These
switches provide systemd directory locations. Setting them to
<quote>no</quote> disables the dependency on systemd and logind.
</para>
<para>
<option>-Dcdda=false</option>: This switch is required if libcdio is not
installed. The cdda backend is useless on machines without a CDROM/DVD
drive.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
None
</seg>
<seg>
libgvfscommon.so,
libgvfsdaemon.so and
some under /usr/lib/gio/modules/
</seg>
<seg>
/usr/include/gvfs-client and
/usr/{lib,share}/gvfs
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libgvfscommon">
<term><filename class="libraryfile">libgvfscommon.so</filename></term>
<listitem>
<para>
contains the common API functions used in
<application>Gvfs</application> programs
</para>
<indexterm zone="gvfs libgvfscommon">
<primary sortas="c-libgvfscommon">libgvfscommon.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>