source: networking/netlibs/curl.xml@ 21d18f7e

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 21d18f7e was 21d18f7e, checked in by Douglas R. Reno <renodr@…>, 11 months ago

Update to curl-7.74.0
Update to tracker-miners-3.0.3
Update to tracker-3.0.2
Update to NetworkManager-1.28.0
Update to fuse3-3.10.1

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

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