source: networking/netlibs/glib-networking.xml@ adf17153

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 adf17153 was adf17153, checked in by Xi Ruoyao <xry111@…>, 18 months ago

more --buildtype=release addition

  • Property mode set to 100644
File size: 6.7 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"/>,
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 --buildtype=release \
135 -Dlibproxy=disabled .. &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.