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

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY curl-download-http "http://curl.haxx.se/download/curl-&curl-version;.tar.bz2">
  <!ENTITY curl-download-ftp  "ftp://gd.tuwien.ac.at/utils/archivers/curl/curl-&curl-version;.tar.bz2">
  <!ENTITY curl-md5sum        "d71b2ee8febfde2c7dc30a43638ec0d9">
  <!ENTITY curl-size          "1.4 MB">
  <!ENTITY curl-buildsize     "27.5 MB">
  <!ENTITY curl-time          "0.5 SBU (additional 0.8 SBU to run the test suite)">
]>

<sect1 id="curl" xreflabel="cURL-&curl-version;">
  <?dbhtml filename="curl.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>cURL-&curl-version;</title>

  <indexterm zone="curl">
    <primary sortas="a-cURL">cURL</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to cURL</title>

    <para>The <application>cURL</application> package contains
    <command>curl</command> and its support library. This is useful for
    transferring files with URL syntax.  This ability to both
    download and redirect files can be incorporated into other programs to support
    functions like streaming media.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Download (HTTP): <ulink url="&curl-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&curl-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &curl-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &curl-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &curl-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &curl-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">cURL Dependencies</bridgehead>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="pkgconfig"/>,
    <xref linkend="openssl"/> or
    <ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink>,
    <xref linkend="openldap"/>,
    <xref linkend="libidn"/>,
    <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
    <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
    <ulink url="http://www.vintela.com/resources/topics/spnego/">SPNEGO</ulink>, and
    <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink></para>

    <bridgehead renderas="sect4">Optional (for Running the Test Suite)</bridgehead>
    <para role="optional"><xref linkend="stunnel"/> (for running HTTPS and FTPS tests) and
    <ulink url="http://valgrind.kde.org/">Valgrind</ulink> (not used if building
    the shared library)</para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/curl"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of cURL</title>

    <para>Install <application>cURL</application> by running the following
    commands:</para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>To test the results, issue: <command>make check</command>. Note that
    if you have <application>Stunnel</application> and
    <application>TCP Wrapper</application> installed and you wish to perform
    the HTTPS tests, you'll need to have an unrestrictive
    <filename>/etc/hosts.deny</filename> file.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role='root'><userinput>make install &amp;&amp;
find docs -name "Makefile*" -o -name "*.1" -o -name "*.3" | xargs rm &amp;&amp;
install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><option>--with-gssapi</option>:
    This parameter adds <application>Kerberos 5</application> support to
    <filename class="libraryfile">libcurl</filename>.</para>

    <para><command>find docs -name "Makefile*" -o -name "*.1"
    -o -name "*.3" | xargs rm</command>: This instruction removes files
    that are not needed in /usr/share/doc/curl-&curl-version; to facilitate
    copying appropriate files.  The "*.1" and "*.3" files are installed
    by the normal <command>make install</command>.</para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>curl and curl-config</seg>
        <seg>libcurl.{so,a}</seg>
        <seg>/usr/include/curl, /usr/share/curl
        and /usr/share/doc/curl-&curl-version;</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="curl-prog">
        <term><command>curl</command></term>
        <listitem>
          <para>is a client that can get documents from or send documents to
          any of the following protocols: HTTP, HTTPS (needs <xref
          linkend="openssl"/>), FTP, GOPHER, DICT, TELNET, LDAP (needs
          <xref linkend="openldap"/> at run time) or FILE.</para>
          <indexterm zone="curl curl-prog">
            <primary sortas="b-curl">curl</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="curl-config">
        <term><command>curl-config</command></term>
        <listitem>
          <para>prints information about the last compile, like libraries
          linked to and prefix setting.</para>
          <indexterm zone="curl curl-config">
            <primary sortas="b-curl-config">curl-config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libcurl">
        <term><filename class='libraryfile'>libcurl.{so,a}</filename></term>
        <listitem>
          <para>provides the API functions required by
          <command>curl</command> and other programs.</para>
          <indexterm zone="curl libcurl">
            <primary sortas="c-libcurl">libcurl.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>