fget - Commandline FTP Utility
====

fget is an FTP analog of the GNU wget program.  It handles intelligent
mirroring of remote FTP sites.


Installation
------------

To build fget, you should be able to simply run these commands:

   ./configure
   make
   make install


Encap Package Support
---------------------

To build this software as an Encap package, you can pass the
--enable-encap option to configure.  This will be automatically
enabled if the epkg or mkencap programs are detected on the system,
but can be overridden by the --disable-encap option.

When building an Encap package, the configure script will automatically
adjust the installation prefix to use an appropriate Encap package
directory.  It does this using a heuristic algorithm which examines the
values of the ${ENCAP_SOURCE} and ${ENCAP_TARGET} environment variables
and the argument to configure's --prefix option.

If mkencap was detected on the system, it will be automatically run during
"make install".  By default, epkg will also be run, but this can be
inhibited with the --disable-epkg-install configure option.

For information on the Encap package management system, see the WSG
Encap Archive:

   http://www.encap.org/


Test Suite
----------

To run the libfget test suite, you must extract the file
test/libfget_test.tgz into the content tree of an FTP server.  Then,
you can run the test suite like this:

  make test TEST_URL=<url>

Replace "<url>" with the URL of the FTP server and directory where
you extracted the test files.


More Information
----------------

For documentation of the libfget API or the fget utility, see the
enclosed manpages.  For more information on the fget package, see:

   http://www.feep.net/fget/

Source code for the latest version of fget will be available there, as
well as Encap binary distributions for many common platforms.


Supported Platforms
-------------------

I develop and test fget under RedHat Linux 9.  I would like to test it
under other platforms, but I no longer have access to other types of
machines.  If you would like me to test new fget releases on a different
platform and are able to give me an account on a machine where I can
test it, please send me email (email address below).

The fget code was reported at one time or another to build properly on
the following platforms, but I can not currently support them:

   AIX 3.2.5, 4.2.1, 4.3.3, and 5.1
   Cygwin 1.3.17
   FreeBSD
   HP-UX 10.20 and 11.00
   IRIX 6.5
   RedHat Linux 7.x, 8.x
   OpenBSD
   Solaris 2.5, 2.6, 7, 8, and 9

If you successfully build fget on another platform, please email me a
patch and/or configuration information.


Compatibility Code
------------------

fget depends on some library calls which are not available or not
usable on some platforms.  To accomodate these systems, I've included
a version of these calls in the compat subdirectory.

I've slightly modified these functions for integration into this source
tree, but the functionality has not been modified from the original
source.  Please note that while this code should work for you, I didn't
write it, so please don't send me bug reports on it.


Author
------

Feedback and bug reports are welcome.

Mark D. Roth <roth@feep.net>