The obligatory revision history... Changes from V3.1 to V3.1-1 1) Delay setting the control handle pointer in the data handle until after the transfer request has received a positive acknowledgement. This should resolve problems calling FtpClose() on the data handle when the transfer is rejected. 2) Fix error handling in FtpRead() and FtpWrite(). 3) Return status of transfer from FtpXfer() instead of status of FtpClose(). 4) Allow FtpClose() to be called on a control handle. This should be used instead of FtpQuit() in cases where a transfer was interrupted. FtpQuit() would attempt to send a 'QUIT' command and wait for a response but this would be out of sync after an interrupt. 5) The idle callback routine was not being set in the data handle if the user didn't set FTPLIB_IDLETIME. Fixed this so it would get set up if either this or FTPLIB_CALLBACKBYTES was set. 6) Open local files in binary mode when appropriate. This is necessary on some systems like NT and VMS. Changes from 12/2/97 (V3) to .... (V3.1) 1) Added FtpPwd(), FtpSysType(), FtpCDUp(), FtpSize() and FtpModDate(). 2) Fixed bug in FtpClose() - It wasn't waiting for the '226 Transfer Complete' since it didn't have access to the control connection. A pointer to it is now kept in the data connection. 3) Fixed bug in FtpClose() - The data connection wasn't being freed. This could have resulted in memory leaks. 4) Allow runtime selection of connection mode (PORT/PASV) with default set at compile time. 5) Added support for a user callback routine which can get called after a user specified number of bytes are transferred or after waiting for data on a socket for a user specified time period. 6) Add FtpOptions() which allows changing connection options. Options include connection mode, callback routine, and parameters regarding when the user's callback routine gets called. 7) Added checks to make sure strcpy()/sprintf()/etc. wouldn't write past end of buffers. 8) Modified build procedure to create a shared library. 9) Added install option to makefile which installs under /usr/local. 10) Modified qftp to use new interface. 11) Modified qftp to log progress every 10% of file or every time data is delayd by 1 second if -v setting is not zero. 12) Modified qftp to use fgets() instead of gets(). ------------------------------------------------------------------------ Changes from 3/15/97 to 12/2/97 1) FtpLastResponse() returns NULL if passed a NULL pointer. 2) Added 'const' keyword on appropriate function arguments. 3) First attempt to translate passed host string as an IP address in dot notation by passing it to inet_addr(). If this fails, pass the string to gethostbyname(). Apparently, some versions of gethostbyname() will parse the translation of a dot notation address for you. One user reports he knows of at least one that does not. In any case, it's the right thing to do. 4) Added protection from double inclusion to header file. Also added 'extern "C"' for C++. 5) Made sure qftp was passed two arguments before examining the second one. 6) Made sure all commands to the server were in upper case. I've been told that some servers require this. 7) Attempt to handle login to accounts with no passwords. 8) Added common data transfer routines so that ascii mode transfers would be handled properly in all cases. Also, exposed these routines for user programs to call. There's now FtpAccess() to open a remote file or directory, FtpRead() and FtpWrite() to pass data, and FtpClose() to terminate the data connection. 9) Added 'list' command to qftp to perform a terse directory (names only). This could be piped into another copy of qftp to retrieve the files. 10) ftplib.c and ftplib.h are now covered by the LGPL instead of the GPL. Feel free to send me a complementary copy of anything you develop commercially with my libraries. All other programs are still covered by the GPL. 11) Added ability to specify a different port number than the default by appending a colon and the desired port number to the remote host name (e.g., remote.host.name:500 would connect to port remote.host.name on port 500). ------------------------------------------------------------------------ Changes from 8/31/96 version to 3/15/97 version 1) Added copyright information to sources. 2) Changed from 'port' to 'pasv' which I'm told will allow the routines to work from behind a firewall. It's also a lot simpler and cleaner than all that code to setup and accept a connect from the server. 3) Added delete (ftprm) support to qftp.c. 4) Modified qftp to allow use without a softlink by passing the ftp command as the first argument. 5) Added netbuf argument to all calls to eliminate static storage and allow multiple simultaneous connections. 6) Renamed routines from ftp*() to Ftp*() to avoid problems with existing programs. Added macros in libftp.h to support old interface. Renamed ftpOpen() to FtpConnect().