source: networking/netlibs/curl.xml@ 0e29df6

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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0e29df6 was 0e29df6, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to libepoxy-1.4.0.
Update to xfce4-terminal-0.8.4.
Update to ffmpeg-3.2.3.
Update to List-AllUtils-0.14 (Perl Module).

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18274 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="libidn"/>,
98 <xref linkend="mitkrb"/>,
99 <xref linkend="nghttp2"/>,
100 <xref linkend="openldap"/>,
101 <xref linkend="samba"/>,
102 <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink>,
103 <ulink url="https://www.gnu.org/software/libidn/#libidn2/">libidn2</ulink>,
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 (formerly known as
109 PolarSSL)</ulink>, and
110 <ulink url="http://spnego.sourceforge.net/">
111 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>patch -Np1 -i ../curl-&curl-version;-valgrind_filter-1.patch &amp;&amp;
134./configure --prefix=/usr \
135 --disable-static \
136 --enable-threaded-resolver \
137 --with-ca-path=/etc/ssl/certs &amp;&amp;
138make</userinput></screen>
139
140<!-- <para>
141 Running the test suite is optional. About 2% of the tests fail. Increase
142 in test time by each failed test is about 10%. Tests SBU above was
143 obtained disabling failing tests, with:
144 </para>
145
146<screen><userinput>cat &gt;&gt; tests/data/DISABLED &lt;&lt; "EOF"
147<literal>564
148700
149701
150703
151706
152707
153708
154709
155710
156711
157712</literal>
158EOF</userinput></screen>
159
160I had the following fail:
161 300 301 303 304 306 309 310 311 312 325
162 400 401 403 406 407 408 409 560 1112 2034
1632035 2037 2038 2041 2042
164
165 - Bruce 20151016
166
167Tests may be using capabilites removed from recent ssh due to
168security issues.
169
170
171 <para>
172 and running <command>make test</command>.
173 </para>-->
174
175 <para>
176 To run the test suite, issue: <command>make test</command>. <!-- Two tests,
177 1139 and 1140, may fail. Works fine for me. Douglas 20160720 --><!-- Some
178 tests (up to 2%) may fail due to timing issues, kernel configuration,
179 or other issues.-->
180 </para>
181
182 <para>
183 Now, as the <systemitem class="username">root</systemitem>
184 user:
185 </para>
186
187<screen role="root"><userinput>make install &amp;&amp;
188
189rm -rf docs/examples/.deps &amp;&amp;
190
191find docs \( -name Makefile\* \
192 -o -name \*.1 \
193 -o -name \*.3 \) \
194 -exec rm {} \; &amp;&amp;
195install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
196cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
197
198 <para>
199 Simple tests to the new installed <command>curl</command>:
200 <command>curl --trace-ascii debugdump.txt http://www.example.com/</command>
201 and
202 <command>curl --trace-ascii d.txt --trace-time http://example.com/</command>.
203 Inspect the locally created trace files <filename>debugdump.txt</filename>
204 and <filename>d.txt</filename>, which contain version downloaded
205 files information, etc. One file has the time for each action logged.
206 </para>
207 </sect2>
208
209 <sect2 role="commands">
210 <title>Command Explanations</title>
211
212 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
213 href="../../xincludes/static-libraries.xml"/>
214
215 <para>
216 <parameter>--enable-threaded-resolver</parameter>: This switch enables
217 <application>cURL</application>'s builtin threaded DNS resolver.
218 </para>
219
220 <para>
221 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This
222 switch sets the location of the BLFS <xref linkend="cacerts"/>.
223 </para>
224
225 <para>
226 <option>--with-gssapi</option>: This parameter adds
227 <application>Kerberos 5</application> support to
228 <filename class="libraryfile">libcurl</filename>.
229 </para>
230
231 <para>
232 <option>--without-ssl --with-gnutls</option>: Use to
233 build with <application>GnuTLS</application> support
234 instead of <application>OpenSSL</application> for SSL/TLS.
235 </para>
236
237 <para>
238 <option>--with-ca-bundle=/etc/ssl/ca-bundle.crt</option>: Use
239 this switch instead of <parameter>--with-ca-path</parameter> if
240 building with <application>GnuTLS</application> support
241 instead of <application>OpenSSL</application> for SSL/TLS.
242 </para>
243
244 <para>
245 <command>find docs ... -exec rm {} \;</command>: This command removes
246 <filename>Makefiles</filename> and man files from the documentation
247 directory that would otherwise be installed by the commands that follow.
248 </para>
249
250 </sect2>
251
252 <sect2 role="content">
253 <title>Contents</title>
254
255 <segmentedlist>
256 <segtitle>Installed Programs</segtitle>
257 <segtitle>Installed Library</segtitle>
258 <segtitle>Installed Directories</segtitle>
259
260 <seglistitem>
261 <seg>
262 curl, and curl-config
263 </seg>
264 <seg>
265 libcurl.so
266 </seg>
267 <seg>
268 /usr/include/curl and
269 /usr/share/doc/curl-&curl-version;
270 </seg>
271 </seglistitem>
272 </segmentedlist>
273
274 <variablelist>
275 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
276 <?dbfo list-presentation="list"?>
277 <?dbhtml list-presentation="table"?>
278
279 <varlistentry id="curl-prog">
280 <term><command>curl</command></term>
281 <listitem>
282 <para>
283 is a command line tool for transferring files with URL syntax.
284 </para>
285 <indexterm zone="curl curl-prog">
286 <primary sortas="b-curl">curl</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="curl-config">
292 <term><command>curl-config</command></term>
293 <listitem>
294 <para>
295 prints information about the last compile, like libraries
296 linked to and prefix setting.
297 </para>
298 <indexterm zone="curl curl-config">
299 <primary sortas="b-curl-config">curl-config</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="libcurl">
305 <term><filename class="libraryfile">libcurl.so</filename></term>
306 <listitem>
307 <para>
308 provides the API functions required by
309 <command>curl</command> and other programs.
310 </para>
311 <indexterm zone="curl libcurl">
312 <primary sortas="c-libcurl">libcurl.so</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 </variablelist>
318
319 </sect2>
320
321</sect1>
Note: See TracBrowser for help on using the repository browser.