home *** CD-ROM | disk | FTP | other *** search
/ The Best Internet Programs / BESTINTERNET.bin / internet / winftp / winftp.doc < prev    next >
Text File  |  1994-01-07  |  18KB  |  482 lines
  1. WinFTP - A WinSock-based FTP Client for Windows 3.1 and Windows/NT.
  2.  
  3. Written by  :  Santanu Lahiri
  4. Based on    :  WS_FTP & WS_PING by Mr John A. Junod
  5. Release Date:  January 7th, 1993
  6.  
  7. Please read the installation guide before proceeding with the actual
  8. installation of this software, as there are some incompatibilities
  9. with the original version.
  10.  
  11. WinFTP is based on the WS_FTP program originally written by Mr John A. 
  12. Junod, for Microsoft Windows 3.1.  In WinFTP, I have added a few features
  13. that I feel would be nice to have in a program of this kind.  I am using 
  14. the FTP engine from WS_FTP, as I believe Mr. Junod has done a really 
  15. superb job on it,  and I give him full credit for that.  I would like 
  16. to take this opportunity to thank him for releasing the source to Public 
  17. Domain.  That has made it possible for me to learn some of the basics 
  18. of WinSock programming from a working source.
  19.  
  20. I am including the source for the project as part of the release.  
  21. Unfortunately, I do not have the necessary expertise in or access to 
  22. Borland's compiler or environment to make the code portable to either.  
  23. This current version has been compiled with Microsoft Visual C for Windows
  24. and Visual C for Windows NT.  If you adapt this code to Borland's compiler, 
  25. please consider making the source available as Public Domain.  
  26.  
  27. If you run into any bugs in this release, or would like to see other features,
  28. please let me know at the following address, or simply post on alt.winsock.  
  29. I will attempt to maintain the source, but I can not guarantee a prompt 
  30. turn-around.  If you add to or modify the source, please consider contacting 
  31. me so that I can incorporate the changes as well.
  32.  
  33. Internet:     slahiri@magnus.acs.ohio-state.edu
  34. BITNET  :     lahiri@ohsthr
  35.  
  36. Disclaimer.
  37. ------------
  38.  
  39. While I have run this software on several different machines and operating 
  40. systems, and have made an attempt to fix any bugs I've run into, you use 
  41. this software at your own risk.  To the best of my knowledge, the program 
  42. is virus-free and has not exhibited any unusual tendencies to go berserk.  
  43. However, I am not liable for any damages you may incur as a consequence of 
  44. using this software.  
  45.  
  46. Also, while this release was posted using Ohio State University's
  47. resources, OSU is not responsible for it, nor should it be held liable.  My
  48. development of this software was done independent of my connection to
  49. OSU.
  50.  
  51. ------------------------------------------------------------------------
  52.  
  53. Now with the pleasantries out of the way, here is a description of the
  54. release itself.  For those of you who had already gotten the previous
  55. release (WS_FTPB.ZIP, not WS_FTP.ZIP), you will need to make some
  56. modifications to your INI file.  These are detailed later.
  57.  
  58. The INI File Format.
  59. ---------------------
  60.  
  61. The program works on the presumption that it is easier to remember and
  62. understand a descriptive string like "CICA.Indiana Windows File Archive"
  63. rather than the name ftp.cica.indiana.edu.  And the assumption that now
  64. and then we need to log in to the same machine using more than one User
  65. ID.  The concept of a Configuration is that you associate a description
  66. with a combination of Host ID and User ID.  Once a Configuration is
  67. defined, it is unique. 
  68.  
  69. The .INI File format is given below.  You can supply a Configuration
  70. string to name each configuration.  In this version, the HostType 
  71. values are as follows:
  72.  
  73. AutoDetect               0
  74.  
  75. Unix                     1    QVT                      8
  76. IBM VM                   2    IBM/TCP                  9
  77. VMS/Multinet             3    Chameleon               10
  78. VMS/UCX                  4    SuperTCP                11
  79. Ftp Software             5    SI NT FTPD              12
  80. CUTCP/NCSA               6    IBM MVS                 13
  81. NOS                      7    UniSys 5000             14
  82.  
  83. The following file is a sample WINFTP.INI file.  If you wish to set
  84. up a proper initialization file, you must edit all references to
  85. directories and all passwords.
  86.  
  87. WIN16:  Copy the WINFTP.INI file into the WINDOWS directory
  88. WIN32:  Copy the WINFTP.INI file into the \WINNT directory
  89.  
  90. Sample  WINFTP.INI  file:
  91. ---------------------------
  92.  
  93. [WINFTP]
  94. CONFIG=Oakland FTP Service
  95. HOSTNAME=oak.oakland.edu
  96. USERID=anonymous
  97. MAILADDR=slahiri@magnus.acs.ohio-state.edu
  98. VIEWER=d:\pfe\pfe32
  99. LogFile=
  100. LogFlag=On
  101. TempDir=D:\TEMP
  102. ConfigNum=20
  103. ViewerCount=6
  104. Retain=0
  105. DblClk=1
  106. AUTOSTART=1
  107. FLAGS=21
  108. CFG0=Oakland FTP Service
  109. CFG1=Monash FTP Archives
  110. CFG2=Biochemistry
  111. CFG3=Cica FTP Archives
  112. CFG4=SunSite Archives
  113.  
  114. [WINFTP:Viewer]
  115. Viewer1=A,.TXT,D:\PFE\PFE,D:\Docs
  116. Viewer2=I,.ZIP,D:\WIN\WIZ\WIZUNZIP
  117. Viewer3=I,.GIF,D:\WIN\WINGIF\WINGIF,D:\WIN\WINGIF
  118. Viewer4=I,.BMP,D:\WIN\WINGIF\WINGIF,D:\WIN\WINGIF
  119. Viewer5=A,.LST,D:\WIN\GANDER\GANDER
  120. Viewer6=I,.WRI,WRITE
  121.  
  122. [WINFTP:Oakland FTP Service]
  123. HostName=oak.oakland.edu
  124. UserID=anonymous
  125. PASS=slahiri@magnus.acs.ohio-state.edu
  126. HostType=AutoDetect
  127. TimeOut=65
  128. Save=0
  129.  
  130. [WINFTP:Monash FTP Archives]
  131. HostName=ftp.cc.monash.edu.au
  132. UserID=anonymous
  133. PASS=slahiri@magnus.acs.ohio-state.edu
  134. DIR=/pub/win3
  135. HostType=AutoDetect
  136. TimeOut=65
  137. Save=1
  138. DIR1=/pub/win3
  139. DIR2=/pub/win3/access
  140. DIR3=/pub/win3/drivers
  141. DIR4=/pub/win3/drivers/printer
  142. DIR5=/pub/win3/nt
  143.  
  144. [WINFTP:Biochemistry]
  145. HostName=biochemistry.bioc.cwru.edu
  146. UserID=anonymous
  147. PASS=slahiri@magnus.acs.ohio-state.edu
  148. HostType=Unix
  149. TimeOut=65
  150.  
  151. [WINFTP:Cica FTP Archives]
  152. HostName=ftp.cica.indiana.edu
  153. UserID=anonymous
  154. PASS=slahiri@magnus.acs.ohio-state.edu
  155. HostType=AutoDetect
  156. TimeOut=65
  157.  
  158. [WINFTP:SunSite Archives]
  159. HostName=sunsite.unc.edu
  160. UserID=anonymous
  161. PASS=slahiri@magnus.acs.ohio-state.edu
  162. HostType=AutoDetect
  163. TimeOut=65
  164.  
  165.  
  166. Description of Dialogs used in WinFTP
  167. ======================================================
  168.  
  169. The HostName Dialog
  170. ---------------------
  171.  
  172. This dialog appears when you wish to connect to a host and click on the
  173. "Connect" button.  Note that the "Save Configuration" option has now been 
  174. replaced by "Save Directories." and has a different functionality to it.
  175. The components of the dialog are:
  176.  
  177. Config  :  The name assigned to the configuration.  
  178. Host    :  The name of the Remote host you wish to connect to.
  179. UserID  :  User ID you will be logging in with
  180. Passwd  :  Corresponding password
  181. TimeOut :  Time in seconds after which WinFTP will abort the connection.
  182. HostType:  Type of Operating System on the host you are connecting to.
  183.  
  184. Script  :  Name of a Script file.  Not Implemented yet.  DO NOT USE.
  185. Account :  MiniDisk Password option.  Not implemented yet, DO NOT USE.
  186.  
  187. Save Password   :  Will save your password as part of your configuration.
  188. Save Directories:  If selected, will save list of visited directories on
  189.                    Close or Exit.
  190.  
  191. Anonymous Login :  Resets UserID & Passwd fields to appropriate values.
  192. DelCfg  :  Delete Current configuration.
  193. SaveCfg :  Save/Update Current Configuration.
  194. Cancel  :  Cancel the Dialog.
  195. OK      :  Accept Current Configuration & Log in to Host
  196.  
  197. If a configuration name is not supplied, WinFTP will attempt to create
  198. one when saving a configuration.
  199.          
  200. The host types currently supported are listed above in the .INI file 
  201. section.  If the type of host you are logging into is not available 
  202. in the list, please contact me with a directory listing and I will 
  203. attempt to include it.
  204.  
  205.  
  206. The PingHost Dialog
  207. --------------------
  208.  
  209. This dialog allows you to query a name server or your hosts file for the
  210. InterNet address corresponding to a host, and ping that host if you
  211. wish.  The "Resolve" button performs the DNS query, while the "PingHost"
  212. button pings it.  You can specify the size of the Ping packet, and the
  213. repeat count.
  214.  
  215. The Ping code draws heavily on the WS_PING program by John Junod.
  216. Both blocking and async ping operations are supported, at least on the
  217. Trumpet stack.
  218.  
  219. This function is still not quite there, though.  For now, I've only been
  220. able to get it to work with the Trumpet stack, version A17, A18.  It does 
  221. NOT work under Win/NT, or with the FTP Software sta