source: networking/netlibs/glib-networking.xml@ 35400a4

elogind
Last change on this file since 35400a4 was 35400a4, checked in by DJ Lucas <dj@…>, 2 years ago

Merge to HEAD 21680.

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

  • Property mode set to 100644
File size: 6.9 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 glib-networking-download-http
8 "&gnome-download-http;/glib-networking/2.60/glib-networking-&glib-networking-version;.tar.xz">
9 <!ENTITY glib-networking-download-ftp
10 "&gnome-download-ftp;/glib-networking/2.60/glib-networking-&glib-networking-version;.tar.xz">
11 <!ENTITY glib-networking-md5sum "e8fd0462a82269fb4bbd6c07a1e7d0f4">
12 <!ENTITY glib-networking-size "184 KB">
13 <!ENTITY glib-networking-buildsize "5.7 MB (with tests)">
14 <!ENTITY glib-networking-time "0.1 SBU (with tests)">
15]>
16
17<sect1 id="glib-networking" xreflabel="glib-networking-&glib-networking-version;">
18 <?dbhtml filename="glib-networking.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>glib-networking-&glib-networking-version;</title>
26
27 <indexterm zone="glib-networking">
28 <primary sortas="a-glib-networking">glib-networking</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to GLib Networking</title>
33
34 <para>
35 The <application>GLib Networking</application> package contains
36 Network related gio modules for <application>GLib</application>.
37 </para>
38
39 &lfs84_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&glib-networking-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&glib-networking-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &glib-networking-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &glib-networking-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &glib-networking-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &glib-networking-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74<!--
75 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/glib-networking-&glib-networking-version;-upstream_fixes-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84-->
85 <bridgehead renderas="sect3">GLib Networking Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89 <xref linkend="glib2"/>,
90 <xref linkend="gnutls"/>, and
91 <xref linkend="gsettings-desktop-schemas"/>
92 </para>
93
94 <bridgehead renderas="sect4">Recommended</bridgehead>
95 <para role="recommended">
96 <xref linkend="make-ca"/>
97 <!-- p11-kit option no longer exists, and is pulled in by GnuTLS anyway -->
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>
103 </para>
104
105 <para condition="html" role="usernotes">User Notes:
106 <ulink url="&blfs-wiki;/glib-networking"/>
107 </para>
108 </sect2>
109
110 <sect2 role="installation">
111 <title>Installation of GLib Networking</title>
112
113 <!-- 2.60.0 of glib-networking introduced an experimental OpenSSL backend.
114 Since it is not tested well upstream yet, and it is recommended by upstream
115 to use the GnuTLS backend on Linux, we will continue using the GnuTLS
116 backend and not mention the OpenSSL backend to prevent confusion. -->
117 <!--
118 <para>
119 First, apply a patch to fix a problem introduced by API changes in GnuTLS:
120 </para>
121
122<screen><userinput remap="pre">patch -Np1 -i ../glib-networking-&glib-networking-version;-upstream_fixes-1.patch</userinput></screen>
123-->
124
125 <para>
126 Install <application>GLib Networking</application> by running the following
127 commands:
128 </para>
129
130<screen><userinput>mkdir build &amp;&amp;
131cd build &amp;&amp;
132
133meson --prefix=/usr \
134 -Dlibproxy=disabled .. &amp;&amp;
135ninja</userinput></screen>
136
137 <para>
138 To test the results, issue: <command>ninja test</command>.
139 </para>
140
141 <!-- glib-networking/#70 -->
142 <!-- The patch fixes this problem, and the connection-gnutls failure was
143 indicative of a complete failure of the GnuTLS backend to use certificates.
144 This broke WebKit and libsoup, and has since been patched. -->
145 <!--
146 <para>
147 The test <emphasis>connection-gnutls</emphasis> is known to fail.
148 </para>
149 -->
150
151 <para>
152 Now, as the <systemitem class="username">root</systemitem> user:
153 </para>
154
155<screen role="root"><userinput>ninja install</userinput></screen>
156
157 </sect2>
158<!--
159 <sect2 role="commands">
160 <title>Command Explanations</title>
161
162 <para>
163 <parameter>- -without-ca-certificates</parameter>: This parameter forces
164 use of PKCS #11 modules for TLS certificate validation instead of a
165 bundle of certificates.
166 </para>
167
168 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
169 href="../../xincludes/static-libraries.xml"/>
170
171 </sect2>
172 -->
173 <!-- This isn't needed anymore and breaks applications which use it.
174 <sect2 role="configuration">
175 <title>Configuring Glib-networking</title>
176 <!- - This breaks the libsoup tests - ->
177
178 <sect3 id="glib-networking-config">
179 <title>Config Files</title>
180 <para>
181 <filename>/etc/profile.d/gio.sh</filename>
182 </para>
183
184 <indexterm zone="glib-networking glib-networking-config">
185 <primary
186 sortas="e-etc-profile.d-gio.sh">/etc/profile.d/gio.sh</primary>
187 </indexterm>
188 </sect3>
189
190 <sect3><title>Configuration Information</title>
191
192 <para>
193 For using the PKCS #11 modules, the <envar>GIO_USE_TLS</envar> variable
194 should be set in the environment. This can be added to the Bash Startup
195 Files (as the <systemitem class="username">root</systemitem> user):
196 </para>
197
198<screen role="root"><userinput>cat &gt; /etc/profile.d/gio.sh &lt;&lt; "EOF"
199<literal># Begin gio.sh
200
201export GIO_USE_TLS=gnutls-pkcs11
202
203# End gio.sh</literal>
204EOF</userinput></screen>
205 </sect3>
206 </sect2>
207-->
208 <sect2 role="content">
209 <title>Contents</title>
210
211 <segmentedlist>
212 <segtitle>Installed Program</segtitle>
213 <segtitle>Installed Libraries</segtitle>
214 <segtitle>Installed Directories</segtitle>
215
216 <seglistitem>
217 <seg>
218 None
219 </seg>
220 <seg>
221 libgiognomeproxy.so and libgiognutls.so (GIO Modules installed in
222 <filename class="directory">/usr/lib/gio/modules</filename>)
223 </seg>
224 <seg>
225 None
226 </seg>
227 </seglistitem>
228 </segmentedlist>
229
230 </sect2>
231
232</sect1>
Note: See TracBrowser for help on using the repository browser.