Changeset 355495ce for networking
- Timestamp:
- 07/19/2012 04:27:40 PM (12 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, 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/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- b24bfef
- Parents:
- ea16306
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
networking/netlibs/curl.xml
rea16306 r355495ce 5 5 %general-entities; 6 6 7 <!ENTITY curl-download-http 8 "http://curl.haxx.se/download/curl-&curl-version;.tar.bz2"> 9 <!--<!ENTITY curl-download-ftp 10 "ftp://gd.tuwien.ac.at/utils/archivers/curl/curl-&curl-version;.tar.bz2">--> 7 <!ENTITY curl-download-http "http://curl.haxx.se/download/curl-&curl-version;.tar.bz2"> 11 8 <!ENTITY curl-download-ftp " "> 12 <!ENTITY curl-md5sum " f0303d47d9d3e6e4f08c2863c6504823">9 <!ENTITY curl-md5sum "bfa80f01b3d300359cfb4d409b6136a3"> 13 10 <!ENTITY curl-size "2.4 MB"> 14 <!ENTITY curl-buildsize " 31MB">11 <!ENTITY curl-buildsize "28 MB"> 15 12 <!ENTITY curl-time "0.5 SBU"> 16 13 ]> … … 33 30 <title>Introduction to cURL</title> 34 31 35 <para>The <application>cURL</application> package contains 36 <command>curl</command> and its support library 37 <filename class="libraryfile">libcurl</filename>. This is useful for 38 transferring files with URL syntax to any of the following protocols: 39 FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, LDAP, LDAPS and FILE. 40 This ability to both download and upload files can be incorporated into 41 other programs to support functions like streaming media.</para> 32 <para> 33 The <application>cURL</application> package contains 34 <command>curl</command> and its support library 35 <filename class="libraryfile">libcurl</filename>. This is useful for 36 transferring files with URL syntax to any of the following protocols: 37 FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, LDAP, LDAPS 38 and FILE. This ability to both download and upload files can be 39 incorporated into other programs to support functions like streaming 40 media. 41 </para> 42 42 43 43 &lfs71_checked; … … 46 46 <itemizedlist spacing="compact"> 47 47 <listitem> 48 <para>Download (HTTP): <ulink url="&curl-download-http;"/></para> 49 </listitem> 50 <listitem> 51 <para>Download (FTP): <ulink url="&curl-download-ftp;"/></para> 52 </listitem> 53 <listitem> 54 <para>Download MD5 sum: &curl-md5sum;</para> 55 </listitem> 56 <listitem> 57 <para>Download size: &curl-size;</para> 58 </listitem> 59 <listitem> 60 <para>Estimated disk space required: &curl-buildsize;</para> 61 </listitem> 62 <listitem> 63 <para>Estimated build time: &curl-time;</para> 48 <para> 49 Download (HTTP): <ulink url="&curl-download-http;"/> 50 </para> 51 </listitem> 52 <listitem> 53 <para> 54 Download (FTP): <ulink url="&curl-download-ftp;"/> 55 </para> 56 </listitem> 57 <listitem> 58 <para> 59 Download MD5 sum: &curl-md5sum; 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Download size: &curl-size; 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Estimated disk space required: &curl-buildsize; 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 Estimated build time: &curl-time; 75 </para> 64 76 </listitem> 65 77 </itemizedlist> … … 67 79 <bridgehead renderas="sect3">cURL Dependencies</bridgehead> 68 80 81 <bridgehead renderas="sect4">Recommended</bridgehead> 82 <para role="recommended"> 83 <xref linkend="cacerts"/> and 84 <xref linkend="openssl"/> or <xref linkend="gnutls"/> 85 </para> 86 69 87 <bridgehead renderas="sect4">Optional</bridgehead> 70 <para role="optional"><!-- <xref linkend="pkgconfig"/>, --> 71 <xref linkend="openssl"/> or <xref linkend="gnutls"/>, 72 <xref linkend="openldap"/>, 73 <xref linkend="libidn"/>, 74 <xref linkend="mitkrb"/>, 75 <ulink url="http://www.libssh2.org">libssh2</ulink> 76 (for secure transfers), 77 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>, 78 <ulink 79 url="http://www.vintela.com/resources/topics/spnego/">SPNEGO</ulink>, and 80 <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink></para> 81 82 <bridgehead renderas="sect4">Optional for Running the Test 83 Suite</bridgehead> 84 <para role="optional"><xref linkend="stunnel"/> (for the HTTPS and FTPS 85 tests)</para> 88 <para role="optional"> 89 <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink>, 90 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>, 91 <xref linkend="libidn"/>, 92 <ulink url="http://www.libssh2.org">libssh2</ulink>, 93 <xref linkend="mitkrb"/>, 94 <xref linkend="openldap"/> and 95 <ulink url="http://www.vintela.com/resources/topics/spnego/"> 96 SPNEGO</ulink> 97 </para> 98 99 <bridgehead renderas="sect4">Optional for Running the Test Suite</bridgehead> 100 <para role="optional"> 101 <xref linkend="stunnel"/> (for the HTTPS and FTPS tests) 102 </para> 86 103 87 104 <para condition="html" role="usernotes">User Notes: 88 <ulink url="&blfs-wiki;/curl"/></para> 105 <ulink url="&blfs-wiki;/curl"/> 106 </para> 89 107 </sect2> 90 108 … … 92 110 <title>Installation of cURL</title> 93 111 94 <para>Install <application>cURL</application> by running the following 95 commands:</para> 112 <para> 113 Install <application>cURL</application> by running the following 114 commands: 115 </para> 96 116 97 117 <screen><userinput>sed -i '/--static-libs)/{N;s#echo .*#echo #;}' curl-config.in && … … 99 119 make</userinput></screen> 100 120 101 <para>To test the results, issue: <command>make check</command>. Note that 102 if you have <application>Stunnel</application> and 103 <application>TCP Wrapper</application> installed and you wish to perform 104 the HTTPS tests, you'll need to have an unrestrictive 105 <filename>/etc/hosts.deny</filename> file.</para> 106 107 <para>Now, as the <systemitem class="username">root</systemitem> 108 user:</para> 121 <para> 122 To test the results, issue: <command>make check</command>. Note that 123 if you have <application>Stunnel</application> and 124 <application>TCP Wrapper</application> installed and you wish to perform 125 the HTTPS tests, you'll need to have an unrestrictive 126 <filename>/etc/hosts.deny</filename> file. 127 </para> 128 129 <para> 130 Now, as the <systemitem class="username">root</systemitem> 131 user: 132 </para> 109 133 110 134 <screen role="root"><userinput>make install && … … 118 142 119 143 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 120 href="../../xincludes/static-libraries.xml"/>144 href="../../xincludes/static-libraries.xml"/> 121 145 122 146 <para> … … 127 151 </para> 128 152 129 <para><option>--with-ca-path=/etc/ssl/certs</option>: This option sets the 130 directory to use as the path to the SSL certificates. If you've not 131 installed <xref linkend="openssl"/> or <xref linkend="gnutls"/> and 132 the <xref linkend="cacerts"/> you can remove this option.</para> 133 134 <para><option>--with-gssapi</option>: 135 This parameter adds <application>Kerberos 5</application> support to 136 <filename class="libraryfile">libcurl</filename>.</para> 137 138 <para><option>--with-libssh2</option>: 139 This parameter adds SSH2 protocol support to 140 <filename class="libraryfile">libcurl</filename>.</para> 141 142 <para><option>--without-ssl --with-gnutls</option>: 143 To build with <application>GnuTLS</application> 144 support instead of <application>OpenSSL</application> for SSL/TLS.</para> 145 146 <para><command>find docs \( -name "Makefile*" -o -name "*.1" -o -name "*.3" 147 \) -exec rm {} \;</command>: This command removes 148 <filename>Makefiles</filename> and man files from the documentation 149 directory that would otherwise be installed by the commands that 150 follow.</para> 153 <para> 154 <parameter>--with-ca-path=/etc/ssl/certs</parameter>: This parameter 155 sets the directory to use as the path to the SSL certificates. 156 If you've not installed <xref linkend="openssl"/> or 157 <xref linkend="gnutls"/> and the <xref linkend="cacerts"/> you can 158 remove this option. 159 </para> 160 161 <para> 162 <option>--with-gssapi</option>: This parameter adds 163 <application>Kerberos 5</application> support to 164 <filename class="libraryfile">libcurl</filename>. 165 </para> 166 167 <para> 168 <option>--with-libssh2</option>: This parameter adds 169 SSH2 protocol support to 170 <filename class="libraryfile">libcurl</filename>. 171 </para> 172 173 <para> 174 <option>--without-ssl --with-gnutls</option>: Use to 175 build with <application>GnuTLS</application> support 176 instead of <application>OpenSSL</application> for SSL/TLS. 177 </para> 178 179 <para> 180 <command>find docs \( -name "Makefile*" -o -name "*.1" -o -name "*.3" 181 \) -exec rm {} \;</command>: This command removes 182 <filename>Makefiles</filename> and man files from the documentation 183 directory that would otherwise be installed by the commands that 184 follow. 185 </para> 186 151 187 </sect2> 152 188 … … 160 196 161 197 <seglistitem> 162 <seg>curl and curl-config</seg> 163 <seg>libcurl.so</seg> 164 <seg>/usr/include/curl and /usr/share/doc/curl-&curl-version;</seg> 198 <seg> 199 curl and curl-config 200 </seg> 201 <seg> 202 libcurl.so 203 </seg> 204 <seg> 205 /usr/include/curl and 206 /usr/share/doc/curl-&curl-version; 207 </seg> 165 208 </seglistitem> 166 209 </segmentedlist> … … 174 217 <term><command>curl</command></term> 175 218 <listitem> 176 <para>is a command line tool for transferring files with URL syntax. 219 <para> 220 is a command line tool for transferring files with URL syntax. 177 221 </para> 178 222 <indexterm zone="curl curl-prog"> … … 185 229 <term><command>curl-config</command></term> 186 230 <listitem> 187 <para>prints information about the last compile, like libraries 188 linked to and prefix setting.</para> 231 <para> 232 prints information about the last compile, like libraries 233 linked to and prefix setting. 234 </para> 189 235 <indexterm zone="curl curl-config"> 190 236 <primary sortas="b-curl-config">curl-config</primary> … … 196 242 <term><filename class="libraryfile">libcurl.so</filename></term> 197 243 <listitem> 198 <para>provides the API functions required by 199 <command>curl</command> and other programs.</para> 244 <para> 245 provides the API functions required by 246 <command>curl</command> and other programs. 247 </para> 200 248 <indexterm zone="curl libcurl"> 201 249 <primary sortas="c-libcurl">libcurl.so</primary> … … 203 251 </listitem> 204 252 </varlistentry> 253 205 254 </variablelist> 206 </sect2> 255 256 </sect2> 257 207 258 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.