home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / FileMover / Dopus4 / ArexxScripts / hotwrite.lha / doc / Istrip.doc < prev   
Encoding:
Text File  |  1992-09-02  |  11.5 KB  |  376 lines
  1.  
  2.  
  3.  
  4. -----------------------------------------------------------------------------
  5.  
  6.  
  7.  
  8.  
  9.                       Illegal LhA file Stripper v1.1
  10.                       ------------------------------
  11.  
  12.                            Coded by TAS in 1994
  13.  
  14.  
  15.  
  16.  
  17. INTRODUCTION:
  18. -------------
  19.  
  20. As a regular scene file trader/sysop, you will notice that increasingly
  21. boards are appending bbs adverts which come under filenames such as:
  22.  
  23. #?#?#?#?#?, ?#?, *, *.*, -**   ....etc
  24.  
  25. These files are difficult to delete due to the fact that they are wild
  26. cards, and this is (I suppose) designed to prevent upload checkers on bbs's
  27. from stripping these files out.
  28.  
  29.  
  30.  
  31. WHAT ISTRIP DOES:
  32. -----------------
  33.  
  34. Istrip removes any files within an LhA which contain such illegal
  35. characters such as:
  36.  
  37. #, *
  38.  
  39. v0.5: will now also remove filenames beginning with a space
  40. v0.6: will now also remove filenames with the µ symbol
  41. v1.0: will now remove any known banners definable in a brainfile
  42. v1.1: removed checking for the ? character as this is not always invalid
  43. v1.3: now another file s:Istrip.nowild like Istrip.known but no wildcards
  44.  
  45.  
  46. USAGE:
  47. ------
  48.  
  49. To process a file with Istrip, simply type:
  50.  
  51.                        ISTRIP <source>
  52. or:
  53.                        ISTRIP <source> <destination>
  54.  
  55.  
  56. If only the source file is specified then this file will also be used as
  57. the destination.
  58.  
  59.          (This software is designed with the plug-in-and-go ideal)
  60.  
  61.  
  62. BBS USAGE:
  63. ----------
  64.  
  65. Different BBS systems use different file check techniques, but generally I
  66. would suggest that you place the ISTRIP program after your LhA checker,
  67. because if a half finished file was checked, Istrip might add some
  68. characters to it which might make it impossable to resume.
  69.  
  70. Example scripts are included for processing files with Istrip.
  71.  
  72. Please would BBS sysops who use ISTRIP mail me the scripts they use on any
  73. of the boards listed at the end of this file so that I can distribute them
  74. with future version of ISTRIP.
  75.  
  76.  
  77. BRAINFILE:
  78. ----------
  79.  
  80. As from version 1.0 Istrip now has a 'brainfile' which is called
  81.  
  82.                               S:Istrip.known
  83.  
  84.      (Copy the given one into your S: otherwise Istrip wont find it!)
  85.  
  86. Whenever Istrip is called if this brainfile exists it will be loaded in and
  87. used to strip known bbs banners. This allows you to use Istrip to replace
  88. your existing lhA stripper. However when adding entries or creating your
  89. own brainfile, extreme caution must be observed because inccorect defintion
  90. of the known banners could result in Istrip removing files from an Lha that
  91. are not bbs banners, it could even remove all files! So please follow these
  92. instructions to the letter.
  93.  
  94. 1) Make sure that any text you put in the brainfile could only describe a
  95.    bbs banner, istrip will add wildcards to each end ie.
  96.  
  97.     AT&T
  98.  
  99.    becomes
  100.  
  101.     #?AT&T#?
  102.  
  103.    so for example DO NOT put such things into the brainfile as
  104.  
  105.     README
  106.  
  107.    as this will erase any file anywhere in the lhA that has README in it
  108.    and there are many many files that are not bbs banners!
  109.  
  110.    also do not put such things as
  111.  
  112.    A
  113.  
  114.    into the brainfile as this means that any file containing an A would
  115.    be deleted.
  116.  
  117. 2) There is no need to put wildcards into the brainfile such as
  118.  
  119.    #?RULEZ#? 
  120.  
  121.    as the wildcards are automatically added.   
  122.  
  123. 3) When adding banner names to the archive be as specific as possable for
  124.    example if you wanted to make ISTRIP remove the banner that was called
  125.  
  126.    >>TRIP_TO_NOWHERE-+49-235-647-346<<
  127.  
  128.    Then you really only need to put in
  129.  
  130.    TRIP_TO_NOWHERE
  131.  
  132.    as there would not be a valid file in an LHA called this.
  133.  
  134. 4) Remember not to leave any lines in the brainfile blank and to make sure
  135.    that there are no extra carrage returns at the end. The best way to
  136.    ensure this is to add your banners into the middle of the Istrip.known
  137.    file, as the one that comes with this archive works fine.
  138.  
  139. 5) When you have added some banners it is a good idea to test ISTRIP by
  140.    running it on an existing Lha file to see if it works ok.
  141.  
  142. -------- UPDATE:
  143.  
  144. v1.3:    Some sysops asked me if I could add a way of deleting files that
  145.     were short or too generic to use wildcard stripping techniques, so
  146.     there is now another brainfile called:
  147.  
  148.     s:Istrip.nowild
  149.  
  150.     This is defined in exactly the same was as s:Istrip.known
  151.     except that it does not automatically add wildcards to the end
  152.     so it will only strip files that exactly match the description,
  153.     although it is not case sensitive.
  154.  
  155.     This means you can remove those stupid banners called:
  156.  
  157.     -
  158.  
  159.     or
  160.     
  161.     A
  162.  
  163.     Just put that name into the s:Istrip.nowild (remember not to leave
  164.     any trailing spaces)
  165.  
  166.     If you are wondering why I didn't combine these to one file, it is
  167.     because I can't make my own character to signal wildcards in the
  168.     Istrip.known file because then people will only start using it as a banner
  169.     name!  Trust me, this is the fastest and best way.
  170.  
  171.     (Please note the included Istrip.nowild file is only a small
  172.     example as the feature is new and sysops are crying out for this
  173.         update, I have rushed it out, a full Istrip.nowild file will
  174.         accompany v1.4)
  175.  
  176.  
  177.  
  178. WHY ISTRIP WAS MADE:
  179. --------------------
  180.  
  181. I am annoyed that BBS sysops have resorted to such means to send their
  182. board adverts out, making illegal file names is not very popular especially
  183. with myself as these files are hard to delete and almost as hard to view
  184. due to their wildcard nature.
  185.  
  186. Another very important note is that these files corrupt your harddisk, the
  187. disk validator software is not designed to handle these filenames and so if
  188. you get a validation error on your harddisk, the presence of these files
  189. can make a minor error which can be fixed, into a bad error like 'bad header
  190. type' or similar.
  191.  
  192. It is no coincidence that all the errors I have had on my harddisk which
  193. could not be fixed have been on these files.
  194.  
  195. People should also note that Quartback tools 2.2 cannot fix these files
  196. either and regards them as bad header types. There could be a new version
  197. that can fix these problems, I am not aware of it though.
  198.  
  199. I would say to all sysops using such banners that they should change them
  200. to legal file names. If their board is cool then people will call it
  201. anyway. If they are worried about people deleting their board ads then they
  202. should change them every week or so.
  203.  
  204.  
  205.  
  206. NEW MOTIVE:
  207. -----------
  208.  
  209. Seeing as ISTRIP is so fast and useful, I have decided to make it strip out
  210. any files the names of which do not contain standard ascii.  I will be
  211. careful to allow language characters, just symbols and other illegal
  212. characters I will make it remove.
  213.  
  214. V1.0:
  215.  
  216. Istrip now can strip any bbs add known to man, these are simply defined in
  217. a brainfile called S:Istrip.known please read the documentation very
  218. carefully when installing your own names into the brain file!
  219.  
  220. V1.3:
  221.  
  222. Seems people are lamer than I thought, making single character adds! So a
  223. new file called s:Istrip.nowild has been added, which does not add
  224. wildcards to the search strings and can be used to define those generic
  225. adverts specifically, like:
  226.  
  227. -
  228. A
  229.  
  230. etc..  Have fun and let me know if theres anything Istrip cant Istrip!
  231.  
  232.  
  233. TECHNICAL NOTES:
  234. ----------------
  235.  
  236. Istrip is written in 68000 machine code and should work on all OS version
  237. and all processors, and all memory configurations (assuming you have
  238. enough!)
  239.  
  240. You will notice the tiny file size of Istrip, this should be an indication
  241. of how efficiently I wrote it, zap it and you will see that this is mostly
  242. text!
  243.  
  244. Istrip will remove any files containing any of these characters:
  245.  
  246.                                     # *
  247.  
  248. let me know of any other characters which should be added. Or you can add
  249. them to the Istrip.known file as single characters, but use extreme caution
  250. as European languages can use these characters.
  251.  
  252.  
  253. How Istrip works.
  254.  
  255. 1) Istrip loads in the entire .lha file into ram
  256. 2) It is processed, the illegal files removed
  257. 3) It is saved to the destination file (which can be the same as the source)
  258.  
  259.    If the source and destination are the same file then nothing is saved
  260.    if there are no files to be removed.
  261.  
  262.  
  263. Istrip can remove files from subdirectories within an LhA also!
  264.  
  265. Istrip does not call LHA ever! so it is VERY fast!
  266.  
  267. If you do not have enough memory to load the entire file in at one go.  If
  268. it cannot load it all in then it simply aborts and the illegal files are
  269. not deleted.  So there is no problem, just that particular file is not
  270. processed.
  271.  
  272.  
  273. Due to some updates in the way ISTRIP stores the structure of the LHA file
  274. it now requires 32k of workspace rather than the old 1k of workspace,
  275. however this means that it can process lha files with upto 16000 files in
  276. them (I hope this is enough!)
  277.  
  278.  
  279.  
  280. KNOWN BUGS:
  281. -----------
  282.  
  283. Istrip will abort if not enough memory.
  284.  
  285. Istrip has a limitation of 5000 known files in each brainfile.
  286.  
  287. No other known bugs, please report any you find!
  288.  
  289.  
  290.  
  291.  
  292. NEW VERSIONS:
  293. -------------
  294.  
  295. 68020/68030 improved/optimised versions.
  296.  
  297. Maximum load size specification (so you can choose not to process larger
  298. files) - This will be done as soon as I find a 1.3 equivent dos call to
  299. STRING-LONG call.
  300.  
  301. Speed increases (is it not fast enough?)
  302.  
  303. Hopefully some people can send me scripts and config files for setup on
  304. various BBS systems, such as AmiExpress, Xenolink, CNET etc... if you run
  305. one of these then please release the scripts or send them to me.
  306.  
  307. Link list use to increase speed when searching for files
  308.  
  309. Ansi Analiser so that even unknown BBS adds can be stripped!
  310.  
  311. Adding of LhA testing also so that ISTRIP will be a total replacement for
  312. all BBS checkers. And it will not use LHA so it will be VERY fast!
  313.  
  314. Ability to add your own BBS banners, I'm considering this because people
  315. want to make ISTRIP a complete replacement for all lha checkers/adders etc,
  316. I will do this if I can make it faster than LHA!
  317.  
  318.  
  319.  
  320. HISTORY:
  321. --------
  322.  
  323. v0.4    - First release version
  324.     - .lha / .lzh files supported - strips #,?,*,@
  325.     - released 14/02/94 - Filesize 2300 bytes
  326.  
  327. v0.5    - now strips files beginning with spaces
  328.     - if only a source file is specified, this is used as the
  329.           destination file aswell
  330.     - released 16/02/94 - Filesize 2344 bytes
  331.  
  332. v0.6    - Progress indicator (Working...) when writing data to disk
  333.     - massive speed up when there are no changes to file, does not
  334.       write a destination file if there was no change. However always
  335.       writes if the destination file has a different name to the source!
  336.     - now strips #,?,*,@,µ and files beginning with a space, more soon!
  337.     - now checks if file is a valid lha file before processing
  338.     - released under the Medellin label
  339.  
  340. v1.0    - Addition of brainfile so that it is possable to add in a list of
  341.       all the known bbs banners you have seen and ISTRIP will strip
  342.           them all still with the same lightening speed!
  343.  
  344. v1.1    - Removal of stripping ? file names
  345.     - released 12/03/94 - Filesize 3596 bytes
  346.  
  347. v1.3    - Release with new Istrip.nowild brainfile for specific bbs add
  348.       removal.
  349.     - Also removed the µ and @ stripping, if you want it, just put the
  350.       names in the Istrip.known file as single characters
  351.     - released 13/06/94 - Filesize 4376 bytes
  352.  
  353.  
  354. new versions all the time! keep upgrading it gets better!
  355.  
  356.  
  357.  
  358. ABOUT THE AUTHOR:
  359. -----------------
  360.  
  361.                Tas can be contacted on any of these boards:
  362.  
  363.                         Dawn-Raid, Dawn-Of-Eternity
  364.                   Kin-Madness, Bad-Dreams, Chaotic-Entity
  365.  
  366.           Or you can internet mail me at Tas@dawnraid.demon.co.uk
  367.  
  368.             preferably call my board in the UK, (+44-707-320-320)
  369.  
  370.  If you want to thank me for this util, then just call my board and upload
  371. something nice! That always makes me happy. Positive and Negative feedback
  372.                              is also accepted!
  373.  
  374. -----------------------------------------------------------------------------
  375.  
  376.