home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 December / WIN95_DEC_1996_1.ISO / network / can12.exe / Can.txt < prev   
Text File  |  1996-12-23  |  10KB  |  173 lines
  1. Connect and Notify version 1.2
  2. by Costas Kotsokalis - C.Kotsokalis@ece.ntua.gr
  3.  
  4. What is CaN?
  5. CaN (Connect and Notify) is an IP Poster. This is the kind of programs you 
  6. would use if you get dynamic PPP (or SLIP) from your Internet Services 
  7. Provider, and want to let the others know your current IP address so that they 
  8. connect to a FTP, WWW or other Internet server you have set up on your PC. CaN 
  9. will upload a HTML file you edit to the WWW server of your choice, using FTP.
  10.  
  11. What is new from 1.1?
  12. Fixed a bug with ftp password. IF YOU UPGRADE FROM 1.1, REMOVE can.dat OR,
  13. TO SAVE TIME, DELETE THE PASSWORD LINE FROM IT.
  14. Used 8-bit graphics and removed background images to save computer resources. 
  15. Added the ability to upload a .plan file (the one used by finger) edited by 
  16. the user, and also a feature to connect to a time server and synchronize local 
  17. clock if desired.
  18. Added a system tray icon with basic options, to speed up use of CaN.  Added 
  19. the ability to hide CaN window after going online and work only with the
  20. system tray icon. 
  21. CaN will now upload the HTML file with the name you want. If no name is
  22. defined, the name Xline.html will be used as in v1.1.
  23.  
  24. How does it work?
  25. If you upgrade from 1.0, you will have to delete all of your old configuration 
  26. files since CaN reads files in a different format now.
  27. When you first run CaN you have to define some basic parameters for the upload 
  28. process. These would be the hostname or IP address of the WWW server to contact 
  29. using FTP, your login name there, your password and the directory to change to 
  30. before you upload the file. You can make these settings by clicking on the 
  31. 'Settings' button. This should be the very first thing to do. If you don't set 
  32. these values, before uploading an 'online' or an 'offline' file, CaN will prompt
  33. you for that.
  34. There are two different files you will upload each time, a file notifying you 
  35. went online, and another one notifying you are going offline. These are pure 
  36. HTML files, that you can edit if you click on the 'HTML files' button. This 
  37. will bring up a menu from which you'll have to choose which file to edit. 
  38. Whatever the choice may be, a dialog box will come up in which you'll have to 
  39. define a title, a background (or bgcolor) and the body of the file. These 
  40. starting tags (html, head, title, body, etc) are put in the file automatically 
  41. by CaN. 
  42. In these two files you can use %I and %T to reference your current IP address 
  43. and current time respectively. CaN will substitute '%I' sequences with your 
  44. current IP, and '%T' with currect time (don't use the quotes!). The files are 
  45. edited once and used every time after that. If you want to change these files, 
  46. just bring up the two dialogs. If you try to upload without having edited (or 
  47. at least saved the examples provided) you will be prompted to perform these 
  48. actions.
  49. When you want to upload one of the two files, you'll have to click on 'Online 
  50. Notify' or 'Offline Notify' buttons. 
  51. While uploading online file, offline button is disabled, and vice versa. This 
  52. is because CaN is a multithreaded program and miscellaneous conflicts could be 
  53. produced by two threads trying to upload the two different files simultaneously.
  54. I prefered to do this ONLY when uploading, and not all the time the program is 
  55. running, meaning that even when you load the program you can actually upload 
  56. an offline file. Why? So that users can run the program when they connect, 
  57. close it, and run it again right before they disconnect.
  58. CaN will also start local servers, if you define their location on your disk - 
  59. we'll get back to this later on though. There are also available:
  60. - A 'finger' button. Using this you can perform finger queries to other 
  61. internet users, and see when they last logged in, etc.
  62. - A 'Ping' button. Using this you can a) see if a server worldwide is up, 
  63. b) check the connection   quality between your PC and this server -through the 
  64. Round Trip time provided- and last but not   least, c) keep your connection 
  65. alive while CaN is pinging some host you define, or until your time limit is 
  66. reached :-) 
  67.   Clicking on the 'Ping' button will bring up a menu with three choices: 
  68. 1) Set ping properties, 
  69. 2) Start ping thread, and 
  70. 3) End ping thread. 
  71. Before starting any ping process you should define ping properties. Note that, 
  72. you can configure CaN to send only a number of packets, or ping infinitely 
  73. until program exits.
  74. - CaN will now get online on startup, if you want it too. This means that, you 
  75. can define this feature and as soon as you start CaN it will upload the 
  76. online file it will find/generate. As   you understand, you can combine all 
  77. these things and have CaN do things like automatically upload 'online' 
  78. file, start pinging remote host, start the local servers you want it to   
  79. (FTP, WWW etc), and disappear so that all functions are performed from the
  80. system tray icon (as discussed above).
  81. - Using 'Local servers' button, now you can launch not only 2 (as in version 
  82. 1.0) but an infinite number of server programs. It is obvious that you can 
  83. launch any executable, even if this is not a server. For example, you can load 
  84. CaN and have it go online on startup, launching Netscape, Internet Explorer, 
  85. some FTP client, an IRC client, telnet sessions and any other Internet tool 
  86. you are using, without you having to perform not even one mouse click.  
  87. - Added a timer which will be enabled as soon as you go online, and will show 
  88. you for how   long   you have been online. 
  89.  
  90. Apart from these, CaN has 6 speedbuttons:
  91. 1. A button to find/refresh your local IP address and show it on top of the 
  92. window.
  93. 2. A button to minimize the window
  94. 3. A button to refresh the window
  95. 4. An 'about' button
  96. 5. An 'exit' button.
  97. 6. A 'Hide' button was added in this version, which will hide the main window
  98. from the screen AND from the taskbar. The application window will be
  99. visible again if you click on the 'Show main window' option, on the system
  100. tray icon.
  101. The reason for using 'minimize' and 'exit' speedbuttons instead of leaving the 
  102. system buttons as they are, is that CaN is multithreaded -again :-))- and 
  103. exiting with the 'x' button on top of the window could leave threads alive 
  104. while parent application has exited -- see also: System Crash :-)
  105.  
  106. System Reqirements:
  107. You will definitely need a PC with the Windows95 or NT operating system, and 8 Mbs 
  108. of RAM. Although CaN is not that complicated, using nice graphics makes it a 
  109. whole lot heavier that it would be with standard buttons etc. 
  110. CaN 1.1 had a problem with windows NT which was corrected. Version 1.2
  111. will work fine under NT now. At this point i would like to thank Peter
  112. Laur for his precious co-operation, so that CaN runs under NT as well.
  113.  
  114. ToDo list:
  115. - Add a help file. I really don't think this is needed, but some complain that 
  116. it would be of use. What can i say, users :-)
  117. - Maybe add a 'chat' service, integrated into CaN. Of course, 
  118. this could be accomplished with any talk server, but what can i say, 
  119. developers :-)
  120. - Add name service lookup
  121. - Add a mail-checker and possibly a mail-sender
  122.  
  123. BUGS:
  124. Only one that i know, when using pseudo-PPP or pseudo-SLIP the first time you 
  125. try to upload the 'online' or 'offline' file, after it's transmitted you will 
  126. get a winsock error. The funny thing is that this happens only the first time 
  127. of each session, and then it's all nice and perfect. I will try to find what's 
  128. the problem with this, although it does not seem to be of need - almost 
  129. everyone gets real PPP these days. If you don't, find another ISP :-)
  130. Writing CaN from the beginning and paying attention to synchronization 
  131. issues fixed all other bugs i was aware off. If you happen to notice peculiar 
  132. behaviour, or get errors like exceptions, GPFs etc., please mail me at 
  133. C.Kotsokalis@ece.ntua.gr and let me know exactly what happens.
  134. PLEASE note that if you are upgrading from 1.0, you HAVE to delete the old 
  135. configuration files. If you don't you can be sure you will get an error 
  136. right on startup.
  137.  
  138. LISENCE AGREEMENT:
  139. The shareware version of CaN 1.2 has 2 features disabled: It won't hide after
  140. uploading the 'online' file(s), and it will not get the network time (nor will
  141. it synchronize the clock, as obvious). As soon as you use your registration
  142. password these will all be functioning as desired.
  143. You can use this piece of software without registering within an evaluation 
  144. period of 30 days.  If you want to continue using it after this period, you 
  145. have to register with CaN. To do this, send $15 US, to the address:
  146.  
  147. Constantinos Kotsokalis
  148. Solomou 43
  149. Galatsi 11147
  150. Athens
  151. GREECE
  152.  
  153. DO NOT FORGET TO WRITE CLEARLY YOUR FULL NAME AND EMAIL ADDRESS!!! One day 
  154. after i receive your subscription i will email you a password which you can 
  155. use to register CaN. Make sure you make a note of the name to register, 
  156. because the password will be generated according to this name. 
  157.  
  158. Registering with CaN entitles you to full support though email. This includes 
  159. serious effort to add features you would like CaN to have, in next versions. 
  160. IF YOU REGISTER WITH CaN YOU WILL ALSO GET THE NEXT VERSIONS OF IT FOR FREE,
  161. UNTIL VERSION 2.0.
  162. Unregistered users have no right to technical support, still i'm eager to hear 
  163. their comments, suggestions, bug reports. If you have any of the above, please 
  164. let me know - no matter if you have registered or not.
  165.  
  166. DISCLAIMER:
  167. "Connect and Notify" is supplied as is.  The author disclaims all warranties, 
  168. expressed or implied, including, without limitation, the warranties of 
  169. merchantability and of fitness for any purpose. The author assumes no 
  170. liability for damages, direct or consequential, which may result from the use 
  171. of "Connect and Notify". By using "Connect and Notify" you automatically 
  172. agree to the above conditions of use.
  173.