glfs/networking/netlibs/glib-networking.xml

<?xml version="1.0" encoding="UTF-8"?>
<!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 glib-networking-download-http
    "&gnome-download-http;/glib-networking/&glib-networking-minor;/glib-networking-&glib-networking-version;.tar.xz">
  <!ENTITY glib-networking-download-ftp  " ">
  <!ENTITY glib-networking-md5sum        "402ff1e8f24dafb02354d9b66ffa11df">
  <!ENTITY glib-networking-size          "280 KB">
  <!ENTITY glib-networking-buildsize     "7.0 MB (with tests)">
  <!ENTITY glib-networking-time          "0.1 SBU (with tests)">
]>

<sect1 id="glib-networking" xreflabel="glib-networking-&glib-networking-version;">
  <?dbhtml filename="glib-networking.html"?>


  <title>glib-networking-&glib-networking-version;</title>

  <indexterm zone="glib-networking">
    <primary sortas="a-glib-networking">glib-networking</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to GLib Networking</title>

    <para>
      The <application>GLib Networking</application> package contains
      Network related gio modules for <application>GLib</application>.
    </para>

    &lfs121_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&glib-networking-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&glib-networking-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &glib-networking-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &glib-networking-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &glib-networking-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &glib-networking-time;
        </para>
      </listitem>
    </itemizedlist>
<!--
    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch:
          <ulink url="&patch-root;/glib-networking-&glib-networking-version;-upstream_fixes-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>
-->
    <bridgehead renderas="sect3">GLib Networking Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="glib2"/> and
      <xref linkend="gnutls"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="gsettings-desktop-schemas"/> (for the applications
      using this package to use proxy server settings in GNOME) and
      <xref linkend="make-ca"/>
      <!-- p11-kit option no longer exists, and is pulled in by GnuTLS anyway -->
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>
    </para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of GLib Networking</title>

    <!-- 2.60.0 of glib-networking introduced an experimental OpenSSL backend.
    Since it is not tested well upstream yet, and it is recommended by upstream
    to use the GnuTLS backend on Linux, we will continue using the GnuTLS
    backend and not mention the OpenSSL backend to prevent confusion. -->

    <para>
      Install <application>GLib Networking</application> by running the following
      commands:
    </para>

<screen><userinput>mkdir build &amp;&amp;
cd    build &amp;&amp;

meson setup            \
   --prefix=/usr       \
   --buildtype=release \
   -Dlibproxy=disabled \
   .. &amp;&amp;
ninja</userinput></screen>

    <para>
      To test the results, issue: <command>ninja test</command>.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>ninja install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/meson-buildtype-release.xml"/>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          None
        </seg>
        <seg>
          libgiognomeproxy.so
          and libgiognutls.so (GIO Modules installed in
          <filename class="directory">/usr/lib/gio/modules</filename>)
        </seg>
        <seg>
          None
        </seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>