Windows Sockets FTP Client Application - WS_FTP and WS_FTP32 Copyright (C) 1994-1995 by John A. Junod. All rights reserved. (PLEASE REVIEW THE ENTIRE CONTENTS OF THIS FILE!!!!) THE INFORMATION AND CODE PROVIDED IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL JOHN A. JUNOD BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF JOHN A. JUNOD HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ********************************************************************** * This program executable, help file and related text files may be * * used without fee by any United States Government organization, * * by individuals for non-commercial home use, and by students, * * faculty and staff of academic institutions. * * * * U.S. Government use: Free * * Non-commercial home use: Free * * Academic use: Free * * All other uses: Contact Ipswitch, Inc. for license information * * * * Archive sites: This program may be included on U.S. Government, * * academic and non-commercial Internet archive sites and on CD-ROM * * collections distributed by such sites, provided any charge is * * solely to recover the cost of distribution. Any such * * distribution must contain the complete program, including this * * file. Non-commercial Internet archive sites must not be in the * * business of making a profit from selling hardware, software, * * information or services. (SimTel and mirrors authorized) * * * * For distribution rights and for all other uses, including * * all corporate use, please contact Ipswitch, Inc. at * * or (617) 676-5700 for license information. * * Ipswitch may also be contacted via mail at 81 Hartwell Ave., * * Lexington, MA 02173 or fax at (617) 676-5710. * * * * Ipswitch, Inc. develops and sells a family of TCP/IP products * * for a range of PC platforms: Acadia/VxD for Windows, Piper/IP * * for DOS and Windows, Vantage/IP for OS/2, the Catipult Netware * * to TCP/IP gateway, IMail electronic mail for Windows and INews * * network news for Windows. * ********************************************************************** DESCRIPTION: ============ This application is a standard File Transfer Protocol (FTP) client application for Windows Sockets. The user interface for this FTP client is designed with the novice FTP user in mind. Usage should be obvious. For more information on FTP please refer to the many different NETNEWS groups or one of the recent books on the Internet. WS_FTP also provides for automatic downloads of files. See HLP file for information on "Auto Transfer of Files". WS_FTP32 is the 32 bit version of WS_FTP for Windows NT and Windows 3.x with Win32s. The benefit of running WS_FTP32 vs WS_FTP is unknown on the Windows 3.x platform (other than it is 32 bit code). The benefit of running WS_FTP32 on Windows NT or Windows 95 is that it is multi-threaded on these platforms. If you have problems with WS_FTP32 under Win32s, please try using the 16 bit version of WS_FTP. REQUIREMENTS: ============= WS_FTP requires you to have a properly installed WINSOCK.DLL and requires Windows 3.1 or later. If you don't have a WINSOCK.DLL, I'd suggest getting the free one from Microsoft or the shareware Trumpet Winsock from ftp.trumpet.com.au or buying a vendor supported one from Ipswitch, Inc. or from FTP Software, Inc. WS_FTP32 requires Windows NT, Windows 95 or Win32s 1.15 (or later) Windows NT and Windows 95 come with a WINSOCK.DLL. If you use a different vendors stack on these platforms you will need to replace the WSOCK32.DLL that comes with the OS. WS_FTP requires a 286 processor. WS_FTP32 requires a 386 processor. INSTALLATION: ============= YOU MUST HAVE A PROPERLY INSTALLED WINSOCK.DLL FOR THIS APPLICATION TO WORK. REFER TO YOUR WINSOCK.DLL DOCUMENTATION FOR SETUP!! 1. Create a directory for this program and copy WS_FTP.EXE, WS_FTP.INI, WS_FTP.EXT and WS_FTP.HLP to that directory. 2. Create an ICON in any Program Manager group. a. Use the File Manager and drag the program into a Program Manager group. b. Use [F]ile [N]ew in the Program Manager. UPDATING FROM PREVIOUS VERSIONS: ================================ PLEASE KEEP YOUR OLD WS_FTP.INI FILE!!!! If you have problems with this version, edit your old INI file and delete the [_config_] section and restart WS_FTP. VALID COMMAND LINE OPTIONS: =========================== -i inifile (must be first in the line!) -p profile_name (cannot be used with gets or puts!) -ask (prompt for command line) ftp://remotehost/pathname/filename [local:/pathname/filename] [-ascii] file://remotehost/pathname/filename [local:/pathname/filename] [-ascii] //remotehost/pathname/filename [local:/pathname/filename] [-ascii] remotehost:/pathname/filename [local:/pathname/filename] [-ascii] local:/pathname/filename //remotehost/pathname/filename [-ascii] local:/pathname/filename remotehost:/pathname/filename [-ascii] WHERE TO GET IT =============== (Stable release versions) ftp://winftp.cica.indiana.edu/pub/pc/win3/winsock/ws_ftp.zip ftp://winftp.cica.indiana.edu/pub/pc/win3/winsock/ws_ftp32.zip on Compuserve in WINCON library 11 (support provided in this area) (first updates, test versions, frequent updates) ftp://ftp.usma.edu/pub/msdos/winsock.files/ws_ftp.zip ftp://ftp.usma.edu/pub/msdos/winsock.files/ws_ftp32.zip http://www.csra.net/junodj/ (commercial versions) contact Ipswitch, Inc. at (617)-676-5700 or FAX:617-676-5710 or by E-Mail at SUPPORT ======= ALL beginner support is provided through Compuserve in the WINCON area. Please do NOT send "how do I use ws_ftp" questions to the author. I will NOT respond. ALL bug reports and suggestions for improvement should be sent to or ALL distribution, commercial purchase requests need to be sent to BUG REPORTS, SUGGESTIONS, ETC... ================================ If you connect to a host that WS_FTP doesn't recognize (i.e. listboxes remain blank or are displayed incorrectly). 1. Try the different host types that are listed in the options dialog box. (the change takes affect immediately, you do not need to change directories, etc..) 2. If you can't find one that displays the directory correctly, then: a. click on the LogWnd button and save the message log to a file b. click on the remote side DirInfo button and save the contents to a different file. c. mail both files to "junodj@martinez.ipswitch.com" Send all bug reports, suggestions, etc to "junodj@martinez.ipswitch.com" or to "junodj@csra.net" If you like this program, let other people know about it! Post your comments in comp.protocol.tcp-ip.ibmpc, alt.winsock and in the windows groups on usenet and places like compuserve. Let people know about it! KNOWN PROBLEMS ============== Many internet providers require you to use PASV mode in order for WS_FTP to work properly. If you always get "Dirlist returned 0", try changing this setting under Advanced in the Connect dialog or in Session Options. This is NOT a true problem in WS_FTP but is a requirement of your network provider. Some versions of the Trumpet Winsock DLL require you to use PASV mode. See the above note. You MAY need to use PASV mode when using TIA. See the above note. WS_FTP does not work properly under some versions of the SPRY stack. You need to contact SPRY to get an upgraded stack that is Winsock compliant. WS_FTP32 does not work properly when using the 16 bit version of Chameleon or Trumpet Winsock on Windows NT or Windows 95. You need to replace the WSOCK32.DLL provided by Microsoft with one from the network stack vendor. Author ====== John A. Junod Internet: 267 Hillwood Street Martinez, GA 30907 Compuserve: 72321,366 (706)-780-2671