packages icon
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

Please note that I use gcc and GNU make to build fget.  While I try to
make the code portable enough for vendor compilers, I don't regularly
test it with them, so YMMV.


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, according to the following rules:

 1) If --prefix was specified, use "${prefix}/encap/${package}-${version}"
 2) If ${ENCAP_SOURCE} is set, use "${ENCAP_SOURCE}/${package}-${version}"
 3) If ${ENCAP_TARGET} is set, use "${ENCAP_TARGET}/encap/${package}-${version}"
 4) Otherwise, use "${default_prefix}/encap/${package}-${version}"

Bear these rules in mind when specifying a --prefix argument, as it may
not do exactly what you expect.

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/


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

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

   http://www-dev.cso.uiuc.edu/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 on the following platforms:

   AIX 4.3.3
   HP-UX 11.00
   IRIX 6.5
   RedHat Linux 6.2
   Solaris 8

The fget code should build properly on the following platforms, but I
do not actively support them:

   AIX 3.2.5
   AIX 4.2.1
   FreeBSD
   HP-UX 10.20
   Linux/libc5
   OpenBSD
   Solaris 2.5
   Solaris 2.6
   Solaris 7

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 lib/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@uiuc.edu>
Computing and Communications Services Office
University of Illinois at Urbana-Champaign