source: networking/netlibs/curl.xml@ 83f8954

10.0 10.1 11.0 11.1 11.2 lazarus qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 83f8954 was 83f8954, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to curl-7.69.1.
Update to Archive-Zip-1.68 (Perl Module).
Update to vala-0.48.1.
Update to libuv-v1.35.0.
Update to icu-66_1.
Update to webkitgtk-2.28.0.
Update to SDL2-2.0.12.

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

  • Property mode set to 100644
File size: 14.5 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 "eb77b3acf050df4afbc780367e0e7064">
10 <!ENTITY curl-size "2.4 MB">
11 <!ENTITY curl-buildsize "82 MB (add 17 MB for tests)">
12 <!ENTITY curl-time "0.3 SBU (add 15 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 &lfs91_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 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
78 <itemizedlist spacing="compact">
79 <listitem>
80 <para>Patch to fix DNS resolution issues: <ulink
81 url="&patch-root;/curl-7.65.1-fix_dns_segfaults-2.patch"/>
82 </para>
83 </listitem>
84 </itemizedlist>
85-->
86
87 <bridgehead renderas="sect3">cURL Dependencies</bridgehead>
88
89 <bridgehead renderas="sect4">Recommended</bridgehead>
90 <para role="recommended">
91 <xref role="runtime" linkend="make-ca"/> (runtime)
92 </para>
93
94 <bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <xref linkend="brotli"/>,
97 <xref linkend="c-ares"/>,
98 <xref linkend="gnutls"/>,
99 <xref linkend="libidn2"/>,
100 <xref linkend="libpsl"/>,
101 <xref linkend="libssh2"/>,
102 <xref linkend="mitkrb"/>,
103 <xref linkend="nghttp2"/>,
104 <xref linkend="openldap"/>,
105 <xref linkend="samba"/>,
106 <ulink url="https://launchpad.net/libmetalink/">libmetalink</ulink>,
107 <ulink url="http://rtmpdump.mplayerhq.hu/">librtmp</ulink>, and
108 <!--<ulink url="https://tls.mbed.org/">mbed TLS</ulink> (formerly known as
109 PolarSSL), and -->
110 <!-- mbedTLS/PolarSSL support was removed in 7.65.1 -->
111 <ulink url="http://spnego.sourceforge.net/">SPNEGO</ulink>
112 </para>
113
114 <bridgehead renderas="sect4">Optional if Running the Test Suite</bridgehead>
115 <para role="optional">
116 <!-- stunnel is still listed in the docs as required, but 7.58.0
117 tests completed happily without it, although the test for unit1323
118 reported that the tool set in the test case does not exist - ken -->
119 <xref linkend="stunnel"/> (for the HTTPS and FTPS tests) and
120 <xref linkend="valgrind"/> (this will slow the tests down and may cause failures.)
121 </para>
122
123 <para condition="html" role="usernotes">User Notes:
124 <ulink url="&blfs-wiki;/curl"/>
125 </para>
126 </sect2>
127
128 <sect2 role="installation">
129 <title>Installation of cURL</title>
130<!--
131 <para>
132 First, apply a patch to fix DNS resolution issues:
133 </para>
134
135<screen><userinput>patch -Np1 -i ../curl-7.65.1-fix_dns_segfaults-2.patch</userinput></screen>
136-->
137
138 <para>
139 Install <application>cURL</application> by running the following
140 commands:
141 </para>
142
143<screen><userinput>./configure --prefix=/usr \
144 --disable-static \
145 --enable-threaded-resolver \
146 --with-ca-path=/etc/ssl/certs &amp;&amp;
147make</userinput></screen>
148
149<!--
150 For version 7.54.1 I got:
151 TESTDONE: 869 tests out of 869 reported OK: 100%
152 TESTDONE: 1092 tests were considered during 1080 seconds
153
154 <para>
155 Running the test suite is optional. About 2% of the tests fail. Increase
156 in test time by each failed test is about 10%. Tests SBU above was
157 obtained disabling failing tests, with:
158 </para>
159
160 2017-10-29 - bdubbs
161 For version 7.56.1 I had a lot of test failures which included long
162 timeouts. Could not determine the cause of the timeouts or failures,
163 but I was missing c-ares, MIT Kerberos, ldap, samba, and the six
164 external packages.
165
166 2017-12-01 - bdubbs
167 Still a lot of test failures. I did have c-ares, Kerberos, and ldap
168 installed this time. Best guess is that servers are not available.
169
170 2018-08-01 - renodr
171 No test failures, but I didn't have any of the optional dependencies except
172 for c-ares and libidn2. I might re-run this test suite before release with
173 all of the optional deps, but right now, it isn't a priority - rather
174 the security fix is.
175-->
176
177 <para>
178 To run the test suite, issue: <command>make test</command>.
179 Tests 323, 1139, 1140, and 1173 are known to fail.
180 A few other tests may fail randomly for unknown reasons.
181 </para>
182<!-- Two (of 857) tests
183fail for unknown reasons, and all tests fail is valgrind is installed. Moving
184valgrind out of $PATH is recommended if you wish to run the test suite while
185it is installed.
186
187Added by Pierre for curl-7.59.0:
188no stunnel, no valgrind, no options
189Warning: smb server unexpectedly alive
190Warning: dict server unexpectedly alive
191TESTDONE: 950 tests out of 951 reported OK: 99%
192TESTFAIL: These test cases failed: 1148
193TESTDONE: 1189 tests were considered during 362 seconds.
194__________
195
196 if stunnel and valgrind are not installed, and also most options
197 (I had rtmpdump), the tests complete without problems.
198Warning: smb server unexpectedly alive
199Warning: dict server unexpectedly alive
200TESTDONE: 938 tests out of 938 reported OK: 100%
201TESTDONE: 1175 tests were considered during 355 seconds.
202 and no. I don't have smb - so commenting the rest of this:
203 To run the test suite, issue: <command>make test</command>. Many tests
204 may fail that depend on optional dependencies that may not be installed
205 or upstream servers that may not be available, especially for tests
206 numbered 700 and above.
207 Test time may be significantly increase due to hanging tests that fail.
208__________
209Added by Bruce for curl-7.60.0:
210TESTDONE: 957 tests out of 959 reported OK: 99%
211TESTFAIL: These test cases failed: 1139 1140
212TESTDONE: 1196 tests were considered during 1184 seconds.
213From the logs, both appear to be ipv6 releated.
214
215==========
216Added by Douglas for curl-7.61.0:
217TESTDONE: 961 tests out of 961 reported OK: 100%
218TESTDONE: 1202 tests were considered during 338 seconds.
219I only have c-ares and libidn2 installed, I will likely try before release
220with all optional dependencies in the book installed.
221
222=========
2237.61.1 NOTE: The test suite is extremely noisy, complaining about verification errors.
224It's possible this is due to openssl-1.1.1, BUT 79/79 tests report as 100% OK. I had
225c-ares, libpsl, and libidn1/2 installed. - Doug
226
227========
2287.62.0: All tests passed. libpsl, c-ares, libssh2, libidn2 installed.
229All 1098 tests report OK.
230
231=======
232Added by Douglas for curl-7.64.0:
233TESTDONE: 1022 tests out of 1023 reported OK: 99%
234TESTFAIL: These tests cases failed: 323
235TESTDONE: 1235 tests were considered during 1279 seconds.
236For dependencies, I had c-ares, gnutls, libidn2, libpsl, krb5, libssh2, nghttp2,
237OpenLDAP, Samba, stunnel, and Valgrind installed.
238=======
239Added by bdubbs for curl-7.64.1:
240TESTDONE: 1022 tests out of 1025 reported OK: 99%
241TESTFAIL: These test cases failed: 323 1139 1140
242TESTDONE: 1242 tests were considered during 1483 seconds
243
244=======
245Added by renodr for curl-7.65.1:
246TESTDONE: 996 tests out of 997 reported OK: 99%
247TESTFAIL: These test cases failed: 1560
248TESTDONE: 1249 tests were considered during 1091 seconds.
249All dependencies except for externals installed.
250=======
251Added by bdubbs for curl-7.65.2:
252TESTDONE: 1034 tests out of 1036 reported OK: 99%
253TESTFAIL: These test cases failed: 323 1560
254TESTDONE: 1254 tests were considered during 1362 seconds.
255Time above does not include test build time.
256All dependencies except for externals installed.
257=======
258Added by bdubbs for curl-7.65.3:
259TESTDONE: 1031 tests out of 1036 reported OK: 99%
260TESTFAIL: These test cases failed: 323 1139 1140 1173 1560
261TESTDONE: 1254 tests were considered during 1364 seconds.
262
263The tests that fail seem to be somewhat random. What happened between
264yesterday and today that that tests 1139 1140 1173 now fail?
265
266=======
267Added by bdubbs for curl-7.68.0:
268TESTDONE: 1066 tests out of 1071 reported OK: 99%
269TESTFAIL: These test cases failed: 323 1139 1140 1173 1560
270TESTDONE: 1290 tests were considered during 1515 seconds.
271
272=======
273Added by bdubbs for curl-7.69.0:
274TESTDONE: 074 tests out of 1079 reported OK: 99%
275TESTFAIL: These test cases failed: 323 1139 1140 1173 1560
276TESTDONE: 1320 tests were considered during 1514 seconds.
277
278For curl-7.69.1, 1082 tests out of 1086 reported OK. 1560 now passes.
2791330 tests were considered during 1528 seconds.
280
281-->
282
283 <para>
284 Now, as the <systemitem class="username">root</systemitem>
285 user:
286 </para>
287
288<screen role="root"><userinput>make install &amp;&amp;
289
290rm -rf docs/examples/.deps &amp;&amp;
291
292find docs \( -name Makefile\* -o -name \*.1 -o -name \*.3 \) -exec rm {} \; &amp;&amp;
293
294install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
295cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
296
297 <para>
298 Simple tests to the new installed <command>curl</command>:
299 <command>curl --trace-ascii debugdump.txt http://www.example.com/</command>
300 and
301 <command>curl --trace-ascii d.txt --trace-time http://example.com/</command>.
302 Inspect the locally created trace files <filename>debugdump.txt</filename>
303 and <filename>d.txt</filename>, which contain version downloaded
304 files information, etc. One file has the time for each action logged.
305 </para>
306 </sect2>
307
308 <sect2 role="commands">
309 <title>Command Explanations</title>
310
311 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
312 href="../../xincludes/static-libraries.xml"/>
313
314 <para>
315 <parameter>--enable-threaded-resolver</parameter>: This switch enables
316 <application>cURL</application>'s builtin threaded DNS resolver.
317 </para>
318
319 <para>
320 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This
321 switch sets the location of the BLFS Certificate Authority store.
322 </para>
323
324 <para>
325 <option>--with-gssapi</option>: This parameter adds
326 <application>Kerberos 5</application> support to
327 <filename class="libraryfile">libcurl</filename>.
328 </para>
329
330 <para>
331 <option>--without-ssl --with-gnutls</option>: Use to
332 build with <application>GnuTLS</application> support
333 instead of <application>OpenSSL</application> for SSL/TLS.
334 </para>
335
336 <para>
337 <option>--with-ca-bundle=/etc/pki/tls/certs/ca-bundle.crt</option>: Use
338 this switch instead of <parameter>--with-ca-path</parameter> if
339 building with <application>GnuTLS</application> support
340 instead of <application>OpenSSL</application> for SSL/TLS.
341 </para>
342
343 <para>
344 <option>--with-libssh2</option>: This paramater adds
345 <application>SSH</application> support to cURL. This is disabled
346 by default.
347 </para>
348
349 <para>
350 <option>--enable-ares</option>: This paramater adds
351 support for DNS resolution through the c-ares library. It is disabled
352 by default, but does speed up DNS resolution queries.
353 </para>
354
355 <para>
356 <command>find docs ... -exec rm {} \;</command>: This command removes
357 <filename>Makefiles</filename> and man files from the documentation
358 directory that would otherwise be installed by the commands that follow.
359 </para>
360
361 </sect2>
362
363 <sect2 role="content">
364 <title>Contents</title>
365
366 <segmentedlist>
367 <segtitle>Installed Programs</segtitle>
368 <segtitle>Installed Library</segtitle>
369 <segtitle>Installed Directories</segtitle>
370
371 <seglistitem>
372 <seg>
373 curl and curl-config
374 </seg>
375 <seg>
376 libcurl.so
377 </seg>
378 <seg>
379 /usr/include/curl and
380 /usr/share/doc/curl-&curl-version;
381 </seg>
382 </seglistitem>
383 </segmentedlist>
384
385 <variablelist>
386 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
387 <?dbfo list-presentation="list"?>
388 <?dbhtml list-presentation="table"?>
389
390 <varlistentry id="curl-prog">
391 <term><command>curl</command></term>
392 <listitem>
393 <para>
394 is a command line tool for transferring files with URL syntax.
395 </para>
396 <indexterm zone="curl curl-prog">
397 <primary sortas="b-curl">curl</primary>
398 </indexterm>
399 </listitem>
400 </varlistentry>
401
402 <varlistentry id="curl-config">
403 <term><command>curl-config</command></term>
404 <listitem>
405 <para>
406 prints information about the last compile, like libraries
407 linked to and prefix setting.
408 </para>
409 <indexterm zone="curl curl-config">
410 <primary sortas="b-curl-config">curl-config</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="libcurl">
416 <term><filename class="libraryfile">libcurl.so</filename></term>
417 <listitem>
418 <para>
419 provides the API functions required by
420 <command>curl</command> and other programs.
421 </para>
422 <indexterm zone="curl libcurl">
423 <primary sortas="c-libcurl">libcurl.so</primary>
424 </indexterm>
425 </listitem>
426 </varlistentry>
427
428 </variablelist>
429
430 </sect2>
431
432</sect1>
Note: See TracBrowser for help on using the repository browser.