home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / PM_ZIP.ZIP / MANUAL.DOC < prev    next >
Text File  |  1989-07-21  |  140KB  |  4,048 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                                                        |
  8.                                                                        |
  9.                                                                        |
  10.                                                                PKWARE  |
  11.                                                                        |
  12.                                           The file compression system  |
  13.                                          where SPEED and SMALL SPACES  |
  14.                                                 make a BIG difference  |
  15.                                                                        |
  16.                                                                        |
  17.                                                                        |
  18.                                                                        |
  19.                                                                 PKZIP  |
  20.                                                               PKUNZIP  |
  21.                                                                 PKSFX  |
  22.                                                              PKZIPFIX  |
  23.                                                                        |
  24.                                                                        |
  25.                                                                        |
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                  PKZIP / PKUNZIP
  33.  
  34.           The following 12 files are included in PKWARE Version 1.01
  35.  
  36.                 PKZIP.EXE  Main compression program.
  37.               PKUNZIP.EXE  Main extraction program.
  38.  
  39.               MAKESFX.COM  Starts the process of creating self-
  40.                            extracting files
  41.               ZIP2EXE.EXE  Used in creating self-extracting files.
  42.  
  43.                README.DOC  General Information.
  44.              DEDICATE.DOC  Dedication of file format and extension to
  45.                            the public domain.
  46.                 ORDER.DOC  Registration information and order form.
  47.               LICENSE.DOC  Information on Site and Distribution Licenses.
  48.              OMBDSMAN.ASP  Association of Shareware Professionals info.
  49.                MANUAL.DOC  Reference manual for PKWARE File Compression
  50.                            Programs.
  51.               APPNOTE.TXT  Technical background material.
  52.  
  53.              PKZIPFIX.EXE  Reconstructs corrupted ZIP files.
  54.  
  55.  
  56.  
  57.                                  PKWARE FEATURES
  58.  
  59.           The following features are available with PKWARE Version 1.0
  60.           (PKZIP/PKUNZIP/PKSFX) Compression Programs.
  61.  
  62.  
  63.           1.  Improved Compression!  PKZIP 1.0 implements a new compression
  64.               algorithm called Imploding, which averages 5% to 15% better
  65.               compression than the maximal compression (Reducing) of
  66.               PKZIP 0.92.  Imploding is also faster at compressing and
  67.               extracting than Reducing was.
  68.  
  69.           2.  Password encryption.  Sensitive data files can be scrambled
  70.               with password protection.
  71.  
  72.           3.  Automatic detection and utilization of 80386 CPU's.  PKZIP
  73.               and PKUNZIP test for the presence of an 80386 CPU.  If
  74.               present, PKZIP and PKUNZIP will use the 80386's 32 bit
  75.               instructions and extended addressing modes for improved
  76.               performance.
  77.  
  78.           4.  Special file handling capabilities will automatically
  79.               recurse through subdirectories and store pathnames within
  80.               a ZIP file.  These paths can then be created on extraction
  81.               if they do not already exist.
  82.  
  83.           5.  Extra compression options allow you to specify the method
  84.               of compression (Shrinking or Imploding) to be employed.
  85.  
  86.  
  87.      PKWARE                           -2-
  88.  
  89.  
  90.  
  91.           6.  A file that has been created as a self-extracting file can
  92.               be treated as a normal ZIP file.  All PKZIP and PKUNZIP
  93.               options (except -v  View) will be valid.
  94.  
  95.           7.  Files contained in a ZIP file can be viewed in several
  96.               different ways.  For example, the can be sorted by:
  97.               compression ratio, size, date, name, or extension.
  98.  
  99.           8.  A new option, -x, can be used to specify files to be excluded
  100.               from any ZIP operation being performed.
  101.  
  102.           9.  Special file attributes (hidden, read-only, system) can be
  103.               masked during creation or extraction of a ZIP file.  PKZIP
  104.               can also be configured to include or not include hidden and
  105.               system files.
  106.  
  107.           10. ANSI comments may be enabled/disabled.
  108.  
  109.           11. Expanded Configuration file options are available.
  110.  
  111.           12. Individual file comments (up to 60 characters in length)
  112.               can be programmed for each file in the ZIP file.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.      PKWARE                           -3-
  148.  
  149.  
  150.  
  151.  
  152.  
  153.                                      CONTENTS
  154.  
  155.  
  156.            1.  INTRODUCTION TO FILE COMPRESSION . . . . . . . . . . . . 5
  157.                A.  File Compression . . . . . . . . . . . . . . . . . . 6
  158.                B.  Two Related Programs - PKZIP & PKUNZIP . . . . . . . 6
  159.                C.  File Compression Terms . . . . . . . . . . . . . . . 7
  160.                D.  Use of Hard and Floppy Disk Systems. . . . . . . . . 7
  161.                E.  General Rules and Default Settings . . . . . . . . . 9
  162.                F.  PKWARE System Limits . . . . . . . . . . . . . . . . 11
  163.  
  164.  
  165.            2.  SUPER QUICK  . . . . . . . . . . . . . . . . . . . . . . 12
  166.                A.  QUICK START - Extracting a File from a BBS . . . . . 12
  167.                B.  Use of PKWARE in Telecommunications - BBS  . . . . . 13
  168.  
  169.  
  170.            3.  PKZIP - COMPRESS FILES INTO ZIP FILES  . . . . . . . . . 15
  171.                A.  QUICK START - Create a ZIP file. . . . . . . . . . . 16
  172.                B.  PKZIP Reference Guide  . . . . . . . . . . . . . . . 18
  173.                C.  Description of Command Options . . . . . . . . . . . 19
  174.  
  175.  
  176.            4.  PKUNZIP - EXTRACT ZIP FILES  . . . . . . . . . . . . . . 36
  177.                A.  QUICK START - Extract a ZIP File . . . . . . . . . . 37
  178.                B.  PKUNZIP Reference Guide  . . . . . . . . . . . . . . 39
  179.                C.  Description of Command Options . . . . . . . . . . . 40
  180.  
  181.  
  182.            5.  PKSFX - SELF-EXTRACTION UTILITY  . . . . . . . . . . . . 50
  183.                A.  Creating a Self-Extracting ZIP file  . . . . . . . . 51
  184.                B.  PKSFX Reference Guide  . . . . . . . . . . . . . . . 53
  185.  
  186.  
  187.            6.  SPECIAL HANDLING PROCEDURES  . . . . . . . . . . . . . . 54
  188.                A.  How a ZIP File is Made . . . . . . . . . . . . . . . 55
  189.                B.  Use of a RAM Disk with PKZIP . . . . . . . . . . . . 55
  190.                C.  LAN - Local Area Network Support . . . . . . . . . . 55
  191.                D.  Creating a Pre-Selected File List. . . . . . . . . . 56
  192.                E.  Batch File Processing  . . . . . . . . . . . . . . . 57
  193.                F.  The Configuration file . . . . . . . . . . . . . . . 58
  194.                G.  PKWARE Error Messages  . . . . . . . . . . . . . . . 61
  195.                H.  PKZIPFIX - File Reconstruction . . . . . . . . . . . 65
  196.  
  197.  
  198.            7.  REGISTRATION AND BACKGROUND  . . . . . . . . . . . . . . 66
  199.                A.  Technical Support  . . . . . . . . . . . . . . . . . 67
  200.                B.  Other Background Information . . . . . . . . . . . . 67
  201.                C.  Registration Information . . . . . . . . . . . . . . 67
  202.                D.  Software License . . . . . . . . . . . . . . . . . . 68
  203.  
  204.  
  205.  
  206.  
  207.      PKWARE                           -4-
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.                                                                        |
  217.                                                                        |
  218.                                                                        |
  219.                                       INTRODUCTION TO FILE COMPRESSION |
  220.                                                                        |
  221.                                                       File Compression |
  222.                                 Two Related Programs - PKZIP & PKUNZIP |
  223.                                                 File Compression Terms |
  224.                                    Use of Hard and Floppy Disk Systems |
  225.                                     General Rules and Default Settings |
  226.                                                   PKWARE System Limits |
  227.                                                                        |
  228.                                                                        |
  229.                                                                        |
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.      PKWARE                           -5-
  268.  
  269.  
  270.  
  271.  
  272.                                     FILE COMPRESSION
  273.  
  274.  
  275.                The term "compression" means to reduce in size.   Computer
  276.           file compression refers to reducing files in size so that they
  277.           take up less storage space on disk.  PKZIP will perform this
  278.           reducing process quickly and easily.  The compressed files are
  279.           then stored in a special file called a ZIP file.
  280.  
  281.           ZIP files have three distinct benefits:
  282.  
  283.                1.  They use less disk space than normal files.  Storing
  284.                    files in compressed form increases the life and
  285.                    storage availability of your expensive hard disk.
  286.  
  287.                2.  Many individual files can be compressed into a single
  288.                    ZIP file.  This makes file group identification,
  289.                    copying, and transporting faster and easier.
  290.  
  291.                3.  Compressed files travel faster via modem which
  292.                    reduces telecommunication transmission and reception.
  293.                    Many BBS (computer bulletin board services) use
  294.                    PKWARE files as their standard.  This enables the BBS
  295.                    to store more files and you to have transfer files
  296.                    faster and easier.
  297.  
  298.  
  299.  
  300.                    TWO RELATED PKWARE PROGRAMS - PKZIP & PKUNZIP
  301.  
  302.                Together, PKZIP and PKUNZIP handle all of your file
  303.           compression needs.
  304.  
  305.                PKZIP is the program that compresses files.  This shrinking
  306.           process is often referred to as data compression.  Terms you will
  307.           see during the compressing process are Storing, Shrinking, and
  308.           Imploding.  PKZIP also handles all file maintenance including
  309.           adding and deleting files, as well as reporting on technical
  310.           information from within the compressed file.
  311.  
  312.                PKUNZIP is the program that uncompresses or extracts
  313.           compressed files.  In addition to extracting a complete ZIP file,
  314.           it can selectively release individual files, show files on the
  315.           screen for fast viewing, or print them out on a printer.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      PKWARE                           -6-
  328.  
  329.  
  330.  
  331.                             FILE COMPRESSION TERMS
  332.  
  333.                The following terms are used throughout this manual.
  334.  
  335.                FILE = The SINGLE name that identifies information on
  336.                     your floppy disk or hard drive.
  337.  
  338.                ZIP FILE = The file that holds file information that has
  339.                     been reduced in size for better storage.  It is
  340.                     sometimes called a compressed file or a library
  341.                     file.   A ZIP file can be made up of either one or
  342.                     more files compressed and stored together under one
  343.                     file name.
  344.  
  345.                FILE EXTRACTION  = The process of recreating files that
  346.                     have been previously compressed.
  347.  
  348.                FILE COMPRESSION  = is the process of reducing a file's
  349.                     size.  This is sometimes referred to as data
  350.                     compressing.
  351.  
  352.           ______________________________________________________________
  353.           |                                                            |
  354.           |   A ZIP file contains one or more files.                   |
  355.           |                                                            |
  356.           | MANUAL.ZIP contains -> chap1.txt  toc.txt  app.txt  cov.txt|
  357.           |                        All of these files are compressed   |
  358.           |                        and stored in one file.             |
  359.           |                                                            |
  360.           |                                                            |
  361.           |                                                            |
  362.           | BIG.ZIP   contains ->  Huge.Wks                            |
  363.           |                        This is a very large worksheet      |
  364.           |                        that has been shrunk in size for    |
  365.           |                        better storage and faster           |
  366.           |                        telecommunications.                 |
  367.           |____________________________________________________________|
  368.  
  369.  
  370.  
  371.  
  372.                   USING PKWARE WITH HARD AND FLOPPY DISK SYSTEMS
  373.  
  374.           PKWARE works BEST on a hard disk system.
  375.  
  376.            1.  Even though you are making files smaller, the process
  377.                used to shrink them can BRIEFLY DOUBLE the storage space
  378.                needed.  When a ZIP file is being modified (e.g. files
  379.                being added), the process creates a new ZIP file which
  380.                will be used as a REPLACEMENT for the old version.  Both
  381.                the OLD and the NEW versions will be on your disk until
  382.                just prior to the completion of the process.
  383.  
  384.  
  385.  
  386.  
  387.      PKWARE                           -7-
  388.  
  389.  
  390.  
  391.            2.  When you extract a ZIP file, the amount of space
  392.                needed to hold that file can double.  A large hard disk
  393.                drive normally insures that enough storage area is
  394.                available.
  395.  
  396.                Many compressed files are stored on floppy disks.  The
  397.                limit to floppy storage is the number of characters your
  398.                floppy system will hold:
  399.  
  400.                     Standard double density floppy     360K
  401.                     High density floppy                1.2 meg
  402.                     3-1/2" floppy                      .7 or 1.4 meg
  403.  
  404.                You may have problems either ADDING files to a ZIP file
  405.                stored on a floppy disk, or extracting files to a
  406.                floppy disk system when the number of characters in the
  407.                ZIP file is more than 50% of the available storage space
  408.                on the floppy disk.
  409.  
  410.  
  411.           Consider a standard floppy disk system:
  412.  
  413.           ______________________________________________________________
  414.           |                                                            |
  415.           |              Standard Floppy Disk Drive of 360K            |
  416.           |                                                            |
  417.           |  A:> BigFile.ZIP  has 250,000 characters                   |
  418.           |                                                            |
  419.           |     1.  In order to ADD files to BigFile.ZIP, you need     |
  420.           |         500,000 of space.  The extra space is used to      |
  421.           |         hold a new updated ZIP file created before the     |
  422.           |         old ZIP file is deleted.                           |
  423.           |                                                            |
  424.           |     2.  When BigFile is extracted, it might require        |
  425.           |         400,000 of space, but the available space on the   |
  426.           |         disk restricts it to 360,000.                      |
  427.           |____________________________________________________________|
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.      PKWARE                           -8-
  448.  
  449.  
  450.  
  451.  
  452.           There are a number of ways to avoid the limitations.  A thorough
  453.           knowledge of PKWARE Programs will show you how to:
  454.  
  455.                1.  Selectively extract files from a ZIP file.
  456.                    Instead of extracting everything at once, you can
  457.                    view file size information and then select SPECIFIC
  458.                    files to be extracted to a floppy.
  459.  
  460.                2.  If you have two floppy drives, create the ZIP file on
  461.                    your second disk drive so that you have the full 360K
  462.                    available to you.
  463.  
  464.                3.  Use the special  -b  command option, which routes the
  465.                    NEW file to an alternate disk drive during the
  466.                    compressing process then copies it back to the floppy
  467.                    disk upon completion.
  468.  
  469.  
  470.  
  471.                         GENERAL RULES AND DEFAULT SETTINGS
  472.  
  473.            1.  PKWARE programs MUST be located in:
  474.  
  475.                A.  The drive you are working on, OR . . .
  476.  
  477.                B.  Any directory accessible through the PATH= setting.
  478.  
  479.                    C:> PATH=C:/Utils
  480.  
  481.                In this example, PKWARE is in the Utils Directory.  The
  482.                computer will find and execute the program even though
  483.                you are in a different directory or drive because any
  484.                commands entered will be run through the PATH.  Consult
  485.                your MS-DOS documentation for more information.
  486.  
  487.                C.  Any directory through the use of PATH notation if you
  488.                    are using MS-DOS 3.0 or later.
  489.  
  490.                    C:>B:PKZIP  -a  OldFile.ZIP  *.*   PKZIP is located
  491.                                                       on the B:> drive
  492.  
  493.                    C:>\UTILS\PKZIP  -v  Stuff.ZIP     PKZIP is located
  494.                                                       in \UTILS as
  495.                                                       indicated in the
  496.                                                       PATH notation
  497.  
  498.            2.  All PKWARE program commands are typed at the prompt.
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.      PKWARE                           -9-
  508.  
  509.  
  510.  
  511.            3.  Typed information can generally be in upper case, lower
  512.                case, or a mixture, except where noted in the manual.
  513.                The following options are case sensitive:  -J -j, -W -w,
  514.                -C -c, -P -p, and the password for the -s option.  It is
  515.                recommended however, to use lower case when possible in
  516.                order to be compatible with future versions of PKWARE.
  517.  
  518.            4.  The DEFAULT is  *.*  or ALL FILES when specific files are
  519.                not named (except for the  -d  delete files option).
  520.  
  521.            5.  It is NOT necessary to type the extension  .ZIP  when
  522.                processing a ZIP file, it will be assumed.  The extension
  523.                is used in this documentation for clarity.
  524.  
  525.            6.  A help screen is displayed when you type the program name
  526.                (PKZIP or PKUNZIP) at the prompt then press <enter>.
  527.                Also typing  -h  on the command line will call up the
  528.                help screen.
  529.  
  530.            7.  The notation  PKUNZIP *  or  *.ZIP  will extract all
  531.                ZIP files within the given area.
  532.  
  533.            8.  During the extracting process, the notation *.* will
  534.                tell PKUNZIP to attempt to extract ALL files whether
  535.                they are ZIP files or not.  This could waste time, but
  536.                will not damage any files.
  537.  
  538.            9.  The default area for the temporary second ZIP file that
  539.                is created while the original is being updated, is the
  540.                same path and directory location as the original ZIP
  541.                file.  As this can cause a space shortage on a floppy
  542.                disk, the -b option is recommended.  (See Section 3.)
  543.  
  544.           10.  The compressing function will STOP if specific, pre-
  545.                specified files are not found.
  546.  
  547.           11.  All MS-DOS file handling procedures can be used:
  548.  
  549.                    Filename.ext          Full file name designations
  550.  
  551.                       Name*.ext          Names with wild card markers
  552.                           *.ext
  553.                    Filename.*
  554.                           *.*
  555.                    File?ame.ext
  556.  
  557.                  A:filename.ext          Disk drive and file name
  558.  
  559.                  C:\Lotus\March\*.*      Disk drive and PATH locations
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.      PKWARE                           -10-
  568.  
  569.  
  570.  
  571.                                    PKWARE SYSTEM LIMITS
  572.  
  573.  
  574.                The following limits should be noted when using the PKWARE
  575.           file compression programs.
  576.  
  577.  
  578.           - This software is designed to run on any IBM personal computer
  579.             or compatible, that is running MS-DOS version 2.0 or higher
  580.             (MS-DOS versions) or OS/2 (OS/2 versions only).
  581.  
  582.           - PKZIP requires a minimum of 85K memory to run.
  583.  
  584.       - PKUNZIP requires a minimum of 70K free memory to run.
  585.  
  586.           - PKZIP is capable of compressing up to 3,900 files into a
  587.             signgle ZIP file.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.      PKWARE                           -11-
  628.  
  629.  
  630.  
  631.  
  632.  
  633.                                                                        |
  634.                                                                        |
  635.                                                                        |
  636.                                                            SUPER QUICK |
  637.                                                                        |
  638.                              QUICK START- Extracting a File from a BBS |
  639.                              Use of PKWARE in Telecommunications - BBS |
  640.                                                                        |
  641.                                                                        |
  642.                                                                        |
  643.                                                                        |
  644.                                                                        |
  645.                                                                        |
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.      PKWARE                           -12-
  688.  
  689.  
  690.  
  691.  
  692.           ______________________________________________________________
  693.           |                                                            |
  694.           |                        QUICK START                         |
  695.           |                                                            |
  696.           |               Extracting a ZIP File from a BBS             |
  697.           |                                                            |
  698.           | A BBS is a Computer Bulletin Board Service.  Those who use |
  699.           | this type of service can acquire programs or other         |
  700.           | information in the form of compressed files.  These files  |
  701.           | are picked up via a modem.  In order to use these files,   |
  702.           | they must be extracted through the use of PKUNZIP.         |
  703.           |                                                            |
  704.           | Follow this example to UNZIP your files:                   |
  705.           |                                                            |
  706.           |     C:>PKUNZIP  A:AnyFile.XYZ   C:                         |
  707.           |       _______  _____________   ___                         |
  708.           |         |         |             |                          |
  709.           |         |         |             Drive/Path to locate the   |
  710.           |         |         |             files on                   |
  711.           |         |         |                                        |
  712.           |         |         Name/ Location of file being extracted   |
  713.           |         |         > Use any MS-DOS file notation           |
  714.           |         |                                                  |
  715.           |         the UNZIP command                                  |
  716.           |         >  The command MUST be located at the prompt       |
  717.           |                or                                          |
  718.           |         >  The program can be located elsewhere through    |
  719.           |            the PATH= setting                               |
  720.           |____________________________________________________________|
  721.  
  722.  
  723.  
  724.                      USE OF PKWARE IN TELECOMMUNICATIONS - BBS
  725.  
  726.  
  727.                Compressed library files store much information into a
  728.           relatively small space.  PKWARE file compression methods are the
  729.           standard used by many successful BBS systems across the country.
  730.  
  731.                Compressed files, known as ZIP files in PKWARE notation,
  732.           created through PKWARE, assure you of the highest level of file
  733.           accuracy.  PKWARE compressed files are the most compact, meaning
  734.           they take less telecommunications time to deliver, PLUS PKWARE is
  735.           FAST!  According to benchmarks published in major computer
  736.           magazines, you will be able to manipulate your compressed files
  737.           many times faster with PKWARE as compared to similar programs on
  738.           the market.  PKWARE provides you with the highest standards of
  739.           the industry.
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.      PKWARE                           -13-
  748.  
  749.  
  750.  
  751.               If you find the software fast, easy, and convenient to use, a
  752.           registration of $25 would be appreciated.  If you send $47 or
  753.           more, you will receive a diskette with documentation for the next
  754.           version of the software, when available.  Please state the
  755.           version of the software that you currently have.  Send
  756.           registrations to:
  757.  
  758.  
  759.                                    PKWARE, Inc.
  760.                             7545 N. Port Washington Rd.
  761.                                     Suite 205
  762.                                 Glendale, WI 53217
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.      PKWARE                           -14-
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.                                                                        |
  815.                                                                        |
  816.                                                                        |
  817.                                  PKZIP - COMPRESS FILES INTO ZIP FILES |
  818.                                                                        |
  819.                                        QUICK START - Create a ZIP file |
  820.                                         Description of Command Options |
  821.                                                                        |
  822.                                                                        |
  823.                                                                        |
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.      PKWARE                           -15-
  868.  
  869.  
  870.  
  871.                        QUICK START - CREATE A ZIP FILE
  872.  
  873.                This section will describe some simple examples,
  874.           illustrating the command format for creating a ZIP file.
  875.  
  876.           ______________________________________________________________
  877.           |                                                            |
  878.           |                       QUICK START                          |
  879.           |                   How to compress files                    |
  880.           |                                                            |
  881.           | Use PKZIP to reduce or compress the size of your files.    |
  882.           | All compressed files are stored in a ZIP file, while in    |
  883.           | their compressed state.                                    |
  884.           |                                                            |
  885.           |  The benefits of Compressing are:                          |
  886.           |                                                            |
  887.           |   - Better use of disk storage area                        |
  888.           |   - Faster telecommunication file transfer via a modem     |
  889.           |   - Collecting numerous files under a single file name     |
  890.           |                                                            |
  891.           | PKZIP uses 4 areas typed at the prompt:                    |
  892.           |                                                            |
  893.           |      PKZIP ZIPFILE [options] [files]                       |
  894.           |                                                            |
  895.           |  1.  The actual program name       PKZIP                   |
  896.           |                                                            |
  897.           |  2.  The command options           letter commands         |
  898.           |                                    example:  -a = add files|
  899.           |                                                            |
  900.           |  3.  The name YOU give your        NewFile  and  LOCATION  |
  901.           |      ZIP file and its location.                            |
  902.           |      If no extension specified,                            |
  903.           |      default = .ZIP.                                       |
  904.           |                                                            |
  905.           |  4.  The files that get compressed  any MS-DOS file        |
  906.           |      into the ZIP file.             notation               |
  907.           |                                                            |
  908.           | Examples:                                                  |
  909.           |                                                            |
  910.           |   C:>PKZIP  -a   A:NEWFILE   *.*                           |
  911.           |                                                            |
  912.           | This will create a file named NEWFILE.ZIP.  The .ZIP       |
  913.           | extension will be added automatically when the ZIP file has|
  914.           | been completed.  In this example, all of the files in the  |
  915.           | current directory will be compressed into NEWFILE.ZIP.     |
  916.           |                                                            |
  917.           |                                                            |
  918.           | C:>PKZIP  -a  B:BUDGET  \LOTUS\Checks.Wks \LOTUS\Money.Wks |
  919.           |                                                            |
  920.           | This will create a ZIP file named BUDGET.ZIP on the B      |
  921.           | drive.  It will contain two files, both currently located  |
  922.           | located in the C:\LOTUS directory.                         |
  923.           |                                                            |
  924.  
  925.  
  926.  
  927.      PKWARE                           -16-
  928.  
  929.  
  930.  
  931.           |                                                            |
  932.           |   C:>PKZIP  -f  FILES   *.TXT                              |
  933.           |                                                            |
  934.           | This will update an existing ZIP file named FILES.ZIP.     |
  935.           | The files with a .TXT extension that already exist in the  |
  936.           | ZIP file, and that are also dated later then those already |
  937.           | within FILES.ZIP, will be updated.                         |
  938.           |____________________________________________________________|
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.      PKWARE                           -17-
  988.  
  989.  
  990.  
  991.                                PKZIP REFERENCE GUIDE
  992.  
  993.  
  994.           The following table will provide a quick reference guide to
  995.           all the options of PKZIP.  The command syntax is also shown
  996.           below.
  997.  
  998.  
  999.           ----------------------------------------------------------------
  1000.           |                                                              |
  1001.           |                          PKZIP                               |
  1002.           |                                                              |
  1003.           | PKZIP [-b[path]] [options] zipfile [@list] [files...]        |
  1004.           |                                                              |
  1005.           | zipfile = ZIP file name.  Default extension is .ZIP          |
  1006.           | file    = Names of files to compress. Wildcards *, ?  are ok.|
  1007.           |           Default is ALL files.                              |
  1008.           | list    = An optional list file name.                        |
  1009.           |                                                              |
  1010.           |                                                              |
  1011.           | Options are:                                                 |
  1012.           |   -a    = Add files                                          |
  1013.           |   -b[path] = Create temporary ZIP file on alternate drive    |
  1014.           |   -c -C = Create/Edit file comments                          |
  1015.           |   -d    = Delete files                                       |
  1016.           |   -f    = Freshen files                                      |
  1017.           |   -h    = Call up help screen                                |
  1018.           |   -i    = Add changed files                                  |
  1019.           |   -j -J<h,r,s> = Mask/Unmask file attributes                 |
  1020.           |   -k    = Retain original date of ZIP file                   |
  1021.           |   -l    = Display license information                        |
  1022.           |   -o    = Set time and date of ZIP file to oldest file       |
  1023.           |   -p -P = Store recursed pathnames                           |
  1024.           |   -q    = Enable ANSI comments                               |
  1025.           |   -r    = Recurse subdirectories                             |
  1026.           |   -s<password> = Scramble files with password protection     |
  1027.           |   -u    = Update files                                       |
  1028.           |   -m[u,f] = Move files                                       |
  1029.           |   -v[b,r,t,c,d,e,n,o,p,s] = View files                       |
  1030.           |   -e[x,s,a,b] = Method of compression                        |
  1031.           |   -w -W<h,s> = Include hidden/system files                   |
  1032.           |   -x    = Exclude files from ZIP operation                   |
  1033.           |   -z    = Create/Edit ZIP comment                            |
  1034.           |                                                              |
  1035.           ----------------------------------------------------------------
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.      PKWARE                           -18-
  1048.  
  1049.  
  1050.  
  1051.                            DESCRIPTION OF COMMAND OPTIONS
  1052.  
  1053.  
  1054.               The commands used in creating a ZIP file will be explained in
  1055.           detail in this section.  You will find that the new command
  1056.           format is much more flexible and easier to use.  Listed below is
  1057.           a summary of important facts to keep in mind while using PKZIP.
  1058.  
  1059.           - The command options can generally be placed anywhere on the
  1060.             command line.
  1061.  
  1062.           - The first filename listed on the command line will be
  1063.             interpreted as the ZIP file.
  1064.  
  1065.           - The commands can usually be typed using either upper case or
  1066.             lower case, with the following exceptions:
  1067.                W w include special files
  1068.                J j mask special files
  1069.                C c create comments
  1070.                P p store pathnames
  1071.  
  1072.             In general, you should use lower case for all commands that
  1073.             are not case sensitive in order to be compatible with future
  1074.             versions of PKZIP.
  1075.  
  1076.           - All command options for the software must be preceded by a
  1077.             '-' character or the MS-DOS switch character (usually '/').
  1078.  
  1079.           - Most options except where noted can be combined (i.e.
  1080.             "-x -y" or "-xy").
  1081.  
  1082.           - The default values for the command line are as follows:
  1083.  
  1084.                - If no options are entered, the default is '-a', the add
  1085.                  file option.
  1086.                - If no extension is specified for the ZIP file the .ZIP
  1087.                  extension will be used.
  1088.                - If no location is listed for the ZIP file, it will be
  1089.                  located in the current directory.
  1090.                - If no file specs (filenames, with or without wildcards)
  1091.                  are listed, the default is *.* (unless the  -d option
  1092.                  is being used).
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.      PKWARE                           -19-
  1108.  
  1109.  
  1110.  
  1111.               The following table lists all the options valid with the
  1112.           PKZIP command.  A brief summary is also given in the table.  The
  1113.           options are explained in detail, along with programming examples,
  1114.           following the table.
  1115.  
  1116.  
  1117.                          Table 3-1   PKZIP COMMAND OPTIONS
  1118.           --------------------------------------------------------------
  1119.  
  1120.           OPTION         SUMMARY
  1121.  
  1122.           -a             Adds files to ZIP file.
  1123.  
  1124.           -b[path]       Creates a temporary ZIP file at the specified
  1125.                          alternate location.  This temporary file is
  1126.                          used only in the creation of the ZIP file, and
  1127.                          will be automatically deleted when the process
  1128.                          is complete.
  1129.  
  1130.           -c -C          Adds file comments to individual files within
  1131.                          the ZIP file.
  1132.  
  1133.           -d             Deletes the specified files from the ZIP file.
  1134.  
  1135.           -e[x,s,a,b]    Specifies compression method.
  1136.  
  1137.           -f             Freshens files in the ZIP file.
  1138.  
  1139.           -h             Calls up a help screen.
  1140.  
  1141.           -i             Adds to the ZIP file only those files that were
  1142.                          changed since the ZIP file was last updated.
  1143.  
  1144.           -j -J<h,r,s>   Specifies masking or unmasking of file
  1145.                          attributes.
  1146.  
  1147.           -k             Retains the original date of the ZIP file
  1148.                          that is being updated.
  1149.  
  1150.           -l             Displays the license screen.
  1151.  
  1152.           -m[u,f]        Adds files to the ZIP file and automatically
  1153.                          deletes the original or source files.
  1154.  
  1155.           -o             Sets time and date of the ZIP file to the time
  1156.                          and date of the latest file contained in the
  1157.                          ZIP file.
  1158.  
  1159.           -p -P          Stores paths that are recursed along with the
  1160.                          filenames in the ZIP file.  The -p option should
  1161.                          be used with -r option.
  1162.  
  1163.           -q             Enables ANSI comments.
  1164.  
  1165.  
  1166.  
  1167.      PKWARE                           -20-
  1168.  
  1169.  
  1170.  
  1171.           -r             Recurses subdirectories from the specified
  1172.                          directories.
  1173.  
  1174.           -s<password>   Scrambles files in the ZIP file with password
  1175.                          protection.
  1176.  
  1177.           -u             Updates the ZIP file.
  1178.  
  1179.           -v[b,r,t,c,d,e,n,o,p,s] Views technical information about
  1180.                          files in the ZIP file.
  1181.  
  1182.           -w -W<h,s>     Specifies whether hidden or system files will
  1183.                          be included in the ZIP file.
  1184.  
  1185.           -x             Is used to exclude files from a ZIP file
  1186.                          operation.
  1187.  
  1188.           -z             Creates a ZIP comment for a ZIP file.
  1189.  
  1190.  
  1191.           Note:  Parameters listed in [ ] are optional.  Where parameters
  1192.           are listed in < >, at least one of the listed parameters must be
  1193.           specified.
  1194.  
  1195.               There are several size factors you must be aware of when
  1196.           using the PKZIP command.  A ZIP file can hold any number of files
  1197.           subject to the storage size of your disk.  You need unused
  1198.           storage space at least equal to the size of the existing ZIP file
  1199.           in order to complete any updating process.
  1200.  
  1201.               For example, if the ZIP file to be updated is currently 250K,
  1202.           you need 250K for actual storage space and another 250K for the
  1203.           updating process.  This is because PKZIP does not delete the
  1204.           original ZIP file until the new updated ZIP file has been
  1205.           created.  So at the instant the new updated ZIP file is completed
  1206.           the original ZIP file will still exist.  Therefore, you would
  1207.           need disk storage space twice the actual size of the ZIP file.
  1208.  
  1209.               If this poses a problem to you, it can be counteracted by
  1210.           using the -b command.  This process is explained in greater
  1211.           detail later in this section.
  1212.  
  1213.               This section will give a detailed explanation of the options
  1214.           used in the PKZIP command.  Recall that except where noted,
  1215.           several options can be combined on the command line, and the
  1216.           options can be placed in any order.
  1217.  
  1218.               The command options are explained in groups determined by
  1219.           function.  The options pertaining to adding or updating ZIP files
  1220.           are explained first, followed by the delete option, view options,
  1221.           configuration options, and miscellaneous options.
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.      PKWARE                           -21-
  1228.  
  1229.  
  1230.  
  1231.           -a  Add files to a ZIP file
  1232.           ---------------------------
  1233.  
  1234.               This command will add files to either a NEWLY CREATED or
  1235.           EXISTING ZIP file.  Same-name files will overwrite those already
  1236.           in the ZIP file regardless of which has the latest date.  This is
  1237.           the default option if no other options are specified.
  1238.  
  1239.                A:>PKZIP  -a  Text  chap1.doc chap2.doc toc.doc
  1240.  
  1241.               Once the program is finished creating a new ZIP file
  1242.           containing the three files listed above, the extension
  1243.           .ZIP will be added to "Text" making it TEXT.ZIP
  1244.  
  1245.  
  1246.           -u  Update existing ZIP file
  1247.           ----------------------------
  1248.  
  1249.               The existing ZIP file will be updated with files only if they
  1250.           are not currently in the ZIP file, or if they are dated later
  1251.           than those with the same name already in the ZIP file.
  1252.  
  1253.               Although this command is similar to the  -a  Add command, it
  1254.           has an update SAFEGUARD.  It will overwrite existing compressed
  1255.           files ONLY if the selected files have a more recent time and
  1256.           date.
  1257.  
  1258.                C:>PKZIP  -u  Oldfile.ZIP   *.Txt  Money.Wks  A:Funds.Wks
  1259.  
  1260.               This example will update the ZIP file named Oldfile.ZIP.  The
  1261.           files listed above will be updated within the ZIP file.  That is
  1262.           they will be added if they do not already exist, or overwritten
  1263.           if they already exist in the ZIP file with an earlier date.
  1264.  
  1265.  
  1266.           -f  Freshen files in ZIP file
  1267.           -----------------------------
  1268.  
  1269.               This option updates files that already exist in the ZIP file
  1270.           with same-named files with later times and dates.
  1271.  
  1272.               The Freshen option is limited to working with files that
  1273.           ALREADY exist in the ZIP file.  Existing zipped files will be
  1274.           overwritten ONLY if the files have been updated since being added
  1275.           to the ZIP file.  It will NOT add new files.
  1276.  
  1277.                C:>PKZIP  -f  STORE.ZIP  *.*
  1278.  
  1279.               In the above example, all the existing files in the ZIP file,
  1280.           STORE, will be updated if a newer version of the file exists in
  1281.           the current directory.
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.      PKWARE                           -22-
  1288.  
  1289.  
  1290.  
  1291.           -i  Selectively BACKUP files
  1292.           ----------------------------
  1293.  
  1294.               This option will add only those files to the ZIP file that
  1295.           were NOT backed up the last time.  It adds only those files that
  1296.           have been changed.  If the program returns the notation "No files
  1297.           found", this means that everything had been previously backed up.
  1298.  
  1299.                C:\PKWARE> PKZIP -i  allfiles.zip
  1300.  
  1301.               In this example, all the files in the ZIP file 'allfiles'
  1302.           that had not been previously backed up, will be backed up.
  1303.  
  1304.  
  1305.           -m[u,f]  Move files into a ZIP file
  1306.           -----------------------------------
  1307.  
  1308.               This option will add files to a new OR existing ZIP file then
  1309.           automatically DELETE the original or source file.  There are two
  1310.           additional options available with the Move option:  Move Update
  1311.           and Move Freshen.
  1312.  
  1313.               When used alone, the Move option is similar to the  -a  Add
  1314.           command option except that it automatically deletes the original
  1315.           files.  This is a real time saver, for example, when compressing
  1316.           an entire directory.  The  -m  option compresses all your files
  1317.           into a single ZIP file, then deletes the original files.
  1318.  
  1319.           -mu = This specifies the Move option used along with the
  1320.                 Update option.  When these two options are used
  1321.                 together, the existing ZIP file will be updated
  1322.                 with files only if they are not currently in the ZIP
  1323.                 file, or if they are dated later than those with the
  1324.                 same name already in the ZIP file.  After the ZIP file
  1325.                 is updated, the original files will be deleted.
  1326.  
  1327.           -mf = This specifies the Move option used along with the
  1328.                 Freshen option.  When these two options are used
  1329.                 together, files already existing in the ZIP file will be
  1330.                 updated with same-named files with later times and
  1331.                 dates.  After the ZIP file is updated, the original
  1332.                 files will be deleted.
  1333.  
  1334.               The original files are deleted after the program verifies the
  1335.           ZIP file for accuracy.  If an error does occur, such as DISK
  1336.           FULL, the original files will NOT be deleted.
  1337.  
  1338.                C:\DB> PKZIP  -m tiny.ZIP  *.dbf
  1339.  
  1340.               In this example, all the database files will be compressed
  1341.           into tiny.ZIP and then will be erased from the \DB directory.
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.      PKWARE                           -23-
  1348.  
  1349.  
  1350.  
  1351.           -d  Delete files from WITHIN a ZIP file
  1352.           ---------------------------------------
  1353.  
  1354.               This option is used to delete single or multiple files within
  1355.           a ZIP file.  Any of the MS-DOS file handling descriptions may be
  1356.           used.  The name of the file will be displayed on the screen as it
  1357.           is being deleted.
  1358.  
  1359.                C:>PKZIP -d  OldFile.ZIP   Garbage.Txt  Useless.Dbf
  1360.  
  1361.               In this example, Garbage.Txt and Useless.Dbf will be deleted
  1362.           from the files in OldFile.ZIP
  1363.  
  1364.  
  1365.           -v[b,r,t][c,d,e,n,o,p,s]  View technical information
  1366.           ----------------------------------------------------
  1367.  
  1368.               This option will display technical information concerning the
  1369.           files contained within a ZIP file.  There are several options
  1370.           available with the View option.  All are explained below.  The
  1371.           options determine how the information will be displayed and
  1372.           sorted.
  1373.  
  1374.                The following information about each file contained in the
  1375.           ZIP file will be displayed on the screen.
  1376.  
  1377.                       Length      Original length of the file
  1378.                       Method      Type of file compression used
  1379.                       Size        Size of the compressed file
  1380.                       Ratio       Percent reduction in file size
  1381.                       Date        Actual date of the file
  1382.                       Time        Actual time of the file
  1383.                       CRC-32      The CRC-32 value of the file
  1384.                       Attribute   The attribute of the file (s=System,
  1385.                                   h=Hidden, w=Writable, r=readonly file,
  1386.                                   and *=encrypted)
  1387.                       Name        Name of the file
  1388.  
  1389.  
  1390.                The View options for PKZIP are explained below.  The options
  1391.           determine how the information will be displayed and sorted on the
  1392.           screen.  The following display options are available:
  1393.  
  1394.           -vb = The  -b Brief display option will display all the
  1395.                 information shown above except the CRC-32 value and the
  1396.                 file attribute.
  1397.  
  1398.           -vt = The  -t Additional Technical display option is used to
  1399.                 display extra technical information.  When this option
  1400.                 is active, the following information (shown on the
  1401.                 following page) will be displayed on the screen.  With this
  1402.                 display, the following information about each file in the
  1403.                 ZIP file will be displayed on the screen.
  1404.  
  1405.  
  1406.  
  1407.      PKWARE                           -24-
  1408.  
  1409.  
  1410.  
  1411.                 The following information will be displayed for each file
  1412.           in the ZIP file, when the  -vt option is used.
  1413.  
  1414.  
  1415.                 Filename            Name of the file
  1416.                 File type           Type of file
  1417.                 Encrypted           It will be noted here if the file is
  1418.                                     encrypted
  1419.                 Attribute           The attribute of the file (s=System,
  1420.                                     h=Hidden, w=Writable, and r=readonly
  1421.                                     file)
  1422.                 Comments            File comment if present will be listed
  1423.                                     here
  1424.                 Date and Time       Date and Time of the ZIP file
  1425.                 Compression Method  Imploding or Shrinking (or Reducing, if
  1426.                                     an earlier of PKZIP was used)
  1427.                 Compressed Size     Reduced or compressed size of the
  1428.                                     file
  1429.                 Uncompressed Size   Original length of the file
  1430.                 CRC-32              The numeric CRC-32 value
  1431.                 Created by          The version of PKZIP and the
  1432.                                     operating system used to create
  1433.                                     the ZIP file.
  1434.                 Needed to extract   The version of PKZIP required to
  1435.                                     extract the files
  1436.  
  1437.  
  1438.           -vc = This option is used to display any existing file
  1439.                 comments.
  1440.  
  1441.           -vr = Display information in reverse order from the default
  1442.                 order.  This option can be used with any of the other
  1443.                 View options to reverse the order of sorting.
  1444.  
  1445.  
  1446.               Any of the display options explained above can be used with
  1447.           the sorting options listed below.
  1448.  
  1449.               The following sorting options are available with the View
  1450.           option.  The default order of sorting is also specified.  (This
  1451.           order can be reversed by using the particular sorting option
  1452.           along with the  -vr  View Reverse option.)
  1453.  
  1454.                -vd = Sort by date of files, oldest to most recent.
  1455.                -ve = Sort by file extension, alphabetically.
  1456.                -vn = Sort by name of files, alphabetically.
  1457.                -vo = Display in original order, i.e. the order in which
  1458.                      the files were zipped.  (This option can be used to
  1459.                      override any configuration parameter you may have
  1460.                      set.)
  1461.                -vp = Sort by percentage ratio of compression, smallest
  1462.                      to largest.
  1463.                -vs = Sort by size of files, smallest to largest.
  1464.  
  1465.  
  1466.  
  1467.      PKWARE                           -25-
  1468.  
  1469.  
  1470.  
  1471.               If no sorting option is specified, the files will be
  1472.           displayed in the order they were compressed.
  1473.  
  1474.               The following example illustrates the command used to display
  1475.           the technical information about a ZIP file sorted by date.  The
  1476.           output is shown below.
  1477.  
  1478.  
  1479.           D:> PKZIP allfiles.zip -vd
  1480.  
  1481.       Length  Method   Size  Ratio   Date    Time   CRC-32  Attr  Name
  1482.       ------  ------   ----- -----   ----    ----   ------  ----  ----
  1483.         6144  Implode   2228  64%  01-04-80  13:52  a1f719af --w  SAVE.DOC
  1484.         7168  Implode   2305  68%  01-04-80  14:58  fc970ad9 --w  EWEXE.DOC
  1485.         2560  Implode   1312  49%  09-03-87  11:12  b89abd8c --w  TYPOS.DOC
  1486.          423  Implode    337  21%  09-03-87  11:14  131dd142 --w  PINTS.DOC
  1487.         2793  Implode   1264  55%  09-03-87  19:16  dab0a3b5 --w  DCA.DOC
  1488.         6638  Implode   3082  54%  01-25-89  21:52  80046b74 --w  ADME.DOC
  1489.        14848  Implode   5514  63%  03-02-89  09:03  7f2d751b --w  IIM1.DOC
  1490.        10240  Implode   4312  58%  03-02-89  09:04  70324a2f --w  IIM2.DOC
  1491.        75264  Implode  23261  70%  03-02-89  09:16  8f5baa0f --w  IIM3.DOC
  1492.       ------          ------  ---                                  -------
  1493.       126078           43615  57%                                       12
  1494.  
  1495.  
  1496.                In the example shown below, the additional technical
  1497.           information will be displayed.  The files are sorted
  1498.           alphabetically by name.  The output displayed below would be
  1499.           repeated for each file within the ZIP file.
  1500.  
  1501.  
  1502.           C:\WORD> PKZIP -vtn docs.zip
  1503.  
  1504.                          Filename: M3.DOC
  1505.                         File type: text
  1506.                        Attributes: --w
  1507.                     Date and Time: Jul 17,1989  09:15:00
  1508.                Compression Method: Implode
  1509.                   Compressed Size:    8258
  1510.                 Uncompressed Size:   25600
  1511.                  32 bit CRC value: 27418eb3
  1512.                        Created by:   PKZIP: 1.0 under MS-DOS
  1513.                 Needed to extract: PKUNZIP: 1.0
  1514.  
  1515.  
  1516.               Any of the View options listed above can be set in the
  1517.           Configuration file.  For example, if you wanted to always display
  1518.           the files contained in a ZIP file sorted by extension, this can
  1519.           be set in the Configuration file.  If no View options are
  1520.           specified, the default View setting is the order in which the
  1521.           files were compressed in the ZIP file.  Any view options
  1522.           specified on the command line will however, override the
  1523.           configuration parameters.
  1524.  
  1525.  
  1526.  
  1527.      PKWARE                           -26-
  1528.  
  1529.  
  1530.  
  1531.               The following View options can be set in the Configuration
  1532.           file.  The corresponding command line option is also listed for
  1533.           reference.
  1534.  
  1535.                VIEW = date      -vd
  1536.                VIEW = extension -ve
  1537.                VIEW = name      -vn
  1538.                VIEW = ratio     -vp
  1539.                VIEW = size      -vs
  1540.                VIEW = natural   -vo
  1541.                VIEW = reverse   -vr
  1542.                VIEW = brief     -vb
  1543.                VIEW = long      -vt
  1544.                VIEW = comments  -vc
  1545.  
  1546.               As in the view options specified on the command line, the
  1547.           last four options, reverse, brief, long and comments, can be
  1548.           combined with any of the sorting options listed above.
  1549.  
  1550.           For more detailed information on the Configuration file, see
  1551.           section 5.
  1552.  
  1553.  
  1554.           -c -C   Create file comments
  1555.           ----------------------------
  1556.  
  1557.               This option is case sensitive.  It is used to create file
  1558.           comments for the individual files contained in the ZIP file.  The
  1559.           maximum length for the comments is 60 characters.  You will be
  1560.           prompted to enter the comments.  If a comment already exists, you
  1561.           can edit it or press the <Enter> key to retain the same comment.
  1562.           To delete an existing comment, press the Space bar followed by
  1563.           the <Enter> key.
  1564.  
  1565.                The  -c (lower case c) option is used to edit all comments
  1566.           for existing files or files that are added.
  1567.  
  1568.               The  -C (upper case C) option is used when you want to create
  1569.           comments for only the new files that were added to the ZIP file.
  1570.           It is used along with the add/update options.  If -C is used
  1571.           without any other options, it has the same effect as -c.
  1572.  
  1573.           C:\PK> PKZIP textfile.zip -C -u
  1574.  
  1575.               In the above example, any comments on existing files will be
  1576.           retained and you will be prompted to enter comments only for the
  1577.           newly added files.
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.      PKWARE                           -27-
  1588.  
  1589.  
  1590.  
  1591.           -z  Create a Zipcomment
  1592.           -----------------------
  1593.  
  1594.               This option allows you to create a descriptive label for your
  1595.           ZIP files.  The Zipcomment will then automatically be displayed
  1596.           by PKZIP or PKUNZIP whenever the specific ZIP file is processed.
  1597.  
  1598.               When you type in the command, as shown below, you will be
  1599.           prompted to enter the Zipcomment.  The  -z option can also be
  1600.           used to edit an existing Zipcomment.
  1601.  
  1602.               The  -z  option can be used alone on an EXISTING ZIP file or
  1603.           in combination with any of the add/update commands.  Examples are
  1604.           shown below.
  1605.  
  1606.           C:\PK>PKZIP  zipdoc -z
  1607.  
  1608.               After entering the above command, the program will prompt you
  1609.           to type in a Zipcomment for the ZIP file 'ZIPDOC.ZIP'.  After
  1610.           entering the Zipcomment, press the <Enter> key to save it.
  1611.  
  1612.  
  1613.           C:\PKWARE> PKZIP zipdoc -z -a  *.doc
  1614.  
  1615.                In this example both files and Zipcomments will be added.
  1616.           To add files and add a Zipcomment, both the  -z and one of the
  1617.           add/update commands must be entered.
  1618.  
  1619.  
  1620.           -x  Exclude files from the ZIP file operation
  1621.           ---------------------------------------------
  1622.  
  1623.               This option is used to exclude files from the current
  1624.           operation.  It can be used along with any of the MS-DOS file
  1625.           handling descriptions.  It can be used along with most of the ZIP
  1626.           command options such as add, update, view, delete, etc.
  1627.  
  1628.           C:\pkzip stuff *.* -x*.BAK
  1629.  
  1630.               In the above example, all of the files in the current
  1631.           directory will be compressed into the file stuff.zip except the
  1632.           files with a .BAK  extension.
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.      PKWARE                           -28-
  1648.  
  1649.  
  1650.  
  1651.           -b[path]  Create temporary ZIP file on alternate drive/path
  1652.           -----------------------------------------------------------
  1653.  
  1654.               This option is designed to be used when insufficient disk
  1655.           space is a problem.  Every time a ZIP file is updated, PKZIP
  1656.           creates a new pre-ZIP file.  When the updating is completed, the
  1657.           original ZIP file is automatically deleted and the pre-ZIP file
  1658.           becomes the new ZIP file.  The result of this operation is that
  1659.           you need disk storage space equal to at least twice the actual
  1660.           size of the ZIP file while updating the ZIP file.
  1661.  
  1662.               Disk space is generally not a problem on a hard disk, but can
  1663.           pose restrictions on a floppy disk.  If adequate disk space is
  1664.           not available, the program will stop.
  1665.  
  1666.               The -b option will locate the pre-ZIP file on the path and
  1667.           location specified.  This file is used only in the process of
  1668.           updating the original ZIP file.  It will replace the original ZIP
  1669.           file and will NOT exist on the location specified in the -b
  1670.           option, when the update process is completed.  The -b option can
  1671.           be used along with any of the update options.
  1672.  
  1673.           C:>PKZIP a:zipdoc *.doc -bc: -u
  1674.  
  1675.               The above example illustrates the use of the -b option.  A
  1676.           ZIP file, zipdoc, located on drive A will be updated with all the
  1677.           .doc files.
  1678.  
  1679.               A temporary ZIP file, used in the update process will be
  1680.           located on the C drive.  This file will not exist when the update
  1681.           process is completed.
  1682.  
  1683.  
  1684.           -e[x,s,a,b]  Use extra compression options
  1685.           ------------------------------------------
  1686.  
  1687.               This option is used to specify the compression algorithm to
  1688.           be used in creating the ZIP file.  There are two types of
  1689.           compression that can be used:  Shrinking and Imploding.  The
  1690.           options are explained below.
  1691.  
  1692.           -ex = This specifies the Imploding method is to be used on all
  1693.                 files being compressed.  In general, it provides a
  1694.                 greater degree of compression over the Shrinking method.
  1695.                 Note that -ex does not try both Shrinking and Imploding.
  1696.                 In most cases where Shrinking would work better than
  1697.                 Reducing in PKZIP 0.9x, Imploding will do better than
  1698.                 Shrinking.  This is the default for PKZIP.
  1699.  
  1700.           -es = This specifies the Shrinking method is to be used on all
  1701.                 files being compressed.  In general, it provides a
  1702.                 faster method of compression over the Imploding method.
  1703.  
  1704.  
  1705.  
  1706.  
  1707.      PKWARE                           -29-
  1708.  
  1709.  
  1710.  
  1711.           -ea = This specifies the Imploding method is to be used on all
  1712.                 ASCII files and the Shrinking method is to be used on
  1713.                 all binary files.
  1714.  
  1715.           -eb = This specifies the Imploding method is to be used on all
  1716.                 binary files and the Shrinking method is to be used on
  1717.                 all ASCII files.
  1718.  
  1719.           Note:  You should be aware of the following when specifying a
  1720.                  compression method.
  1721.  
  1722.           - Using -ea -eb is the same as using -ex.
  1723.  
  1724.           - Numbers after the parameters such as "-ex4" or "-ea3" are
  1725.             accepted for compatibility with PKZIP 0.92 but they have no
  1726.             effect on the data compression in PKZIP 1.0.
  1727.  
  1728.           - Regardless of the compression method specified, files
  1729.             smaller than 320 bytes in size will be Shrunk, if enough
  1730.             memory is present.
  1731.  
  1732.           - Shrinking requires more memory than Imploding.  If there is
  1733.             enough memory to perform Imploding, but not enough memory to
  1734.             perform Shrinking and any of the last three options listed
  1735.             are chosen, PKZIP will issue a warning and use Imploding
  1736.             instead.  Shrinking requires about 128K to run, and
  1737.             Imploding approximately 90K.
  1738.  
  1739.  
  1740.           Some example commands are shown below.
  1741.  
  1742.           C:>PKZIP zipdoc -es *.DOC
  1743.  
  1744.               This command would Shrink all the files with a .DOC extension
  1745.           into the ZIP file.
  1746.  
  1747.           C:>PKZIP -ea zipdoc
  1748.  
  1749.               This command would Implode the ASCII files and Shrink the
  1750.           binary files.
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.      PKWARE                           -30-
  1768.  
  1769.  
  1770.  
  1771.           -p -P  Store relative paths with filenames in the ZIP file
  1772.           ----------------------------------------------------------
  1773.  
  1774.               This option is case sensitive.  It allows you to store the
  1775.           directory and path information pertaining to each file within the
  1776.           ZIP file (or list file).
  1777.  
  1778.               If -p (lower case p) is used, all the pathnames that are
  1779.           recursed into will be stored in the ZIP file.  The  -p option is
  1780.           meaningful only when used with the  -r  option explained below.
  1781.           If -P (upper case P) is used, all the pathnames specified on the
  1782.           command line and those recursed into will be stored in the ZIP
  1783.           file.
  1784.  
  1785.  
  1786.           -r  Recurse through subdirectories
  1787.           ----------------------------------
  1788.  
  1789.               This command allows you more flexibility when creating or
  1790.           updating ZIP files.  The program will recurse through specified
  1791.           directories when obtaining files to compress.
  1792.  
  1793.           For example:
  1794.  
  1795.           C:> PKZIP alldoc -r  D:*.doc  C:\word\pk\*.txt
  1796.  
  1797.               This command will search all .DOC files on the D drive and
  1798.           all  .TXT files on the C:\word\pk directory and all directories
  1799.           below.  For example:
  1800.  
  1801.           C:\data>PKZIP -rp stuff
  1802.  
  1803.               This example will compress all the files in the current
  1804.           directory, and all directories below the current subdirectory.
  1805.           PKUNZIP  can then restore this directory tree either in the same
  1806.           directory, or at any place in the directory tree.  An entire
  1807.           directory tree can be compressed into a ZIP file and then
  1808.           restored by using the  -d option in PKUNZIP.  (See the -d
  1809.           option for PKUNZIP, Section 4.)
  1810.  
  1811.               By default, the filename only will be stored, unless the  -p
  1812.           or  -P  option is specified on the command line.
  1813.  
  1814.  
  1815.           -l  Display the License screen
  1816.           ------------------------------
  1817.  
  1818.               This command will display the software license agreement.
  1819.  
  1820.           A:>PKZIP -l
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.      PKWARE                           -31-
  1828.  
  1829.  
  1830.  
  1831.           -h  Display help screen
  1832.           -----------------------
  1833.  
  1834.               This command will display a help screen whenever typed on
  1835.           the command line.
  1836.  
  1837.           D:\PKWARE> PKZIP -h
  1838.  
  1839.  
  1840.  
  1841.           -s<password>  Scramble files with password
  1842.           ------------------------------------------
  1843.  
  1844.               This option is used to scramble, or encrypt the files in the
  1845.           ZIP file.  It includes password protection.  When extracting the
  1846.           ZIP file, the files will not be extracted unless the correct
  1847.           password is included on the command line.
  1848.  
  1849.               When specifying the password, there is no space between the
  1850.           s and the password.  Also the password is case sensitive.  It
  1851.           must be entered exactly the same when you Unzip the file.  It is
  1852.           important that you remember or somehow record the passwords that
  1853.           you use, because PKZIP does not retain a record of these
  1854.           passwords anywhere.
  1855.  
  1856.           C:\FINANCE> PKZIP PAYROLL -m -sSecret  *.pyr
  1857.  
  1858.               In the above example, the ZIP file PAYROLL will be created
  1859.           with all the files having a *.pyr extension.  In order to Unzip
  1860.           this file, the password 'Secret' will have to be specified
  1861.           exactly as shown above.
  1862.  
  1863.  
  1864.           -q   Enable ANSI Comments
  1865.           -q-  Disable ANSI Comments
  1866.           --------------------------
  1867.  
  1868.               This option can be used to override a command in the
  1869.           Configuration file.  By default, ANSI sequences are disabled.
  1870.           ANSI sequences are enabled or disabled in the Configuration file
  1871.           by the following commands.
  1872.  
  1873.                ANSI = Enabled
  1874.                ANSI = Disabled
  1875.  
  1876.               To override the configuration string, simply include the  -q
  1877.           or  -q- option on the command line.  An example is shown below.
  1878.  
  1879.           C:\MAIN> PKZIP allfile.zip -u -q-
  1880.  
  1881.               In this example, the ZIP file, allfile.zip will be updated.
  1882.           If the ANSI comments had been enabled in the configuration file,
  1883.           they would be disabled by the  -q- option on the command line.
  1884.  
  1885.  
  1886.  
  1887.      PKWARE                           -32-
  1888.  
  1889.  
  1890.  
  1891.           -o   Set ZIP file date to latest file date included
  1892.           -o-  Set ZIP file date to current date
  1893.           --------------------------------------
  1894.  
  1895.               This option can be used to override a command in the
  1896.           Configuration file.  By default the ZIP file being created will
  1897.           be given the current time and date.  By using the following
  1898.           command in the Configuration file, the ZIP file date will be
  1899.           determined by the date of the latest file included in the ZIP
  1900.           file.
  1901.  
  1902.                ZIPDATE = latest
  1903.  
  1904.               To override the configuration string, simply include the  -o
  1905.           or  -o- option on the command line.  Note:  This option is
  1906.           denoted by the letter o, not a zero.  An example is shown below.
  1907.  
  1908.           C:\MAIN> PKZIP DONE.ZIP -a -o-  *.doc
  1909.  
  1910.               In this example, all the files with a .doc extension will be
  1911.           added to the ZIP file.  The file will then be given the current
  1912.           date.  Assuming the ZIPDATE had been set to latest in the
  1913.           configuration file, it would be overwritten to current by the
  1914.           -o-  option on the command line.
  1915.  
  1916.           NOTE:  Please see the -k option for related information.
  1917.  
  1918.  
  1919.           -k   Keep current date on the ZIP file
  1920.           -k-  Set ZIP file date to current date
  1921.           --------------------------------------
  1922.  
  1923.               This option can be used to override a command in the
  1924.           Configuration file.  By default the ZIP file being created will
  1925.           be given the current time and date.  By using the following
  1926.           command in the Configuration file, the current ZIP file date will
  1927.           be retained when the file is updated.
  1928.  
  1929.                ZIPDATE = keep
  1930.  
  1931.               To override the configuration string, simply include the  -k
  1932.           or  -k- option on the command line.  An example is shown below.
  1933.  
  1934.           C:\MAIN> PKZIP DONE.ZIP -f -k-  *.txt
  1935.  
  1936.               In this example, all the files with a .txt extension will be
  1937.           freshened in the ZIP file.  The file will then be given the
  1938.           current date.  Assuming the ZIPDATE had been set to keep in the
  1939.           configuration file, it would be overwritten to current by the
  1940.           -k- option on the command line.
  1941.  
  1942.           NOTE:  Please see the -o option for related information.
  1943.  
  1944.  
  1945.  
  1946.  
  1947.      PKWARE                           -33-
  1948.  
  1949.  
  1950.  
  1951.           -w<H,S>  Include hidden or system files
  1952.           -W<H,S>  Do not include hidden or system files
  1953.           ----------------------------------------------
  1954.  
  1955.               This option is used to specify whether or not the hidden or
  1956.           system files will be included in the ZIP file.  It can be used to
  1957.           override a command in the Configuration file.  By default, hidden
  1958.           or system files will not be included.  By using one of the
  1959.           following commands in the Configuration file, you can specify
  1960.           whether system or hidden files will be included by default.
  1961.  
  1962.                INCLUDE = hidden
  1963.                INCLUDE = system
  1964.  
  1965.               To override the string in the Configuration file, simply
  1966.           include the -w<H,S> or -W<H,S> option on the command line.  To
  1967.           specify hidden files, use H; and to specify system files, use S.
  1968.           An example is shown below.
  1969.  
  1970.           C:\DOS> PKZIP ALL.ZIP  -a -Whs
  1971.  
  1972.               In this example, all of the files in the current directory
  1973.           will be compressed into ALL.ZIP except the hidden and system
  1974.           files.  Assuming the hidden files had been included in the
  1975.           Configuration file, this command overrides the Configuration
  1976.           file.
  1977.  
  1978.           NOTE:  There is no space between the W or w, and the h or s.
  1979.  
  1980.                For more detailed information on the Configuration file, see
  1981.           section 5.
  1982.  
  1983.  
  1984.  
  1985.           -j<H,S,R>  Mask hidden, system or readonly file attributes
  1986.           -J<H,S,R>  Do not mask hidden, system or readonly file
  1987.                      attributes
  1988.           ------------------------------------------------------
  1989.  
  1990.               This option is used to mask the hidden, system or readonly
  1991.           attributes of files so that they can be treated as normal
  1992.           writable files.  This command can be used to override commands in
  1993.           the Configuration file.  By default, these files will not be
  1994.           masked.
  1995.  
  1996.               By using the following commands in the Configuration file,
  1997.           you can specify whether system, hidden or readonly files will be
  1998.           masked, and thus treated as normal writable files.
  1999.  
  2000.                MASK = hidden
  2001.                MASK = system
  2002.                MASK = readonly
  2003.  
  2004.  
  2005.  
  2006.  
  2007.      PKWARE                           -34-
  2008.  
  2009.  
  2010.  
  2011.               To override the string in the Configuration file, simply
  2012.           include the -j<H,S,R> or -J<H,S,R> option on the command line.
  2013.           To specify hidden files, use H; to specify system files, use S;
  2014.           and to specify readonly files, use R.  An example is shown below.
  2015.  
  2016.           C:\DOS> PKZIP SAVE.ZIP  -a -jrh -whs ibmbio.com ibmdos.com
  2017.  
  2018.               In this example, the hidden/system/readonly files IBMBIO.COM
  2019.           and IBMDOS.COM will be included in SAVE.ZIP.  However, their
  2020.           hidden and readonly attributes will be masked off in the .ZIP
  2021.           file, saving them with the system attribute only.
  2022.  
  2023.               When the hidden, system and readonly attribute of files are
  2024.           masked off, the  -v View option will display the attribute as --w
  2025.           (for writable) in the attribute column.
  2026.  
  2027.           NOTE:  There is no space between the J or j, and the h, s or r.
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.      PKWARE                           -35-
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.                                                                        |
  2075.                                                                        |
  2076.                                                                        |
  2077.                                         PKUNZIP - EXTRACTING ZIP FILES |
  2078.                                                                        |
  2079.                                       QUICK START - Extract a zip File |
  2080.                                                PKUNZIP Reference Guide |
  2081.                                         Description of Command Options |
  2082.                                                                        |
  2083.                                                                        |
  2084.                                                                        |
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.      PKWARE                           -36-
  2128.  
  2129.  
  2130.  
  2131.  
  2132.                          QUICK START - EXTRACTING A ZIP FILE
  2133.  
  2134.  
  2135.               This section will describe some simple examples, illustrating
  2136.           the command format for extracting files from a ZIP file.
  2137.  
  2138.           ______________________________________________________________
  2139.           |                                                            |
  2140.           |                      QUICK START                           |
  2141.           |                 How to Extract a ZIP file                  |
  2142.           |                                                            |
  2143.           | A ZIP file is one which holds much information in a        |
  2144.           | greatly reduced space.  Use the PKUNZIP program to         |
  2145.           | extract compressed files from a ZIP file.  An entire ZIP   |
  2146.           | file can be extracted, or specific files  can be           |
  2147.           | delegated to be extracted.                                 |
  2148.           |                                                            |
  2149.           | There are five main parameters in the PKUNZIP command:     |
  2150.           |                                                            |
  2151.           | 1. The actual program name          PKUNZIP                |
  2152.           |                                                            |
  2153.           | 2. The command options (optional)   letter commands        |
  2154.           |                                     example: -v=view files |
  2155.           |                                                            |
  2156.           | 3. The ZIP file name                AnyFile.ZIP            |
  2157.           |                                                            |
  2158.           | 4. The destination where you want  Default = directory     |
  2159.           |    the extracted information to    where program is started|
  2160.           |    be located (optional)                                   |
  2161.           |                                                            |
  2162.           | 5. Selected files to be extracted  Default = *.*           |
  2163.           |    (optional)                                              |
  2164.           |                                                            |
  2165.           |  Examples:                                                 |
  2166.           |                                                            |
  2167.           |    C:>PKUNZIP  AnyFile.ZIP  A:                             |
  2168.           |                                                            |
  2169.           | This command will extract all the files in the ZIP file    |
  2170.           | AnyFile.ZIP.  It will locate extracted files on the A      |
  2171.           | drive.                                                     |
  2172.           |                                                            |
  2173.           |                                                            |
  2174.           |    C:>PKUNZIP  A:AnyFile.ZIP  *.C                          |
  2175.           |                                                            |
  2176.           | In this example the ZIP file located in the A drive will   |
  2177.           | be extracted on the C drive.  The destination is the C     |
  2178.           | drive by default.  Only the *.C files will be extracted.   |
  2179.           |                                                            |
  2180.           |                                                            |
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.      PKWARE                           -37-
  2188.  
  2189.  
  2190.  
  2191.           |    C:>PKUNZIP \Collect\AnyFile.ZIP  A:  -o                 |
  2192.           |                                                            |
  2193.           |                                                            |
  2194.           | In this example, the path location of the ZIP file is      |
  2195.           | specified.   The files will be extracted on the A drive.   |
  2196.           | With the  -o option, the file with the same name as those  |
  2197.           | existing on the A drive, will overwrite the already        |
  2198.           | existing files, without asking for user confirmation.      |
  2199.           |____________________________________________________________|
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.      PKWARE                           -38-
  2248.  
  2249.  
  2250.  
  2251.                               PKUNZIP REFERENCE GUIDE
  2252.  
  2253.  
  2254.           The following table will provide a quick reference guide to
  2255.           all of the options of PKUNZIP.  The command syntax is also shown
  2256.           below.
  2257.  
  2258.  
  2259.           ----------------------------------------------------------------
  2260.           |                                                              |
  2261.           |                        PKUNZIP                               |
  2262.           |                                                              |
  2263.           | PKUNZIP [options] zipfile [d:path\] [file...]                |
  2264.           |                                                              |
  2265.           | zipfile = ZIP file name.  Default extension is .ZIP          |
  2266.           | file    = Names of files to compress. Wildcards *, ?  are ok.|
  2267.           |           Default is ALL files.                              |
  2268.           | list    = An optional list file name.                        |
  2269.           |                                                              |
  2270.           |                                                              |
  2271.           | Options are:                                                 |
  2272.           |   -c[m] = Extract files to the screen [with more]            |
  2273.           |   -d    = Create directories on extraction from ZIP file     |
  2274.           |   -h    = Call up help screen                                |
  2275.           |   -j -J<h,r,s> = Mask/Unmask file attributes                 |
  2276.           |   -l    = Display license information                        |
  2277.           |   -n    = Extract only newer files                           |
  2278.           |   -o    = Overwrite existing files                           |
  2279.           |   -p[a/b][c][n] = Extract files to the printer               |
  2280.           |   -s<password> = Unscrambles files with password protection  |
  2281.           |   -t    = Test ZIP file integrity                            |
  2282.           |   -q    = Enable ANSI comments                               |
  2283.           |   -v[b,r,c,d,e,n,p,s] = View file information                |
  2284.           |   -x    = Extract files (the default option)                 |
  2285.           |                                                              |
  2286.           ----------------------------------------------------------------
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.      PKWARE                           -39-
  2308.  
  2309.  
  2310.  
  2311.                        DESCRIPTION OF COMMAND OPTIONS
  2312.  
  2313.  
  2314.               The command options used in extracting a ZIP file will be
  2315.           explained in detail in this section.  You will find that the new
  2316.           command format is much more flexible and easier to use.  Listed
  2317.           below is a summary of important facts to keep in mind while using
  2318.           PKUNZIP.
  2319.  
  2320.           - The command options can generally be placed anywhere on the
  2321.             command line.
  2322.  
  2323.           - The first filename listed on the command line will be
  2324.             interpreted as the ZIP file to be extracted.  Subsequent
  2325.             filenames will be interpreted as specific files to be
  2326.             extracted.
  2327.  
  2328.           - The command can be typed using either upper case, lower
  2329.             case, or any combination.
  2330.  
  2331.           - All command options must be preceded by a '-' character
  2332.             (i.e. -v) or the MS-DOS switch character, usually '/'.
  2333.  
  2334.           - Unlike PKZIP, unrelated options of PKUNZIP cannot be combined.
  2335.  
  2336.           - The default values for the command line are as follows:
  2337.  
  2338.           - If no options are entered, the default is -x, the extract
  2339.             files option.
  2340.  
  2341.           - If no extension is specified for the ZIP file the .ZIP
  2342.             extension is assumed.
  2343.  
  2344.           - If no destination is specified for the extracted files, they
  2345.             will be located in directory that the program is being run
  2346.             from.
  2347.  
  2348.           - If no file specs (filenames, with or without wildcards) are
  2349.             listed, the default is *.*.
  2350.  
  2351.  
  2352.               The following table lists all the options valid with the
  2353.           PKZIP command.  A brief summary is also given in the table.  The
  2354.           options are explained in detail, along with programming examples,
  2355.           following the table.
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.      PKWARE                           -40-
  2368.  
  2369.  
  2370.  
  2371.                           Table 4-1   pkunzip Command Options
  2372.           --------------------------------------------------------------
  2373.  
  2374.           OPTION         SUMMARY
  2375.  
  2376.           -c[m]          Extracts files to the console [with more]
  2377.  
  2378.           -d             Uses the pathnames stored in the ZIP file and
  2379.                          creates the paths on extraction if they do not
  2380.                          already exist.
  2381.  
  2382.           -h             Displays a help screen.
  2383.  
  2384.           -j -J<h,r,s>   Specifies masking or unmasking of file
  2385.                          attributes.
  2386.  
  2387.           -l             Displays the license agreement.
  2388.  
  2389.           -n             Extracts files from the ZIP file only if they
  2390.                          are newer than the ones already on the disk.
  2391.  
  2392.           -o             Overwrites existing files without asking for
  2393.                          confirmation.
  2394.  
  2395.           -p[a/b][c][n]  Extracts files to a printer.
  2396.  
  2397.           -s<password>   Unscrambles the files with password protection.
  2398.  
  2399.           -t             Tests the ZIP file for corruption.
  2400.  
  2401.           -q             Enables ANSI comments.
  2402.  
  2403.           -v[b,r,c,d,e,n,p,s]  Views technical information about
  2404.                          files in the ZIP
  2405.  
  2406.           -x             Extracts files from the ZIP file.
  2407.  
  2408.  
  2409.           Note:  Parameters listed in [ ] are optional.  For parameters
  2410.           listed in < >, at least one of the listed parameters must be
  2411.           specified.
  2412.  
  2413.               This section will give a detailed explanation of the command
  2414.           options used in the PKUNZIP command.
  2415.  
  2416.               The command options are explained in groups determined by
  2417.           function.  The options pertaining to extracting ZIP files are
  2418.           explained first, followed by the view options, print options, and
  2419.           miscellaneous options.
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.      PKWARE                           -41-
  2428.  
  2429.  
  2430.  
  2431.           -x  Extract files from a ZIP file
  2432.           ---------------------------------
  2433.  
  2434.               This command will extract files from a ZIP file.  Either the
  2435.           entire ZIP file can be extracted or certain files can be
  2436.           specified to be extracted.  The extracted files will be located
  2437.           in the current directory unless you specify a destination.  The
  2438.           -x option is the default option for the PKUNZIP command.  If no
  2439.           option is listed on the command  -x will be assumed.
  2440.  
  2441.               If a file being extracted already exists at the same
  2442.           destination where the extracted files are being located, the
  2443.           program will prompt you for confirmation before it overwrites the
  2444.           existing file.
  2445.  
  2446.           C:\DB>PKUNZIP -x  A:lists.zip  *.dbf  *.txt
  2447.  
  2448.               In the above example, all of the files with a .dbf or a .txt
  2449.           extension will be extracted from the ZIP file called 'lists'.
  2450.           The ZIP file is located on the A drive.  When the noted files are
  2451.           extracted, they will be located in the C:\DB directory.
  2452.  
  2453.  
  2454.           -o  Extract files from ZIP file and overwrite existing files
  2455.               on disk
  2456.           ------------------------------------------------------------
  2457.  
  2458.               This command will extract files from a ZIP file and
  2459.           automatically overwrite any same-named files found in the
  2460.           destination where the extracted files are being located.  The
  2461.           program will NOT prompt you for confirmation before overwriting
  2462.           these files.
  2463.  
  2464.               Either the entire ZIP file can be extracted or certain files
  2465.           can be specified to be extracted.  The extracted files will be
  2466.           located in the current directory unless you specify a
  2467.           destination.
  2468.  
  2469.           C:>PKUNZIP  Zfile  *.doc -o
  2470.  
  2471.  
  2472.               In the above example, all of the files with a .doc extension
  2473.           will be extracted from the ZIP file called 'Zfile' (the .ZIP
  2474.           extension is assumed).  As the files are being extracted any
  2475.           files with the same name in the current directory will be
  2476.           automatically overwritten.
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.      PKWARE                           -42-
  2488.  
  2489.  
  2490.  
  2491.           -c[m]  Extract files from a ZIP file and display them on the
  2492.                  screen
  2493.           ------------------------------------------------------------
  2494.  
  2495.               This command will extract files from a ZIP file and display
  2496.           them on the monitor.  The extracted files will scroll
  2497.           continuously on the screen.  The software can be told to pause
  2498.           after each screen of output by using the -cm (more) option.
  2499.  
  2500.           A:>PKUNZIP  STUFF  -c  dates.doc
  2501.  
  2502.               In this example, the file 'dates.doc' will be extracted from
  2503.           the noted ZIP file, and displayed on the screen.
  2504.  
  2505.  
  2506.  
  2507.           -n  Extract only new files from the ZIP file
  2508.           --------------------------------------------
  2509.  
  2510.               This command will extract files from the ZIP file only if
  2511.           they are newer than the same-named ones already on the disk, or
  2512.           if they do not already exist on the disk.  This option serves as
  2513.           an overwriting safeguard.  It will not allow an older version of
  2514.           a file in a ZIP file to overwrite a newer version on disk.
  2515.           "Newer" is defined as the most recent time and date created.
  2516.  
  2517.           C:>PKUNZIP -n  C:\DB\lists  *.dbf
  2518.  
  2519.               In this example, all of the files with a .dbf extension, that
  2520.           are dated more recently than any same-named files on disk, or
  2521.           that do not already exist on disk will be extracted from the ZIP
  2522.           file 'lists'.
  2523.  
  2524.  
  2525.  
  2526.           -t  Test the ZIP file
  2527.           ---------------------
  2528.  
  2529.               This option is used to test the files to make sure they are
  2530.           valid and have not been corrupted.  The files will be listed as
  2531.           they are being tested 'OK' will listed after each file if it is
  2532.           not corrupted.  This option does not extract files from the ZIP
  2533.           file; it only tests them.  For instructions on reconstructing a
  2534.           ZIP file that has been corrupted, see the section on PKZIPFIX in
  2535.           section 5.
  2536.  
  2537.           C:\WORD\PK> pkunzip  zipdoc  *.doc -t
  2538.  
  2539.               In the above example all the .DOC files will be tested from
  2540.           the ZIP file 'zipdoc'.
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.      PKWARE                           -43-
  2548.  
  2549.  
  2550.  
  2551.           -v[b,r][c,d,e,n,p,s]  View technical information
  2552.           ----------------------------------------------------
  2553.  
  2554.               This option will display technical information concerning the
  2555.           files contained within a ZIP file.  There are several options
  2556.           available with the View option.  The view options for PKUNZIP are
  2557.           the same as those for PKZIP except for -vc.  In PKUNZIP -vc will
  2558.           cause the files to be sorted by the 32 bit CRC value.  Also,
  2559.           there is no  -vt (view more technical information) option.
  2560.  
  2561.                The following information about each file in the ZIP file
  2562.           will be displayed (scrolled) on the screen.
  2563.  
  2564.                       Length      Original length of the file
  2565.                       Method      Type of file compression used, Implode or
  2566.                                   Shrink, (or Reduce if an older version of
  2567.                                   PKZIP was used)
  2568.                       Size        Size of the compressed file
  2569.                       Ratio       Percent reduction in file size
  2570.                       Date        Actual date of the file
  2571.                       Time        Actual time of the file
  2572.                       CRC-32      The CRC-32 value of the file
  2573.                       Attribute   The attribute of the file (s=System,
  2574.                                   h=Hidden, w=Writable, r=readonly file,
  2575.                                   and *=encrypted file)
  2576.                       Name        Name of the file
  2577.  
  2578.  
  2579.               The View options for PKUNZIP are explained below.  The
  2580.           options determine how the information will be displayed and
  2581.           sorted.
  2582.  
  2583.           The following display options are available:
  2584.  
  2585.           -vb = The  -b Brief display option will display all the
  2586.                 information shown above except the CRC-32 value and the
  2587.                 file attribute.
  2588.  
  2589.           -vr = Display information in reverse order from the default
  2590.                 order.  This option is used with any of the sorting
  2591.                 options listed below to reverse the order of sorting.
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.      PKWARE                           -44-
  2608.  
  2609.  
  2610.  
  2611.               The following sorting options are available with the View
  2612.           option.  The default order of sorting is also specified.  (This
  2613.           order can be reversed by using the particular sorting option
  2614.           along with the  -vr  View Reverse option.)
  2615.  
  2616.                -vd = Sort by date of files, oldest to most recent.
  2617.                -ve = Sort by file extension, alphabetically.
  2618.                -vn = Sort by name of files, alphabetically.
  2619.                -vp = Sort by percentage ratio of compression, smallest
  2620.                      to largest.
  2621.                -vs = Sort by size of files, smallest to largest.
  2622.                -vc = Sort by 32 bit CRC value.
  2623.  
  2624.               If no sorting option is specified, the files will be
  2625.           displayed in the order they were compressed.
  2626.  
  2627.  
  2628.               The following command illustrates the View option used to
  2629.           display a ZIP file sorted by name.  The output display is shown
  2630.           below.
  2631.  
  2632.           D:> PKUNZIP backups.zip   -vn
  2633.  
  2634.  
  2635.        Length  Method   Size  Ratio   Date    Time   CRC-32  Attr  Name
  2636.        ------  ------   ----- -----   ----    ----   ------  ----  ----
  2637.         10752  Implode   3933  64%  07-06-89  19:23  426c896a --w  AGO.BAK
  2638.         25600  Implode   8525  67%  07-13-89  17:55  bacc8813 --w  DM1.BAK
  2639.         41984  Implode  13320  69%  07-10-89  21:36  b20889a9 --w  DM2.BAK
  2640.         26112  Implode   8470  68%  07-11-89  18:53  eb623405 --w  DM3.BAK
  2641.         16896  Implode   6153  64%  07-10-89  20:52  05d3ba41 --w  DM4.BAK
  2642.         28601  Implode   8602  70%  07-13-89  18:49  c0bd9829 --w  EM4.BAK
  2643.          7168  Implode   2456  66%  01-04-80  14:57  007c1270 --w  EXE.BAK
  2644.          4608  Implode   1906  59%  06-28-89  23:35  d70bcf7e --w  FMAL.BAK
  2645.          6656  Implode   1926  72%  06-28-89  13:00  7447224b --w  PK.BAK
  2646.          3072  Implode   1181  62%  06-28-89  16:59  597bade0 --w  PK1.BAK
  2647.          6144  Implode   2350  62%  01-04-80  13:48  96bb2322 --w  SAVE.BAK
  2648.          1240  Implode    754  40%  07-10-89  11:23  8899969f --w  TEEN.BAK
  2649.          8704  Implode   3504  60%  06-29-89  19:26  760cc345 --w  TIAL.BAK
  2650.         26624  Implode   8495  69%  06-29-89  00:16  8849114b --w  TZIP.BAK
  2651.         38400  Implode  12080  69%  06-29-89  18:31  53619fb8 --w  VZIP.BAK
  2652.           927  Implode    502  46%  07-17-89  18:31  61b90c8f --w  WIEW.BAK
  2653.           319  Shrunk     246  23%  07-17-89  18:33  045dda73 --w  XXXZ.BAK
  2654.        ------          ------  ---                                -------
  2655.        253807           84403  67%                                     17
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.      PKWARE                           -45-
  2668.  
  2669.  
  2670.  
  2671.           -p[a/b][c][n]  Extract files to a printer
  2672.           -----------------------------------------
  2673.  
  2674.               This option is used to extract files from a ZIP file and send
  2675.           them to a printer for printing.  The command parameters are
  2676.           defined below.  The parameters of the print option must be
  2677.           programmed together on the command line.  (i.e. -pac1 is correct,
  2678.           -p -a -c1 is NOT correct.)
  2679.  
  2680.            -p   Specifies the extract to printer option.
  2681.  
  2682.           a/b   The a and b parameters will set the printer device to
  2683.                 either ASCII or Binary mode respectively.  If no mode
  2684.                 is specified, whatever the default mode is for the
  2685.                 device will be used.
  2686.  
  2687.                 ASCII mode is commonly used to print text.  It will
  2688.                 form feed after each file.
  2689.  
  2690.                 Binary mode corresponds to the COPY command commonly
  2691.                 used to send fonts or graphics to a laser printer.  It
  2692.                 will not form feed after each file.
  2693.  
  2694.                 The a and b options cannot be mixed in the same
  2695.                 command.
  2696.  
  2697.             c   This option specifies the port that the data should be
  2698.                 sent through.   If c is included in the print option,
  2699.                 this specifies a serial (COM) port is to be used.  If c
  2700.                 is NOT included in the print option, this indicates a
  2701.                 parallel (LPT) port is to be used.
  2702.  
  2703.             n   This is the number of the print port being used.  It can
  2704.                 be any number from 1 to 4.  If no number is listed, 1 is
  2705.                 assumed by default.
  2706.  
  2707.           C:>PKUNZIP -pbc2  PICTURE.ZIP
  2708.  
  2709.               In the above example, the files compressed in the ZIP file
  2710.           'PICTURE' will be extracted and printed in binary mode to the
  2711.           serial port COM2.
  2712.  
  2713.           C:>PKUNZIP  stuff *.doc -p
  2714.  
  2715.               In the above example, all the .DOC files will be extracted
  2716.           from STUFF.ZIP to the parallel port LPT1.
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.      PKWARE                           -46-
  2728.  
  2729.  
  2730.  
  2731.           -d  Recreate directory paths upon extraction
  2732.           --------------------------------------------
  2733.  
  2734.               This command option uses the pathnames that have been stored
  2735.           in the ZIP file.  The directory pathnames are stored in the ZIP
  2736.           file by the use of  -p, -P and -r options in the list of PKZIP
  2737.           commands explained in Section 3.  If the stored output paths do
  2738.           not exist at the extraction destination, this command will create
  2739.           them as they are stored in the ZIP file.
  2740.  
  2741.           For example:  If the following directory tree exists on drive C.
  2742.  
  2743.                root----+-abc--+-dir1
  2744.                        |      |
  2745.                        |      +-dir2-+-dir3
  2746.                        |             |
  2747.                        +-xyz--       +-dir4
  2748.                        |
  2749.                        +-pdq
  2750.  
  2751.  
  2752.           If you then executed: PKZIP -r -p  A:STUFF  C:\abc\*.*
  2753.  
  2754.           If you then executed: PKUNZIP  -d  A:STUFF  C:\pdq\newabc
  2755.  
  2756.           After the PKUNZIP command is processed, the C drive would then
  2757.           look like this:
  2758.  
  2759.                root----+-abc--+-dir1
  2760.                        |      |
  2761.                        |      +-dir2-+-dir3
  2762.                        |             |
  2763.                        +-xyz--       +-dir4
  2764.                        |
  2765.                        +-pdq--+-newabc-+-dir1
  2766.                                        |
  2767.                                        +-dir2-+-dir3
  2768.                                               |
  2769.                                               +-dir4
  2770.  
  2771.  
  2772.               All of the files originally in C:\ABC and its subdirectories
  2773.           (dir1, dir2, dir3, and dir4) have been restored to C:\PDQ\NEWABC,
  2774.           with the directory tree being recreated.
  2775.  
  2776.               If this -d option is not specified and pathnames have been
  2777.           stored in the ZIP file, only the filenames stored in the ZIP file
  2778.           will be used, any pathnames will be ignored.
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.      PKWARE                           -47-
  2788.  
  2789.  
  2790.  
  2791.           -h  Display help screen
  2792.           -----------------------
  2793.  
  2794.               This command will display a help screen whenever typed on the
  2795.           command line.  The help screen will also occur when a command has
  2796.           been entered incorrectly.
  2797.  
  2798.           D:\PKWARE> PKZIP -h
  2799.  
  2800.  
  2801.  
  2802.           -l  Display the License screen
  2803.           ------------------------------
  2804.  
  2805.               This command will display the software license agreement.
  2806.  
  2807.  
  2808.  
  2809.           -q   Enable ANSI Comments
  2810.           --------------------------
  2811.  
  2812.               By default, ANSI sequences are filtered from the comments.
  2813.           This option allows any ANSI sequences to be displayed
  2814.           unfiltered.
  2815.  
  2816.  
  2817.           C:\ACCT> PKUNZIP ACCT.ZIP -o -q
  2818.  
  2819.               In this example, the ZIP file will be uncompressed
  2820.           (overwriting files existing on disk) and the ANSI comments of the
  2821.           file being extracted will be enabled.
  2822.  
  2823.  
  2824.  
  2825.           -j<H,S,R>  Mask hidden, system or readonly file attributes
  2826.           -J<H,S,R>  Do not mask hidden, system or readonly file
  2827.                      attributes
  2828.           ----------------------------------------------------------
  2829.  
  2830.               This option is used to mask the hidden, system or readonly
  2831.           attributes of files so that they will be treated as normal
  2832.           writable files.  By default hidden, system, and readonly
  2833.           attributes are masked off upon extraction.  To preserve these
  2834.           attributes, the -J option must be used.
  2835.  
  2836.  
  2837.           C:\DOS> PKUNZIP ALL.ZIP -Jhs
  2838.  
  2839.               In this example, any hidden or system file attributes of the
  2840.           files being extracted will be preserved.
  2841.  
  2842.  
  2843.           NOTE:  There is no space between the J or j, and the h, s or r.
  2844.  
  2845.  
  2846.  
  2847.      PKWARE                           -48-
  2848.  
  2849.  
  2850.  
  2851.           -s<password>  Unscramble files with password
  2852.           --------------------------------------------
  2853.  
  2854.               This option is used to unscramble, or decrypt the files in
  2855.           the ZIP file.  It is used in combination with the  -s Scramble
  2856.           option of the Zip options.  It includes password protection.
  2857.  
  2858.               When Unzipping a ZIP file that has been encrypted, the files
  2859.           will not be extracted unless the correct password is included on
  2860.           the command line.  Unzip skips encrypted files if the password is
  2861.           not stated on the command line.
  2862.  
  2863.               When specifying the password, there is no space between the
  2864.           s and the password.  Also the password is case sensitive.  It
  2865.           must be entered exactly the same as when you zipped the file.  It
  2866.           is important that you remember or somehow record the passwords
  2867.           that you use, because PKZIP does not retain a record of these
  2868.           passwords anywhere.
  2869.  
  2870.           C:\FINANCE> PKUNZIP PAYROLL -o -sSecret  *.pyr
  2871.  
  2872.               In the above example, all of the files with a *.pyr extension
  2873.           will be extracted from the ZIP file 'PAYROLL'.  In this case the
  2874.           password specified when the file was zipped, was 'Secret'.
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.      PKWARE                           -49-
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.                                                                           |
  2915.                                                                           |
  2916.                                                                           |
  2917.                                           PKSFX - SELF-EXTRACTION UTILITY |
  2918.                                                                           |
  2919.                                       Creating a Self-Extracting ZIP File |
  2920.                                                     PKSFX Reference Guide |
  2921.                                                                           |
  2922.                                                                           |
  2923.                                                                           |
  2924.                                                                           |
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.      PKWARE                           -50-
  2968.  
  2969.  
  2970.  
  2971.  
  2972.                           CREATING A SELF-EXTRACTING ZIP FILE
  2973.  
  2974.  
  2975.                ZIP files can be extracted without PKUNZIP through the
  2976.           use of self-extraction methods.  This is useful when you need to
  2977.           transfer compressed files to a person who may not be familiar
  2978.           with file compression and extraction procedures, or who does
  2979.           not have the PKUNZIP program.  The self-extracting ZIP file is
  2980.           an executable file with a .EXE extension.  By simply typing in
  2981.           the name of the self-extracting ZIP file, the PKUNZIP extraction
  2982.           process will be performed.
  2983.  
  2984.                Several options are available for running (extracting) self-
  2985.           extracting ZIP files.  They are listed on the following page.
  2986.  
  2987.                All self-extracting ZIP files can be treated as a normal ZIP
  2988.           file.  All of the PKZIP and PKUNZIP options can be performed on
  2989.           a self-extracting ZIP file.  The only difference is, the .EXE
  2990.           extension must be specified on the command line or the program
  2991.           will search for a ZIP file with the same name.
  2992.  
  2993.                In the example shown below, files in the self-extracting ZIP
  2994.           file, STARTUP.EXE will be freshened using the PKZIP  -f option.
  2995.  
  2996.           C:\PKWARE> PKZIP STARTUP.EXE -f
  2997.  
  2998.  
  2999.                There are also several options that are available to use
  3000.           WHILE extracting the self-extracting ZIP file.  These are listed
  3001.           in the PKSFX reference guide in the next section.  An example is
  3002.           shown below.
  3003.  
  3004.           C:\PKWARE> SEZIP  -d C:\
  3005.  
  3006.                In this example, the self-extracting ZIP file, will be
  3007.           extracted with the  -d  options.  The directories stored in the
  3008.           ZIP file will be reconstructed on the C: drive.
  3009.  
  3010.  
  3011.                The ZIP2EXE program is used to create a self-extracting ZIP
  3012.           file from a ZIP file, while leaving the original ZIP file
  3013.           intact.  ZIP2EXE in turn, uses PKSFX.PRG to create the self-
  3014.           extracting ZIP file.  PKSFX must be in the current directory or
  3015.           PATH when creating a self-extracting file.  The program MAKESFX
  3016.           will create PKSFX.PRG from the distribution file.  (You must run
  3017.           MAKESFX initially before you can create any self-extracting
  3018.           files.)
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.      PKWARE                           -51-
  3028.  
  3029.  
  3030.  
  3031.                The following example illustrates the process of creating a
  3032.           self-extracting ZIP file.  If you have not run MAKESFX to create
  3033.           PKSFX.PRG, you must do this first.
  3034.  
  3035.  
  3036.             -------------------------------------------------------------
  3037.             |          CREATING A SELF-EXTRACTING ZIP FILE              |
  3038.             |                                                           |
  3039.             | 1.  Create the ZIP file using PKZIP.                      |
  3040.             |                                                           |
  3041.             | 2.  Create the self-extracting file by entering:          |
  3042.             |                                                           |
  3043.             |          C:\>ZIP2EXE  zipfile                             |
  3044.             |                                                           |
  3045.             |     Where zipfile is the name of the ZIP file you want to |
  3046.             |     create the self-extracting file from.  The default    |
  3047.             |     extension is .ZIP if none is given.                   |
  3048.             |                                                           |
  3049.             |     When the process is completed a message such as the   |
  3050.             |     one shown below will be displayed on the screen to    |
  3051.             |     let you know the conversion has been successful.      |
  3052.             |                                                           |
  3053.             |          zipfile.ZIP => zipfile.EXE                       |
  3054.             -------------------------------------------------------------
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.      PKWARE                           -52-
  3088.  
  3089.  
  3090.  
  3091.                                PKSFX REFERENCE GUIDE
  3092.  
  3093.  
  3094.  
  3095.                This is a quick reference guide to the options available
  3096.           while uncompressing a self-extracting ZIP file.
  3097.  
  3098.  
  3099.  
  3100.           ---------------------------------------------------------------
  3101.           |                         PKSFX                               |
  3102.           |                                                             |
  3103.           |                                                             |
  3104.           | Syntax:                                                     |
  3105.           |   PKSFX  [options]  [d:path\]  [file...]                    |
  3106.           |                                                             |
  3107.           | Where:                                                      |
  3108.           |   PKSFX   = Name of the self-extracting ZIP file.           |
  3109.           |   options = Any of the options listed below.                |
  3110.           |   d:path\ = Output drive and/or path.                       |
  3111.           |   file    = Name(s) of files to extract.  Wildcards *, ?,   |
  3112.           |             are ok.  Default is all files.                  |
  3113.           |                                                             |
  3114.           |                                                             |
  3115.           |  Options:                                                   |
  3116.           |                                                             |
  3117.           |    -c[m] = Extract to screen [with more]                    |
  3118.           |    -d    = Create directories stored in ZIP file            |
  3119.           |    -n    = Extract only newer files                         |
  3120.           |    -p[a,b,c][1,2,3] = Extract to printer                    |
  3121.           |            [ASC mode, Bin,mode, COM port] [port number]     |
  3122.           |    -o    = Overwrite existing files                         |
  3123.           |    -x    = Extract files (default)                          |
  3124.           |    -l    = Display software license agreement               |
  3125.           |    -t    = Test ZIP file integrity                          |
  3126.           |                                                             |
  3127.           |                                                             |
  3128.           ---------------------------------------------------------------
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.      PKWARE                           -53-
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.                                                                        |
  3156.                                                                        |
  3157.                                                                        |
  3158.                                            SPECIAL HANDLING PROCEDURES |
  3159.                                                                        |
  3160.                                                 How a ZIP File is Made |
  3161.                                           Use of a RAM Disk with PKZIP |
  3162.                                       LAN - Local Area Network Support |
  3163.                                      Creating a Pre-Selected File List |
  3164.                                                  Batch File Processing |
  3165.                                                 The Configuration File |
  3166.                                                  PKWARE Error Messages |
  3167.                                         PKZIPFIX - File Reconstruction |
  3168.                                                                        |
  3169.                                                                        |
  3170.                                                                        |
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.      PKWARE                           -54-
  3208.  
  3209.  
  3210.  
  3211.                               HOW A ZIP FILE IS MADE
  3212.  
  3213.  
  3214.               PKZIP creates a temporary pre-ZIP file that has an extension
  3215.           of .!!! such as in  OldFile.!!!  during the compressing process.
  3216.           OldFile.!!! is the upgraded version of OldFile.ZIP.
  3217.  
  3218.               When all of your files have been successfully compressed, the
  3219.           original ZIP file is deleted and the file with the extension .!!!
  3220.           is simply renamed with a new extension .ZIP.
  3221.  
  3222.               It is FASTER to rename the temporary ZIP file than to copy it
  3223.           from one disk drive to another.  The FASTEST way to create your
  3224.           ZIP files is to do so from your largest disk drive.  The -b
  3225.           option is used to locate the pre-ZIP file on an alternate drive
  3226.           location, when your disk space is limited.
  3227.  
  3228.  
  3229.  
  3230.                             USE OF A RAM DISK WITH PKZIP
  3231.  
  3232.  
  3233.               PKZIP swaps information on and off disk memory as it runs.
  3234.           This process is NOT the same as the physical creation of the NEW
  3235.           ZIP file.  The default drive for this program activity is the
  3236.           drive from which the program was executed.  You can speed up
  3237.           performance as well as gain disk space by telling PKZIP which
  3238.           drive and/or subdirectory to use through a DOS environmental
  3239.           string.  All routing can be directed to your RAM Disk by using
  3240.           the  Set PKTMP command.
  3241.  
  3242.                C:>Set PKTMP=D:   --->  where "D:" refers to the RAM disk
  3243.  
  3244.  
  3245.  
  3246.                        LAN - LOCAL AREA NETWORK SUPPORT
  3247.  
  3248.               Both PKZIP and PKUNZIP, when opening files for read-only type
  3249.           access, will automatically open files in SHARE "deny write
  3250.           access" mode.  This pertains to systems running with DOS 3.0 or
  3251.           above, so that files can be read concurrently by other tasks.
  3252.           PKZIP uses a unique filename for all temporary files created.
  3253.           This allows PKZIP to be run by concurrent programs or on a
  3254.           network drive without any file contention or conflict.
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.      PKWARE                           -55-
  3268.  
  3269.  
  3270.  
  3271.                          CREATING A PRE-SELECTED LIST FILE
  3272.  
  3273.  
  3274.               This option is used to create List Files to record file
  3275.           selections you use frequently.  These List Files can then be
  3276.           typed on the command line instead of typing all the file names
  3277.           separately. List Files can be used with all the PKZIP and PKUNZIP
  3278.           command options.
  3279.  
  3280.               The procedure for creating List Files is somewhat easier with
  3281.           the new PKWARE programs.  The following example illustrates the
  3282.           steps necessary for creating List Files.
  3283.  
  3284.                __________________________________________________
  3285.                |                                                |
  3286.                |             CREATE A LIST FILE                 |
  3287.                |                                                |
  3288.                |   1.  Create the list using a word processor   |
  3289.                |       or text editor.                          |
  3290.                |                                                |
  3291.                |   2.  Type in the names of the files you       |
  3292.                |       select using any MS-DOS file notation.   |
  3293.                |                                                |
  3294.                |   3.  Include the directory and path locations |
  3295.                |       of the files in the list.                |
  3296.                |                                                |
  3297.                |   4.  Save the List File under the name you    |
  3298.                |       choose.  There is no default extension.  |
  3299.                |                                                |
  3300.                |    List File Name       Files Included         |
  3301.                |                                                |
  3302.                |      Group              letters.txt            |
  3303.                |                         C:\LOTUS\*.*           |
  3304.                |                         C:\DB\Monthly.*        |
  3305.                |                         D:\*.WKS               |
  3306.                |________________________________________________|
  3307.  
  3308.  
  3309.               When using a List File, it is preceded by the @ symbol on the
  3310.           command line.  If the List File is not in the directory, the @
  3311.           symbol is put before the PATH designation.   Note:  more than one
  3312.           list may be used on one command line.
  3313.  
  3314.                The List File can be mixed with other options, examples are
  3315.           shown below.
  3316.  
  3317.                C:>PKUNZIP  -r  NewFile.ZIP   @Group
  3318.  
  3319.                C:>PKUNZIP  AnyFile.ZIP   Today.Txt  @Group  @Data
  3320.  
  3321.                C:>PKZIP  -u  MoreFile  @Group  @\LOTUS\Accounts
  3322.  
  3323.                C:>PKZIP  -a  OldFile   *.Dbf  @OldStuff
  3324.  
  3325.  
  3326.  
  3327.      PKWARE                           -56-
  3328.  
  3329.  
  3330.  
  3331.                          USE OF PKWARE IN BATCH FILE PROCESSING
  3332.  
  3333.  
  3334.               When running PKZIP and PKUNZIP with other applications, you
  3335.           can test if the PKWARE experienced an error by using the DOS
  3336.           error level variable.  PKZIP and PKUNZIP return zero error level
  3337.           if no errors have occurred.
  3338.  
  3339.               If an error has occurred, the software will return one of the
  3340.           following error codes:
  3341.  
  3342.  
  3343.            PKZIP:
  3344.                     0    No error.
  3345.                     1    Bad file name or file specification.
  3346.                     2,3  Error in ZIP file.
  3347.                     4-11 Insufficient Memory.
  3348.                     12   No files were found to add to the ZIP file,
  3349.                          or no files were specified for deletion.
  3350.                     13   File not found.  The specified ZIP file
  3351.                          or list file was not found.
  3352.                     14   Disk full.
  3353.                     15   ZIP file is read-only and can not be modified.
  3354.                     16   Bad or illegal parameters specified.
  3355.                     17   Too many files.
  3356.  
  3357.           PKUNZIP:
  3358.                     0    No error.
  3359.                     1    Warning error (such as failed CRC check).
  3360.                     2,3  Error in ZIP file.
  3361.                     4-8  Insufficient Memory.
  3362.                     9    File not found.  No ZIP files found.
  3363.                     10   Bad or illegal parameters specified.
  3364.                     11   No files found to extract/view etc.
  3365.                     50   Disk Full.
  3366.                     51   Unexpected EOF in ZIP file.
  3367.  
  3368.           NOTE:
  3369.  
  3370.              Please note that if testing errorlevels in a batch file that
  3371.           DOS tests the errorlevel not for equality, but for greater than
  3372.           or equal to.
  3373.  
  3374.              For example, if the software exits with an exit code of 10,
  3375.           errorlevel 10 will be true, and so will errorlevel 9, errorlevel
  3376.           8, and so on.  Therefore, Errorlevel 0 will always test as true.
  3377.           Therefore, errorlevels should be tested in descending order.
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.      PKWARE                           -57-
  3388.  
  3389.  
  3390.  
  3391.           For example:
  3392.  
  3393.                pkunzip stuff -d d:\temp
  3394.                if errorlevel 51 goto err51
  3395.                if errorlevel 50 goto err50
  3396.                if errorlevel 10 goto err10
  3397.                if errorlevel 9 goto err9
  3398.                if errorlevel 4 goto err4
  3399.                if errorlevel 2 goto err2
  3400.                if errorlevel 1 goto err1
  3401.                echo No Error
  3402.                goto exit
  3403.                :err51
  3404.                echo Unexpected EOF
  3405.                goto exit
  3406.                :err50
  3407.                echo Disk Full
  3408.                goto exit
  3409.                .
  3410.                .
  3411.  
  3412.  
  3413.                              THE CONFIGURATION FILE
  3414.  
  3415.  
  3416.                The Configuration file can be used to set parameters to
  3417.           values other than the normal default values.  These values will
  3418.           then be the defaults for the specified parameters.  You can
  3419.           override any parameters that are set in the Configuration file
  3420.           by entering contrary instructions on the command line.
  3421.  
  3422.                PKZIP 1.0 will look in the current directory for the
  3423.           Configuration file called PKZIP.CFG.  If not found, then PKZIP
  3424.           will look for an environment variable of the form
  3425.           PKZIP.CFG=d:\path and will look in the specified path for
  3426.           PKZIP.CFG.
  3427.  
  3428.                This is a brief explanation of the configuration options for
  3429.           PKZIP 1.0 and their equivalent command line options.  An asterisk
  3430.           (*) indicates that this is the default for PKZIP.
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.      PKWARE                           -58-
  3448.  
  3449.  
  3450.  
  3451.           The following parameters can be set in the Configuration file.
  3452.  
  3453.           CONFIGURATION COMMAND      COMMAND LINE OPTION     DEFAULT
  3454.           ---------------------      -------------------     -------
  3455.  
  3456.           ANSI = enabled                     -q
  3457.                = disabled                    -q-                *
  3458.  
  3459.           ZIPDATE = latest                   -o
  3460.                   = keep                     -k
  3461.                   = current                  -k- -o-            *
  3462.  
  3463.           INCLUDE = hidden                   -wh
  3464.                   = system                   -ws
  3465.           EXCLUDE = hidden                   -WH                *
  3466.                   = system                   -WS                *
  3467.           Note:  These options can be combined. (For example:
  3468.                  INCLUDE = hidden/system)
  3469.  
  3470.           MASK = readonly                    -jr
  3471.                = hidden                      -jh
  3472.                = system                      -js
  3473.           PASS = readonly                    -Jr                *
  3474.                = hidden                      -Jh                *
  3475.                = system                      -Js                *
  3476.           Note:  These options can be combined.  (For example:
  3477.                  MASK = hidden, system)
  3478.  
  3479.           VIEW = comments                    -vc
  3480.                = extension                   -ve
  3481.                = size                        -vs
  3482.                = date                        -vd
  3483.                = name                        -vn
  3484.                = ratio                       -vp
  3485.                = natural                     -vo                *
  3486.                = reverse                     -vr
  3487.                = brief                       -vb
  3488.                = long                        -vl
  3489.           Note:  Some of these options can be combined.  The last three
  3490.                  options, reverse, brief and long, can be combined with any
  3491.                  of the above options.
  3492.  
  3493.           COMPRESS = size                    -ex                *
  3494.                    = speed                   -es
  3495.  
  3496.           PATHS = none                       -p-                *
  3497.                   all                        -P
  3498.                   recurse                    -p
  3499.  
  3500.           RECURSE = on                       -r
  3501.                   = off                      -r-                *
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.      PKWARE                           -59-
  3508.  
  3509.  
  3510.  
  3511.                For some of the parameters, only one value can be specified.
  3512.           For example, ANSI can be either enabled or disabled.  In other
  3513.           cases, more than one variable can be set per parameter.  For
  3514.           example, INCLUDE can be set to either system and/or hidden
  3515.           files.
  3516.  
  3517.                The parameters can be typed in uppercase, lowercase, or a
  3518.           combination.  When more than one variable can be set per
  3519.           parameter, the variables can be listed on the same line,
  3520.           separated by a comma (,), switch (/), or space.
  3521.  
  3522.                For example, when setting the MASK parameter to include all
  3523.           readonly, hidden and system files to be masked any of the
  3524.           following programming methods would be acceptable.
  3525.  
  3526.  
  3527.  
  3528.                MASK=readonly
  3529.                MASK=hidden
  3530.                MASK=system
  3531.  
  3532.                MASK=readonly, hidden, system
  3533.  
  3534.                MASK=readonly hidden system
  3535.  
  3536.                MASK=readonly/hidden/system
  3537.  
  3538.                MASK=readonly, hidden/system
  3539.  
  3540.  
  3541.                There are two environmental variables that can be set.
  3542.           These environmental strings can be typed in on the command line
  3543.           at the DOS prompt.
  3544.  
  3545.           Setting the path for the Configuration file.
  3546.  
  3547.                C:>SET PKZIP.CFG = C:\UTILS
  3548.  
  3549.                In this case, PKZIP.CFG is located in the \UTILS directory.
  3550.           Use the location of your choice.
  3551.  
  3552.  
  3553.           Setting a RAM disk.
  3554.  
  3555.                C:>SET PKTMP=D:
  3556.  
  3557.                This will speed up the program operation default by
  3558.           directing the mechanics of PKZIP to a RAM disk.  This has
  3559.           nothing to do with the creation of the "new" archive file during
  3560.           the add or upgrade process.
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.      PKWARE                           -60-
  3568.  
  3569.  
  3570.  
  3571.                                  ERROR MESSAGES
  3572.  
  3573.  
  3574.                The following error messages may appear when using PKZIP.
  3575.           When the word 'WARNING' appears in the message, program
  3576.           execution will continue, otherwise, the program will abort to
  3577.           DOS.
  3578.  
  3579.           A brief explanation of each message follows.
  3580.  
  3581.  
  3582.           PKZIP:  Can't open XXXX.ZIP for write access!
  3583.  
  3584.                The named ZIP file is read-only or locked by another
  3585.                application and can not be modified.
  3586.  
  3587.  
  3588.           PKZIP:  No file(s) found.
  3589.  
  3590.                No matching files were found to list using the View
  3591.                option.
  3592.  
  3593.  
  3594.           PKZIP:  Insufficient disk space for updated files:  XXXX.ZIP.
  3595.  
  3596.                The -b option was used, and there is not enough space on
  3597.                the original drive containing the ZIP file to receive the
  3598.                updated ZIP file.  Try to free up some space on the drive
  3599.                containing the ZIP file, and retry the operation.  Also,
  3600.                make sure that the drive specified with the -b option is
  3601.                different than the drive containing the ZIP file.
  3602.  
  3603.  
  3604.           PKZIP:  Insufficient disk space for ZIP comment.
  3605.  
  3606.                There is insufficient disk space to hold the comment as
  3607.                entered.
  3608.  
  3609.  
  3610.           PKZIP:  Warning!  Not enough memory for Shrinking method.
  3611.  
  3612.                The -es or -ea or -eb options were used to specify that
  3613.                certain files should be Shrunk.  However, there is not
  3614.                enough memory available to perform Shrinking.  Instead,
  3615.                all files will be Imploded.
  3616.  
  3617.  
  3618.           PKZIP:  Warning!  Can't delete XXXXX.
  3619.  
  3620.                The -m (Move) option was specified to delete files after
  3621.                the ZIP file was constructed.  However, the named file
  3622.                could not be deleted, and is probably read-only.
  3623.  
  3624.  
  3625.  
  3626.  
  3627.      PKWARE                           -61-
  3628.  
  3629.  
  3630.  
  3631.           PKZIP:  No files specified for deletion!
  3632.  
  3633.                The -d (Delete) option was specified, but no filenames
  3634.                were given to delete.  This option does NOT default to
  3635.                *.* if no filenames are given.
  3636.  
  3637.  
  3638.           PKZIP:  Nothing to do!
  3639.  
  3640.                No matching files, or files with the specified
  3641.                attributes, or files after the specified date etc., were
  3642.                found to compress.
  3643.  
  3644.  
  3645.           PKZIP:  Insufficient memory.
  3646.  
  3647.                Insufficient memory is available to process the ZIP file.
  3648.                Try making more memory available to PKZIP.  If this does
  3649.                not rectify the problem, then the ZIP file might be
  3650.                corrupted, and PKZIPFIX should be used to fix the ZIP
  3651.                file.
  3652.  
  3653.  
  3654.           PKZIP:  XXXX.ZIP - error in ZIP, use PKZIPFIX.
  3655.  
  3656.                The named ZIP file has a corrupted file index.  Use
  3657.                PKZIPFIX to reconstruct the ZIP file.
  3658.  
  3659.  
  3660.           PKZIP:  Can't create: XXXX.
  3661.  
  3662.                The named file could not be created.  Either the target
  3663.                directory is full or the file already exists and is read-
  3664.                only or locked by another application.
  3665.  
  3666.  
  3667.           PKZIP:  Disk full, file:  XXXX.
  3668.  
  3669.                A disk full error occurred while writing to the specified
  3670.                file.  Try freeing up some disk space on the target
  3671.                drive.  Also, see the -b option and the PKTMP environment
  3672.                variable.
  3673.  
  3674.  
  3675.           PKZIP:  Can't find:  XXXX.ZIP.
  3676.  
  3677.                The named ZIP file could not be found.
  3678.  
  3679.  
  3680.           PKZIP:  Too many files.
  3681.  
  3682.                There are too many files to compress into one ZIP file.  The
  3683.                limit is 3900 files per ZIP file.
  3684.  
  3685.  
  3686.  
  3687.      PKWARE                           -62-
  3688.  
  3689.  
  3690.  
  3691.           The following error messages may appear when using PKUNZIP.  A
  3692.           brief explanation of each message follows.
  3693.  
  3694.  
  3695.           PKUNZIP:  Warning!  File XYZZY already exists.  Overwrite (y/n)?
  3696.  
  3697.                The file XYZZY already exists on the disk.  Pressing N
  3698.                will leave the original file on the disk, and not extract
  3699.                the file from the ZIP file.  Pressing Y will extract the
  3700.                file from the ZIP file, and overwrite the file on the
  3701.                disk.  Also, see the -o and -n options.
  3702.  
  3703.  
  3704.           PKUNZIP:  Warning!  I don't know how to handle:  XYZZY.
  3705.  
  3706.                The file XYZZY is compressed or encoded in a way that
  3707.                this version of PKUNZIP is unable to handle.  Either a
  3708.                later version of PKUNZIP is required to properly extract
  3709.                this file, or the ZIP file is possibly corrupted.
  3710.  
  3711.  
  3712.           PKUNZIP:  Warning!  Inconsistent local header for file:  XYZZY.
  3713.  
  3714.                The local header for file XYZZY is different than the
  3715.                central header information.  Use PKZIPFIX to reconstruct
  3716.                the ZIP file.
  3717.  
  3718.  
  3719.           PKUNZIP:  Warning!  File fails CRC check.
  3720.  
  3721.                The CRC-32 check for the file being extracted or tested
  3722.                did not match the stored value for the file.  The file is
  3723.                probably corrupted.
  3724.  
  3725.  
  3726.           PKUNZIP:  Warning!  XXXX.ZIP has errors.
  3727.  
  3728.                The named ZIP file had one or more errors detected in it.
  3729.  
  3730.  
  3731.           PKUNZIP:  Warning!  File has bad table.
  3732.  
  3733.                The file being tested or extracted has an error in its
  3734.                encoding.  The file is probably corrupt.
  3735.  
  3736.  
  3737.           PKUNZIP:  Warning!  No file(s) found.
  3738.  
  3739.                No files were found to extract, test, or list.
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.      PKWARE                           -63-
  3748.  
  3749.  
  3750.  
  3751.           PKUNZIP:  Warning!  XXX.ZIP - error in ZIP, use PKZIPFIX.
  3752.  
  3753.                The named ZIP file has a corrupted file index.  Use
  3754.                PKZIPFIX to reconstruct the ZIP file.
  3755.  
  3756.  
  3757.           PKUNZIP:  Warning!  Insufficient memory.
  3758.  
  3759.                Insufficient memory is available to process the ZIP file.
  3760.                Try making more memory available to PKUNZIP.  If this
  3761.                does not rectify the problem, then the ZIP file might be
  3762.                corrupted, and PKZIPFIX should be used to fix the ZIP
  3763.                file.
  3764.  
  3765.  
  3766.           PKUNZIP:  Warning!  Can't create: XXXXX.
  3767.  
  3768.                The named file could not be created.  The output
  3769.                directory is either invalid or full.
  3770.  
  3771.  
  3772.           PKUNZIP:  Can't find: XXXX.ZIP.
  3773.  
  3774.                The named ZIP file(s) could not be found.
  3775.  
  3776.  
  3777.           PKUNZIP:  Can't open: XXXX
  3778.  
  3779.                The specified file list could not be opened.
  3780.  
  3781.  
  3782.           PKUNZIP:  Warning!  Can't open XXXX.ZIP
  3783.  
  3784.                The named file could not be opened.  Either a disk error
  3785.                occurred, or the file is locked by another application.
  3786.  
  3787.  
  3788.           PKUNZIP:  Disk full, file:  XXXXX.
  3789.  
  3790.                There is not enough free room on the destination
  3791.                drive/directory for the file being extracted.  The
  3792.                program will abort and exit to DOS.
  3793.  
  3794.  
  3795.           PKUNZIP:  Incorrect password for file.
  3796.  
  3797.                The ZIP file is password protected, and cannot be opened
  3798.                unless the correct password is entered.  The password
  3799.                entered is not the correct password.
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.      PKWARE                           -64-
  3808.  
  3809.  
  3810.  
  3811.           PKUNZIP:  Skipping encrypted file.
  3812.  
  3813.                Only the files that are password will be skipped (not
  3814.                extracted) because they are password protected and the
  3815.                correct password was not entered.
  3816.  
  3817.  
  3818.  
  3819.                           PKZIPFIX - RECONSTRUCTING ZIP FILES
  3820.  
  3821.  
  3822.                PKZIPFIX is a simple to use utility that takes advantage of
  3823.           the extra reliability of the ZIP file format to reconstruct
  3824.           truncated or damaged ZIP files.  The ZIP file format was
  3825.           designed for high reliability, using  4-byte signatures for all
  3826.           file headers, and redundant distributed and centralized
  3827.           directory structures.
  3828.  
  3829.                PKZIPFIX, however, cannot create good data out of bad data!
  3830.           If a portion of a ZIP file has been corrupted, PKZIPFIX will
  3831.           allow recovery of the unaffected files.  Depending on how badly
  3832.           damaged the ZIP file is, one or more files may still extract
  3833.           with errors.
  3834.  
  3835.                PKZIPFIX should be used when PKZIP or PKUNZIP indicates
  3836.           that a ZIP file is in error, or a ZIP file has become damaged.
  3837.           PKZIPFIX can also be used to extract the ZIP file portion from a
  3838.           PKSFX self-extracting file.
  3839.  
  3840.  
  3841.  
  3842.                      -------------------------------------------------
  3843.                      |                 PKZIPFIX                      |
  3844.                      |         Reconstructing ZIP files              |
  3845.                      |                                               |
  3846.                      |Syntax:  PKZIPFIX  zipfile                     |
  3847.                      |                                               |
  3848.                      | zipfile = The name of the ZIP file to be      |
  3849.                      |           reconstructed.  The .ZIP extension  |
  3850.                      |           will be assumed by default.         |
  3851.                      |                                               |
  3852.                      |                                               |
  3853.                      | PKZIP fix will attempt to recover zipfile,    |
  3854.                      | and will create a file called PKFIXED.ZIP     |
  3855.                      | which contains the reconstructed ZIP file.    |
  3856.                      |                                               |
  3857.                      |                                               |
  3858.                      -------------------------------------------------
  3859.  
  3860.  
  3861.                The file that is created by PKZIPFIX, PKFIXED.ZIP, can then
  3862.           be extracted or listed with PKUNZIP.  IT is strongly recommended
  3863.           that you then use PKZIP to create a new ZIP file from the files
  3864.           that are extracted from PKFIXED.ZIP.
  3865.  
  3866.  
  3867.      PKWARE                           -65-
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.                                                                        |
  3874.                                                                        |
  3875.                                                                        |
  3876.                                            REGISTRATION AND BACKGROUND |
  3877.                                                                        |
  3878.                                                      Technical Support |
  3879.                                           Other Background Information |
  3880.                                               Registration Information |
  3881.                                                       Software License |
  3882.                                                                        |
  3883.                                                                        |
  3884.                                                                        |
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914.  
  3915.  
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.      PKWARE                           -66-
  3928.  
  3929.  
  3930.  
  3931.  
  3932.                                   TECHNICAL SUPPORT
  3933.  
  3934.  
  3935.           If you have any further questions or comments about PKWARE File
  3936.           Compression programs, contact:
  3937.  
  3938.                    Mail:  PKWARE, Inc.
  3939.                           7545 North Port Washington Road
  3940.                           Suite 205
  3941.                           Glendale, WI 53217
  3942.  
  3943.                    PKWARE Support BBS - avaliable 24 hours
  3944.                        (414) 352-7176
  3945.  
  3946.                    Voice - 9am to 5pm CST:
  3947.                        (414) 352-3670
  3948.  
  3949.                    Fax - (414) 352-3815
  3950.  
  3951.  
  3952.                            _______
  3953.                       ____|__     |               (tm)
  3954.                    --|       |    |-------------------
  3955.                      |   ____|__  |  Association of
  3956.                      |  |       |_|  Shareware
  3957.                      |__|   o   |    Professionals
  3958.                    -----|   |   |---------------------
  3959.                         |___|___|    MEMBER
  3960.               
  3961.  
  3962.  
  3963.                            REGISTRATION INFORMATION
  3964.  
  3965.  
  3966.           ______________________________________________________________
  3967.           |                                                            |
  3968.           |                      REGISTRATION                          |
  3969.           |                                                            |
  3970.           | If you find PKPZIP, PKUNZIP, and PKSFX fast, easy, and con-|
  3971.           | venient to use, a partial registration of $25 would be     |
  3972.           | appreciated.                                               |
  3973.           |                                                            |
  3974.           | If you send $47 or more, you will receive, when available, |
  3975.           | a diskette and manual for the next version of the software.|
  3976.           |                                                            |
  3977.           | Please state the current version number of the software    |
  3978.           | you are presently using.  Send check or money order to:    |
  3979.           |                                                            |
  3980.           |                       PKWARE, Inc.                         |
  3981.           |              7545 North Port Washington Road               |
  3982.           |                        Suite 205                           |
  3983.           |                 Glendale, WI  53217-3422                   |
  3984.           |____________________________________________________________|
  3985.  
  3986.  
  3987.      PKWARE                           -67-
  3988.  
  3989.  
  3990.  
  3991.                                  SOFTWARE LICENSE
  3992.  
  3993.  
  3994.           PKZIP (tm) FAST! Create/Update Utility
  3995.           PKUNZIP (tm) FAST! Extract Utility
  3996.           PKSFX (R) FAST! Self-Extract Utility
  3997.           Copyright 1989 PKWARE Inc.  All Rights Reserved
  3998.  
  3999.           PKSFX Registered U.S. Patent and Trademark Office
  4000.  
  4001.  
  4002.                You are free to use, copy and distribute PKZIP, PKUNZIP, and
  4003.           PKSFX for NONCOMMERCIAL use if:
  4004.  
  4005.                No fee is charged for use, copying or distribution.
  4006.  
  4007.                It is not modified in any way.
  4008.  
  4009.                Clubs and user groups may charge a nominal fee not to exceed
  4010.           ($10) for expenses and handling while distributing PKZIP,
  4011.           PKUNZIP, and PKSFX.
  4012.  
  4013.                Site licenses and commercial licenses for PKZIP, PKUNZIP,
  4014.           and PKSFX are available.  Consult the file ORDER.DOC for more
  4015.           information, or contact PKWARE for more information.
  4016.  
  4017.  
  4018.                PKWARE hereby disclaims all warranties relating to this
  4019.           software, whether express or implied, including without
  4020.           limitation any implied warranties of merchantability or fitness
  4021.           for a particular purpose. PKWARE will not be liable for any
  4022.           special, incidental, consequential, indirect or similar damages
  4023.           due to loss of data or any other reason, even if PKWARE or an
  4024.           agent of PKWARE has been advised of the possibility of such
  4025.           damages.  In no event shall PKWARE's liability for any damages
  4026.           ever exceed the price paid for the license to use software,
  4027.           regardless of the form of the claim.  The person using the
  4028.           software bears all risk as to the quality and performance of the
  4029.           software.
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.      PKWARE                           -68-
  4048.