Windows Sockets FTP Client Application - WS_FTP - Version 95.01.22 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 * * distributed freely and may be used without fee by any individual * * for non-commercial use and by any United States Government * * organization. * * * * Non-commercial use: free * * * * U.S. Government use: free * * * * Commercial use: Contact Ipswitch, Inc. at * * or (617)-246-1150 for commercial use. * * * * Archive sites: This program may be included on CD-ROMs or other * * distribution methods freely, provided any charge for such is * * for recovering the cost of distribution and reasonable profit * * and not for the purpose of "selling" the program. In this case * * the distribution must contain the complete program including * * this file. * * * * Authors: This program may be distributed with your book provided * * you include a notice indicating that commercial use of this * * program must be coordinated with Ipswitch, Inc. or you include * * the contents of this text box in print. In any case the distribu- * * tion must contain the complete program including this file. (The * * WS_FTP.INI file may be modified provided the WS_FTP home entry * * is included and not modified.) * * * * Please contact for information on commercial * * use or commercial distribution of this product! * ********************************************************************** 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] THE LATEST VERSION: =================== The latest version of this application should always be the file /pub/msdos/winsock.files/ws_ftp.zip on ftp.usma.edu (129.29.64.246). (or /pub/msdos/winsock.files/ws_ftp32.zip for the 32 bit version) To access it, enter 129.29.64.246 as the host name and check the "anonymous login" box in the WS_FTP connect dialog box. The latest version is usually uploaded winftp.cica.indiana.edu in the /pub/pc/win3/winsock directory as ws_ftp.zip. Source code for the 93.12.05 version is in the file ws_ftp_s.zip in the /pub/msdos/winsock.files directory on ftp.usma.edu. 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@css583.gordon.army.mil" ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Send all bug reports, suggestions, etc to "junodj@css583.gordon.army.mil" or to "72321,366" on compuserve. 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 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. RECENT CHANGES: =============== 95.01.22 added TANDEM host type (no-auto detect, untested) added IBM Spartacus KNET host type (auto detect, untested) added STRATUS VOS host type (auto detect, untested) changed log window style modified retrieve abort procedure fixed name convert when full path specified aborts on disk full error with message box added A or B in log file added logging entries in program options fixed Cancel/No buttons on multiple file deletes 95.01.04 added BULL CP6 host type (untested) writes transfer entry to WS_FTP.LOG in current directory (can be disabled by adding "dolog=0" to "[_config_]" and supports "logfile=name" in "[_config_]") 95.01.01 added IBM R1000 host type (untested) fixed filename problem when specifying both local and remote filenames fixed double click on close button problem added support for strange UNIX dir listings that start with 'D' or 'F' fixed window redraw resizeable windows 94.12.20 added CDC Cyber host type (untested) host type listboxes sorted and some name changes fix for upper case D marking directorys for UNIX fix for saving ports below 100 fix for IBM MVS and PDS elements (untested) cleanup of some interface issues If you report a bug (to or to 72321,366 on Compuserve) then PLEASE include the version number!!! (or at least the file date!) Author ====== John A. Junod Internet: 267 Hillwood Street Martinez, GA 30907 Compuserve: 72321,366 AOL: jjunod (706)-780-2671