source: networking/netlibs/curl.xml@ e3a68e4

10.0 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 e3a68e4 was e3a68e4, checked in by Douglas R. Reno <renodr@…>, 16 months ago

Update to node.js-12.18.2
Update to cURL-7.71.1

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

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