source: networking/netlibs/curl.xml@ 8f31a869

10.0 10.1 11.0 8.0 8.1 8.2 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 8f31a869 was 8f31a869, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update curl dependencies

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

  • Property mode set to 100644
File size: 9.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.lzma">
8 <!ENTITY curl-download-ftp " ">
9 <!ENTITY curl-md5sum "ddbd157359bc8a9174e11b151254b264">
10 <!ENTITY curl-size "2.0 MB">
11 <!ENTITY curl-buildsize "39 MB (additional 11 MB for tests)">
12 <!ENTITY curl-time "0.4 SBU (additional 10.6 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 &lfs7a_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 Required patch:
82 <ulink url="&patch-root;/curl-&curl-version;-valgrind_filter-1.patch"/>
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">cURL Dependencies</bridgehead>
88
89 <bridgehead renderas="sect4">Recommended</bridgehead>
90 <para role="recommended">
91 <xref linkend="cacerts"/> (runtime) and
92 <xref linkend="openssl"/> or <xref linkend="gnutls"/>
93 </para>
94
95 <bridgehead renderas="sect4">Optional</bridgehead>
96 <para role="optional">
97 <xref linkend="mitkrb"/>,
98 <xref linkend="nghttp2"/>,
99 <xref linkend="openldap"/>,
100 <xref linkend="samba"/>,
101 <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink>,
102 <ulink url="https://www.gnu.org/software/libidn/#libidn2/">libidn2</ulink>,
103 <ulink url="https://launchpad.net/libmetalink/">libmetalink</ulink>,
104 <ulink url="https://github.com/rockdaboot/libpsl">libpsl</ulink>,
105 <ulink url="http://rtmpdump.mplayerhq.hu/">librtmp</ulink>,
106 <ulink url="http://www.libssh2.org">libssh2</ulink>,
107 <ulink url="https://tls.mbed.org/">mbed TLS (formerly known as
108 PolarSSL)</ulink>, and
109 <ulink url="http://spnego.sourceforge.net/">
110 SPNEGO</ulink>
111 </para>
112
113 <bridgehead renderas="sect4">Optional for Running the Test Suite</bridgehead>
114 <para role="optional">
115 <xref linkend="stunnel"/> (for the HTTPS and FTPS tests) and
116 <xref linkend="valgrind"/>
117 </para>
118
119 <para condition="html" role="usernotes">User Notes:
120 <ulink url="&blfs-wiki;/curl"/>
121 </para>
122 </sect2>
123
124 <sect2 role="installation">
125 <title>Installation of cURL</title>
126
127 <para>
128 Install <application>cURL</application> by running the following
129 commands:
130 </para>
131
132<screen><userinput>patch -Np1 -i ../curl-&curl-version;-valgrind_filter-1.patch &amp;&amp;
133./configure --prefix=/usr \
134 --disable-static \
135 --enable-threaded-resolver \
136 --with-ca-path=/etc/ssl/certs &amp;&amp;
137make</userinput></screen>
138
139<!-- <para>
140 Running the test suite is optional. About 2% of the tests fail. Increase
141 in test time by each failed test is about 10%. Tests SBU above was
142 obtained disabling failing tests, with:
143 </para>
144
145<screen><userinput>cat &gt;&gt; tests/data/DISABLED &lt;&lt; "EOF"
146<literal>564
147700
148701
149703
150706
151707
152708
153709
154710
155711
156712</literal>
157EOF</userinput></screen>
158
159I had the following fail:
160 300 301 303 304 306 309 310 311 312 325
161 400 401 403 406 407 408 409 560 1112 2034
1622035 2037 2038 2041 2042
163
164 - Bruce 20151016
165
166Tests may be using capabilites removed from recent ssh due to
167security issues.
168
169
170 <para>
171 and running <command>make test</command>.
172 </para>-->
173
174 <para>
175 To run the test suite, issue: <command>make test</command>. <!-- Two tests,
176 1139 and 1140, may fail. Works fine for me. Douglas 20160720 --><!-- Some
177 tests (up to 2%) may fail due to timing issues, kernel configuration,
178 or other issues.-->
179 </para>
180
181 <para>
182 Now, as the <systemitem class="username">root</systemitem>
183 user:
184 </para>
185
186<screen role="root"><userinput>make install &amp;&amp;
187
188rm -rf docs/examples/.deps &amp;&amp;
189
190find docs \( -name Makefile\* \
191 -o -name \*.1 \
192 -o -name \*.3 \) \
193 -exec rm {} \; &amp;&amp;
194install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
195cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
196
197 <para>
198 Simple tests to the new installed <command>curl</command>:
199 <command>curl --trace-ascii debugdump.txt http://www.example.com/</command>
200 and
201 <command>curl --trace-ascii d.txt --trace-time http://example.com/</command>.
202 Inspect the locally created trace files <filename>debugdump.txt</filename>
203 and <filename>d.txt</filename>, which contain version downloaded
204 files information, etc. One file has the time for each action logged.
205 </para>
206 </sect2>
207
208 <sect2 role="commands">
209 <title>Command Explanations</title>
210
211 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
212 href="../../xincludes/static-libraries.xml"/>
213
214 <para>
215 <parameter>--enable-threaded-resolver</parameter>: This switch enables
216 <application>cURL</application>'s builtin threaded DNS resolver.
217 </para>
218
219 <para>
220 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This
221 switch sets the location of the BLFS <xref linkend="cacerts"/>.
222 </para>
223
224 <para>
225 <option>--with-gssapi</option>: This parameter adds
226 <application>Kerberos 5</application> support to
227 <filename class="libraryfile">libcurl</filename>.
228 </para>
229
230 <para>
231 <option>--without-ssl --with-gnutls</option>: Use to
232 build with <application>GnuTLS</application> support
233 instead of <application>OpenSSL</application> for SSL/TLS.
234 </para>
235
236 <para>
237 <option>--with-ca-bundle=/etc/ssl/ca-bundle.crt</option>: Use
238 this switch instead of <parameter>--with-ca-path</parameter> if
239 building with <application>GnuTLS</application> support
240 instead of <application>OpenSSL</application> for SSL/TLS.
241 </para>
242
243 <para>
244 <command>find docs ... -exec rm {} \;</command>: This command removes
245 <filename>Makefiles</filename> and man files from the documentation
246 directory that would otherwise be installed by the commands that follow.
247 </para>
248
249 </sect2>
250
251 <sect2 role="content">
252 <title>Contents</title>
253
254 <segmentedlist>
255 <segtitle>Installed Programs</segtitle>
256 <segtitle>Installed Library</segtitle>
257 <segtitle>Installed Directories</segtitle>
258
259 <seglistitem>
260 <seg>
261 curl, and curl-config
262 </seg>
263 <seg>
264 libcurl.so
265 </seg>
266 <seg>
267 /usr/include/curl and
268 /usr/share/doc/curl-&curl-version;
269 </seg>
270 </seglistitem>
271 </segmentedlist>
272
273 <variablelist>
274 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
275 <?dbfo list-presentation="list"?>
276 <?dbhtml list-presentation="table"?>
277
278 <varlistentry id="curl-prog">
279 <term><command>curl</command></term>
280 <listitem>
281 <para>
282 is a command line tool for transferring files with URL syntax.
283 </para>
284 <indexterm zone="curl curl-prog">
285 <primary sortas="b-curl">curl</primary>
286 </indexterm>
287 </listitem>
288 </varlistentry>
289
290 <varlistentry id="curl-config">
291 <term><command>curl-config</command></term>
292 <listitem>
293 <para>
294 prints information about the last compile, like libraries
295 linked to and prefix setting.
296 </para>
297 <indexterm zone="curl curl-config">
298 <primary sortas="b-curl-config">curl-config</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 <varlistentry id="libcurl">
304 <term><filename class="libraryfile">libcurl.so</filename></term>
305 <listitem>
306 <para>
307 provides the API functions required by
308 <command>curl</command> and other programs.
309 </para>
310 <indexterm zone="curl libcurl">
311 <primary sortas="c-libcurl">libcurl.so</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 </variablelist>
317
318 </sect2>
319
320</sect1>
Note: See TracBrowser for help on using the repository browser.