source: networking/netlibs/curl.xml@ e024fe4

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since e024fe4 was e024fe4, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Remove pcre as dependency for qpdf.
Update to curl-7.57.0.
Update to nasm-2.13.02.
Update to x265-2.6.
Update to upower-0.99.7.
Update to stunnel-5.44.
Update to QScintilla_gpl-2.10.2.

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

  • Property mode set to 100644
File size: 10.6 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 "93157c8f6593691bc00ae238a4c53863">
10 <!ENTITY curl-size "2.2 MB">
11 <!ENTITY curl-buildsize "36 MB (add 11 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 &lfs81_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="cacerts"/> (runtime) and
93 <xref linkend="openssl"/>
94 </para>
95
96 <bridgehead renderas="sect4">Optional</bridgehead>
97 <para role="optional">
98 <xref linkend="c-ares"/>,
99 <xref linkend="gnutls"/>,
100 <xref linkend="libidn2"/>,
101 <xref linkend="mitkrb"/>,
102 <xref linkend="nghttp2"/>,
103 <xref linkend="openldap"/>,
104 <xref linkend="samba"/>,
105 <ulink url="https://launchpad.net/libmetalink/">libmetalink</ulink>,
106 <ulink url="https://github.com/rockdaboot/libpsl">libpsl</ulink>,
107 <ulink url="http://rtmpdump.mplayerhq.hu/">librtmp</ulink>,
108 <ulink url="http://www.libssh2.org">libssh2</ulink>,
109 <ulink url="https://tls.mbed.org/">mbed TLS</ulink> (formerly known as
110 PolarSSL), and
111 <ulink url="http://spnego.sourceforge.net/"> SPNEGO</ulink>
112 </para>
113
114 <bridgehead renderas="sect4">Optional for Running the Test Suite</bridgehead>
115 <para role="optional">
116 <xref linkend="stunnel"/> (for the HTTPS and FTPS tests) and
117 <xref linkend="valgrind"/>
118 </para>
119
120 <para condition="html" role="usernotes">User Notes:
121 <ulink url="&blfs-wiki;/curl"/>
122 </para>
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of cURL</title>
127
128 <para>
129 Install <application>cURL</application> by running the following
130 commands:
131 </para>
132
133<screen><userinput>./configure --prefix=/usr \
134 --disable-static \
135 --enable-threaded-resolver \
136 --with-ca-path=/etc/ssl/certs &amp;&amp;
137make</userinput></screen>
138
139<!--
140 For version 7.54.1 I got:
141 TESTDONE: 869 tests out of 869 reported OK: 100%
142 TESTDONE: 1092 tests were considered during 1080 seconds
143
144 <para>
145 Running the test suite is optional. About 2% of the tests fail. Increase
146 in test time by each failed test is about 10%. Tests SBU above was
147 obtained disabling failing tests, with:
148 </para>
149
150 2017-10-29 - bdubbs
151 For version 7.56.1 I had a lot of test failures which included long
152 timeouts. Could not determine the cause of the timeouts or failures,
153 but I was missing c-ares, MIT Kerberos, ldap, samba, and the six
154 external packages.
155
156 2017-12-01 - bdubbs
157 Still a lot of test failures. I did have c-ares, Kerberos, and ldap
158 installed this time. Best guess is that servers are not available.
159-->
160 <note>
161 <para>
162 To run the tests for this package, valgrind requires a version of the
163 /lib/ld-2.23.so (or later) library with debugging symbols present.
164 </para>
165
166 <para>Current versions of LFS does not strip /lib/ld-2.23.so but
167 previous versions of LFS stripped these debugging symbols at the end of
168 Chapter 6. To get this library on oldeer systems, glibc must be rebuilt
169 with the current
170 glibc version using the same compiler that was used to build LFS. The
171 ld-2.23.so can then be renamed to ld-2.23.so.dbg and copied to /lib. Then
172 a symlink needs to be changed:
173 </para>
174
175 <screen role="nodump"><userinput>ln -sfv ld-2.23.so.dbg /lib/ld-linux-x86-64.so.2</userinput></screen>
176
177 <para>
178 Adjust the above instruction as needed for a 32-bit system
179 or for a different version of glibc.
180 </para>
181 </note>
182
183 <para>
184 To run the test suite, issue: <command>make test</command>. Many tests
185 may fail that depend on optional dependencies that may not be installed
186 or upstream servers that may not be available, especially for tests
187 numbered 700 and above.
188 Test time may be significantly increase due to hanging tests that fail.
189 </para>
190
191 <para>
192 Now, as the <systemitem class="username">root</systemitem>
193 user:
194 </para>
195
196<screen role="root"><userinput>make install &amp;&amp;
197
198rm -rf docs/examples/.deps &amp;&amp;
199
200find docs \( -name Makefile\* -o -name \*.1 -o -name \*.3 \) -exec rm {} \; &amp;&amp;
201
202install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
203cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
204
205 <para>
206 Simple tests to the new installed <command>curl</command>:
207 <command>curl --trace-ascii debugdump.txt http://www.example.com/</command>
208 and
209 <command>curl --trace-ascii d.txt --trace-time http://example.com/</command>.
210 Inspect the locally created trace files <filename>debugdump.txt</filename>
211 and <filename>d.txt</filename>, which contain version downloaded
212 files information, etc. One file has the time for each action logged.
213 </para>
214 </sect2>
215
216 <sect2 role="commands">
217 <title>Command Explanations</title>
218
219 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
220 href="../../xincludes/static-libraries.xml"/>
221
222 <para>
223 <parameter>--enable-threaded-resolver</parameter>: This switch enables
224 <application>cURL</application>'s builtin threaded DNS resolver.
225 </para>
226
227 <para>
228 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This
229 switch sets the location of the BLFS <xref linkend="cacerts"/>.
230 </para>
231
232 <para>
233 <option>--with-gssapi</option>: This parameter adds
234 <application>Kerberos 5</application> support to
235 <filename class="libraryfile">libcurl</filename>.
236 </para>
237
238 <para>
239 <option>--without-ssl --with-gnutls</option>: Use to
240 build with <application>GnuTLS</application> support
241 instead of <application>OpenSSL</application> for SSL/TLS.
242 </para>
243
244 <para>
245 <option>--with-ca-bundle=/etc/ssl/ca-bundle.crt</option>: Use
246 this switch instead of <parameter>--with-ca-path</parameter> if
247 building with <application>GnuTLS</application> support
248 instead of <application>OpenSSL</application> for SSL/TLS.
249 </para>
250
251 <para>
252 <command>find docs ... -exec rm {} \;</command>: This command removes
253 <filename>Makefiles</filename> and man files from the documentation
254 directory that would otherwise be installed by the commands that follow.
255 </para>
256
257 </sect2>
258
259 <sect2 role="content">
260 <title>Contents</title>
261
262 <segmentedlist>
263 <segtitle>Installed Programs</segtitle>
264 <segtitle>Installed Library</segtitle>
265 <segtitle>Installed Directories</segtitle>
266
267 <seglistitem>
268 <seg>
269 curl, and curl-config
270 </seg>
271 <seg>
272 libcurl.so
273 </seg>
274 <seg>
275 /usr/include/curl and
276 /usr/share/doc/curl-&curl-version;
277 </seg>
278 </seglistitem>
279 </segmentedlist>
280
281 <variablelist>
282 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
283 <?dbfo list-presentation="list"?>
284 <?dbhtml list-presentation="table"?>
285
286 <varlistentry id="curl-prog">
287 <term><command>curl</command></term>
288 <listitem>
289 <para>
290 is a command line tool for transferring files with URL syntax.
291 </para>
292 <indexterm zone="curl curl-prog">
293 <primary sortas="b-curl">curl</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="curl-config">
299 <term><command>curl-config</command></term>
300 <listitem>
301 <para>
302 prints information about the last compile, like libraries
303 linked to and prefix setting.
304 </para>
305 <indexterm zone="curl curl-config">
306 <primary sortas="b-curl-config">curl-config</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="libcurl">
312 <term><filename class="libraryfile">libcurl.so</filename></term>
313 <listitem>
314 <para>
315 provides the API functions required by
316 <command>curl</command> and other programs.
317 </para>
318 <indexterm zone="curl libcurl">
319 <primary sortas="c-libcurl">libcurl.so</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 </variablelist>
325
326 </sect2>
327
328</sect1>
Note: See TracBrowser for help on using the repository browser.