home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / GENUTIL / pklte150.exe / PKLITE.DOC < prev    next >
Text File  |  1995-04-10  |  31KB  |  1,359 lines
  1.  
  2.                                  PKLITE (R)
  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 are
  183.      strongly encouraged to register.  As a registered user, you will
  184.      receive a diskette with the current version of PKLITE and a printed
  185.      manual for the software.  You will also receive, when available,
  186.      one 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 (R) Reg. U.S. Pat. and Tm. Off. Executable File Compressor
  245.      Copr. 1990-1995 PKWARE Inc. All Rights Reserved. Patent No. 5,051,745
  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 (tm) package 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 use PKLITE on a regular basis you are strongly encouraged to
  275.      register it.  With a registration of US $46.00 you will receive a
  276.      printed manual, the latest version of PKLITE, and when available,
  277.      the next version of the software.  Please state the version of
  278.      the software that you currently have.
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                                      5
  297.  
  298.      II.  USING PKLITE
  299.      ─────────────────────────────────────────────────────────
  300.  
  301.      This section describes the command line structure of PKLITE and
  302.      explains the options.
  303.  
  304.  
  305.  
  306.      1.  EXPLANATION OF THE COMMAND LINE
  307.      ─────────────────────────────────────────────────────────
  308.  
  309.      PKLITE is an easy to use file compression program.  All of the
  310.      commands used with PKLITE are entered on the command line at the
  311.      DOS prompt.  The command options used with PKLITE are explained
  312.      in detail in the following section, along with examples.
  313.  
  314.  
  315.      The PKLITE command line structure is shown below.
  316.  
  317.  
  318.      PKLITE  [options] [d:][path] Infile  [[d:][path] Outfile]
  319.  
  320.  
  321.           PKLITE = The PKWARE executable compression program.
  322.  
  323.           options = The different PKLITE options that you can specify.
  324.  
  325.           [d:] [path] Infile = The name and path location of the
  326.                executable file being compressed (or expanded),
  327.                also know as the source file.
  328.  
  329.           [d:] [path] Outfile = The name and path location of the
  330.                destination file you want to rename or to
  331.                relocate the compressed or expanded file.
  332.  
  333.  
  334.      NOTE:  Parameters listed in [ ] are optional.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.                                      6
  356.  
  357.      EXAMPLES:
  358.  
  359.      A simple example is shown below.
  360.  
  361.      C:\DOS> PKLITE  attrib.exe
  362.  
  363.      In this example the file attrib.exe will be compressed and the
  364.      compressed version of the file will overwrite the original
  365.      version.  After you type the command shown above, PKLITE will
  366.      display the following information on the screen.
  367.  
  368.  
  369.      PKLITE (R) Reg. U.S. Pat. and Tm. Off. Executable File Compressor
  370.      Copr. 1990-1995 PKWARE Inc. All Rights Reserved. Patent No. 5,051,745
  371.  
  372.      Compressing: attrib.exe
  373.      Original Size: 10656  Compressed Size: 6790   Ratio: 36.3
  374.  
  375.  
  376.      After a file is compressed with PKLITE, it will display several
  377.      pieces of important information.  PKLITE will list the name of
  378.      the original file, original size of the file, the compressed
  379.      size, and the compression ratio.  The output filename and
  380.      location will also be listed if they are different than the
  381.      original filename and location.  An example is shown below.
  382.  
  383.  
  384.      The following example illustrates the use of an output file to
  385.      change the name and location of the file after it is compressed.
  386.  
  387.  
  388.      C:\> PKLITE  light.exe  A:smlight.exe
  389.  
  390.      PKLITE (R) Reg. U.S. Pat. and Tm. Off. Executable File Compressor
  391.      Copr. 1990-1995 PKWARE Inc. All Rights Reserved. Patent No. 5,051,745
  392.  
  393.      Compressing: LIGHT.EXE into file A:SMLIGHT.EXE
  394.      Original Size: 18466   Compressed Size: 12299   Ratio: 33.4
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                                      7
  415.  
  416.      Listed below is a summary of important facts to keep in mind
  417.      while using PKLITE.
  418.  
  419.      -The commands can be typed using either upper case or lower case.
  420.  
  421.      -All command options for the software must be preceded by a '-'
  422.       character or the MS-DOS switch character (usually '/').
  423.  
  424.      -Options can be combined (i.e. "-o -b" or "-ob").
  425.  
  426.      -If no extension for the source file is specified, PKLITE will
  427.       automatically compress any files with that particular name and a
  428.       .EXE or .COM extension.
  429.  
  430.      -If no destination file is listed on the command line, the
  431.       compressed file will have the same name as the source file and
  432.       will be located in the same directory (i.e. it will overwrite
  433.       the source file).
  434.  
  435.      -Typing PKLITE on the command line with no options, will bring up
  436.       a help screen listing all the program options.
  437.  
  438.  
  439.       CAUTION
  440.  
  441.           It is very important that you do not use PKLITE on original
  442.           program diskettes.  You should always make a copy of the
  443.           original diskettes that are supplied with an application,
  444.           and work only from the copies.  All original diskettes
  445.           should be kept in safe place.
  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.  
  473.                                      8
  474.  
  475.      The following table lists all the options available with PKLITE.
  476.      A brief summary is also given in the table.  The options are
  477.      explained in detail, along with programming examples in the
  478.      following section.
  479.  
  480.  
  481.  
  482.                         PKLITE COMMAND OPTIONS
  483.          ───────────────────────────────────────────────────
  484.          Option      Summary
  485.  
  486.            -a        Always compress files with internal overlays
  487.                      and optimize relocations.
  488.  
  489.            -b        Make backup .BAK file of original.
  490.  
  491.            -e        Extra compression method. (Commercial Version)
  492.  
  493.            -l        Display software license screen.
  494.  
  495.            -n        Never compress files with overlays or optimize 
  496.                      relocations.
  497.  
  498.            -o        Overwrite output file if it exists.
  499.  
  500.            -r        Remove extra .EXE data.
  501.  
  502.            -u        Update file time/date to current time/date.
  503.  
  504.            -x        Expand a compressed file.
  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.  
  534.                                      9
  535.  
  536.      2.  PKLITE OPTIONS
  537.      ─────────────────────────────────────────────────────────
  538.  
  539.      The PKLITE options are described below.
  540.  
  541.  
  542.      -a   Always Compress Files With Internal Overlays and Optimize
  543.           Relocations
  544.  
  545.        This option is used to tell PKLITE to always compress files even
  546.        though they use internal overlays.  Programs which use overlays
  547.        loaded from .EXE files, may not run normally when in compressed
  548.        form.  PKLITE will detect if a program file contains internal
  549.        overlays.  It will prompt you for confirmation before it
  550.        compresses any files with overlays if you do not use the -a
  551.        option.
  552.  
  553.        This option will also tell PKLITE to always optimize headers.
  554.        PKLITE tests the relocation table to see if it can be optimized
  555.        for better compression.  This performs the same operation as
  556.        running HDROPT before PKLITE.  
  557.  
  558.          C:\> PKLITE  -a  *.EXE
  559.  
  560.        In the example shown above, PKLITE will compress all of the .EXE
  561.        files in the current directory even if internal overlays are
  562.        detected.  You will not be prompted for confirmation before any
  563.        files are compressed.  The files will overwrite the original
  564.        files since there is no destination directory specified.
  565.  
  566.  
  567.        NOTE:  Overlay data is not compressed by PKLITE, however the load
  568.        image data located before the overlay data is compressed.  Some
  569.        programs require that the overlay data in the .EXE file be
  570.        located at a specified point in the .EXE file.  These programs
  571.        will not run correctly when compressed with PKLITE.  Programs
  572.        that do not run correctly can be returned to their original state
  573.        with the -x option.
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.                                      10
  594.  
  595.      -b   Make Backup .BAK File of Original
  596.  
  597.        This option will create a backup file of the original
  598.        uncompressed file with a .BAK extension.  The file will be
  599.        located in the same directory as the original file.
  600.  
  601.        If you use the -b option when a file with the same name as the
  602.        source file and a .BAK extension already exists at the
  603.        destination, it will be overwritten.
  604.  
  605.        If an output file is specified with the -b option, the -b option
  606.        will be ignored.
  607.  
  608.          C:\GAMES> PKLITE  -b  GAME.EXE
  609.  
  610.        In the example shown above, the program GAME.EXE will be
  611.        compressed, and a backup of the original file called GAME.BAK
  612.        will be created and located in the GAMES directory.
  613.  
  614.  
  615.        You can also retain the original file in its uncompressed state
  616.        by specifying a destination file on the command line by using the
  617.        [[d:][path] Outfile] option.  By using this feature, you rename
  618.        the compressed file and retain the source file in its original
  619.        form.
  620.  
  621.          C:\PK> PKLITE  PROG.COM  PROGCMP.COM
  622.  
  623.        In this example, the file PROG.COM will be compressed and the
  624.        compressed version of the file will be named PROGCMP.COM.  By
  625.        renaming the file, the uncompressed version of the file
  626.        (PROG.COM) will be retained in its original form.
  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.  
  652.                                      11
  653.  
  654.      -e   Use Extra Compression Method
  655.  
  656.        (* Option available only in PKLITE Professional version *)
  657.  
  658.        This option is used to produce the smallest executable files.  It
  659.        uses a slightly different algorithm, which also scrambles the
  660.        executable file.  This scrambling makes the executable data more
  661.        resistant to disassembly or "reverse engineering" procedures.
  662.        After a file is compressed using this method, it cannot be
  663.        expanded to match the original executable file.  If you attempt
  664.        to expand it using the -x option, PKLITE will return a message
  665.        stating the file cannot be expanded.  This option is ideal for
  666.        software developers who wish to distribute their programs in
  667.        compressed form.
  668.  
  669.          C:\DATA> PKLITE  -e  TEST.EXE  A:
  670.  
  671.        In the example shown above, PKLITE will use the extra compression
  672.        method to compress TEST.EXE.  The compressed file will be located
  673.        on the A: drive.
  674.  
  675.  
  676.      -l   Display software license screen
  677.  
  678.        This option is used to display the PKLITE software license
  679.        agreement.  It is also printed on page 5 of this manual.  To
  680.        display the license agreement, type the following on the command
  681.        line.
  682.  
  683.          C:\> PKLITE  -l
  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.  
  711.                                      12
  712.  
  713.      -n   Never Compress Files With Overlays or Optimize Relocation Table
  714.  
  715.        This option is used to tell PKLITE to never compress files that
  716.        use overlays.  Programs which use overlays loaded from .EXE
  717.        files, may not run normally when in compressed form.  PKLITE will
  718.        detect when a program file contains overlays and will
  719.        automatically skip it.  If you do not use this feature, PKLITE
  720.        will prompt you for confirmation before compressing any files
  721.        with overlays.
  722.  
  723.          C:\DATA> PKLITE  -n  *.EXE  C:\DATA\COMP
  724.  
  725.        In the example shown above, PKLITE will compress all of the .EXE
  726.        files in the DATA directory as long as they do not use overlays.
  727.        The compressed files will be placed in the C:\DATA\COMP
  728.        destination directory.
  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.  
  770.                                      13
  771.  
  772.      -o   Overwrite Output File if it Exists
  773.  
  774.        This option is used when you specify a destination file (output
  775.        file) on the command line.  If a file with the same name as the
  776.        output file that you have specified already exists at the
  777.        destination, it will automatically be overwritten when you use
  778.        this command.  If you do not use this option, PKLITE will prompt
  779.        you for confirmation before it overwriting any existing output
  780.        file.
  781.  
  782.          C:\PKWARE> PKLITE  -o  PROG.EXE  A:\TINYPROG.EXE
  783.  
  784.        In the example shown above, PKLITE will compress PROG.EXE and
  785.        will locate the compressed version of the program on the A:
  786.        drive.  The compressed version of the program will be named
  787.        TINYPROG.EXE.  If a file called TINYPROG.EXE already exists on
  788.        the A: drive, it will automatically be overwritten.
  789.  
  790.        NOTE:  The -o option is only necessary if a output file is
  791.        specified.
  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.  
  829.                                      14
  830.  
  831.      -r   Remove Extra .EXE Data
  832.  
  833.        This option will compress a file and discard any data appended
  834.        after the load image data.  This data could be setup information,
  835.        overlay data, or debugging information.
  836.  
  837.        The -r option should be used only when you are sure there is
  838.        extra data in the file located after the load image data.  Only
  839.        use this option if you know you will no longer need this extra
  840.        data.  It may delete overlay or other important data.
  841.  
  842.          C:\NET>  PKLITE  -r  *.EXE
  843.  
  844.        This example will compress all of the files in the C:\NET
  845.        directory that have a .EXE extension.  It will also discard any
  846.        data appended to the files.
  847.  
  848.  
  849.        CAUTION
  850.  
  851.           This option should be used with caution.  It can endanger the
  852.           operation of the files being compressed.
  853.  
  854.           THE EXTRA DATA CANNOT BE RESTORED WITH THE -X.
  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.  
  888.                                      15
  889.  
  890.      -u   Update File Time/Date to Current Time/Date
  891.  
  892.        This option will assign the current time and date to the file
  893.        that you are compressing.  If you do not use this option, the
  894.        time and date of the compressed file will be set to the time and
  895.        date of the original file by default.
  896.  
  897.          C:\PKWARE> PKLITE  -u  FILE.COM  B:
  898.  
  899.        In the example shown above, the program FILE.COM will be
  900.        compressed and the compressed version of the program will be
  901.        located on the B: drive.  The compressed file will retain the
  902.        same name (FILE.COM) as the original file.  However, the time and
  903.        date will be updated to the current time and date at the time the
  904.        file was compressed.
  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.  
  947.                                      16
  948.  
  949.      -x   Expand a Compressed File
  950.  
  951.        This option will expand any files you have compressed with
  952.        PKLITE.  When you use this option, the file will be returned to
  953.        its original size.  You can rename and/or relocate a file when
  954.        you expand it by using the [[d:][path] Outfile] option on the
  955.        command line.
  956.  
  957.          C:\> PKLITE  -x  FILE.EXE  A:
  958.  
  959.        In the example shown above, the compressed file FILE.EXE will be
  960.        expanded and the expanded file will be located on the A: drive.
  961.  
  962.        After a compressed file is expanded, PKLITE will display several
  963.        important facts.  PKLITE will list the name of the compressed
  964.        file, original (compressed) size of the file, and the expanded
  965.        size of the file.  The output file and location will also be
  966.        listed if appropriate.  An example is shown below.
  967.  
  968.          C:\> PKLITE  -x FILE1.EXE  FILE2
  969.  
  970.        Expanding: FILE1.EXE into file FILE2.EXE
  971.        Original Size: 12299    Expanded Size: 18466
  972.  
  973.  
  974.        NOTE:  The expand option can be used with the following options:
  975.  
  976.           -b  Create Backup file
  977.           -o  Overwrite option
  978.           -u  Update time/date
  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.  
  1006.                                      17
  1007.  
  1008.      When the -x option is used with the -b option, a backup of the
  1009.      compressed version of the file will be created with a .BAK
  1010.      extension.
  1011.  
  1012.      When the -x option is used with the -o option, PKLITE will
  1013.      overwrite any same-named files without prompting you for
  1014.      confirmation.
  1015.  
  1016.      You can also use the -x option along with the -u Update option to
  1017.      update to the current time and date when expanding a file.  (If
  1018.      you used the -u Update time/date option when you compressed the
  1019.      program, then when you expand it, it will retain the new time and
  1020.      date.  The time/date does not return to the original value.)
  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.  
  1065.                                      18
  1066.  
  1067.      III.  PROGRAMS THAT SHOULD NOT BE COMPRESSED
  1068.      ─────────────────────────────────────────────────────────
  1069.  
  1070.      PKLITE can compress most executable files.  However, there are
  1071.      some applications that cannot be compressed, or do not run
  1072.      correctly when compressed.  The following is a sample list of
  1073.      such programs.
  1074.  
  1075.      COMMAND.COM   MS DOS Command interpreter and shell.
  1076.  
  1077.                This program has a self-contained loader.  It will
  1078.                attempt to load data which is compressed and fail.
  1079.  
  1080.      CV.EXE    Microsoft Codeview debugging program.
  1081.                When run in compressed form, the program returns:
  1082.                Invalid format in CV.EXE.
  1083.  
  1084.                The program does a run time check on the .EXE file, and
  1085.                in compressed form the error is reported.  PKLITE
  1086.                cannot detect this and compresses the file without any
  1087.                warnings.
  1088.  
  1089.  
  1090.      C2.EXE    Part of Microsoft C 6.00 compiler.
  1091.                When run in compressed form it reports:
  1092.                   Overlay not found.
  1093.  
  1094.                This is an example of a program with internal overlays
  1095.                where the overlay manager works incorrectly with the
  1096.                compressed .EXE file.  When compressing with PKLITE,
  1097.                the overlay data will be detected and the user will be
  1098.                prompted as to whether this file should be compressed.
  1099.  
  1100.  
  1101.      FOXPRO.EXE   FoxPro 1.00 - 1.02 Database program.
  1102.  
  1103.                This program contains internal overlays.  It will not
  1104.                run correctly when in compressed form.
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.                                      19
  1123.  
  1124.      PIFEDIT.EXE  Microsoft Windows PIF editing program.
  1125.  
  1126.                PKLITE cannot compress any Microsoft Windows executable
  1127.                files.  PKLITE detects whether the file being
  1128.                compressed is a Windows application, and will not
  1129.                attempt to compress it.
  1130.  
  1131.  
  1132.      MAKEINI.EXE  OS/2 program.
  1133.  
  1134.                PKLITE cannot compress any OS/2 executable files.
  1135.                PKLITE detects whether the file being compressed is an
  1136.                OS/2 application, and will not attempt to compress it.
  1137.  
  1138.  
  1139.      Programs that modify the executable file.
  1140.  
  1141.                Programs that modify the load image data in a
  1142.                executable file will not work correctly in the
  1143.                compressed state.  Many programs have setup programs
  1144.                that modify the executable file itself.  An example of
  1145.                this would be the PUTAV program in PKZIP version 1.10.
  1146.                If run on a compressed version of PKZIP, the message
  1147.                "Error in: PKZIP.EXE" will be displayed.  The PKZIP
  1148.                program should be expanded to its original size with
  1149.                the -x option before running PUTAV.  After installing
  1150.                the AV, PKZIP may be recompressed.
  1151.  
  1152.                Programs that modify the extra overlay data or data
  1153.                stored at the end of the .EXE file may run correctly in
  1154.                compressed form, since only the load image data is
  1155.                compressed by PKLITE.  StupenDOS version 2.0 is an
  1156.                example of such a program.  Setup information is
  1157.                appended to the .EXE file.  Therefore, saving the setup
  1158.                works correctly with StupenDOS even when in compressed
  1159.                form.
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.                                      20
  1182.  
  1183.      IV.  PKLITE ERROR MESSAGES
  1184.      ─────────────────────────────────────────────────────────
  1185.  
  1186.      The following error messages may appear when using PKLITE.  A
  1187.      brief explanation of each message along with possible solutions
  1188.      is listed below.  The DOS errorlevel value returned with each
  1189.      error is also listed.
  1190.  
  1191.      1  Syntax Error
  1192.  
  1193.           This error appears when the PKLITE command line you have
  1194.           entered contains a syntax error.  When this occurs, PKLITE
  1195.           will print the help screen showing all the program options
  1196.           on the monitor.
  1197.  
  1198.      2  File extension must be EXE or COM
  1199.  
  1200.           The file you have attempted to compress does not have a .EXE
  1201.           or .COM extension.  If the file is in fact an executable
  1202.           file, you can rename the file with a .EXE or .COM extension
  1203.           and then compress it.
  1204.  
  1205.      3  Cannot open input file
  1206.  
  1207.           The file you have attempted to compress cannot be opened by
  1208.           PKLITE.  Either a disk error occurred, or the file is locked
  1209.           by another application.  You must make sure it is a true
  1210.           executable file.
  1211.  
  1212.      4  Could not open output file
  1213.  
  1214.           PKLITE could not create the output file.  Either a disk
  1215.           error has occurred, or the file is locked by another
  1216.           application.  If you have specified an output file, make
  1217.           sure it is a valid filename and location.
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.                                      21
  1241.  
  1242.      5  Write error
  1243.  
  1244.           An error has occurred in writing a file to disk.  PKLITE is
  1245.           not able to write to a necessary file.  Either a disk error
  1246.           has occurred, or the file is locked by another application.
  1247.  
  1248.      6  Disk full error
  1249.  
  1250.           There is not enough disk space available on the destination
  1251.           drive for the file being created.  PKLITE never deletes the
  1252.           original file until it is finished writing the compressed
  1253.           file, therefore, there must be enough free disk space for
  1254.           the compressed file and the original file.  Try to free up
  1255.           more disk space.
  1256.  
  1257.      7  Read error
  1258.  
  1259.           PKLITE is not able to read a specified file.  Check the
  1260.           file;  it may be corrupted.
  1261.  
  1262.      8  Create error
  1263.  
  1264.           The named file could not be created.  Check the output
  1265.           directory; it may be invalid or full.
  1266.  
  1267.      9  Memory error
  1268.  
  1269.           There is insufficient memory available to process the
  1270.           command.  Try making more memory available.  PKLITE requires
  1271.           a minimum of 85K memory.
  1272.  
  1273.      10  Cannot compress file into itself
  1274.  
  1275.           The file being compressed and the output file are the same.
  1276.           When specifying an output file, make sure the output file is
  1277.           not the same as the input file.
  1278.           Incorrect:  PKLITE   pat.exe  pat
  1279.           Correct:    PKLITE   pat.exe
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.                                      22
  1300.  
  1301.      11  EXE header error
  1302.  
  1303.           The header information of the file contains too much
  1304.           information to be compressed.  If memory is limited,
  1305.           increasing the amount of memory available to PKLITE may
  1306.           help.
  1307.  
  1308.      12  No extract code error
  1309.  
  1310.           You are attempting to expand a file (with -x) but the
  1311.           extract code is corrupted or missing.  Make sure the file
  1312.           has been compressed with PKLITE.
  1313.  
  1314.      13  Data error
  1315.  
  1316.           An error has been detected in the compressed data.  The file
  1317.           is corrupted.
  1318.  
  1319.      14  Compressing many files into one file error
  1320.  
  1321.           You are attempting to compress multiple files into one
  1322.           output file.  For example:  PKLITE  *.exe  file.exe.
  1323.           Correct the command line.
  1324.  
  1325.      15  Output wildcards error
  1326.  
  1327.           The output path/file cannot contain any wildcard characters
  1328.           ('*' or '?').  Correct the command line.
  1329.  
  1330.      MS-DOS, Codeview, C Optimizing Compiler, FoxPro, Windows and OS/2
  1331.      are trademarks or registered trademarks of Microsoft Corp.
  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.