home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DOWNCHEK.ZIP / DOWNCHEK.DOC next >
Encoding:
Text File  |  1993-05-02  |  11.3 KB  |  225 lines
  1.  
  2.  ██████╗   ██████╗  ██╗    ██╗ ███╗   ██╗  ██████╗ ██╗  ██╗ ███████╗ ██╗  ██╗
  3.  ██╔══██╗ ██╔═══██╗ ██║    ██║ ████╗  ██║ ██╔════╝ ██║  ██║ ██╔════╝ ██║ ██╔╝
  4.  ██║  ██║ ██║   ██║ ██║ █╗ ██║ ██╔██╗ ██║ ██║      ███████║ █████╗   █████╔╝
  5.  ██║  ██║ ██║   ██║ ██║███╗██║ ██║╚██╗██║ ██║      ██╔══██║ ██╔══╝   ██╔═██╗
  6.  ██████╔╝ ╚██████╔╝ ╚███╔███╔╝ ██║ ╚████║ ╚██████╗ ██║  ██║ ███████╗ ██║  ██╗
  7.  ╚═════╝   ╚═════╝   ╚══╝╚══╝  ╚═╝  ╚═══╝  ╚═════╝ ╚═╝  ╚═╝ ╚══════╝ ╚═╝  ╚═╝
  8.                                      1.1
  9.  
  10.                         An utility for Maximus sysops.
  11.  
  12. This program is Yet Another Download Counter. For the uninitiated,  a Download 
  13. Counter is an utility that inserts in a  file's description  some digits  that 
  14. tell how many times it's been downloaded by a user.
  15.  
  16. DOWNCHEK  updates/creates  download counters  in your  FILES.BBS descriptions, 
  17. taking the information it needs from your log files. The counter format is the 
  18. standard one:
  19.  
  20. filename    │count.│ description
  21. ────────────┴──────┴─────────────────────────────────
  22. GPFA204.LHA  [   5] GP-Fax Patch to version 2.04...
  23.  
  24. Other less popular formats (round parenthesis, larger number of digits,  etc.) 
  25. are not supported at the moment.
  26.  
  27. DOWNCHEK is  capable of  scanning the  log files  in the  format generated  by 
  28. MAXIMUS and BINKLEYTERM. Thus, also file attaches and request will  update the 
  29. counters. Downloads or mailer transfers of files not included in any FILES.BBS 
  30. (QWK Packets, Echomail Bundles, etc.) will be reported  as missing  and simply 
  31. ignored.
  32.  
  33. The syntax of the program is DOWNCHEK <logname> where <logname> is the name of 
  34. a  valid  Maximus or  BinkleyTerm log  file. The  same log  may include  lines 
  35. generated from both programs, so it's okay to  have Maximus  and Binkley  send 
  36. the log information to the same file.
  37.  
  38. Warning: every time you run DOWNCHEK,  the entire  specified log  is processed 
  39. from start to finish. In order to get  correct results,  you should  therefore 
  40. run it just before deleting or archiving your log file(s).
  41.  
  42. DOWNCHEK  creates  a  backup  (FILES.BAK)  of  every  FILES.BBS   file  before 
  43. processing it.   If, for  any unexpected  reason, processing  should terminate 
  44. irregularly,  don't  forget  to  copy  the  FILES.BAK back  on the  incomplete 
  45. FILES.BBS before trying again !
  46.  
  47.                            ┌─────────────────────┐
  48.                            │ SYSTEM REQUIREMENTS │
  49.                            └─────────────────────┘
  50.  
  51. The memory requirements for DOWNCHEK depend largely on  the size  of your  log 
  52. files  and  FILES.BBS'es. However,  you should  have at  least 512K  of system 
  53. memory installed and a 80286 processor (or better). Expanded / extended memory 
  54. won't hurt, either.
  55.  
  56. The package  includes also  DOWNOS2.EXE,  an OS/2  version which  requires, of
  57. course, OS/2.  I have _NEVER_ tested it,  so please let me know if it works as
  58. expected (it should..).
  59.  
  60.                                 ┌────────────┐
  61.                                 │ DISCLAIMER │
  62.                                 └────────────┘
  63.  
  64. DOWNCHEK  is  provided  without  warranty  of  any kind,  either expressed  or 
  65. implied,  including,   but  not   limited  to,   the  implied   warranties  of 
  66. merchantability and fitness for a particular purpose.  The  entire risk  as to 
  67. the quality and performance of the program is  with you.   Should the  program 
  68. prove defective, you assume the cost  of all  necessary servicing,  repair, or 
  69. correction.
  70.  
  71. The above means that this program works fine  on my  computer. That's  all the 
  72. warranties I  can offer  about it!   If it  works on  yours too,  good; if  it 
  73. doesn't, tough luck. It may not work. It  may even  lead to  loss of  data, to 
  74. hardware damage, to mass extinctions, to all kind of catastrophic events.
  75. Therefore, always backup your data and don't blame  me if  anything unpleasant 
  76. happens.
  77.  
  78.                                ┌──────────────┐
  79.                                │ DISTRIBUTION │
  80.                                └──────────────┘
  81.  
  82. This program is Freely Redistributable Copyrighted  FreeWare. This  means that 
  83. you can use it for as long as you like, and you  don't have  to pay  anything. 
  84. However, DOWNCHEK is NOT in the public domain, and I retain all rights to  it: 
  85. that means you may not modify it in  any way,  but you  might freely  copy it, 
  86. distribute it, even sell it for profit or include it  in a  commercial package 
  87. with the exception of the following case.
  88.  
  89. Permission to include this program in a collection  of freely  redistributable 
  90. programs or in a commercial package (in a disk library, on CD-ROM, in magazine 
  91. coverdisks etc.) is hereby  granted to  anyone as  long as  the aforementioned 
  92. distribution DOES NOT TAKE PLACE OR ORIGINATE IN ITALY. I want it to be clear: 
  93. any  disk  magazine/CD-ROM/library/commercial package  that includes  DOWNCHEK 
  94. must not be made, sold or mantained in Italy or by Italian citizens. I'll take 
  95. legal actions against anyone in Italy  who distributes  this program  by means 
  96. other than BBS uploads/downloads.   The only  allowed way  to distribute  this 
  97. program within the borders of Italy is through  modem transfer  (that is:  you 
  98. may upload it and make it freely available on a Bulletin Board System (BBS)).
  99.  
  100. The above may appear weird, but I've got my reasons.  Anyone anywhere  else in 
  101. the world may distribute it, sell it, give it in any way he/she sees fit.
  102.  
  103. By  copying  or distributing  DOWNCHEK you  indicate your  acceptance of  this 
  104. license, and all its terms and conditions.
  105.  
  106.                                 ┌────────────┐
  107.                                 │ COMMENTS ? │
  108.                                 └────────────┘
  109.  
  110. This program is another quick-and-dirty job. I did it because I tried at least 
  111. five download counters and NONE behaved like I wanted them to.
  112. I'm not going to name anyone, but a popular Download  Counter took  about four 
  113. hours to process my weekly log file and update all the counters. The same  job 
  114. is done by DOWNCHEK in a few minutes.   Another one  had the  nasty occasional 
  115. habit of overwriting the first few characters of a file's  description instead 
  116. of embedding them in right place. And yet another one  sometimes just  trashed 
  117. the entire FILES.BBS, leaving me with a zero-lenght file and much despair. 
  118.  
  119. DOWNCHEK isn't  perfect (as  a matter  of fact  it's quite  limited) but  does 
  120. perfectly what I wanted from a download counter,  nothing more,  nothing less. 
  121. That's enough for me, and I hope it will suit your needs too.
  122.  
  123. I may improve it  in many  areas, and  probably will  (for instance,  the OS/2 
  124. version was included due to beta  testers' suggestions).   I plan  to make  it 
  125. understand the  log format  of more  front ends  (FrontDoor, Portal  of Power, 
  126. D'Bug.. sorry, I mean D'Bridge, and so on). For that a few  log samples  would 
  127. be useful, so if you want your favourite mailer supported  just fileattach  to 
  128. my node a sizeable chunk of one of your logs.
  129.  
  130. Some encouragement from you (comments, congratulations, small or  huge amounts 
  131. of money, even a simple "Thank You, it's been useful to me" note) might prompt 
  132. me to dedicate some more hours to the task.
  133.  
  134. Feedback, spontaneous contributions, bug reports etc. might be sent to me at 
  135. the following address:
  136.  
  137.                               Giancarlo Cairella
  138.                             c/o AMIGABYTE Magazine
  139.                           C.so Vittorio Emanuele 15
  140.                              20122 Milano, Italy
  141.  
  142. You may contact me (and download the latest version of DOWNCHEK) on
  143.  
  144.        BBS2000 (The first BBS in Italy, online 24 hrs a day since 1983)
  145.                      Tel. +39-2-76006857 / +39-2-76006329
  146.  
  147. All netmail should be directed to:
  148.  
  149. Vertigo         2:331/301@fidonet.org (aka 2:331/300).
  150.  
  151. I can also be contacted as:
  152.  
  153. Bix: Vertigo
  154. Compu$erve ID: 100022,602
  155. Internet/Uucp: Vertigo@bbs2000.sublink.org
  156.                Vertigo@cup.portal.com
  157.  
  158.  
  159. Please direct all flames to >NUL:
  160.  
  161. Acknowledgement: Maximus BBS is (c) by Scott Dudley
  162.                : BinkleyTerm is (c) Bit Bucket Software (Vince Perriello)
  163.  
  164.  
  165.                    ┌─────────────────────────────────────┐
  166.                    │ OTHER NICE UTILITIES BY YOURS TRULY │
  167.                    └─────────────────────────────────────┘
  168.  
  169.                                   ECHOCHEK
  170.  
  171. ECHOCHEK looks into your SQUISH.CFG file and looks at all  the echomail  areas 
  172. that  your  system  is  carrying.  The  Maximus system  file AREA.DAT  is then 
  173. checked, to make sure all of the incoming echo are  included and  available to 
  174. your users.  All "orphan" areas (that is, areas who are present on your system 
  175. but missing in the AREA.DAT definitions and therefore not available  to users) 
  176. are reported in a text file called MISSING.CTL. This file strictly follows the 
  177. AREAS.CTL format and conventions. You only have to make slight  alterations to 
  178. it  with  a  text  editor (to  supply proper  area descriptions,  for example, 
  179. instead of the default echo tag  name) before  appending it  to AREAS.CTL  (or 
  180. MSGAREAS.CTL,  if  you keep  message and  file areas  definitions in  separate 
  181. files) and recompiling it with SILT. Quite useful on large  echo-backbones and 
  182. message-oriented BBS'es.
  183.  
  184.                                    GIFFCHEK
  185.  
  186. This  program  checks  the  size  of  all Gif's  found in  the specified  file 
  187. directories, and puts the report at the beginning of the files' description in 
  188. the FILES.BBS. GIFFCHEK looks for a download counter and, if  found, puts  the 
  189. gif data  after it  and before  the actual  description. It  correctly handles 
  190. files description longer than one line. Supports GIF and IFF ILBM pictures.
  191.  
  192.                                    DUPEUSER
  193.  
  194. An utility designed to help Maximus BBS sysops identifying duplicate  users in 
  195. their user file. "Duplicate" doesn't only  mean double  entries with  the same 
  196. name: it  also means  all those  guys who  log on  your BBS  with two  or more 
  197. different names in order to download twice as  many programs  as their  single 
  198. account limits would allow. DUPEUSER scans your Maximus userfile and  extracts 
  199. a list of all users using the same password, therefore helping you  to quickly 
  200. check out suspicious accounts. It also extracts all failed entry attempts from 
  201. your log file and  lets you  check immediately  suspicious users  that try  to 
  202. logon as "John Smith" and then (after Maximus has refused access to that name) 
  203. remember that the account name they are using on your board is "Jack Brown".
  204.  
  205.                                     GIFUPL
  206.  
  207. For GIF-oriented  BBS'es: GIFUPL  checks any  GIF file  immediately after  the 
  208. upload and makes sure  it's a  valid GIF  (also reporting  its resolution  and 
  209. number of colors). If it isn't, the bad file will be moved to the  destination 
  210. directory of your choice and the upload WILL NOT be credited to the user.
  211.  
  212.                                    ITALIANO
  213.  
  214. The Italian language file for Maximus 2.00. Includes a translated ITALIAN.MAD 
  215. file, ready to be compiled.
  216.  
  217.  
  218.   All of the above may be downloaded or file requestes using the above names
  219.                                     from:
  220.  
  221.        BBS2000 (The first BBS in Italy, online 24 hrs a day since 1983)
  222.                      Tel. +39-2-76006857 / +39-2-76006329
  223.                  Fidonet 2:331/301 (HST) 2:331/350 (V32/PEP)
  224.                                    -*-*-*-
  225.