source: networking/netlibs/curl.xml@ 85d14e15

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 85d14e15 was 85d14e15, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update to curl-7.60.0.
Update to x265-2.8.
Update to glib-networking-2.56.1.
Update to cryptsetup-2.0.3.

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

  • Property mode set to 100644
File size: 11.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 curl-download-http "https://curl.haxx.se/download/curl-&curl-version;.tar.xz">
8 <!ENTITY curl-download-ftp " ">
9 <!ENTITY curl-md5sum "a889cd11b4ae8794b7030472cb4df0a0">
10 <!ENTITY curl-size "2.2 MB">
11 <!ENTITY curl-buildsize "38 MB (add 13 MB for tests)">
12 <!ENTITY curl-time "0.4 SBU (add 13 SBU for tests)">
13]>
14
15<sect1 id="curl" xreflabel="cURL-&curl-version;">
16 <?dbhtml filename="curl.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>cURL-&curl-version;</title>
24
25 <indexterm zone="curl">
26 <primary sortas="a-cURL">cURL</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to cURL</title>
31
32 <para>
33 The <application>cURL</application> package contains an utility
34 and a library used for transferring files with URL syntax to any of
35 the following protocols: FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP,
36 TELNET, DICT, LDAP, LDAPS and FILE. Its ability to both download
37 and upload files can be incorporated into other programs to support
38 functions like streaming media.
39 </para>
40
41 &lfs82_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&curl-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&curl-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &curl-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &curl-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &curl-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &curl-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77<!-- Tests seem to pass without any patch
78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>
82 Required patch:
83 <ulink url="&patch-root;/curl-&curl-version;-valgrind_filter-1.patch"/>
84 </para>
85 </listitem>
86 </itemizedlist>
87-->
88 <bridgehead renderas="sect3">cURL Dependencies</bridgehead>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref role="runtime" linkend="make-ca"/> (runtime)
93 </para>
94
95 <bridgehead renderas="sect4">Optional</bridgehead>
96 <para role="optional">
97 <xref linkend="c-ares"/>,
98 <xref linkend="gnutls"/>,
99 <xref linkend="libidn2"/>,
100 <xref linkend="mitkrb"/>,
101 <xref linkend="nghttp2"/>,
102 <xref linkend="openldap"/>,
103 <xref linkend="samba"/>,
104 <ulink url="https://launchpad.net/libmetalink/">libmetalink</ulink>,
105 <ulink url="https://github.com/rockdaboot/libpsl">libpsl</ulink>,
106 <ulink url="http://rtmpdump.mplayerhq.hu/">librtmp</ulink>,
107 <ulink url="http://www.libssh2.org">libssh2</ulink>,
108 <ulink url="https://tls.mbed.org/">mbed TLS</ulink> (formerly known as
109 PolarSSL), and
110 <ulink url="http://spnego.sourceforge.net/">SPNEGO</ulink>
111 </para>
112
113 <bridgehead renderas="sect4">Optional if Running the Test Suite</bridgehead>
114 <para role="optional">
115 <!-- stunnel is still listed in the docs as required, but 7.58.0
116 tests completed happily without it, although the test for unit1323
117 reported that the tool set in the test case does not exist - ken -->
118 <xref linkend="stunnel"/> (for the HTTPS and FTPS tests) and
119 <xref linkend="valgrind"/> (this will slow the tests down)
120 </para>
121
122 <para condition="html" role="usernotes">User Notes:
123 <ulink url="&blfs-wiki;/curl"/>
124 </para>
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of cURL</title>
129
130 <para>
131 Install <application>cURL</application> by running the following
132 commands:
133 </para>
134
135<screen><userinput>./configure --prefix=/usr \
136 --disable-static \
137 --enable-threaded-resolver \
138 --with-ca-path=/etc/ssl/certs &amp;&amp;
139make</userinput></screen>
140
141<!--
142 For version 7.54.1 I got:
143 TESTDONE: 869 tests out of 869 reported OK: 100%
144 TESTDONE: 1092 tests were considered during 1080 seconds
145
146 <para>
147 Running the test suite is optional. About 2% of the tests fail. Increase
148 in test time by each failed test is about 10%. Tests SBU above was
149 obtained disabling failing tests, with:
150 </para>
151
152 2017-10-29 - bdubbs
153 For version 7.56.1 I had a lot of test failures which included long
154 timeouts. Could not determine the cause of the timeouts or failures,
155 but I was missing c-ares, MIT Kerberos, ldap, samba, and the six
156 external packages.
157
158 2017-12-01 - bdubbs
159 Still a lot of test failures. I did have c-ares, Kerberos, and ldap
160 installed this time. Best guess is that servers are not available.
161-->
162 <note>
163 <para>
164 If running the tests for this package with valgrind, it will require a
165 version of /lib/ld-2.[MINORVERSION].so library
166 with debugging symbols present.
167 </para>
168
169 <para>Current versions of LFS do not strip /lib/ld-[MINORVERSION].so but
170 previous versions of LFS stripped these debugging symbols at the end of
171 Chapter 6. To get this library on older systems, glibc must be rebuilt
172 with the currently running
173 glibc version using the same compiler that was used to build LFS. The
174 ld-[MINORVERSION].so can then be renamed to ld-2.[MINORVERSION].so.dbg
175 and copied to /lib. Then a symlink needs to be changed:
176 </para>
177
178 <screen role="nodump"><userinput>ln -sfv ld-2.[MINORVERSION].so.dbg /lib/ld-linux-x86-64.so.2</userinput></screen>
179
180 <para>
181 Adjust the above instruction as needed for a 32-bit system
182 and to match your installed version of glibc.
183 </para>
184 </note>
185
186 <para>
187 To run the test suite, issue: <command>make test</command>. Two (of 857) tests
188 failsfor unknown reasons.<!--
189Added by Pierre for curl-7.59.0:
190no stunnel, no valgrind, no options
191Warning: smb server unexpectedly alive
192Warning: dict server unexpectedly alive
193TESTDONE: 950 tests out of 951 reported OK: 99%
194TESTFAIL: These test cases failed: 1148
195TESTDONE: 1189 tests were considered during 362 seconds.
196__________
197
198 if stunnel and valgrind are not installed, and also most options
199 (I had rtmpdump), the tests complete without problems.
200Warning: smb server unexpectedly alive
201Warning: dict server unexpectedly alive
202TESTDONE: 938 tests out of 938 reported OK: 100%
203TESTDONE: 1175 tests were considered during 355 seconds.
204 and no. I don't have smb - so commenting the rest of this:
205 To run the test suite, issue: <command>make test</command>. Many tests
206 may fail that depend on optional dependencies that may not be installed
207 or upstream servers that may not be available, especially for tests
208 numbered 700 and above.
209 Test time may be significantly increase due to hanging tests that fail. i
210__________
211Added by Bruce for curl-7.60.0:
212TESTDONE: 957 tests out of 959 reported OK: 99%
213TESTFAIL: These test cases failed: 1139 1140
214TESTDONE: 1196 tests were considered during 1184 seconds.
215From the logs, both appear to be ipv6 releated.
216-->
217 </para>
218
219 <para>
220 Now, as the <systemitem class="username">root</systemitem>
221 user:
222 </para>
223
224<screen role="root"><userinput>make install &amp;&amp;
225
226rm -rf docs/examples/.deps &amp;&amp;
227
228find docs \( -name Makefile\* -o -name \*.1 -o -name \*.3 \) -exec rm {} \; &amp;&amp;
229
230install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
231cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
232
233 <para>
234 Simple tests to the new installed <command>curl</command>:
235 <command>curl --trace-ascii debugdump.txt http://www.example.com/</command>
236 and
237 <command>curl --trace-ascii d.txt --trace-time http://example.com/</command>.
238 Inspect the locally created trace files <filename>debugdump.txt</filename>
239 and <filename>d.txt</filename>, which contain version downloaded
240 files information, etc. One file has the time for each action logged.
241 </para>
242 </sect2>
243
244 <sect2 role="commands">
245 <title>Command Explanations</title>
246
247 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
248 href="../../xincludes/static-libraries.xml"/>
249
250 <para>
251 <parameter>--enable-threaded-resolver</parameter>: This switch enables
252 <application>cURL</application>'s builtin threaded DNS resolver.
253 </para>
254
255 <para>
256 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This
257 switch sets the location of the BLFS Certificate Authority store.
258 </para>
259
260 <para>
261 <option>--with-gssapi</option>: This parameter adds
262 <application>Kerberos 5</application> support to
263 <filename class="libraryfile">libcurl</filename>.
264 </para>
265
266 <para>
267 <option>--without-ssl --with-gnutls</option>: Use to
268 build with <application>GnuTLS</application> support
269 instead of <application>OpenSSL</application> for SSL/TLS.
270 </para>
271
272 <para>
273 <option>--with-ca-bundle=/etc/ssl/ca-bundle.crt</option>: Use
274 this switch instead of <parameter>--with-ca-path</parameter> if
275 building with <application>GnuTLS</application> support
276 instead of <application>OpenSSL</application> for SSL/TLS.
277 </para>
278
279 <para>
280 <command>find docs ... -exec rm {} \;</command>: This command removes
281 <filename>Makefiles</filename> and man files from the documentation
282 directory that would otherwise be installed by the commands that follow.
283 </para>
284
285 </sect2>
286
287 <sect2 role="content">
288 <title>Contents</title>
289
290 <segmentedlist>
291 <segtitle>Installed Programs</segtitle>
292 <segtitle>Installed Library</segtitle>
293 <segtitle>Installed Directories</segtitle>
294
295 <seglistitem>
296 <seg>
297 curl and curl-config
298 </seg>
299 <seg>
300 libcurl.so
301 </seg>
302 <seg>
303 /usr/include/curl and
304 /usr/share/doc/curl-&curl-version;
305 </seg>
306 </seglistitem>
307 </segmentedlist>
308
309 <variablelist>
310 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
311 <?dbfo list-presentation="list"?>
312 <?dbhtml list-presentation="table"?>
313
314 <varlistentry id="curl-prog">
315 <term><command>curl</command></term>
316 <listitem>
317 <para>
318 is a command line tool for transferring files with URL syntax.
319 </para>
320 <indexterm zone="curl curl-prog">
321 <primary sortas="b-curl">curl</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="curl-config">
327 <term><command>curl-config</command></term>
328 <listitem>
329 <para>
330 prints information about the last compile, like libraries
331 linked to and prefix setting.
332 </para>
333 <indexterm zone="curl curl-config">
334 <primary sortas="b-curl-config">curl-config</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="libcurl">
340 <term><filename class="libraryfile">libcurl.so</filename></term>
341 <listitem>
342 <para>
343 provides the API functions required by
344 <command>curl</command> and other programs.
345 </para>
346 <indexterm zone="curl libcurl">
347 <primary sortas="c-libcurl">libcurl.so</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 </variablelist>
353
354 </sect2>
355
356</sect1>
Note: See TracBrowser for help on using the repository browser.