home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d786 / virusz.lha / VirusZ / Tools / DLD.doc < prev   
Text File  |  1992-12-24  |  5KB  |  127 lines
  1. *======================================================================*
  2. *                           DL-Decruncher 1.4                          *
  3. *----------------------------------------------------------------------*
  4. *             © 1992 by Georg Hörmann. All rights reserved.            *
  5. *                 This utility requires Kickstart 2.0!                 *
  6. *          You need arp.library to run DLD with Kickstart 1.3!         *
  7. *======================================================================*
  8.  
  9. 1.Copyright
  10. -----------
  11. This program and its documentation are copyright © 1992 by Georg Hörmann.
  12. You are not allowed to change neither program nor documentation by any
  13. means.
  14.  
  15. 2.Disclaimer
  16. ------------
  17. This software is provided "as is". I'm in no way responsible for any
  18. damages or loss of data caused by this software.
  19.  
  20. 3. What is DLD?
  21. ---------------
  22. DLD is the utility you were waiting for so long. It makes it possible
  23. to load and decrunch almost every packed file. This is especially
  24. useful for packers that don't have a decruncher.
  25. This tool combines two things in one: first I wanted to code a Kick 2.0
  26. only utility to use those mighty new routines and second I needed a
  27. demo program for my decrunch.library!
  28. I added an arp.library interface for Kick 1.3 users too which was my
  29. very first attempt in using arp.
  30.  
  31. 4. How to use DLD?
  32. ------------------
  33. Nothing more easy than that! Copy the latest decrunch.library to your
  34. libs drawer and everything is ready for the first attempts.
  35. With Kick 1.3, you have to copy arp.library to your libs drawer too.
  36. DLD's shell syntax is as follows:
  37.  
  38. SOURCE,DEST,QUIET/S,LIST/S
  39.  
  40. SOURCE - Crunched file you want to have decrunched.
  41.      If LIST is specified, this is the name of the directory to
  42.      be listed (LIST uses current path if SOURCE is not specified).
  43. DEST   - If specified, file to save decrunched data to,
  44.      if not specified, the sourcefile will be overwritten.
  45.      If LIST option is active, this is ignored.
  46. QUIET  - Switch off text output (does not apply for list option).
  47. LIST   - Instead of decrunching the source file, DLD prints
  48.      a listing of the contents of the directory specified with
  49.      SOURCE. You'll get a listing of the following format:
  50.             filename                length  cruncher
  51.      e.g.   testfile              12345678  PowerPacker 3.0    
  52.  
  53. If you do not specify any parameters, DLD will print a short help
  54. page with a rough overview of functions and the current version
  55. of your decrunch.library.
  56. Do not run DLD from workbench, it is a shell command.
  57.  
  58. 5. It doesn't decrunch my demos!!
  59. ---------------------------------
  60. There can be several reasons for this (although every[!] error will be
  61. reported with a little message, some people will never understand it):
  62. a) The file is not crunched.
  63. b) The file is crunched with an unknown cruncher.
  64. c) The file is defect.
  65. d) You don't have enough memory to decrunch the file.
  66. e) You try to run DLD on Kickstart 1.3 without arp.library!
  67. f) You have not installed decrunch.library in your libs drawer.
  68. g) etc.
  69.  
  70. 6. How to contact the author?
  71. -----------------------------
  72. Well, try to reach me at the following address (if you have new
  73. crunchers, good music or any new ideas):
  74.  
  75.             Georg Hörmann
  76.             Am Lahnewiesgraben 19
  77.             8100 Garmisch-Partenkirchen
  78.             Phone: ++49-(0)8821-71978
  79.             Germany
  80.  
  81. 7. The end
  82. ----------
  83. This was a very brief documentation for a very small program.
  84. Hope you enjoy DLD as much as I do (now I'm just waiting for the first
  85. cruncher coders to complain about this destructive utility). Always
  86. remember: if a file can't be decrunched with DLD it is not crunched.
  87.  
  88. Have fun, Georg ;^]
  89.  
  90. moveq    #0,d0
  91. rts        ;successful exit
  92.  
  93. *=====================================================================*
  94. *                             DLD History                             *
  95. *=====================================================================*
  96.  
  97. 1.0    Coded this nice little decrunch.library tool in about 3 hours.
  98.     Thanks to Commodore for Kick 2.0 and this wonderful ReadArgs()
  99.     routine.
  100.  
  101. 1.1    Now all 1.3 users can use DLD too. I added an arp.library
  102.     interface that is only used when run on Kick 1.3. So you still
  103.     don't need arp with OS 2.0.
  104.  
  105. 1.2    Fixed a rather small bug: if you specified a directory as
  106.     source file, DLD tried to read it anyway. Now it tells you
  107.     not to select directories.
  108.     Added LIST option. This is really useful with disks you
  109.     don't know. It prints a listing similar to that of the
  110.     Shell command 'List', but instead of protection bits and
  111.     date/time, it prints the crunchers the files were packed
  112.     with (if packed).
  113.  
  114. 1.3     Did some enhancements for use with decrunch.library v34.
  115.         Decrunch errors will be reported more detailed now.
  116.  
  117. 1.4     Uses decrunch.library v35 now, with more information about
  118.         absolute address crunchers (startaddress + jumpaddress).
  119.         Added possibility to skip SOURCE when LISTing directories.
  120.         LIST uses current path then.
  121.         Improved save routine. Checks disk space now and skips
  122.     saving if not enough free space available.
  123.         Added help page with information on DLD and decrunch.library.
  124.         Thanks to Axel Folley, PBA and others for these ideas...
  125.  
  126. EOF
  127.