Changeset bf8ac01


Ignore:
Timestamp:
04/29/2005 05:39:00 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 6.1, 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, kea, ken/inkscape-core-mods, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
ef8b91c2
Parents:
38ef567
Message:

Tagged curl.xml.

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • basicnet/netlibs/curl.xml

    r38ef567 rbf8ac01  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
    12<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    23   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    … …  
    1314
    1415<sect1 id="curl" xreflabel="cURL-&curl-version;">
    15 <sect1info>
    16 <othername>$LastChangedBy$</othername>
    17 <date>$Date$</date>
    18 </sect1info>
    19 <?dbhtml filename="curl.html"?>
    20 <title>cURL-&curl-version;</title>
    21 <indexterm zone="curl">
    22 <primary sortas="a-CURL">CURL</primary></indexterm>
    23 
    24 <sect2>
    25 <title>Introduction to <application>cURL</application></title>
    26 
    27 <para>The <application>cURL</application> package contains
    28 <command>curl</command> and its support library. This is useful for
    29 transferring files with <acronym>URL</acronym> syntax.  This ability to both
    30 download and redirect files can be incorporated into other programs to support
    31 functions like streaming media.</para>
    32 
    33 <sect3><title>Package information</title>
    34 <itemizedlist spacing='compact'>
    35 <listitem><para>Download (HTTP):
    36 <ulink url="&curl-download-http;"/></para></listitem>
    37 <listitem><para>Download (FTP):
    38 <ulink url="&curl-download-ftp;"/></para></listitem>
    39 <listitem><para>Download MD5 sum: &curl-md5sum;</para></listitem>
    40 <listitem><para>Download size: &curl-size;</para></listitem>
    41 <listitem><para>Estimated disk space required:
    42 &curl-buildsize;</para></listitem>
    43 <listitem><para>Estimated build time:
    44 &curl-time;</para></listitem></itemizedlist>
    45 </sect3>
    46 
    47 <sect3><title><application>cURL</application> dependencies</title>
    48 <sect4><title>Optional</title>
    49 <para><xref linkend="pkgconfig"/>,
    50 <xref linkend="openssl"/>,
    51 <xref linkend="openldap"/>,
    52 <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
    53 <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
    54 <ulink url="http://www.gnu.org/software/libidn/">Libidn</ulink>,
    55 <ulink url="http://www.vintela.com/resources/topics/spnego/">SPNEGO</ulink> and
    56 <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink></para>
    57 </sect4>
    58 
    59 <sect4><title>Optional (for running the test suite)</title>
    60 <para><xref linkend="stunnel"/> (for running <acronym>HTTPS</acronym> and
    61 <acronym>FTPS</acronym> tests) and
    62 <ulink url="http://valgrind.kde.org/">Valgrind</ulink> (not used if building
    63 the shared library)</para>
    64 </sect4>
    65 </sect3>
    66 
    67 </sect2>
    68 
    69 <sect2>
    70 <title>Installation of <application>cURL</application></title>
    71 
    72 <para>Install <application>cURL</application> by running the following
    73 commands:</para>
    74 
    75 <screen><userinput><command>./configure --prefix=/usr &amp;&amp;
    76 make</command></userinput></screen>
    77 
    78 <para>If you wish to run the testsuite, use the following commands to fix a
    79 bug in the test script and then run the tests:</para>
    80 
    81 <screen><userinput><command>sed -i -e 's/^require "valgrind.pm"/# &amp;/' tests/runtests.pl &amp;&amp;
    82 make check</command></userinput></screen>
    83 
    84 <para>Now, as the root user:</para>
    85 
    86 <screen><userinput role='root'><command>make install &amp;&amp;
     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">TEMPLATE Dependencies</bridgehead>
     61   
     62    <bridgehead renderas="sect4">Optional</bridgehead>
     63    <para><xref linkend="pkgconfig"/>,
     64    <xref linkend="openssl"/>,
     65    <xref linkend="openldap"/>,
     66    <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
     67    <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>,
     68    <ulink url="http://www.gnu.org/software/libidn/">Libidn</ulink>,
     69    <ulink url="http://www.vintela.com/resources/topics/spnego/">SPNEGO</ulink> and
     70    <ulink url="http://daniel.haxx.se/projects/c-ares/">c-ares</ulink></para>
     71   
     72    <bridgehead renderas="sect4">Optional (for running the test suite)</bridgehead>
     73    <para><xref linkend="stunnel"/> (for running HTTPS and FTPS tests) and
     74    <ulink url="http://valgrind.kde.org/">Valgrind</ulink> (not used if building
     75    the shared library)</para>
     76   
     77  </sect2>
     78 
     79  <sect2 role="installation">
     80    <title>Installation of CURL</title>
     81   
     82    <para>Install <application>cURL</application> by running the following
     83    commands:</para>
     84   
     85<screen><userinput>./configure --prefix=/usr &amp;&amp;
     86make</userinput></screen>
     87   
     88    <para>If you wish to run the testsuite, use the following commands to fix a
     89    bug in the test script and then run the tests:</para>
     90   
     91<screen><userinput>sed -i -e 's/^require "valgrind.pm"/# &amp;/' tests/runtests.pl &amp;&amp;
     92make check</userinput></screen>
     93   
     94    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     95   
     96<screen role='root'><userinput>make install &amp;&amp;
    8797find docs -name "Makefile*" \
    88        -o -name "*.1" \
    89        -o -name "*.3" | xargs rm &amp;&amp;
     98    -o -name "*.1" \
     99    -o -name "*.3" | xargs rm &amp;&amp;
    90100install -v -d -m755 /usr/share/doc/curl-&curl-version; &amp;&amp;
    91 cp -v -R docs/* /usr/share/doc/curl-&curl-version;</command></userinput></screen>
    92 
    93 </sect2>
    94 
    95 <sect2>
    96 <title>Command explanations</title>
    97 
    98 <para><option>--with-gssapi</option>:
    99 This parameter adds <application>Kerberos 5</application> support to
    100 <filename class="libraryfile">libcurl</filename>.</para>
    101 
    102 </sect2>
    103 
    104 <sect2>
    105 <title>Contents</title>
    106 
    107 <segmentedlist>
    108 <segtitle>Installed Programs</segtitle>
    109 <segtitle>Installed Library</segtitle>
    110 <segtitle>Installed Directories</segtitle>
    111 
    112 <seglistitem>
    113 <seg>curl and curl-config</seg>
    114 <seg>libcurl.[so,a]</seg>
    115 <seg>/usr/include/curl, /usr/share/curl
    116 and /usr/share/doc/curl-&curl-version;</seg>
    117 </seglistitem>
    118 </segmentedlist>
    119 
    120 <variablelist>
    121 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    122 <?dbfo list-presentation="list"?>
    123 
    124 <varlistentry id="curl-prog">
    125 <term><command>curl</command></term>
    126 <listitem><para>is a client that can get documents from or send documents to
    127 any of the following protocols: <acronym>HTTP</acronym>,
    128 <acronym>HTTPS</acronym> (needs <xref linkend="openssl"/>),
    129 <acronym>FTP</acronym>, GOPHER, DICT, TELNET, <acronym>LDAP</acronym> (needs
    130 <xref linkend="openldap"/> at run time) or FILE.</para>
    131 <indexterm zone="curl curl-prog">
    132 <primary sortas="b-curl">curl</primary>
    133 </indexterm></listitem>
    134 </varlistentry>
    135 
    136 <varlistentry id="curl-config">
    137 <term><command>curl-config</command></term>
    138 <listitem><para>prints information about the last compile, like libraries
    139 linked to and prefix setting.</para>
    140 <indexterm zone="curl curl-config">
    141 <primary sortas="b-curl-config">curl-config</primary>
    142 </indexterm></listitem>
    143 </varlistentry>
    144 
    145 <varlistentry id="libcurl">
    146 <term><filename class='libraryfile'>libcurl.[so,a]</filename></term>
    147 <listitem><para>provides the <acronym>API</acronym> functions required by
    148 <command>curl</command> and other programs.</para>
    149 <indexterm zone="curl libcurl">
    150 <primary sortas="c-libcurl">libcurl.[so,a]</primary>
    151 </indexterm></listitem>
    152 </varlistentry>
    153 </variablelist>
    154 
    155 </sect2>
    156 
     101cp -v -R docs/* /usr/share/doc/curl-&curl-version;</userinput></screen>
     102   
     103  </sect2>
     104 
     105  <sect2 role="commands">
     106    <title>Command Explanations</title>
     107   
     108    <para><option>--with-gssapi</option>:
     109    This parameter adds <application>Kerberos 5</application> support to
     110    <filename class="libraryfile">libcurl</filename>.</para>
     111   
     112  </sect2>
     113 
     114  <sect2 role="content">
     115    <title>Contents</title>
     116   
     117    <segmentedlist>
     118      <segtitle>Installed Programs</segtitle>
     119      <segtitle>Installed Library</segtitle>
     120      <segtitle>Installed Directories</segtitle>
     121     
     122      <seglistitem>
     123        <seg>curl and curl-config</seg>
     124        <seg>libcurl.[so,a]</seg>
     125        <seg>/usr/include/curl, /usr/share/curl
     126        and /usr/share/doc/curl-&curl-version;</seg>
     127      </seglistitem>
     128    </segmentedlist>
     129   
     130    <variablelist>
     131      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     132      <?dbfo list-presentation="list"?>
     133      <?dbhtml list-presentation="table"?>
     134     
     135      <varlistentry id="curl-prog">
     136        <term><command>curl</command></term>
     137        <listitem>
     138          <para>is a client that can get documents from or send documents to
     139          any of the following protocols: HTTP, HTTPS (needs <xref
     140          linkend="openssl"/>), FTP, GOPHER, DICT, TELNET, LDAP (needs
     141          <xref linkend="openldap"/> at run time) or FILE.</para>
     142          <indexterm zone="curl curl-prog">
     143            <primary sortas="b-curl">curl</primary>
     144          </indexterm>
     145        </listitem>
     146      </varlistentry>
     147     
     148      <varlistentry id="curl-config">
     149        <term><command>curl-config</command></term>
     150        <listitem>
     151          <para>prints information about the last compile, like libraries
     152          linked to and prefix setting.</para>
     153          <indexterm zone="curl curl-config">
     154            <primary sortas="b-curl-config">curl-config</primary>
     155          </indexterm>
     156        </listitem>
     157      </varlistentry>
     158     
     159      <varlistentry id="libcurl">
     160        <term><filename class='libraryfile'>libcurl.[so,a]</filename></term>
     161        <listitem>
     162          <para>provides the API functions required by
     163          <command>curl</command> and other programs.</para>
     164          <indexterm zone="curl libcurl">
     165            <primary sortas="c-libcurl">libcurl.[so,a]</primary>
     166          </indexterm>
     167        </listitem>
     168      </varlistentry>
     169     
     170    </variablelist>
     171   
     172  </sect2>
     173 
    157174</sect1>
    158175
Note: See TracChangeset for help on using the changeset viewer.