 @@ -1,24 +1,25 @@
 FETCH(3)                NetBSD Library Functions Manual               FETCH(3)
 NNAAMMEE
      ffeettcchhMMaakkeeUURRLL, ffeettcchhPPaarrsseeUURRLL, ffeettcchhCCooppyyUURRLL, ffeettcchhFFrreeeeUURRLL, ffeettcchhXXGGeettUURRLL,
      ffeettcchhGGeettUURRLL, ffeettcchhPPuuttUURRLL, ffeettcchhSSttaattUURRLL, ffeettcchhLLiissttUURRLL, ffeettcchhXXGGeett,
      ffeettcchhGGeett, ffeettcchhPPuutt, ffeettcchhSSttaatt, ffeettcchhLLiisstt, ffeettcchhXXGGeettFFiillee, ffeettcchhGGeettFFiillee,
      ffeettcchhPPuuttFFiillee, ffeettcchhSSttaattFFiillee, ffeettcchhLLiissttFFiillee, ffeettcchhXXGGeettHHTTTTPP, ffeettcchhGGeettHHTTTTPP,
      ffeettcchhPPuuttHHTTTTPP, ffeettcchhSSttaattHHTTTTPP, ffeettcchhLLiissttHHTTTTPP, ffeettcchhXXGGeettFFTTPP, ffeettcchhGGeettFFTTPP,
      ffeettcchhPPuuttFFTTPP, ffeettcchhSSttaattFFTTPP, ffeettcchhLLiissttFFTTPP ffeettcchhIInniittUURRLLLLiisstt,
      ffeettcchhFFrreeeeUURRLLLLiisstt, ffeettcchhUUnnqquuootteePPaatthh, ffeettcchhUUnnqquuootteeFFiilleennaammee,
-     ffeettcchhSSttrriinnggiiffyyUURRLL, ffeettcchh -- file transfer functions
+     ffeettcchhSSttrriinnggiiffyyUURRLL, ffeettcchhCCoonnnneeccttiioonnCCaacchheeIInniitt, ffeettcchhCCoonnnneeccttiioonnCCaacchheeCClloossee,
      ffeettcchh -- file transfer functions
 LLIIBBRRAARRYY
                File Transfer Library for URLs (libfetch, -lfetch)
 SSYYNNOOPPSSIISS
      ##iinncclluuddee <<ssttddiioo..hh>>
      ##iinncclluuddee <<ffeettcchh..hh>>
      _s_t_r_u_c_t _u_r_l _*
      ffeettcchhMMaakkeeUURRLL(_c_o_n_s_t _c_h_a_r _*_s_c_h_e_m_e, _c_o_n_s_t _c_h_a_r _*_h_o_s_t, _i_n_t _p_o_r_t,
          _c_o_n_s_t _c_h_a_r _*_d_o_c, _c_o_n_s_t _c_h_a_r _*_u_s_e_r, _c_o_n_s_t _c_h_a_r _*_p_w_d);
      _s_t_r_u_c_t _u_r_l _*
 @@ -113,26 +114,32 @@ SSYYNNOOPPSSIISS
      _v_o_i_d
      ffeettcchhFFrreeeeUURRLLLLiisstt(_s_t_r_u_c_t _u_r_l___l_i_s_t _*_u_l);
      _c_h_a_r _*
      ffeettcchhUUnnqquuootteePPaatthh(_s_t_r_u_c_t _u_r_l _*_u);
      _c_h_a_r _*
      ffeettcchhUUnnqquuootteeFFiilleennaammee(_s_t_r_u_c_t _u_r_l _*_u);
      _c_h_a_r _*
      ffeettcchhSSttrriinnggiiffyyUURRLL(_c_o_n_s_t _s_t_r_u_c_t _u_r_l _*_u);
      _v_o_i_d
      ffeettcchhCCoonnnneeccttiioonnCCaacchheeIInniitt(_i_n_t _g_l_o_b_a_l, _i_n_t _p_e_r___h_o_s_t);
      _v_o_i_d
      ffeettcchhCCoonnnneeccttiioonnCCaacchheeCClloossee(_v_o_i_d);
 DDEESSCCRRIIPPTTIIOONN
      These functions implement a high-level library for retrieving and upload-
      ing files using Uniform Resource Locators (URLs).
      ffeettcchhPPaarrsseeUURRLL() takes a URL in the form of a null-terminated string and
      splits it into its components function according to the Common Internet
      Scheme Syntax detailed in RFC 1738.  A regular expression which produces
      this syntax is:
            <scheme>:(//(<user>(:<pwd>)?@)?<host>(:<port>)?)?/(<document>)?
      If the URL does not seem to begin with a scheme name, it is assumed to be
      a local path.  Only absolute path names are accepted.
 @@ -197,39 +204,46 @@ DDEESSCCRRIIPPTTIIOONN
      ffeettcchhLLiissttUURRLL() attempts to list the contents of the directory pointed to
      by the URL provided.  The pattern can be a simple glob-like expression as
      hint.  Callers should not depend on the server to filter names.  If suc-
      cessful, it appends the list of entries to the _u_r_l___l_i_s_t structure.  The
      _u_r_l___l_i_s_t structure is defined as follows in <_f_e_t_c_h_._h>:
      struct url_list {
          size_t      length;
          size_t      alloc_size;
          struct url  *urls;
      };
      The list should be initialized by calling ffeettcchhIInniittUURRLLLLiisstt() and the
-     entries be freed by calling ffeettcchhFFrreeeeUURRLLLLiisstt().  The functio
+     entries be freed by calling ffeettcchhFFrreeeeUURRLLLLiisstt().  The function
      ffeettcchhAAppppeennddUURRLLLLiisstt() can be used to append one URL lists to another.  If
      the `c' (cache result) flag is specified, the library is allowed to
      internally cache the result.
      ffeettcchhSSttrriinnggiiffyyUURRLL() returns the URL as string.  ffeettcchhUUnnqquuootteePPaatthh()
      returns the path name part of the URL with any quoting undone.  Query
      arguments and fragment identifiers are not included.
      ffeettcchhUUnnqquuootteeFFiilleennaammee() returns the last component of the path name as
      returned by ffeettcchhUUnnqquuootteePPaatthh().  ffeettcchhSSttrriinnggiiffyyUURRLL(), ffeettcchhUUnnqquuootteePPaatthh(),
      and ffeettcchhUUnnqquuootteeFFiilleennaammee() return a string that should be deallocated
      with ffrreeee() after use.
      ffeettcchhCCoonnnneeccttiioonnCCaacchheeIInniitt() enables the connection cache.  The first argu-
      ment specifies the global limit on cached connections.  The second argu-
      ment specifies the host limit.  Entries are considered to specify the
      same host, if the host name from the URL is identical, indepent of the
      address or address family.  ffeettcchhCCoonnnneeccttiioonnCCaacchheeCClloossee() flushed the con-
      nection cache and closes all cached connections.
      ffeettcchhXXGGeett(), ffeettcchhGGeett(), ffeettcchhPPuutt(), and ffeettcchhSSttaatt() are similar to
      ffeettcchhXXGGeettUURRLL(), ffeettcchhGGeettUURRLL(), ffeettcchhPPuuttUURRLL(), and ffeettcchhSSttaattUURRLL(), except
      that they expect a pre-parsed URL in the form of a pointer to a _s_t_r_u_c_t
      _u_r_l rather than a string.
      All of the ffeettcchhXXGGeettXXXXXX(), ffeettcchhGGeettXXXXXX(), and ffeettcchhPPuuttXXXXXX() functions
      return a pointer to a stream which can be used to read or write data from
      or to the requested document, respectively.  Note that although the
      implementation details of the individual access methods vary, it can gen-
      erally be assumed that a stream returned by one of the ffeettcchhXXGGeettXXXXXX() or
      ffeettcchhGGeettXXXXXX() functions is read-only, and that a stream returned by one
      of the ffeettcchhPPuuttXXXXXX() functions is write-only.
 @@ -499,14 +513,14 @@ BBUUGGSS
      superfluous at this site" in an FTP context and "Accepted" in an HTTP
      context.
      ffeettcchhSSttaattFFTTPP() does not check that the result of an MDTM command is a
      valid date.
      The man page is incomplete, poorly written and produces badly formatted
      text.
      The error reporting mechanism is unsatisfactory.
      Some parts of the code are not fully reentrant.
-NetBSD 5.0                     February 4, 2009                     NetBSD 5.0
+NetBSD 5.0                     January 22, 2010                     NetBSD 5.0