home *** CD-ROM | disk | FTP | other *** search
/ Cheats, Hacks & Hints / Cheats_Hacks_and_Hints.bin / games / dgenert / dislite.doc < prev    next >
Text File  |  1993-04-01  |  23KB  |  502 lines
  1.                                     DISLITE
  2.  
  3.                        Executable file expander version 1.15
  4.  
  5.  
  6.  
  7. CONTENTS
  8.  
  9.          WARRANTY                           MESSAGES
  10.      COPYING                            BUGS
  11.          WHAT                               PRICE
  12.          WHY                                THANKS
  13.          HOW                                NEW
  14.          LIMITS                             NOTE
  15.      TECHS                              WHO
  16.  
  17.  
  18.  
  19. WARRANTY
  20.  
  21.    NONE! THIS PROGRAM COMES 'AS IS'. I CANNOT BE HELD RESPONSIBLE FOR
  22.    ANY DAMAGE CAUSED BY THE USE OR MISUSE THIS PROGRAM. I CANNOT
  23.    GUARANTEE THE FITNESS OF THIS PROGRAM FOR ANY PARTICULAR PURPOSE.
  24.    IF THIS PROGRAM TURNS OUT TO BEHAVE UNEXPECTEDLY OR ERRONEOUSLY,
  25.    THE USER IS RESPONSIBLE, AND I CANNOT BE FORCED TO SUPPLY THE USER
  26.    WITH A FIX.
  27.    
  28.    So, now that I have the lawyers off my back (I hope), you can forget
  29.    all that capsed crap above, and read the rest of the manual, in
  30.    which I promise not to shout anymore.
  31.  
  32.  
  33.  
  34. COPYING
  35.  
  36.    You are free to distribute this program, provided that neither the
  37.    program nor this document are changed, and the program and this
  38.    document are kept together. Only a marginal fee may be asked for
  39.    shipment and handling when distributing. You are not allowed to
  40.    sell this program.
  41.  
  42.    Now that the black-market pirates are away too, we can get to business.
  43.  
  44.  
  45.  
  46. WHAT
  47.  
  48.    DISLITE expands all programs compressed by PKLITE to their
  49.    original image. Expanding your files has many benefits over leaving
  50.    them in their compressed state.
  51.  
  52.    Most important, the uncompressed image can be examined by other
  53.    tools, such as virus scanners. A regular virus scanner can never
  54.    detect a virus embedded in a compressed file (unless by executing
  55.    and checking for suspicious actions), but on the uncompressed image
  56.    a much faster pattern matching algorithm can be used.
  57.    
  58.    Then, PKLITE compressed programs can hardly be compressed any further
  59.    using "regular" file compressors like UC2, ARJ. The uncompressed files
  60.    however, usually compress quite well using these products, and normally
  61.    the result of compressing the original file is better than that
  62.    achieved when first compressing with PKLITE, and then with another
  63.    compression utility. (Though not always)
  64.    
  65.    The same argument usually holds if you are using products like Stacker
  66.    or SpeedStor to enlarge your disk, which could be considered as
  67.    compression utilities on-the-fly. It would be silly to have a second,
  68.    almost useless, compression slowing down your system.
  69.  
  70.    In a similar context can be mentioned that some people prefer other
  71.    executable processors, such as DIET, to recompress the files.
  72.    
  73.    Then there is an increase in execution speed of uncompressed files,
  74.    because the uncompression is no longer needed before execution. This
  75.    may, on the other hand, not be true on fast machines with slow drives.
  76.    In these circumstances the compressed file might actually execute
  77.    quicker because there is less disk access.
  78.    
  79.    Finally, for the compression-hunters, there are a few extra's in this
  80.    program that lets you strip unnecessary information off of the
  81.    executables, making it a tad smaller.
  82.  
  83.  
  84.  
  85. WHY
  86.  
  87.    You could ask why this separate program is necessary, as PKLITE
  88.    has the -x option to "extract" (I'd rather call it uncompress)
  89.    a compressed files.
  90.    
  91.    The answer is simple. There is also an option in the commercial
  92.    version of PKLITE to generate "unextractable" files (-e). Needless
  93.    to say there are numerous programs available nowadays in this
  94.    "unextractable" format.
  95.    
  96.    Also, with almost minimal effort it is quite easy to modify a
  97.    PKLITE compressed file in such a way that "PKLITE -x" cannot
  98.    handle it anymore. There are even tools around that do exactly
  99.    this.
  100.    
  101.    DISLITE has the capability of expanding both "unextractable" files
  102.    and slightly modified files to their original image. Notice that
  103.    CHK4LITE that comes with PKLITE is also not able to recognise
  104.    modified PKLITE compressed files. Use "DISLITE -l" to determine
  105.    if a file is compressed by PKLITE or not. See the HOW section for
  106.    info on the -l option.
  107.    
  108.    
  109.    You should NOT use DISLITE to undo an erroneous "PKLITE -e" done
  110.    on your recently compiled fantastic program, to do a binary
  111.    compare with the latest version of your fantastic program. To
  112.    make a binary compare all parts of the executable have to be
  113.    restored exactly as they were, and the "PKLITE -e" process
  114.    throws some information away that is subsequently lost.
  115.    
  116.    Needless to say the information lost during extra compression is not
  117.    important to run your program.
  118.    
  119.  
  120.  
  121. HOW
  122.  
  123.    Usage of DISLITE is very simple. Just type:
  124.    
  125. > DISLITE file
  126.  
  127.    to decompress the executable file.EXE or file.COM in the
  128.    current directory. You can also specify two filenames in which
  129.    case the first file is left intact and the decompressed program
  130.    is written to the second filename.
  131.    
  132.    If you type DISLITE without any parameters, the following help screen
  133.    appears to remind you of the possible options:
  134.  
  135.     Usage: DISLITE [options] [d:][\path]Infile [[d:][\path]Outfile]
  136.     Options are:
  137.       -b = make backup .BAK file of original
  138.       -cN = N is max number of segments
  139.       -e = extract unextractable file (*)
  140.       -f = un-do the fixup optimizations done by HDROPT & `extra`
  141.       -h = remove irrelevant header data
  142.       -k = omit kludge code added on some files
  143.       -l = only list version info
  144.       -o = overwrite output file if it exists
  145.       -p = align text data on a page
  146.       -r = remove overlay data
  147.       -s = silent, do not generate any warnings
  148.       -u = update file time/date to current time/date
  149.       -v = verbose
  150.  
  151.    In fact the options can appear anywhere on the command line, not just
  152.    directly after the program name. Options can always be combined,
  153.    so "-b -v -h" can be abbreviated as "-bvh". You can also use the switch
  154.    character (usually '/', but it could be set to anything) as the option
  155.    indicator. In case you use '/', the program tries to be smart and figures
  156.    out whether you mean a filename or indeed an option (since you can use
  157.    the '/' character as a directory separator too). In case of difficulty,
  158.    use '-' and '\'. (More specific: DISLITE will only recognise an option
  159.    initiated with '/' as option if every following character is a valid
  160.    option.)
  161.    
  162.    A short description of all possible options follows:
  163.    
  164.    -b  This option makes a backup of the compressed file image, which
  165.        has the same name and path as the Infile, but the extension .BAK.
  166.        Any existing file with that name will automatically be overwritten.
  167.     
  168.    -c  This option sets the maximum number of segments in a compressed
  169.        program that DISLITE can handle. Notice that running out of segments
  170.        only produces a warning or two. If memory is short, reducing the
  171.        number of segments increases the amount of fixups DISLITE can handle.
  172.        (It is essential that there is enough memory for fixups).
  173.        If you are combining options, the c option should always be the last
  174.        letter in a sequence. You can put the number either directly after
  175.        the 'c' or separate them with a space.
  176.    
  177.    -e  This option is completly ignored by the program. Use it to your
  178.        hearts contents to spell interesting words using the option
  179.        letters. You might find "DISLITE -less" easier to remember than
  180.        "DISLITE -ls" to which it is otherwise functionally the same.
  181.        Notice that most option letters have no effect when you specify
  182.        them more than once.
  183.  
  184.    -f  This option undoes the effect of "HDROPT", and also the optimization
  185.        done by "PKLITE -e" extra compression, which is the same. The fixups
  186.        are rearranged such that they become relative to the observed segments
  187.        in the executable. This is automatically done for extra compressed
  188.        files.
  189.        
  190.    -h  Most linkers include in the ex