source: networking/netlibs/curl.xml@ ef0c157

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 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 ef0c157 was ef0c157, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Update to openbox-3.5.2
Update to curl-7.32.0

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

  • Property mode set to 100644
File size: 7.4 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 "http://curl.haxx.se/download/curl-&curl-version;.tar.bz2">
8 <!ENTITY curl-download-ftp " ">
9 <!ENTITY curl-md5sum "30d04b0a8c43c6770039d1bf033dfe79">
10 <!ENTITY curl-size "2.6 MB">
11 <!ENTITY curl-buildsize "29 MB (additional 7 MB for tests)">
12 <!ENTITY curl-time "0.5 SBU (additional 2.9 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 &lfs73_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">cURL Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Recommended</bridgehead>
80 <para role="recommended">
81 <xref linkend="cacerts"/> and
82 <xref linkend="openssl"/> or <xref linkend="gnutls"/>
83 </para>
84
85 <bridgehead renderas="sect4">Optional</bridgehead>
86 <para role="optional">
87 <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink>,
88 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
89 <xref linkend="libidn"/>,
90 <ulink url="https://launchpad.net/libmetalink/">libmetalink</ulink>,
91 <ulink url="http://www.libssh2.org">libssh2</ulink>,
92 <xref linkend="mitkrb"/>,
93 <xref linkend="openldap"/> and
94 <ulink url="http://www.vintela.com/resources/topics/spnego/">
95 SPNEGO</ulink>
96 </para>
97
98 <bridgehead renderas="sect4">Optional for Running the Test Suite</bridgehead>
99 <para role="optional">
100 <xref linkend="stunnel"/> (for the HTTPS and FTPS tests)
101 </para>
102
103 <para condition="html" role="usernotes">User Notes:
104 <ulink url="&blfs-wiki;/curl"/>
105 </para>
106 </sect2>
107
108 <sect2 role="installation">
109 <title>Installation of cURL</title>
110
111 <para>
112 Install <application>cURL</application> by running the following
113 commands:
114 </para>
115
116<screen><userinput>./configure --prefix=/usr \
117 --disable-static \
118 --enable-threaded-resolver \
119 --with-ca-path=/etc/ssl/certs &amp;&amp;
120make</userinput></screen>
121
122 <para>
123 To test the results, issue: <command>make test</command>.
124 </para>
125
126 <para>
127 Now, as the <systemitem class="username">root</systemitem>
128 user:
129 </para>
130
131<screen role="root"><userinput>make install &amp;&amp;
132find docs \( -name "Makefile*" -o -name "*.1" -o -name "*.3" \) -exec rm {} \; &amp;&amp;
133install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
134cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
135 </sect2>
136
137 <sect2 role="commands">
138 <title>Command Explanations</title>
139
140 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
141 href="../../xincludes/static-libraries.xml"/>
142
143 <para>
144 <parameter>--enable-threaded-resolver</parameter>: This switch enables
145 <application>cURL</application>'s builtin threaded DNS resolver.
146 </para>
147
148 <para>
149 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This parameter
150 sets the directory to use as the path to the SSL certificates.
151 If you've not installed <xref linkend="openssl"/> or
152 <xref linkend="gnutls"/> and the <xref linkend="cacerts"/> you can
153 remove this option.
154 </para>
155
156 <para>
157 <option>--with-gssapi</option>: This parameter adds
158 <application>Kerberos 5</application> support to
159 <filename class="libraryfile">libcurl</filename>.
160 </para>
161
162 <para>
163 <option>--without-ssl --with-gnutls</option>: Use to
164 build with <application>GnuTLS</application> support
165 instead of <application>OpenSSL</application> for SSL/TLS.
166 </para>
167
168 <para>
169 <command>find docs \( -name "Makefile*" -o -name "*.1" -o -name "*.3"
170 \) -exec rm {} \;</command>: This command removes
171 <filename>Makefiles</filename> and man files from the documentation
172 directory that would otherwise be installed by the commands that
173 follow.
174 </para>
175
176 </sect2>
177
178 <sect2 role="content">
179 <title>Contents</title>
180
181 <segmentedlist>
182 <segtitle>Installed Programs</segtitle>
183 <segtitle>Installed Library</segtitle>
184 <segtitle>Installed Directories</segtitle>
185
186 <seglistitem>
187 <seg>
188 curl and curl-config
189 </seg>
190 <seg>
191 libcurl.so
192 </seg>
193 <seg>
194 /usr/include/curl and
195 /usr/share/doc/curl-&curl-version;
196 </seg>
197 </seglistitem>
198 </segmentedlist>
199
200 <variablelist>
201 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
202 <?dbfo list-presentation="list"?>
203 <?dbhtml list-presentation="table"?>
204
205 <varlistentry id="curl-prog">
206 <term><command>curl</command></term>
207 <listitem>
208 <para>
209 is a command line tool for transferring files with URL syntax.
210 </para>
211 <indexterm zone="curl curl-prog">
212 <primary sortas="b-curl">curl</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="curl-config">
218 <term><command>curl-config</command></term>
219 <listitem>
220 <para>
221 prints information about the last compile, like libraries
222 linked to and prefix setting.
223 </para>
224 <indexterm zone="curl curl-config">
225 <primary sortas="b-curl-config">curl-config</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="libcurl">
231 <term><filename class="libraryfile">libcurl.so</filename></term>
232 <listitem>
233 <para>
234 provides the API functions required by
235 <command>curl</command> and other programs.
236 </para>
237 <indexterm zone="curl libcurl">
238 <primary sortas="c-libcurl">libcurl.so</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 </variablelist>
244
245 </sect2>
246
247</sect1>
Note: See TracBrowser for help on using the repository browser.