home *** CD-ROM | disk | FTP | other *** search
/ PC Interdit / pc-interdit.iso / share / pklite / pklite.doc < prev    next >
Text File  |  1994-09-20  |  31KB  |  1,359 lines
  1.  
  2.                                  PKLITE (tm)
  3.  
  4.                        The Executable File Compressor
  5.  
  6.  
  7.  
  8.             Topic                                                     Page
  9.  
  10.      I.  Introduction to PKLITE . . . . . . . . . . . . . . . . . . . . 2
  11.          1.  PKLITE Overview  . . . . . . . . . . . . . . . . . . . . . 2
  12.          2.  System Requirements. . . . . . . . . . . . . . . . . . . . 3
  13.          3.  Technical Support. . . . . . . . . . . . . . . . . . . . . 3
  14.          4.  Registration Information . . . . . . . . . . . . . . . . . 4
  15.          5.  Software License . . . . . . . . . . . . . . . . . . . . . 5
  16.  
  17.  
  18.      II. Using PKLITE . . . . . . . . . . . . . . . . . . . . . . . . . 6
  19.          1.  Explanation of the Command Line. . . . . . . . . . . . . . 6
  20.          2.  PKLITE options . . . . . . . . . . . . . . . . . . . . .  10
  21.               -a  Always compress files with internal overlays  . . .  10
  22.               -b  Make backup .BAK file of original . . . . . . . . .  11
  23.               -e  Extra compression method  . . . . . . . . . . . . .  12
  24.               -l  Display software license screen . . . . . . . . . .  12
  25.               -n  Never compress files with overlays. . . . . . . . .  13
  26.               -o  Overwrite output file if it exists. . . . . . . . .  14
  27.               -r  Remove any extra .EXE data. . . . . . . . . . . . .  15
  28.               -u  Update file time/date to current time/date. . . . .  16
  29.               -x  Expand a compressed file. . . . . . . . . . . . . .  17
  30.  
  31.  
  32.      III. Programs That Should Not Be Compressed. . . . . . . . . . .  19
  33.  
  34.      IV.  PKLITE Error Messages . . . . . . . . . . . . . . . . . . .  21
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                      1
  60.  
  61.      I.  INTRODUCTION TO PKLITE
  62.      ─────────────────────────────────────────────────────────
  63.  
  64.      This section contains an introduction to the PKLITE data
  65.      compression software.
  66.  
  67.  
  68.  
  69.      1.  PKLITE OVERVIEW
  70.      ─────────────────────────────────────────────────────────
  71.  
  72.      PKLITE is an easy to use file compression program.  It increases
  73.      your valuable disk space by compressing executable files (with
  74.      .EXE and .COM extensions).  PKLITE will compress these executable
  75.      files so they will require much less disk space yet will still
  76.      run normally.
  77.  
  78.      PKLITE compresses your files much like PKZIP, but it adds a small
  79.      amount of extraction code at the beginning of the executable
  80.      file.  When you run an application that has been compressed with
  81.      PKLITE, the program will automatically be expanded into memory
  82.      and run.  The compressing process does not change the operation
  83.      of the program at all, it merely reduces the disk space required
  84.      to store it.  No additional memory is needed to run most programs
  85.      compressed with PKLITE.
  86.  
  87.      PKLITE also has the ability to expand your files back to their
  88.      original size.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                      2
  119.  
  120.      2.  SYSTEM REQUIREMENTS
  121.      ────────────────────────────────────────────────────────
  122.      PKLITE will run on any IBM PC or compatible with DOS 2.0 or
  123.      higher.  Running a program that has been compressed with PKLITE
  124.      requires a maximum of 4K extra memory overhead to expand the
  125.      application in memory.  Memory available to the application
  126.      remains the same as before it was compressed.
  127.  
  128.  
  129.  
  130.      3.  TECHNICAL SUPPORT
  131.      ─────────────────────────────────────────────────────────
  132.  
  133.      If you have any questions regarding PKLITE or any of the other
  134.      PKWARE programs, please call our technical support staff for
  135.      assistance.  Our office hours are Monday through Friday, 9:00am
  136.      to 5:00pm central time.  You can also leave a message on our
  137.      24-hour PKWARE Support BBS, or mail your comments and questions
  138.      to the PKWARE office.  The PKWARE address and telephone numbers
  139.      are listed below.
  140.  
  141.  
  142.       PKWARE, Inc.
  143.       9025 North Deerwood Drive
  144.       Brown Deer, WI 53223
  145.  
  146.           Voice (9am to 5pm CT):  (414) 354-8699
  147.  
  148.           Fax:  (414) 354-8559
  149.  
  150.           PKWARE Support BBS (Available 24 hours): (414) 354-8670
  151.  
  152.           PKWARE on CompuServe 75300,730
  153.  
  154.           PKWARE also monitors support conferences on Relaynet, ILink
  155.                 and SmartNet
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                      3
  178.  
  179.      4.  REGISTRATION INFORMATION
  180.      ────────────────────────────────────────────────────────
  181.  
  182.      If you find PKLITE fast, easy, and convenient to use, you can
  183.      become a registered user.  As a registered user, you will receive
  184.      a diskette with the current version of PKLITE and a printed
  185.      manual for the software.  You will also receive, when available,
  186.      a free upgrade of PKLITE.
  187.  
  188.      Please state the version number of the software you are presently
  189.      using.  For registration information, including price
  190.      information, contact PKWARE at the following location:
  191.  
  192.  
  193.              PKWARE, Inc.
  194.              9025 North Deerwood Drive
  195.              Brown Deer, WI 53223
  196.  
  197.              (414) 354-8699  Voice
  198.              (414) 354-8559  Fax
  199.              (414) 354-8670  BBS
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                      4
  237.  
  238.      5.  SOFTWARE LICENSE
  239.      ─────────────────────────────────────────────────────────
  240.  
  241.      The software license agreement is shown below.
  242.  
  243.  
  244.      PKLITE (tm)   Executable File Compressor   Version 1.13    8-01-91
  245.      Copyright 1990-1991 PKWARE Inc.  All Rights Reserved.  Patent Pending
  246.  
  247.  
  248.      You are free to use, copy and distribute PKLITE for noncommercial
  249.      use IF:
  250.  
  251.       - No fee is charged for use, copying or distribution.
  252.  
  253.       - It is not modified in any way.
  254.  
  255.      Usage of the software to create compressed executables for
  256.      commercial software requires registration of the PKLITE
  257.      Professional Package (tm) for $146.  This version includes an
  258.      extra compression option so that compressed executables cannot be
  259.      uncompressed by PKLITE.
  260.  
  261.      PKWARE hereby disclaims all warranties relating to this
  262.      software, whether express or implied, including without
  263.      limitation any implied warranties of merchantability or fitness
  264.      for a particular purpose. PKWARE will not be liable for any
  265.      special, incidental, consequential, indirect or similar damages
  266.      due to loss of data or any other reason, even if PKWARE or an
  267.      agent of PKWARE has been advised of the possibility of such
  268.      damages.  In no event shall PKWARE's liability for any damages
  269.      ever exceed the price paid for the license to use software,
  270.      regardless of the form of the claim.  The person using the
  271.      software bears all risk as to the quality and performance of the
  272.      software.
  273.  
  274.      If you find PKLITE easy, and convenient to use, a registration of
  275.      $46.00 would be appreciated.  Registration includes one free
  276.      upgrade to the software and a printed manual.  Please state the
  277.      version of the software that you currently have.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                      5
  296.  
  297.      II.  USING PKLITE
  298.      ─────────────────────────────────────────────────────────
  299.  
  300.      This section describes the command line structure of PKLITE and
  301.      explains the options.
  302.  
  303.  
  304.  
  305.      1.  EXPLANATION OF THE COMMAND LINE
  306.      ─────────────────────────────────────────────────────────
  307.  
  308.      PKLITE is an easy to use file compression program.  All of the
  309.      commands used with PKLITE are entered on the command line at the
  310.      DOS prompt.  The command options used with PKLITE are explained
  311.      in detail in the following section, along with examples.
  312.  
  313.  
  314.      The PKLITE command line structure is shown below.
  315.  
  316.  
  317.      PKLITE  [options] [d:][path] Infile  [[d:][path] Outfile]
  318.  
  319.  
  320.           PKLITE = The PKWARE executable compression program.
  321.  
  322.           options = The different PKLITE options that you can specify.
  323.  
  324.           [d:] [path] Infile = The name and path location of the
  325.                executable file being compressed (or expanded),
  326.                also know as the source file.
  327.  
  328.           [d:] [path] Outfile = The name and path location of the
  329.                destination file you want to rename or to
  330.                relocate the compressed or expanded file.
  331.  
  332.  
  333.      NOTE:  Parameters listed in [ ] are optional.
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                      6
  355.  
  356.      EXAMPLES:
  357.  
  358.      A simple example is shown below.
  359.  
  360.      C:\DOS> PKLITE  attrib.exe
  361.  
  362.      In this example the file attrib.exe will be compressed and the
  363.      compressed version of the file will overwrite the original
  364.      version.  After you type the command shown above, PKLITE will
  365.      display the following information on the screen.
  366.  
  367.  
  368.      PKLITE (tm)   Executable File Compressor   Version 1.13    8-01-91
  369.      Copyright 1990-1991 PKWARE Inc.  All Rights Reserved.  Patent Pending
  370.  
  371.      Compressing: attrib.exe
  372.      Original Size: 10656  Compressed Size: 6790   Ratio: 36.3
  373.  
  374.  
  375.      After a file is compressed with PKLITE, it will display several
  376.      pieces of important information.  PKLITE will list the name of
  377.      the original file, original size of the file, the compressed
  378.      size, and the compression ratio.  The output filename and
  379.      location will also be listed if they are different than the
  380.      original filename and location.  An example is shown below.
  381.  
  382.  
  383.      The following example illustrates the use of an output file to
  384.      change the name and location of the file after it is compressed.
  385.  
  386.  
  387.      C:\> PKLITE  light.exe  A:smlight.exe
  388.  
  389.      PKLITE (tm)   Executable File Compressor   Version 1.13    8-01-91
  390.      Copyright 1990-1991 PKWARE Inc.  All Rights Reserved.  Patent Pending
  391.  
  392.      Compressing: LIGHT.EXE into file A:SMLIGHT.EXE
  393.      Original Size: 18466   Compressed Size: 12299   Ratio: 33.4
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                      7
  414.  
  415.      Listed below is a summary of important facts to keep in mind
  416.      while using PKLITE.
  417.  
  418.      -The commands can be typed using either upper case or lower case.
  419.  
  420.      -All command options for the software must be preceded by a '-'
  421.       character or the MS-DOS switch character (usually '/').
  422.  
  423.      -Options can be combined (i.e. "-o -b" or "-ob").
  424.  
  425.      -If no extension for the source file is specified, PKLITE will
  426.       automatically compress any files with that particular name and a
  427.       .EXE or .COM extension.
  428.  
  429.      -If no destination file is listed on the command line, the
  430.       compressed file will have the same name as the source file and
  431.       will be located in the same directory (i.e. it will overwrite
  432.       the source file).
  433.  
  434.      -Typing PKLITE on the command line with no options, will bring up
  435.       a help screen listing all the program options.
  436.  
  437.  
  438.       CAUTION
  439.  
  440.           It is very important that you do not use PKLITE on original
  441.           program diskettes.  You should always make a copy of the
  442.           original diskettes that are supplied with an application,
  443.           and work only from the copies.  All original diskettes
  444.           should be kept in safe place.
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.                                      8
  473.  
  474.      The following table lists all the options available with PKLITE.
  475.      A brief summary is also given in the table.  The options are
  476.      explained in detail, along with programming examples in the
  477.      following section.
  478.  
  479.  
  480.  
  481.                         PKLITE COMMAND OPTIONS
  482.          ───────────────────────────────────────────────────
  483.          Option      Summary
  484.  
  485.            -a        Always compress files with internal overlays
  486.                      and optimize relocations.
  487.  
  488.            -b        Make backup .BAK file of original.
  489.  
  490.            -e        Extra compression method. (Commercial Version)
  491.  
  492.            -l        Display software license screen.
  493.  
  494.            -n        Never compress files with overlays or optimize 
  495.                      relocations.
  496.  
  497.            -o        Overwrite output file if it exists.
  498.  
  499.            -r        Remove extra .EXE data.
  500.  
  501.            -u        Update file time/date to current time/date.
  502.  
  503.            -x        Expand a compressed file.
  504.  
  505.          ────────────────────────────────────────────────────
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                                      9
  534.  
  535.      2.  PKLITE OPTIONS
  536.      ─────────────────────────────────────────────────────────
  537.  
  538.      The PKLITE options are described below.
  539.  
  540.  
  541.      -a   Always Compress Files With Internal Overlays and Optimize
  542.           Relocations
  543.  
  544.        This option is used to tell PKLITE to always compress files even
  545.        though they use internal overlays.  Programs which use overlays
  546.        loaded from .EXE files, may not run normally when in compressed
  547.        form.  PKLITE will detect if a program file contains internal
  548.        overlays.  It will prompt you for confirmation before it
  549.        compresses any files with overlays if you do not use the -a
  550.        option.
  551.  
  552.        This option will also tell PKLITE to always optimize headers.
  553.        PKLITE 1.13 tests the relocation table to see if it can be optimized
  554.        for better compression.  This performs the same operation as
  555.        running HDROPT before PKLITE.  
  556.  
  557.          C:\> PKLITE  -a  *.EXE
  558.  
  559.        In the example shown above, PKLITE will compress all of the .EXE
  560.        files in the current directory even if internal overlays are
  561.        detected.  You will not be prompted for confirmation before any
  562.        files are compressed.  The files will overwrite the original
  563.        files since there is no destination directory specified.
  564.  
  565.  
  566.        NOTE:  Overlay data is not compressed by PKLITE, however the load
  567.        image data located before the overlay data is compressed.  Some
  568.        programs require that the overlay data in the .EXE file be
  569.        located at a specified point in the .EXE file.  These programs
  570.        will not run correctly when compressed with PKLITE.  Programs
  571.        that do not run correctly can be returned to their original state
  572.        with the -x option.
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                      10
  593.  
  594.      -b   Make Backup .BAK File of Original
  595.  
  596.        This option will create a backup file of the original
  597.        uncompressed file with a .BAK extension.  The file will be
  598.        located in the same directory as the original file.
  599.  
  600.        If you use the -b option when a file with the same name as the
  601.        source file and a .BAK extension already exists at the
  602.        destination, it will be overwritten.
  603.  
  604.        If an output file is specified with the -b option, the -b option
  605.        will be ignored.
  606.  
  607.          C:\GAMES> PKLITE  -b  GAME.EXE
  608.  
  609.        In the example shown above, the program GAME.EXE will be
  610.        compressed, and a backup of the original file called GAME.BAK
  611.        will be created and located in the GAMES directory.
  612.  
  613.  
  614.        You can also retain the original file in its uncompressed state
  615.        by specifying a destination file on the command line by using the
  616.        [[d:][path] Outfile] option.  By using this feature, you rename
  617.        the compressed file and retain the source file in its original
  618.        form.
  619.  
  620.          C:\PK> PKLITE  PROG.COM  PROGCMP.COM
  621.  
  622.        In this example, the file PROG.COM will be compressed and the
  623.        compressed version of the file will be named PROGCMP.COM.  By
  624.        renaming the file, the uncompressed version of the file
  625.        (PROG.COM) will be retained in its original form.
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.                                      11
  652.  
  653.      -e   Use Extra Compression Method
  654.  
  655.        (* Option available only in PKLITE Professional version *)
  656.  
  657.        This option is used to produce the smallest executable files.  It
  658.        uses a slightly different algorithm, which also scrambles the
  659.        excutable file.  This scrambling makes the executable data more
  660.        resistant to disassembly or "reverse engineering" procedures.
  661.        After a file is compressed using this method, it cannot be
  662.        expanded to match the original executable file.  If you attempt
  663.        to expand it using the -x option, PKLITE will return a message
  664.        stating the file cannot be expanded.  This option is ideal for
  665.        software developers who wish to distribute their programs in
  666.        compressed form.
  667.  
  668.          C:\DATA> PKLITE  -e  TEST.EXE  A:
  669.  
  670.        In the example shown above, PKLITE will use the extra compression
  671.        method to compress TEST.EXE.  The compressed file will be located
  672.        on the A: drive.
  673.  
  674.  
  675.      -l   Display software license screen
  676.  
  677.        This option is used to display the PKLITE software license
  678.        agreement.  It is also printed on page 5 of this manual.  To
  679.        display the license agreement, type the following on the command
  680.        line.
  681.  
  682.          C:\> PKLITE  -l
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.                                      12
  711.  
  712.      -n   Never Compress Files With Overlays or Optimize Relocation Table
  713.  
  714.        This option is used to tell PKLITE to never compress files that
  715.        use overlays.  Programs which use overlays loaded from .EXE
  716.        files, may not run normally when in compressed form.  PKLITE will
  717.        detect when a program file contains overlays and will
  718.        automatically skip it.  If you do not use this feature, PKLITE
  719.        will prompt you for confirmation before compressing any files
  720.        with overlays.
  721.  
  722.          C:\DATA> PKLITE  -n  *.EXE  C:\DATA\COMP
  723.  
  724.        In the example shown above, PKLITE will compress all of the .EXE
  725.        files in the DATA directory as long as they do not use overlays.
  726.        The compressed files will be placed in the C:\DATA\COMP
  727.        destination directory.
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.                                      13
  770.  
  771.      -o   Overwrite Output File if it Exists
  772.  
  773.        This option is used when you specify a destination file (output
  774.        file) on the command line.  If a file with the same name as the
  775.        output file that you have specified already exists at the
  776.        destination, it will automatically be overwritten when you use
  777.        this command.  If you do not use this option, PKLITE will prompt
  778.        you for confirmation before it overwriting any existing output
  779.        file.
  780.  
  781.          C:\PKWARE> PKLITE  -o  PROG.EXE  A:\TINYPROG.EXE
  782.  
  783.        In the example shown above, PKLITE will compress PROG.EXE and
  784.        will locate the compressed version of the program on the A:
  785.        drive.  The compressed version of the program will be named
  786.        TINYPROG.EXE.  If a file called TINYPROG.EXE already exists on
  787.        the A: drive, it will automatically be overwritten.
  788.  
  789.        NOTE:  The -o option is only necessary if a output file is
  790.        specified.
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.                                      14
  829.  
  830.      -r   Remove Extra .EXE Data
  831.  
  832.        This option will compress a file and discard any data appended
  833.        after the load image data.  This data could be setup information,
  834.        overlay data, or debugging information.
  835.  
  836.        The -r option should be used only when you are sure there is
  837.        extra data in the file located after the load image data.  Only
  838.        use this option if you know you will no longer need this extra
  839.        data.  It may delete overlay or other important data.
  840.  
  841.          C:\NET>  PKLITE  -r  *.EXE
  842.  
  843.        This example will compress all of the files in the C:\NET
  844.        directory that have a .EXE extension.  It will also discard any
  845.        data appended to the files.
  846.  
  847.  
  848.        CAUTION
  849.  
  850.           This option should be used with caution.  It can endanger the
  851.           operation of the files being compressed.
  852.  
  853.           THE EXTRA DATA CANNOT BE RESTORED WITH THE -X.
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.                                      15
  888.  
  889.      -u   Update File Time/Date to Current Time/Date
  890.  
  891.        This option will assign the current time and date to the file
  892.        that you are compressing.  If you do not use this option, the
  893.        time and date of the compressed file will be set to the time and
  894.        date of the original file by default.
  895.  
  896.          C:\PKWARE> PKLITE  -u  FILE.COM  B:
  897.  
  898.        In the example shown above, the program FILE.COM will be
  899.        compressed and the compressed version of the program will be
  900.        located on the B: drive.  The compressed file will retain the
  901.        same name (FILE.COM) as the original file.  However, the time and
  902.        date will be updated to the current time and date at the time the
  903.        file was compressed.
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.                                      16
  947.  
  948.      -x   Expand a Compressed File
  949.  
  950.        This option will expand any files you have compressed with
  951.        PKLITE.  When you use this option, the file will be returned to
  952.        its original size.  You can rename and/or relocate a file when
  953.        you expand it by using the [[d:][path] Outfile] option on the
  954.        command line.
  955.  
  956.          C:\> PKLITE  -x  FILE.EXE  A:
  957.  
  958.        In the example shown above, the compressed file FILE.EXE will be
  959.        expanded and the expanded file will be located on the A: drive.
  960.  
  961.        After a compressed file is expanded, PKLITE will display several
  962.        important facts.  PKLITE will list the name of the compressed
  963.        file, original (compressed) size of the file, and the expanded
  964.        size of the file.  The output file and location will also be
  965.        listed if appropriate.  An example is shown below.
  966.  
  967.          C:\> PKLITE  -x FILE1.EXE  FILE2
  968.  
  969.        Expanding: FILE1.EXE into file FILE2.EXE
  970.        Original Size: 12299    Expanded Size: 18466
  971.  
  972.  
  973.        NOTE:  The expand option can be used with the following options:
  974.  
  975.           -b  Create Backup file
  976.           -o  Overwrite option
  977.           -u  Update time/date
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.                                      17
  1006.  
  1007.      When the -x option is used with the -b option, a backup of the
  1008.      compressed version of the file will be created with a .BAK
  1009.      extension.
  1010.  
  1011.      When the -x option is used with the -o option, PKLITE will
  1012.      overwrite any same-named files without prompting you for
  1013.      confirmation.
  1014.  
  1015.      You can also use the -x option along with the -u Update option to
  1016.      update to the current time and date when expanding a file.  (If
  1017.      you used the -u Update time/date option when you compressed the
  1018.      program, then when you expand it, it will retain the new time and
  1019.      date.  The time/date does not return to the original value.)
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.                                      18
  1065.  
  1066.      III.  PROGRAMS THAT SHOULD NOT BE COMPRESSED
  1067.      ─────────────────────────────────────────────────────────
  1068.  
  1069.      PKLITE can compress most executable files.  However, there are
  1070.      some applications that cannot be compressed, or do not run
  1071.      correctly when compressed.  The following is a sample list of
  1072.      such programs.
  1073.  
  1074.      COMMAND.COM   MS DOS Command interpreter and shell.
  1075.  
  1076.                This program has a self-contained loader.  It will
  1077.                attempt to load data which is compressed and fail.
  1078.  
  1079.      CV.EXE    Microsoft Codeview debugging program.
  1080.                When run in compressed form, the program returns:
  1081.                Invalid format in CV.EXE.
  1082.  
  1083.                The program does a run time check on the .EXE file, and
  1084.                in compressed form the error is reported.  PKLITE
  1085.                cannot detect this and compresses the file without any
  1086.                warnings.
  1087.  
  1088.  
  1089.      C2.EXE    Part of Microsoft C 6.00 compiler.
  1090.                When run in compressed form it reports:
  1091.                   Overlay not found.
  1092.  
  1093.                This is an example of a program with internal overlays
  1094.                where the overlay manager works incorrectly with the
  1095.                compressed .EXE file.  When compressing with PKLITE,
  1096.                the overlay data will be detected and the user will be
  1097.                prompted as to whether this file should be compressed.
  1098.  
  1099.  
  1100.      FOXPRO.EXE   FoxPro 1.00 - 1.02 Database program.
  1101.  
  1102.                This program contains internal overlays.  It will not
  1103.                run correctly when in compressed form.
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                      19
  1122.  
  1123.      PIFEDIT.EXE  Microsoft Windows PIF editing program.
  1124.  
  1125.                PKLITE cannot compress any Microsoft Windows executable
  1126.                files.  PKLITE detects whether the file being
  1127.                compressed is a Windows application, and will not
  1128.                attempt to compress it.
  1129.  
  1130.  
  1131.      MAKEINI.EXE  OS/2 program.
  1132.  
  1133.                PKLITE cannot compress any OS/2 executable files.
  1134.                PKLITE detects whether the file being compressed is an
  1135.                OS/2 application, and will not attempt to compress it.
  1136.  
  1137.  
  1138.      Programs that modify the executable file.
  1139.  
  1140.                Programs that modify the load image data in a
  1141.                executable file will not work correctly in the
  1142.                compressed state.  Many programs have setup programs
  1143.                that modify the executable file itself.  An example of
  1144.                this would be the PUTAV program in PKZIP version 1.10.
  1145.                If run on a compressed version of PKZIP, the message
  1146.                "Error in: PKZIP.EXE" will be displayed.  The PKZIP
  1147.                program should be expanded to its original size with
  1148.                the -x option before running PUTAV.  After installing
  1149.                the AV, PKZIP may be recompressed.
  1150.  
  1151.                Programs that modify the extra overlay data or data
  1152.                stored at the end of the .EXE file may run correctly in
  1153.                compressed form, since only the load image data is
  1154.                compressed by PKLITE.  StupenDOS version 2.0 is an
  1155.                example of such a program.  Setup information is
  1156.                appended to the .EXE file.  Therefore, saving the setup
  1157.                works correctly with StupenDOS even when in compressed
  1158.                form.
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.                                      20
  1181.  
  1182.      IV.  PKLITE ERROR MESSAGES
  1183.      ─────────────────────────────────────────────────────────
  1184.  
  1185.      The following error messages may appear when using PKLITE.  A
  1186.      brief explanation of each message along with possible solutions
  1187.      is listed below.  The DOS errorlevel value returned with each
  1188.      error is also listed.
  1189.  
  1190.      1  Syntax Error
  1191.  
  1192.           This error appears when the PKLITE command line you have
  1193.           entered contains a syntax error.  When this occurs, PKLITE
  1194.           will print the help screen showing all the program options
  1195.           on the monitor.
  1196.  
  1197.      2  File extension must be EXE or COM
  1198.  
  1199.           The file you have attempted to compress does not have a .EXE
  1200.           or .COM extension.  If the file is in fact an executable
  1201.           file, you can rename the file with a .EXE or .COM extension
  1202.           and then compress it.
  1203.  
  1204.      3  Cannot open input file
  1205.  
  1206.           The file you have attempted to compress cannot be opened by
  1207.           PKLITE.  Either a disk error occurred, or the file is locked
  1208.           by another application.  You must make sure it is a true
  1209.           executable file.
  1210.  
  1211.      4  Could not open output file
  1212.  
  1213.           PKLITE could not create the output file.  Either a disk
  1214.           error has occurred, or the file is locked by another
  1215.           application.  If you have specified an output file, make
  1216.           sure it is a valid filename and location.
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.                                      21
  1240.  
  1241.      5  Write error
  1242.  
  1243.           An error has occurred in writing a file to disk.  PKLITE is
  1244.           not able to write to a necessary file.  Either a disk error
  1245.           has occurred, or the file is locked by another application.
  1246.  
  1247.      6  Disk full error
  1248.  
  1249.           There is not enough disk space available on the destination
  1250.           drive for the file being created.  PKLITE never deletes the
  1251.           original file until it is finished writing the compressed
  1252.           file, therefore, there must be enough free disk space for
  1253.           the compressed file and the original file.  Try to free up
  1254.           more disk space.
  1255.  
  1256.      7  Read error
  1257.  
  1258.           PKLITE is not able to read a specified file.  Check the
  1259.           file;  it may be corrupted.
  1260.  
  1261.      8  Create error
  1262.  
  1263.           The named file could not be created.  Check the output
  1264.           directory; it may be invalid or full.
  1265.  
  1266.      9  Memory error
  1267.  
  1268.           There is insufficient memory available to process the
  1269.           command.  Try making more memory available.  PKLITE requires
  1270.           a minimum of 85K memory.
  1271.  
  1272.      10  Cannot compress file into itself
  1273.  
  1274.           The file being compressed and the output file are the same.
  1275.           When specifying an output file, make sure the output file is
  1276.           not the same as the input file.
  1277.           Incorrect:  PKLITE   pat.exe  pat
  1278.           Correct:    PKLITE   pat.exe
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.                                      22
  1299.  
  1300.      11  EXE header error
  1301.  
  1302.           The header information of the file contains too much
  1303.           information to be compressed.  If memory is limited,
  1304.           increasing the amount of memory available to PKLITE may
  1305.           help.
  1306.  
  1307.      12  No extract code error
  1308.  
  1309.           You are attempting to expand a file (with -x) but the
  1310.           extract code is corrupted or missing.  Make sure the file
  1311.           has been compressed with PKLITE.
  1312.  
  1313.      13  Data error
  1314.  
  1315.           An error has been detected in the compressed data.  The file
  1316.           is corrupted.
  1317.  
  1318.      14  Compressing many files into one file error
  1319.  
  1320.           You are attempting to compress multiple files into one
  1321.           output file.  For example:  PKLITE  *.exe  file.exe.
  1322.           Correct the command line.
  1323.  
  1324.      15  Output wildcards error
  1325.  
  1326.           The output path/file cannot contain any wildcard characters
  1327.           ('*' or '?').  Correct the command line.
  1328.  
  1329.      MS-DOS, Codeview, C Optimizing Compiler, Windows and OS/2 are
  1330.      trademarks or registered trademarks of Microsoft Corp.
  1331.      Foxpro is a trademark of Fox Software.
  1332.      PKZIP, PKUNZIP are registered trademarks of PKWARE, Inc.
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.                                      23
  1358.  
  1359.