source: networking/netlibs/curl.xml@ 84fe2e9

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 84fe2e9 was 84fe2e9, checked in by Douglas R. Reno <renodr@…>, 18 months ago

Update to gnome-desktop-3.36.2
Update to boost-1.73.0
Update to curl-7.70.0

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

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