source: basicnet/netlibs/curl.xml@ 3e89149

10.0 10.1 11.0 11.1 11.2 11.3 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 gnome kde5-13430 kde5-14269 kde5-14686 ken/inkscape-core-mods krejzi/svn lazarus nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 3e89149 was 3e89149, checked in by Randy McMurchy <randy@…>, 16 years ago

Corrected the case of the name 'cURL' to be consistent with the developer

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

  • Property mode set to 100644
File size: 6.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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 "ftp://gd.tuwien.ac.at/utils/archivers/curl/curl-&curl-version;.tar.bz2">
9 <!ENTITY curl-md5sum "d71b2ee8febfde2c7dc30a43638ec0d9">
10 <!ENTITY curl-size "1.4 MB">
11 <!ENTITY curl-buildsize "27.5 MB">
12 <!ENTITY curl-time "0.5 SBU (additional 0.8 SBU to run the test suite)">
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>The <application>cURL</application> package contains
33 <command>curl</command> and its support library. This is useful for
34 transferring files with URL syntax. This ability to both
35 download and redirect files can be incorporated into other programs to support
36 functions like streaming media.</para>
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing='compact'>
40 <listitem>
41 <para>Download (HTTP): <ulink url="&curl-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&curl-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &curl-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &curl-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &curl-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &curl-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">cURL Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Optional</bridgehead>
63 <para role="optional"><xref linkend="pkgconfig"/>,
64 <xref linkend="openssl"/> or
65 <ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink>,
66 <xref linkend="openldap"/>,
67 <xref linkend="libidn"/>,
68 <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
69 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
70 <ulink url="http://www.vintela.com/resources/topics/spnego/">SPNEGO</ulink>, and
71 <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink></para>
72
73 <bridgehead renderas="sect4">Optional (for Running the Test Suite)</bridgehead>
74 <para role="optional"><xref linkend="stunnel"/> (for running HTTPS and FTPS tests) and
75 <ulink url="http://valgrind.kde.org/">Valgrind</ulink> (not used if building
76 the shared library)</para>
77
78 <para condition="html" role="usernotes">User Notes:
79 <ulink url="&blfs-wiki;/curl"/></para>
80
81 </sect2>
82
83 <sect2 role="installation">
84 <title>Installation of cURL</title>
85
86 <para>Install <application>cURL</application> by running the following
87 commands:</para>
88
89<screen><userinput>./configure --prefix=/usr &amp;&amp;
90make</userinput></screen>
91
92 <para>To test the results, issue: <command>make check</command>. Note that
93 if you have <application>Stunnel</application> and
94 <application>TCP Wrapper</application> installed and you wish to perform
95 the HTTPS tests, you'll need to have an unrestrictive
96 <filename>/etc/hosts.deny</filename> file.</para>
97
98 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
99
100<screen role='root'><userinput>make install &amp;&amp;
101find docs -name "Makefile*" -o -name "*.1" -o -name "*.3" | xargs rm &amp;&amp;
102install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
103cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
104
105 </sect2>
106
107 <sect2 role="commands">
108 <title>Command Explanations</title>
109
110 <para><option>--with-gssapi</option>:
111 This parameter adds <application>Kerberos 5</application> support to
112 <filename class="libraryfile">libcurl</filename>.</para>
113
114 <para><command>find docs -name "Makefile*" -o -name "*.1"
115 -o -name "*.3" | xargs rm</command>: This instruction removes files
116 that are not needed in /usr/share/doc/curl-&curl-version; to facilitate
117 copying appropriate files. The "*.1" and "*.3" files are installed
118 by the normal <command>make install</command>.</para>
119
120 </sect2>
121
122 <sect2 role="content">
123 <title>Contents</title>
124
125 <segmentedlist>
126 <segtitle>Installed Programs</segtitle>
127 <segtitle>Installed Library</segtitle>
128 <segtitle>Installed Directories</segtitle>
129
130 <seglistitem>
131 <seg>curl and curl-config</seg>
132 <seg>libcurl.{so,a}</seg>
133 <seg>/usr/include/curl, /usr/share/curl
134 and /usr/share/doc/curl-&curl-version;</seg>
135 </seglistitem>
136 </segmentedlist>
137
138 <variablelist>
139 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
140 <?dbfo list-presentation="list"?>
141 <?dbhtml list-presentation="table"?>
142
143 <varlistentry id="curl-prog">
144 <term><command>curl</command></term>
145 <listitem>
146 <para>is a client that can get documents from or send documents to
147 any of the following protocols: HTTP, HTTPS (needs <xref
148 linkend="openssl"/>), FTP, GOPHER, DICT, TELNET, LDAP (needs
149 <xref linkend="openldap"/> at run time) or FILE.</para>
150 <indexterm zone="curl curl-prog">
151 <primary sortas="b-curl">curl</primary>
152 </indexterm>
153 </listitem>
154 </varlistentry>
155
156 <varlistentry id="curl-config">
157 <term><command>curl-config</command></term>
158 <listitem>
159 <para>prints information about the last compile, like libraries
160 linked to and prefix setting.</para>
161 <indexterm zone="curl curl-config">
162 <primary sortas="b-curl-config">curl-config</primary>
163 </indexterm>
164 </listitem>
165 </varlistentry>
166
167 <varlistentry id="libcurl">
168 <term><filename class='libraryfile'>libcurl.{so,a}</filename></term>
169 <listitem>
170 <para>provides the API functions required by
171 <command>curl</command> and other programs.</para>
172 <indexterm zone="curl libcurl">
173 <primary sortas="c-libcurl">libcurl.{so,a}</primary>
174 </indexterm>
175 </listitem>
176 </varlistentry>
177
178 </variablelist>
179
180 </sect2>
181
182</sect1>
Note: See TracBrowser for help on using the repository browser.