source: networking/netlibs/curl.xml@ c18fd2e6

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 c18fd2e6 was c18fd2e6, checked in by Pierre Labastie <pieere@…>, 4 years ago

Updates:
unbound-1.7.0
xbitmaps-1.1.2
xdg-user-dirs-0.17
libgpg-error-1.28

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

  • Property mode set to 100644
File size: 11.7 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 "04c00832fa62d443b8745b056464fb30">
10 <!ENTITY curl-size "2.2 MB">
11 <!ENTITY curl-buildsize "43 MB (add 12 MB for tests without valgrind)">
12 <!ENTITY curl-time "0.5 SBU (add 4.4 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>. One test
188 fails for 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. -->
210 </para>
211
212 <para>
213 Now, as the <systemitem class="username">root</systemitem>
214 user:
215 </para>
216
217<screen role="root"><userinput>make install &amp;&amp;
218
219rm -rf docs/examples/.deps &amp;&amp;
220
221find docs \( -name Makefile\* -o -name \*.1 -o -name \*.3 \) -exec rm {} \; &amp;&amp;
222
223install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
224cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
225
226 <para>
227 Simple tests to the new installed <command>curl</command>:
228 <command>curl --trace-ascii debugdump.txt http://www.example.com/</command>
229 and
230 <command>curl --trace-ascii d.txt --trace-time http://example.com/</command>.
231 Inspect the locally created trace files <filename>debugdump.txt</filename>
232 and <filename>d.txt</filename>, which contain version downloaded
233 files information, etc. One file has the time for each action logged.
234 </para>
235 </sect2>
236
237 <sect2 role="commands">
238 <title>Command Explanations</title>
239
240 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
241 href="../../xincludes/static-libraries.xml"/>
242
243 <para>
244 <parameter>--enable-threaded-resolver</parameter>: This switch enables
245 <application>cURL</application>'s builtin threaded DNS resolver.
246 </para>
247
248 <para>
249 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This
250 switch sets the location of the BLFS Certificate Authority store.
251 </para>
252
253 <para>
254 <option>--with-gssapi</option>: This parameter adds
255 <application>Kerberos 5</application> support to
256 <filename class="libraryfile">libcurl</filename>.
257 </para>
258
259 <para>
260 <option>--without-ssl --with-gnutls</option>: Use to
261 build with <application>GnuTLS</application> support
262 instead of <application>OpenSSL</application> for SSL/TLS.
263 </para>
264
265 <para>
266 <option>--with-ca-bundle=/etc/ssl/ca-bundle.crt</option>: Use
267 this switch instead of <parameter>--with-ca-path</parameter> if
268 building with <application>GnuTLS</application> support
269 instead of <application>OpenSSL</application> for SSL/TLS.
270 </para>
271
272 <para>
273 <command>find docs ... -exec rm {} \;</command>: This command removes
274 <filename>Makefiles</filename> and man files from the documentation
275 directory that would otherwise be installed by the commands that follow.
276 </para>
277
278 </sect2>
279
280 <sect2 role="content">
281 <title>Contents</title>
282
283 <segmentedlist>
284 <segtitle>Installed Programs</segtitle>
285 <segtitle>Installed Library</segtitle>
286 <segtitle>Installed Directories</segtitle>
287
288 <seglistitem>
289 <seg>
290 curl and curl-config
291 </seg>
292 <seg>
293 libcurl.so
294 </seg>
295 <seg>
296 /usr/include/curl and
297 /usr/share/doc/curl-&curl-version;
298 </seg>
299 </seglistitem>
300 </segmentedlist>
301
302 <variablelist>
303 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
304 <?dbfo list-presentation="list"?>
305 <?dbhtml list-presentation="table"?>
306
307 <varlistentry id="curl-prog">
308 <term><command>curl</command></term>
309 <listitem>
310 <para>
311 is a command line tool for transferring files with URL syntax.
312 </para>
313 <indexterm zone="curl curl-prog">
314 <primary sortas="b-curl">curl</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="curl-config">
320 <term><command>curl-config</command></term>
321 <listitem>
322 <para>
323 prints information about the last compile, like libraries
324 linked to and prefix setting.
325 </para>
326 <indexterm zone="curl curl-config">
327 <primary sortas="b-curl-config">curl-config</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="libcurl">
333 <term><filename class="libraryfile">libcurl.so</filename></term>
334 <listitem>
335 <para>
336 provides the API functions required by
337 <command>curl</command> and other programs.
338 </para>
339 <indexterm zone="curl libcurl">
340 <primary sortas="c-libcurl">libcurl.so</primary>
341 </indexterm>
342 </listitem>
343 </varlistentry>
344
345 </variablelist>
346
347 </sect2>
348
349</sect1>
Note: See TracBrowser for help on using the repository browser.