source: networking/netlibs/glib-networking.xml@ 2c09991

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 2c09991 was 2c09991, checked in by Xi Ruoyao <xry111@…>, 16 months ago

glib-networking: demote gsettings-desktop-schemas to recommended

and remove -Dlibproxy=disabled (now auto detected)

  • Property mode set to 100644
File size: 6.8 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.68/glib-networking-&glib-networking-version;.tar.xz">
9 <!ENTITY glib-networking-download-ftp " ">
10<!-- <!ENTITY glib-networking-download-ftp
11 "&gnome-download-ftp;/glib-networking/2.66/glib-networking-&glib-networking-version;.tar.xz"> -->
12 <!ENTITY glib-networking-md5sum "182ae3263763160a2cf0bd4f854448c3">
13 <!ENTITY glib-networking-size "236 KB">
14 <!ENTITY glib-networking-buildsize "5.1 MB (with tests)">
15 <!ENTITY glib-networking-time "less than 0.1 SBU (with tests)">
16]>
17
18<sect1 id="glib-networking" xreflabel="glib-networking-&glib-networking-version;">
19 <?dbhtml filename="glib-networking.html"?>
20
21 <sect1info>
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 &lfs101_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"/> and
90 <xref linkend="gnutls"/>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <xref linkend="gsettings-desktop-schemas"/> (for the applications
96 using this package to use proxy server setting in GNOME) and
97 <xref linkend="make-ca"/>
98 <!-- p11-kit option no longer exists, and is pulled in by GnuTLS anyway -->
99 </para>
100
101 <bridgehead renderas="sect4">Optional</bridgehead>
102 <para role="optional">
103 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>
104 </para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/glib-networking"/>
108 </para>
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of GLib Networking</title>
113
114 <!-- 2.60.0 of glib-networking introduced an experimental OpenSSL backend.
115 Since it is not tested well upstream yet, and it is recommended by upstream
116 to use the GnuTLS backend on Linux, we will continue using the GnuTLS
117 backend and not mention the OpenSSL backend to prevent confusion. -->
118 <!--
119 <para>
120 First, apply a patch to fix a problem introduced by API changes in GnuTLS:
121 </para>
122
123<screen><userinput remap="pre">patch -Np1 -i ../glib-networking-&glib-networking-version;-upstream_fixes-1.patch</userinput></screen>
124-->
125
126 <para>
127 Install <application>GLib Networking</application> by running the following
128 commands:
129 </para>
130
131<screen><userinput>mkdir build &amp;&amp;
132cd build &amp;&amp;
133
134meson --prefix=/usr \
135 --buildtype=release &amp;&amp;
136ninja</userinput></screen>
137
138 <para>
139 To test the results, issue: <command>ninja test</command>.
140 </para>
141
142 <!-- glib-networking/#70 -->
143 <!-- The patch fixes this problem, and the connection-gnutls failure was
144 indicative of a complete failure of the GnuTLS backend to use certificates.
145 This broke WebKit and libsoup, and has since been patched. -->
146 <!--
147 <para>
148 The test <emphasis>connection-gnutls</emphasis> is known to fail.
149 </para>
150 -->
151
152 <para>
153 Now, as the <systemitem class="username">root</systemitem> user:
154 </para>
155
156<screen role="root"><userinput>ninja install</userinput></screen>
157
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
164 href="../../xincludes/meson-buildtype-release.xml"/>
165
166 </sect2>
167
168 <!-- This isn't needed anymore and breaks applications which use it.
169 <sect2 role="configuration">
170 <title>Configuring Glib-networking</title>
171 <!- - This breaks the libsoup tests - ->
172
173 <sect3 id="glib-networking-config">
174 <title>Config Files</title>
175 <para>
176 <filename>/etc/profile.d/gio.sh</filename>
177 </para>
178
179 <indexterm zone="glib-networking glib-networking-config">
180 <primary
181 sortas="e-etc-profile.d-gio.sh">/etc/profile.d/gio.sh</primary>
182 </indexterm>
183 </sect3>
184
185 <sect3><title>Configuration Information</title>
186
187 <para>
188 For using the PKCS #11 modules, the <envar>GIO_USE_TLS</envar> variable
189 should be set in the environment. This can be added to the Bash Startup
190 Files (as the <systemitem class="username">root</systemitem> user):
191 </para>
192
193<screen role="root"><userinput>cat &gt; /etc/profile.d/gio.sh &lt;&lt; "EOF"
194<literal># Begin gio.sh
195
196export GIO_USE_TLS=gnutls-pkcs11
197
198# End gio.sh</literal>
199EOF</userinput></screen>
200 </sect3>
201 </sect2>
202-->
203 <sect2 role="content">
204 <title>Contents</title>
205
206 <segmentedlist>
207 <segtitle>Installed Program</segtitle>
208 <segtitle>Installed Libraries</segtitle>
209 <segtitle>Installed Directories</segtitle>
210
211 <seglistitem>
212 <seg>
213 None
214 </seg>
215 <seg>
216 libgiognomeproxy.so and libgiognutls.so (GIO Modules installed in
217 <filename class="directory">/usr/lib/gio/modules</filename>)
218 </seg>
219 <seg>
220 None
221 </seg>
222 </seglistitem>
223 </segmentedlist>
224
225 </sect2>
226
227</sect1>
Note: See TracBrowser for help on using the repository browser.