home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / ZIP204G / MANUAL.DOC < prev    next >
Text File  |  1993-10-07  |  202KB  |  5,610 lines

  1.  
  2.          ┌─────────────────────────────────────────────┐                │
  3.          │                 PKZIP 2                     ├┐               │
  4.          │                                             ││               │
  5.          │ The next generation in compression software ││               │
  6.          │                                             ││               │
  7.          │              *SHAREWARE MANUAL*             ││               │
  8.          └┬────────────────────────────────────────────┘│               │
  9.           └─────────────────────────────────────────────┘               │
  10.                                         │
  11.                                         │
  12.                                         │
  13.                                         │
  14.                                         │
  15.                                         │
  16.                                         │
  17.                                      PKZIP  │
  18.                                    PKUNZIP  │
  19.                                      PKSFX  │
  20.                                   PKZIPFIX  │
  21.                                    PKUNZJR  │
  22.                                        ┌┤
  23.                            PKWARE, Inc.                ││
  24.                            9025 N. Deerwood Drive      ││
  25.                            Brown Deer, WI 53223  USA   ││
  26.                                        ││
  27.                               Phone (414) 354-8699 ││
  28.                               Fax   (414) 354-8559 ││
  29.                               BBS   (414) 354-8670 ││
  30.                 ═══════════════════════════════════════════╧╛
  31.  
  32. Copyright 1989-1993 PKWARE Inc. All Rights Reserved.
  33.  
  34. U.S. Patent No. 5,051,745
  35.  
  36. No part of this publication may be reproduced, transmitted,
  37. transcribed, stored in a retrieval system, or translated into any other
  38. language or computer language in whole or in part, in any form or
  39. by any means, whether it be electronic, mechanical, magnetic,
  40. optical, manual or otherwise, without prior written consent of PKWARE, Inc.
  41.  
  42. PKWARE, Inc. disclaims all warranties as to this software, whether express
  43. or implied, including without limitation any implied warranties of
  44. merchantability, fitness for a particular purpose, functionality, data
  45. integrity or protection.
  46.  
  47. PKWARE, the PKWARE logo, PKZIP, PKUNZIP, and PKSFX are
  48. registered trademarks of PKWARE, Inc.
  49.  
  50. StupenDOS is a trademark of Eclipse Technologies, Inc.
  51.  
  52. MS-DOS is a trademark of Microsoft Corporation.
  53.  
  54. Netware and Novell are registered trademarks of Novell, Inc.
  55.  
  56. Trademarks of other companies mentioned in this documentation appear for
  57. identification purposes only and are the property of their respective
  58. companies.
  59.  
  60. *** PLEASE NOTE ***
  61. This is a condensed version of the manual provided with the registered
  62. version of PKZIP.  Some sections have been condensed or omitted in this
  63. shareware version.  Most notably, the tutorial had to be omitted.
  64.  
  65. See the ADDENDUM.DOC file for information about the benefits of registering
  66. PKZIP.
  67.  
  68.                                     CONTENTS
  69. ════════════════════════════════════════════════════════════════════════════
  70.  
  71. ________________________________________________________________
  72. Introduction                                                   1
  73.  
  74.      Product Support ......................................... 3
  75.  
  76. ________________________________________________________________
  77. Installation                                                   5
  78.  
  79.      Installing PKZIP On Your Hard Drive ..................... 5
  80.  
  81.       The Addendum File .................................. 7
  82.  
  83. ________________________________________________________________
  84. Tutorial                                                       8
  85.  
  86.      Getting Started ......................................... 8
  87.  
  88.      Simple PKZIP and PKUNZIP usage ......................... 10
  89.  
  90.       Zipping a Single File ............................. 12
  91.  
  92.       Zipping Multiple Files ............................ 14
  93.  
  94.       Testing .ZIP files ................................ 15
  95.  
  96.      Storing and Rebuilding Directory Structures ............ 16
  97.  
  98.       Deleting Files from a .ZIP file ................... 19
  99.  
  100.      Speed vs. Size ......................................... 21
  101.  
  102.      Selecting the Compression Type ......................... 23
  103.  
  104.      Using Advanced Features ................................ 24
  105.  
  106.       Extracting Files to a Device ...................... 24
  107.  
  108.       Storing and Restoring the Volume Label ............ 25
  109.  
  110.       Compressing and Extracting Hidden and System Files  26
  111.  
  112.       Zipfile and File Comments ......................... 27
  113.  
  114.      Suggested Reading ...................................... 29
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. ════════════════════════════════════════════════════════════════════════════
  122. PKWARE Inc.                   Contents                                     i
  123.  
  124. ________________________________________________________________
  125. PKZIP Command Reference                                       30
  126. ________________________________________________________________
  127. PKTMP                                                         47
  128. ________________________________________________________________
  129. PKUNZIP Command Reference                                     48
  130. ________________________________________________________________
  131. PKSFX/ZIP2EXE                                                 57
  132.  
  133.      Creating a Self-Extracting File ........................ 57
  134.  
  135.      PKSFX Junior ........................................... 57
  136.  
  137.      PKUNZIP Junior ......................................... 58
  138.  
  139.      PKSFX Command Summary .................................. 59
  140.  
  141.      Modifying a Self-Extracting File ....................... 60
  142.  
  143.      Stripping the PKSFX Code ............................... 60
  144.  
  145.      Sending a Self-Extractor ............................... 60
  146.  
  147.       With PKSFX Junior ................................. 61
  148.  
  149.       With PKSFX ........................................ 61
  150.  
  151.      Confirm before extract ................................. 62
  152.  
  153.      Memory Requirements .................................... 62
  154. ________________________________________________________________
  155. Using List Files                                              63
  156.  
  157.      Reading List Files ..................................... 64
  158.  
  159.      Generating List Files .................................. 65
  160.  
  161.      List file size ......................................... 66
  162.  
  163. ________________________________________________________________
  164. Using Data Encryption                                         68
  165.  
  166.       Long Keys ......................................... 69
  167.  
  168.       Complex Keys ...................................... 69
  169.  
  170.       Multiple Keys ..................................... 70
  171.  
  172.       How secure is PKZIP encryption? ................... 72
  173.  
  174.  
  175.  
  176.  
  177. ════════════════════════════════════════════════════════════════════════════
  178. ii                            Contents                               PKZIP 2
  179.  
  180. ________________________________________________________________
  181. PKZIP Configuration ......................................... 74
  182.  
  183.      PKZIP.CFG .............................................. 75
  184.  
  185. ________________________________________________________________
  186. Authenticity Verification                                     78
  187.  
  188.      Using PUTAV ............................................ 78
  189.  
  190.      Application for Authenticity Verification                81
  191.  
  192. ________________________________________________________________
  193. F.A.Q. (Frequently Asked Questions) ......................... 82
  194.  
  195. ________________________________________________________________
  196. How Does PKZIP Work?                                          91
  197.  
  198.      Compression ............................................ 91
  199.  
  200.       Information content ............................... 91
  201.  
  202.       Binary Data Representation ........................ 92
  203.  
  204.       Speed vs. Size .................................... 95
  205.  
  206.      Archiving .............................................. 95
  207.  
  208.       How PKZIP Builds a .ZIP File ...................... 97
  209.  
  210.       Building a New .ZIP File .......................... 97
  211.  
  212.       The .ZIP File Structure ........................... 98
  213.  
  214. ________________________________________________________________
  215. Trouble-Shooting                                             101
  216.  
  217.       Determining the Problem .......................... 101
  218.  
  219.       Customer Support Form ............................ 105
  220.  
  221. ________________________________________________________________
  222. ERROR MESSAGES                                               107
  223.  
  224.      Error Levels .......................................... 118
  225.  
  226. ________________________________________________________________
  227. PK Safe ANSI                                                 120
  228.  
  229.       Usage ............................................ 120
  230.  
  231.       Monochrome Option ................................ 121
  232.  
  233. ════════════════════════════════════════════════════════════════════════════
  234. PKWARE Inc.                   Contents                                   iii
  235.  
  236. FEATURES
  237. ════════════════════════════════════════════════════════════════════════════
  238.  
  239.  
  240. The PKZIP 2 software utilities include many features.  Here are just
  241. a few of them:
  242.  
  243. Improved Compression.  PKZIP 2 implements a new compression
  244. algorithm called Deflating.  Deflating has varying levels of compression
  245. and speed available, allowing you to specify the method of compression
  246. to be employed.  Both the speed and amount of compression are improved
  247. over previous versions of PKZIP.
  248.  
  249. Multi-volume archive support.  PKZIP 2 can create .ZIP files
  250. larger than a single floppy disk.
  251.  
  252. Subdirectory storage.  PKZIP 2 can find and store subdirectory
  253. pathnames within a .ZIP file.  Files can then be restored to their
  254. original subdirectories, or they may be re-created.  Storage includes
  255. empty subdirectories.
  256.  
  257. Automatic detection and utilization of  80386 and 80486 CPU's,
  258. EMS and XMS memory, Novell Netware, and 32-bit DPMI.  PKZIP 2 gets
  259. the most out of your machine by using the power of modern CPU's.  EMS
  260. and XMS support offer the ability to process more files with less
  261. available conventional memory.  Novell Netware and 32-bit DPMI support
  262. offer speed improvements.
  263.  
  264. The above features also allow you to get the best performance when
  265. in a DOS session under OS/2 or Windows.  OS/2 and Windows offer EMS,
  266. XMS and 32-bit DPMI without your using extra drivers.
  267.  
  268. Memory Requirements.  PKZIP requires a minimum of 183K of conventional
  269. memory.  If EMS is available, the conventional memory requirement
  270. is 85K.  PKUNZIP requires 90K of conventional memory.  PKSFX requires
  271. a minumum of 71K of memory.
  272.  
  273. Easy to use configuration program.  PKZIP 2 can be configured
  274. to best suit your needs through the use of the PKCFG program.
  275.  
  276. PKSFX Junior and PKUNZIP Junior.  These "Junior" programs use
  277. very little memory and are extremely small.  Although they are reduced in
  278. ability, their small size makes them very useful.
  279.  
  280. Password Encryption.  Sensitive data files can be scrambled
  281. with password protection.  The security of this feature has been improved
  282. in PKZIP 2.
  283.  
  284. Authenticity Verification.  Users requiring authentication of
  285. archive files may request an Authenticity Verification code.  This
  286. allows users to create .ZIP files which reveal tampering.
  287.  
  288.  
  289. ════════════════════════════════════════════════════════════════════════════
  290. iv                            Features                               PKZIP 2
  291.  
  292.                                 INTRODUCTION
  293. ════════════════════════════════════════════════════════════════════════════
  294.  
  295.  
  296. Welcome to PKZIP 2.0.  This release continues the high performance tradition
  297. of previous versions of PKZIP, with a host of new features.  In addition to
  298. an improved reference section, this manual contains a step-by-step tutorial.
  299. By following the Installation, Tutorial and Advanced Features sections in
  300. order you will learn how to use PKZIP to your best advantage.  Use the
  301. Command Reference sections in your day-to-day use of PKZIP. Convenient
  302. indices to these sections are printed on the inside of the front and back
  303. covers.
  304.  
  305. PKZIP is a powerful program. It has many options, but it is possible to make
  306. use of PKZIP by knowing only a few simple options.  You can start out with a
  307. basic understanding and learn more if and when you need to use additional
  308. features.
  309.  
  310. It is recommended that you first read through this introduction and the
  311. installation procedure.  Then perform the installation and work through the
  312. Tutorial in order.
  313.  
  314. Follow up with the Advanced Features section of the Tutorial.  You should not
  315. attempt to use the PKZIP Backup Guide until you have completed (and
  316. understand) the entire tutorial.
  317.  
  318. Conventions
  319.  
  320. This manual follows several conventions for clarity and to help you find
  321. information quickly.  Text that you would see on your computer screen is
  322. shown here in a "typewriter" typeface.  Text that would be entered by you
  323. in these examples is shown in bold:
  324.  
  325. C:\DOS>dir
  326.  
  327. Bold text is also used for emphasis and to point out terms which are then
  328. shown in vocabulary boxes.
  329.  
  330. Vocabulary
  331. ────────────────────────────────────────────────────────────────────────────
  332. Terms that are felt to be technical enough to require explanation are listed
  333. in convenient vocabulary blocks.  These vocabulary terms are with the first
  334. instance of the word, so that you may read them and continue on without
  335. needing to search for the glossary.  This block is an example.
  336. ────────────────────────────────────────────────────────────────────────────
  337.  
  338. **  Anything that we want to be sure you don't miss will be pointed out in
  339.     the same manner as this paragraph.
  340.  
  341.  
  342.  
  343.  
  344.  
  345. ════════════════════════════════════════════════════════════════════════════
  346. PKWARE Inc.                   Introduction                                 1
  347.  
  348.  
  349. Command Syntax
  350.  
  351. Standard command specification syntax is used throughout the Command
  352. Reference section.  This is used to differentiate between command option
  353. parameters which are optional or mandatory, and to indicate when certain
  354. options may be combined:
  355.  
  356. < >     Angle Brackets are used to indicate a command option parameter which
  357. must be present.  The option parameter will follow immediately after the
  358. option with no space.
  359.  
  360. [ ]     Square Brackets indicate a command option parameter which is not
  361. mandatory.
  362.  
  363. , |     If there are several possible options which may be used in the
  364. position indicated by the angle or square brackets, they will be separated by
  365. either a Comma or a Vertical Bar.  If options are separated by a comma, then
  366. more than one of the options may be used simultaneously.  If they are
  367. separated by a vertical bar, the options are exclusive of one another and
  368. only one may be used at a time.
  369.  
  370. Following are some abstract examples of how these syntax rules are applied.
  371.  
  372. Syntax               Valid Entries
  373. ---------------------------------------------------
  374. -z<a,b,c>           -za, -zab, -zac, -zbc, -zabc
  375.  
  376. -z<a|b|c>           -za, -zb, -zc
  377.  
  378. -z[a,b]             -za, -zb, -zab, -z
  379.  
  380. -z<a|b,c>           -za, -zb, -zac, -zbc
  381.             -zab or -zabc would be invalid.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401. ════════════════════════════════════════════════════════════════════════════
  402. 2                            Introduction                            PKZIP 2
  403.  
  404. Product Support
  405.  
  406. We hope that your use of PKZIP and PKUNZIP will be enjoyable and trouble-
  407. free.  It is our intention to provide the best possible product and
  408. documentation. We understand that problems may arise, and in most cases you
  409. will be able to resolve any problems you may have by referring to the
  410. documentation.  Answers to questions you might have will usually be found
  411. within these pages.
  412.  
  413. You may reach our Product Support staff in several convenient ways.
  414.  
  415. Support Conferences
  416.  
  417. PKWARE maintains support conferences on several BBS Networks.  Such as ILink,
  418. SmartNet and Rime.  You may leave a question in the PKWARE support conference
  419. on any of these networks.  A Support Technician or fellow user will answer
  420. your questions.  Many other BBS networks also offer PKWARE conferences, but
  421. these are not necessarily monitored by PKWARE.
  422.  
  423. PKWARE BBS
  424.  
  425. PKWARE also maintains its own BBS.  The PKWARE BBS is normally available 24
  426. hours a day.  The BBS supports all baud rates from 1200 up to 14.4K.  Set
  427. your communications software for 8 bits, 1 stop bit, no parity.
  428.  
  429. The PKWARE BBS offers the latest in PKWARE shareware as well as many other
  430. files for downloading.  The PKWARE BBS has multiple phone lines for your
  431. convenience.
  432.  
  433. PKWARE BBS
  434. (414)354-8670
  435.  
  436. CompuServe
  437.  
  438. PKWARE Support Technicians maintain a discussion forum on CompuServe.  To
  439. get to the forum, simply type "GO PKWARE" from any CompuServe prompt.
  440.  
  441. PKWARE CompuServe ID# 75300,730
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457. ════════════════════════════════════════════════════════════════════════════
  458. PKWARE Inc.                   Introduction                                 3
  459.  
  460.  
  461. Internet/Usenet
  462.  
  463. PKWARE products are frequently discussed in the newsgroup "comp.compression".
  464. Internet newsgroups are not supported directly by PKWARE.
  465.  
  466. Through Internet
  467. PKWARE.Inc@mixcom.com
  468.  
  469. Voice and Fax
  470.  
  471. You may reach a PKWARE Support Technician by sending a Fax containing your
  472. question.
  473.  
  474. PKWARE FAX
  475. (414)354-8559
  476.  
  477. If your question is urgent, or you do not have access to any of the above
  478. methods of communication, a Support Technician may be reached by phone.
  479. PKWARE Technical support is normally available Monday through Friday, 9 am
  480. to 5 pm Central Time (-7 hours GMT).
  481.  
  482. PKWARE Voice Support
  483. (414)354-8699
  484.  
  485. Information to Give
  486.  
  487. When contacting PKWARE Technical Support in any of the above methods, please
  488. be prepared to provide as much information about the problem as possible.
  489. Include the version numbers for: PKZIP, DOS, and any Memory and Device
  490. Drivers you are using.  Include the command(s) you have tried to use, and
  491. what the results were and note why you feel you have a problem.
  492.  
  493. When faxing a problem, a print out of any error messages is often helpful in
  494. determining a solution.
  495.  
  496. Please see the Trouble Shooting section for additional information.
  497.  
  498. PKWARE Inc.
  499. 9025 N. Deerwood Dr.
  500. Brown Deer, WI  53223
  501. (414)354-8699
  502. (414)354-8559 FAX
  503. (414)354-8670 BBS
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513. ════════════════════════════════════════════════════════════════════════════
  514. 4                            Introduction                            PKZIP 2
  515.  
  516.                                 INSTALLATION
  517. ════════════════════════════════════════════════════════════════════════════
  518.  
  519.  
  520. PKZIP works best when it is located in your path.  You can put PKZIP in your
  521. path by either copying it into an already existing subdirectory that is in
  522. your path, or by copying it into its own subdirectory and putting that
  523. subdirectory into your path.
  524.  
  525. Throughout this manual many examples will show the command prompt. This will
  526. look like "C:\>" or "C:\PKWARE>" or something similar.  This represents the
  527. command prompt displayed by your computer and is not to be typed in.  If you
  528. do not see a prompt that looks like this when you are using DOS, try typing
  529. the command "PROMPT $P$G". This will set your prompt to resemble those used
  530. here.  You may also want to add the "PROMPT $P$G" command to your
  531. AUTOEXEC.BAT file.
  532.  
  533. Path
  534. ────────────────────────────────────────────────────────────────────────────
  535. There are two meanings for path as used under MS-DOS.  It may refer to the
  536. location of a file, or it may refer to the places DOS will search for a
  537. command.
  538.  
  539. In the first instance, a path would be the directory or subdirectories that a
  540. file is located in.  If a file called "HOURS.PYS" is in a subdirectory called
  541. "JUNE" under a directory called "PAYROLL" on the D: hard disk, it's full path
  542. would be "D:\PAYROLL\JUNE\HOURS.PYS".
  543.  
  544. In the second instance, the path is a list of places stored in an environment
  545. variable called "path".  If you type "path" at the DOS prompt and press enter
  546. you will see the path that is currently set on your computer.  It will
  547. usually look something like this:
  548.  
  549. C:\;C:\DOS;C:\UTIL;D:\WINDOWS
  550.  
  551. It will look different on your machine).  The path is set by a statement in
  552. the AUTOEXEC.BAT file.  For more information, please see your DOS manual.
  553. ────────────────────────────────────────────────────────────────────────────
  554.  
  555. Installing PKZIP On Your Hard Drive
  556.  
  557. Your computer should be turned on and at the DOS prompt.  If your computer
  558. normally runs a program automatically when you turn it on, you will need to
  559. exit from this program.  You should have a prompt on your screen similar to:
  560.  
  561. C:\>
  562.  
  563. **  This installation example shows PKZIP being run from the C:\PKWARE
  564.     directory.  PKZIP may be run from any drive in any directory.
  565.  
  566.  
  567.  
  568.  
  569. ════════════════════════════════════════════════════════════════════════════
  570. PKWARE Inc.                   Installation                                 5
  571.  
  572.  
  573. Place the diskette containing the original PKZIP distribution in your floppy
  574. drive, either A: or B:.  Next, create a subdirectory for PKZIP on your hard
  575. drive.  To do so type:
  576.  
  577. C:\>MD \PKWARE
  578.  
  579. Then change to this subdirectory.
  580.  
  581. C:\>CD \PKWARE
  582. C:\PKWARE>
  583.  
  584. Now enter the name of the self-extractor on your PKZIP disk, include the drive
  585. letter as part of the name.
  586.  
  587. C:\PKWARE>A:PKZ200
  588.  
  589. Note that the name of the self-extractor used throughout this manual
  590. (PKZ200.EXE) may vary but will follow the pattern of PKZ###.EXE where ###
  591. represents the version number of the software.
  592.  
  593. The contents of this file will now extract into the PKWARE subdirectory.
  594.  
  595. The A: and C: drives in the above command are only for example, and may be
  596. replaced with other drive letters as appropriate to your particular setup.
  597.  
  598. You must next modify your AUTOEXEC.BAT file.  You can edit this file with any
  599. editor that can load and save DOS TEXT or plain ASCII files (For example,
  600. "edit" in DOS 5.0, Windows Write, or any word processor with a DOS TEXT
  601. editing ability. Consult your word processor's manual if you are unsure).
  602.  
  603. If you have DOS 5.0 type:
  604.  
  605. C:\>edit autoexec.bat
  606.  
  607. Look for a line in the file that says something similar to:
  608.  
  609. PATH=C:\;C:\DOS;(etc...)
  610.  
  611. Go to the end of this line and add a semicolon if one is not already there,
  612. and the drive and path to PKZIP that you just created. For example
  613. "...;C:\PKWARE"
  614.  
  615. The line will now look similar to this:
  616.  
  617. PATH=C:\;C:\DOS;C:\PKWARE
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625. ════════════════════════════════════════════════════════════════════════════
  626.  6                           Installation                            PKZIP 2
  627.  
  628.  
  629. You will most likely have additional items between the C:\DOS; and C:\PKWARE.
  630.  
  631. Next add a line that looks like this:
  632.  
  633. set pkzip.cfg=c:\pkware
  634.  
  635. The directory specified must be equal to the directory where PKZIP.CFG is
  636. located. If you have followed this installation procedure exactly, the above
  637. line will work fine.  This line should be near the top of the AUTOEXEC.BAT
  638. file.
  639.  
  640. Save the file and exit.  You will have to re-boot your computer to make the
  641. change take effect.
  642.  
  643. After you reboot type "path" at the command line and press [ENTER].  Your
  644. machine will show the path.  Make certain that the subdirectory you placed
  645. the PKWARE files in is shown in the path.
  646.  
  647. You may now verify that PKZIP is installed by typing "PKZIP" at the DOS
  648. command prompt.  After you press [ENTER] you should see a banner screen from
  649. PKZIP.  Try PKUNZIP as well.  You should be able to type PKUNZIP or PKZIP in
  650. any directory and drive, not just in the PKWARE subdirectory.
  651.  
  652. If you receive the message "Bad command or file name" or "Unknown command",
  653. PKZIP is not properly installed.  Check the location of the files you
  654. extracted from the distribution file. Also check the lines that were added to
  655. the AUTOEXEC.BAT file.  Make certain you have rebooted since the changes were
  656. made to the AUTOEXEC.BAT file.
  657.  
  658. The Addendum File
  659.  
  660. In addition to the files that make up the PKZIP program, you also have a text
  661. file containing any last minute changes or updates to the documentation.  You
  662. need to print the addendum file in order to be aware of anything that is not
  663. mentioned in the manual, or has changed since this manual was printed.
  664.  
  665. To print the addendum, load the text file ADDENDUM.DOC into your
  666. wordprocessor and print it.
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681. ════════════════════════════════════════════════════════════════════════════
  682. PKWARE Inc.                   Installation                                 7
  683.  
  684. TUTORIAL
  685. ════════════════════════════════════════════════════════════════════════════
  686.  
  687. A comprehensive tutorial is provided with the registered version of PKZIP.
  688. This tutorial has been omitted from the shareware version to save
  689. download transmission time.
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737. ════════════════════════════════════════════════════════════════════════════
  738. PKWARE Inc.                   Tutorial                                  8-29
  739.  
  740. PKZIP
  741. ════════════════════════════════════════════════════════════════════════════
  742. Command Reference
  743.  
  744. Items contained in square brackets([ ]) are optional parameters to an option
  745. and need not be included.  Where there are two (or more) items separated by a
  746. comma, you may use any ONE of those options following the main option
  747. character.  If there are parameters in angle brackets(<>) you must include
  748. that option, or choose one of those in the series.  When choosing options
  749. from a bracketed series, you may use more than one of these options if they
  750. are separated by a comma. If the options are separated by a vertical bar (|)
  751. you may only choose one option.  See page 2 for examples.
  752.  
  753. Command Option Guide
  754.  
  755. _____________________________________
  756. -a+  Turn off archive attribute of added files.
  757.  
  758. By using this option you can create a complete backup of your disk, while
  759. clearing the archive attributes to make the way for incremental archiving.
  760.  
  761. Incremental archiving makes use of the archive attribute to take only the
  762. files which have been modified since the last backup.  In order for this
  763. process to work smoothly you must first have a complete backup and a clearing
  764. of the archive attribute for all files.
  765.  
  766.    C:>pkzip f:backup.zip -a+ -rp
  767.  
  768. _____________________________________
  769. -b<drive:path>  Create temporary .ZIP file on alternate drive
  770.  
  771. Every time a .ZIP file is updated, PKZIP creates a temporary work file. When
  772. the modifications to the .ZIP file are successfully completed, the original
  773. .ZIP file is replaced with the temporary work file.  This means you must have
  774. at least as much additional disk space available as was used by the original
  775. .ZIP file.
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793. ════════════════════════════════════════════════════════════════════════════
  794. 30                              PKZIP                                PKZIP 2
  795.  
  796.  
  797. For Example: If you have an existing .ZIP file of 500K, and you are adding
  798. another file to it that takes 10K compressed, you need additional workspace
  799. of at least 510K during the update process.
  800.  
  801. This command option will allow you to create the temporary .ZIP file on a
  802. drive different from the one on which the original .ZIP file resides.  This
  803. allows you to update large .ZIP files when space is limited, such as a large
  804. .ZIP file on a floppy disk.  Also, by setting this temporary drive to point
  805. to a RAM drive, you can speed up the operation of PKZIP.
  806.  
  807. Immediately following the -b option place the drive and/or path you wish to
  808. use for the temporary work file.
  809.  
  810.    A:>pkzip test.zip -bc: order.doc
  811.  
  812.    C:>pkzip wp.zip -bz:\public wp51\*.*
  813.  
  814. **  It is necessary to specify a path in addition to the drive letter only
  815.     if you are in a situation where disk space or access is being limited by
  816.     subdirectory, such as on a local area network.
  817.  
  818. _____________________________________
  819. -c      Create/Edit file comments for all files
  820. -ac     Create/Edit file comments for all files during update
  821. -C      Add comments for new files only
  822.  
  823. Each individual file contained within a .ZIP file may have a comment attached
  824. to it.  Comments are useful for identifying files, especially if you need to
  825. go back months later to look at a file, or if you are sending the file to
  826. someone else.  Each comment may be up to 59 characters long, including spaces
  827. and punctuation.
  828.  
  829. The -c (lower case) option is used when you want to add or edit file comments
  830. for all files within an existing .ZIP file.
  831.  
  832. The -ac option may be used during the .ZIP file creation process, or during
  833. an update/freshen process.  This will add comments for new files as well as
  834. allowing you to edit/add comments for files that were already in the .ZIP
  835. file.
  836.  
  837.    pkzip test.zip -ac license.doc
  838.  
  839. When each file is added to the .ZIP file you will be prompted for a comment.
  840. Type a comment of up to 59 characters, and press [ENTER].  If you are
  841. updating an existing .ZIP file and there are files which already have
  842. comments, the comment will be displayed on the prompt line for you to edit.
  843. You may make changes or simply press [ENTER] to leave it unchanged.
  844.  
  845.  
  846.  
  847.  
  848.  
  849. ════════════════════════════════════════════════════════════════════════════
  850. PKWARE Inc.                        PKZIP                                  31
  851.  
  852. The -C (upper case) option is used when you want to add a file comment to new
  853. files that are being added to an existing .ZIP file.  Files which are not
  854. being added, or files which already existed in the .ZIP file will not be
  855. prompted for comments.
  856.  
  857.    pkzip test.zip -C *.doc
  858.  
  859. In this situation, you would be adding additional files to the file called
  860. test.zip. Since the file license.doc was added to it in the previous example,
  861. you would not be prompted for a comment for this file.
  862.  
  863. _____________________________________
  864. -d Delete files
  865.  
  866. This command will allow you to remove individual files from within a .ZIP
  867. file.  This command is only applicable to already existing .ZIP files.
  868.  
  869.    pkzip test.zip -d license.doc
  870.  
  871. In the above example the file license.doc would be removed from the .ZIP file
  872. test.zip (assuming that it was in the .ZIP file in the first place).
  873.  
  874. **  The deletion of files from within a .ZIP file causes a situation where
  875. a temporary .ZIP file will exist during the deletion process.  In order to
  876. delete a file from a .ZIP file there must be as much disk space free as will
  877. be occupied by the modified .ZIP file.
  878.  
  879. Multiple files may be deleted at one time.  You may do this either by placing
  880. multiple file names on the command line, or by specifying a list file
  881. containing the names of files you want deleted.  (See Using List Files)
  882.  
  883.    pkzip july.zip -d file1.wk file2.wk1
  884.  
  885.    pkzip tue_back.zip -d @old.lst
  886.  
  887. _____________________________________
  888. -e[x|n|f|s] Specify compression method
  889.  
  890. -ex         Maximum compression (most compression, most time)
  891. -en         Normal compression (default)
  892. -ef         Fast compression
  893. -es         Super Fast compression (least compression, least time)
  894.  
  895. -e0         Zero compression (storing)
  896.  
  897. PKZIP 2 provides four different methods of compression, allowing you to
  898. choose the compression that best suits your need.  You can choose speed, high
  899. compression or a balance.  The default method will provide good compression
  900. at a reasonable speed.
  901.  
  902.  
  903.  
  904.  
  905. ════════════════════════════════════════════════════════════════════════════
  906. 32                              PKZIP                                PKZIP 2
  907.  
  908. The switches for this option are intended to be mnemonic in nature:
  909.  
  910. -ex     eXtra or maXimum
  911. -en     Normal
  912. -ef     Fast
  913. -es     Speed/Super Fast
  914. -e0     Zero compression
  915.  
  916. The only two that may be difficult to remember are the order of Fast and
  917. Super Fast, you might want to think "Extra Speed".
  918.  
  919. If you need to complete the compression in the minimum amount of time
  920. possible, then choose the fast compression method.  To force PKZIP to use its
  921. fastest compression method, use the option -es (Super Fast).
  922.  
  923. To achieve the smallest files possible, specify the maximum compression
  924. method using the option -ex (Maximum).
  925.  
  926.    pkzip -ex test.zip d:\wp51\*.wp
  927.  
  928. Using no compression with the zero option is useful when archiving files
  929. which will either not compress or compress very little.  This would generally
  930. be true when archiving .ZIP files.  By specifying no compression PKZIP will
  931. store the files directly rather than first attempting to compress them.
  932.  
  933. The compression method to use by default can be specified in the
  934. configuration file.  If you have specified the super fast, fast or maximum
  935. compression method in your configuration you may override this and use the
  936. normal method by using the option -en.
  937.  
  938. _____________________________________
  939. -f  Freshen files in a .ZIP file
  940.  
  941. When this command is specified, PKZIP will compare the contents of the .ZIP
  942. file specified on the command line against the files specified for
  943. compression.  If a file ALREADY EXISTS in the .ZIP file, PKZIP will check to
  944. see if the file exists in the source area (i.e. the files specified on the
  945. command line).  If the file does exist, it then checks to see if the file in
  946. the source area is more recent than the copy contained in the .ZIP file.  If
  947. it is more recent, it will replace the compressed file with the one found in
  948. the source area.
  949.  
  950. Using this parameter will normally speed up the ZIP process considerably, as
  951. PKZIP will be able to skip over files that it has already compressed.
  952.  
  953.    pkzip -f baka.zip c:\ranma\*.*
  954.  
  955. This example checks the contents of the .ZIP file "baka.zip" against the
  956. files specified by "c:\ranma\*.*".  Any file that matches will be
  957.  
  958.  
  959.  
  960.  
  961. ════════════════════════════════════════════════════════════════════════════
  962. PKWARE Inc.                        PKZIP                                  33
  963.  
  964. updated if the file in the source area is newer than the copy within the .ZIP
  965. file.
  966.                                 See Also: -u, -i
  967.  
  968. _____________________________________
  969. -h display command summary (Help)
  970.  
  971. This option will display a brief summary of the command switches available.
  972.  
  973. _____________________________________
  974. -i   Add files that have the archive attribute - then turn attribute off
  975. -i-  Add files that have the archive attribute - do not turn attribute off
  976.  
  977. This option is very handy when backing up files.  If this option is
  978. specified, only files with the archive attribute will be compressed, and the
  979. archive attribute will be set to off when the ZIP operation is complete for
  980. these files.
  981.  
  982. You may alternatively ZIP all files with the archive attribute set, but not
  983. modify the archive attribute.
  984.  
  985. A detailed explanation of the use of this option is given in the PKZIP Backup
  986. Guide.
  987.  
  988. Archive Attribute───────────────────────────────────────────────────────────
  989. Every file on an MS-DOS partition has several properties associated with it.
  990. One of these properties is called the Archive Attribute.  When a file has
  991. just been created, this attribute is set to be ON.  Also, if a file is
  992. altered, the attribute is set.  After a file has been backed-up by a program
  993. which uses this attribute, the attribute is switched off.  By making use of
  994. the archive attribute you may make certain that you get all files that are
  995. new or changed.  You save time by not backing up files you have previously
  996. archived.  This process is called an Incremental Backup.
  997. ────────────────────────────────────────────────────────────────────────────
  998.  
  999.                            See Also: PKZIP Backup Guide,
  1000.                                 -f , -u, -a+
  1001.  
  1002. _____________________________________
  1003. -j<h,r,s> Specify masking of file attributes
  1004. -J<h,r,s> Specify retention of file attributes (used to override config file)
  1005.  
  1006. When PKZIP archives a read-only file (or is forced to archive a hidden or
  1007. system file through use of the -w option) the default is to retain these
  1008. attributes with the file in the archive.  You may choose to strip these
  1009. attributes off the file during the ZIP process by specifying the -j (lower
  1010. case) with the letter(s) corresponding to the attribute you wish to mask.
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017. ════════════════════════════════════════════════════════════════════════════
  1018. 34                              PKZIP                                PKZIP 2
  1019.  
  1020.  
  1021. File Attributes─────────────────────────────────────────────────────────────
  1022. Every file on an MS-DOS partition has several properties associated with it.
  1023. These attributes are: archive(a), hidden(h), read-only(r), and system(s).
  1024. The archive attribute is explained under the -i option.  The Hidden attribute
  1025. prevents MS-DOS from displaying the file in a directory listing.  Files that
  1026. have this attribute are normally ignored by PKZIP.  The read-only attribute
  1027. prevents a file from being changed or deleted.  When a file has this
  1028. attribute you cannot delete the file or change it's contents.  The system
  1029. attribute signifies a file that is a system file.  System files are used by
  1030. MS-DOS and are treated as Hidden files. Please see your DOS manual for
  1031. additional information.
  1032. ────────────────────────────────────────────────────────────────────────────
  1033.  
  1034. You may set masking of particular attributes to be the default by using
  1035. either the PKZIP.CFG file or the PKZIP configuration program.
  1036.  
  1037. If any of these options are set in the configuration they may be overridden
  1038. temporarily by use of the -J (upper case) option.
  1039.  
  1040.    pkzip markie.zip -Jhs c:\util\*.*
  1041.  
  1042. **  Please note there is no space between the -j/J option and the h,r or s.
  1043.  
  1044. _____________________________________
  1045. -k  Retain original .ZIP file date
  1046. -k- Set .ZIP file date to the current date (override configuration file)
  1047.  
  1048. Normally, when PKZIP updates an existing .ZIP file by either adding to it or
  1049. deleting from it, the .ZIP file date is changed to the current date.  If
  1050. the - k option is specified on the command line the .ZIP file date will not
  1051. be altered.
  1052.  
  1053. This option may be made the default, see PKZIP Configuration.
  1054.  
  1055. If PKZIP is configured to keep the original date in the configuration file,
  1056. this may be overridden temporarily by use of the -k- option.
  1057.  
  1058.                                  See Also: -o
  1059.  
  1060. _____________________________________
  1061. -l Display license screen
  1062.  
  1063. If this command is specified, PKZIP will display the software license
  1064. agreement.
  1065.  
  1066. _____________________________________
  1067. -m[u|f]  Move files
  1068.  
  1069. Normally, when PKZIP archives a file, it is making a copy of that file. The
  1070. original file is not modified in any way.  By choosing the -m option, you may
  1071. actually MOVE the file into the .ZIP file.
  1072.  
  1073. ════════════════════════════════════════════════════════════════════════════
  1074. PKWARE Inc.                        PKZIP                                  35
  1075.  
  1076.  
  1077. After the ZIP operation is complete, PKZIP will delete all the files it just
  1078. placed into the .ZIP file.  In effect moving the files from their previous
  1079. location into the .ZIP file.
  1080.  
  1081. This option may be combined with the Update (-u) and Freshen (-f) options.
  1082. When this is done PKZIP will perform the Update or Freshen as it would
  1083. normally, and then delete all the files that were placed into the archive.
  1084.  
  1085.                                 See Also: -f, -u
  1086.  
  1087. _____________________________________
  1088. -o   Set .ZIP file date to latest file in .ZIP file
  1089. -o-  Set .ZIP file date to current date (used to override configuration file)
  1090.  
  1091. Normal default operation for PKZIP is to set the date of a .ZIP file it is
  1092. modifying or creating to the current date.  By specifying the -o option you
  1093. can tell PKZIP to set the date of the .ZIP file equal to that of the oldest
  1094. file within the .ZIP file.
  1095.  
  1096. This option may be made the default, see PKZIP Configuration.
  1097.  
  1098. If this option is set, you may override it by using the -o- option.  This
  1099. will force PKZIP to set the .ZIP file date to the current date.  Note that
  1100. the -o- option must be completely separate from any other options, such as
  1101. the -f in the example:
  1102.  
  1103.    pkzip oldfiles.zip -o- -f c:\wp51\text\*.wp
  1104.  
  1105.                                 See Also: -k
  1106. _____________________________________
  1107. -P  Preserve specified path names
  1108. -P- Turn off path storage (used to override configuration file)
  1109.  
  1110. This option and the related -rp option control the storage of pathnames with
  1111. files inside of a .ZIP file.  The -p (lower case) option is used only in
  1112. combination with the -r option as -rp (see -r for more information).
  1113.  
  1114. The -P (upper case) option can be used alone or as a -rP option. The -P
  1115. option causes PKZIP to store pathnames found on the command line as part of a
  1116. filename specified for compression.  This command will only have an effect if
  1117. a file or files specified either on the command line or in a list file have
  1118. path names.
  1119.  
  1120.    pkzip pathtest.zip -P c:\dos\attrib.exe
  1121.  
  1122. In the above command the file "attrib.exe" would be compressed into the .ZIP
  1123. file "pathtest".  Because the -P option was specified, and because the path
  1124. "\dos" was specified as part of the file name, the
  1125.  
  1126.  
  1127.  
  1128.  
  1129. ════════════════════════════════════════════════════════════════════════════
  1130. 36                              PKZIP                                PKZIP 2
  1131.  
  1132.  
  1133. file will be stored as "dos\attrib.exe". This means that the path name will
  1134. be available for reconstruction during extraction.  Stored path names can be
  1135. seen when the .ZIP file is viewed.
  1136.  
  1137.    pkzip path2.zip -P d:\coreldrw\*.cdr
  1138.  
  1139. In this example all files with the "cdr" extension will be placed into the
  1140. .ZIP file "path2", and will have the path "coreldrw\" stored with them.
  1141.  
  1142. This option may be made the default, see PKZIP Configuration.
  1143.  
  1144. If path storage is turned on in the configuration file, you may turn it off
  1145. for a particular command by using the -P- option.
  1146.  
  1147.    pkzip mydoc.zip -P- c:\wp51\docs\zoofund.wp
  1148.  
  1149.                                 See Also: -r, -v
  1150. _____________________________________
  1151. -q      Enable ANSI comments
  1152. -q-     Disable ANSI comments (used to override configuration file)
  1153.  
  1154. PKZIP retains ANSI control codes in comment text that is added to a .ZIP
  1155. file.  During display of the comment text, PKZIP will normally disable ANSI
  1156. codes.  If you want to have the ANSI control codes used by PKZIP when
  1157. displaying comment text, you must specify this option.
  1158.  
  1159.    pkzip spacemp.zip -q se.diz
  1160.  
  1161. This option may be made the default, see PKZIP Configuration.
  1162.  
  1163. If the ANSI option is turned on in the configuration file you may temporarily
  1164. override it by using the -q- option.  Note that the -q and -q- options must
  1165. be separated from any other options specified.
  1166.  
  1167. _____________________________________
  1168. -r   Recurse subdirectories
  1169. -rp  Recurse subdirectories, preserve the path structure below
  1170. -rP  Recurse subdirectories, preserve path structure specified and below
  1171. -r-  Turn off recursion (used to override configuration file)
  1172.  
  1173. When this option is specified, PKZIP will search the source directory for
  1174. subdirectories.  If any subdirectories are found, PKZIP searches them for
  1175. files.  If a further level of subdirectories is found in a subdirectory,
  1176. PKZIP will search these as well.
  1177.  
  1178. PKZIP will enter as many subdirectory levels as exist.
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185. ════════════════════════════════════════════════════════════════════════════
  1186. PKWARE Inc.                        PKZIP                                  37
  1187.  
  1188.  
  1189.    pkzip mail.zip -r c:\mymail\*.*
  1190.  
  1191. Using the above command, all files contained within the "mymail"subdirectory,
  1192. as well as all files within any subdirectories, would be archived.  Only the
  1193. file names would be retained, and not the names of the subdirectories.
  1194.  
  1195.    pkzip mail2.zip -rp c:\mymail\*.*
  1196.  
  1197. The second example would preserve the same files as the first, but also keep
  1198. the names of any subdirectories found below the "mymail" subdirectory.  Note
  1199. that the "mymail" subdirectory itself would not be retained since the -P is
  1200. not being used.
  1201.  
  1202.    pkzip pay_june.zip -rP d:\payroll\*.*
  1203.  
  1204. The third example will compress all of the files in the payroll directory, as
  1205. well as all of the files in any subdirectories.  The -rp would cause the
  1206. subdirectories to be recursed and stored.  The -P will cause "\payroll" to be
  1207. stored as well.  Without the -P, the "\payroll" portion of the path would not
  1208. be stored.  This option may be made the default, see PKZIP Configuration.
  1209.  
  1210. **  Please note that paths are not stored when the -r option is specified
  1211.     without the p or P option.  In order for paths to be stored, the -r
  1212.     option must be accompanied by the -p or -P option.
  1213.  
  1214. _____________________________________
  1215. -s[password] Encrypt files
  1216.  
  1217. By specifying this option you may encrypt data as it
  1218. is compressed by PKZIP.  This feature of PKZIP causes the information
  1219. contained within a .ZIP file to be scrambled.  A file which has been
  1220. scrambled will be unreadable until extracted with the same encryption key.
  1221.  
  1222. If a password is not specified the user will be prompted for one.
  1223.  
  1224. **  This feature should be used with caution.  For a complete explanation of
  1225.     the use of this option please see Using Data Encryption.
  1226.  
  1227. _____________________________________
  1228. -t<date>  Select files NEWER than or EQUAL to date
  1229. -T<date>  Select files OLDER than date
  1230.  
  1231. This option will allow you to select files according to their date.  The date
  1232. specifier is a six-digit number conforming to the following formats:
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241. ════════════════════════════════════════════════════════════════════════════
  1242. 38                              PKZIP                                PKZIP 2
  1243.  
  1244.  
  1245. "American" style:     mmddyy
  1246. 040193     April 1st, 1993
  1247. 103189     October 31st, 1989
  1248.  
  1249. "European" style:     ddmmyy
  1250. 010493     1 April, 1993
  1251. 311089     31 October, 1989
  1252.  
  1253. "Japanese" style:     yymmdd
  1254. 930401     1993 April 01
  1255. 891031     1989 October 31
  1256.  
  1257. PKZIP adapts itself to the date format for which your machine is configured
  1258. automatically.
  1259.  
  1260. All users within the United States use the first date format.
  1261.  
  1262. If you are outside the United States and are unsure of the configuration of
  1263. your computer, enter the DATE command at the DOS prompt.  This will show you
  1264. the date format being used on your computer.
  1265.  
  1266. The -t and -T options may be combined to specify a date range.
  1267.  
  1268. These examples all use the "American" date format (mmddyy).  To compress all
  1269. files created after or on November 4, 1992:
  1270.  
  1271.    pkzip test.zip -t110492
  1272.  
  1273. To compress all files created before January 10, 1991:
  1274.  
  1275.    pkzip test.zip -T011091
  1276.  
  1277. To compress all files created between October 1, 1992 and October 31, 1992:
  1278.  
  1279.    pkzip test.zip -t100192 -T103192
  1280.  
  1281. If -t is used with no date, files with dates equal to the current date are
  1282. specified:
  1283.  
  1284.    pkzip today.zip -t
  1285.  
  1286. _____________________________________
  1287. -u  Update files
  1288.  
  1289. This option only affects PKZIP operations involving an already existing .ZIP
  1290. file. When -u is used in conjunction with a PKZIP command, the files
  1291. specified for archiving will be compared against the files already present in
  1292. the .ZIP file.  If the file to be added into the .ZIP file is already present
  1293. and is not NEWER, PKZIP will not bother to re-compress the file.
  1294.  
  1295.  
  1296.  
  1297. ════════════════════════════════════════════════════════════════════════════
  1298. PKWARE Inc.                        PKZIP                                  39
  1299.  
  1300. By using this option, you may save yourself time when archiving files that
  1301. are backed up repeatedly.  This option differs from the behavior of the -f
  1302. option in that files which are not already present in the .ZIP file will be
  1303. added.
  1304.  
  1305.    PKZIP p:\backup\sdsource.zip -u d:\c700\work\sd*.*
  1306.  
  1307. In this example a .ZIP file called "sdsource.zip" is created in a "backup"
  1308. directory on the P: drive.  All files in the source directory matching the
  1309. file specification will be added or updated.
  1310.  
  1311.                                    See Also: -f
  1312.  
  1313. _____________________________________
  1314. -v[b][r,c|d|e|n|o|p|s][m]      View [brief] file information
  1315. -vt[m]                         View Technical file information
  1316.  
  1317. This option will display technical information concerning the files contained
  1318. within a .ZIP file.  There are several options available with the View
  1319. option. Each of the -v options may have an `m' added to it, causing the
  1320. screen to pause every 25 lines.
  1321.  
  1322. In it's simplest form the -v by itself gives a display similar to this:
  1323.  
  1324.    pkzip am70 -v
  1325.  
  1326.    PKZIP (R)  FAST!  Create/Update Utility  Version 2
  1327.    Copr. 1989-1992 PKWARE Inc.  All Rights Reserved.  PKZIP/h for help
  1328.    PKZIP Reg. U.S. Pat. and Tm. Off.   Patent No. 5,051,745
  1329.  
  1330.    ■80486 CPU detected.
  1331.    ■XMS version 3.00 detected.
  1332.    ■Novell Netware version 3.11 detected.
  1333.  
  1334.    Searching ZIP: AM70.ZIP - PKWARE Support BBS (414)354-8670
  1335.  
  1336.    Length  Method    Size  Ratio   Date    Time    CRC-32  Attr  Name
  1337.    ------  ------    ----- ----- --------  -----  -------- ----  ------------
  1338.     76812  DeflatX   23139  70%  01-30-92  12:03  971fea04 --w-  AM.DOC
  1339.    191872  DeflatX   80773  58%  01-31-92  15:02  25cf904a --w-  AM.EXE
  1340.     11664  DeflatX    6935  41%  01-30-92  11:57  183b5606 --w-  AM.HLP
  1341.    149567  DeflatX   63211  58%  01-31-92  15:02  bf2fffee --w-  AM.OVR
  1342.      2262  DeflatX    1021  55%  03-16-91  10:39  50b63fc5 --w-  NEW-WARE.BBS
  1343.      5327  DeflatX    2068  62%  10-14-91  11:25  924efc72 --w-  PATHINFO.TXT
  1344.       130  DeflatX     118  10%  11-14-90  10:05  fd1b1183 --w-  PROGMENU.AM
  1345.      3664  DeflatX    1644  56%  04-04-91  10:32  c8d5c9cf --w-  PROGMENU.DOC
  1346.      1688  DeflatX     740  57%  11-10-90  11:27  8ef23b8a --w-  READ!.POP
  1347.      1416  DeflatX     595  58%  01-30-92  12:03  32b1497e --w-  VENDOR.DOC
  1348.      2167  DeflatX     949  57%  01-30-92  12:07  2e13f4d4 --w-  WARNING.!!!
  1349.      2200  DeflatX    1049  53%  01-30-92  12:01  20c953ee --w-  WHAT'S.NEW
  1350.    ------           ------  ---                                  ------------
  1351.    448769           182242  60%                                       12
  1352.  
  1353. ════════════════════════════════════════════════════════════════════════════
  1354. 40                              PKZIP                                PKZIP 2
  1355.  
  1356. This is the standard, unsorted view of the .ZIP file contents.  The columns
  1357. displayed from left to right consist of:
  1358.  
  1359. Length     Original (non-compressed) size of the file
  1360. Method     Type of compression routine used on this file
  1361. Size       Current (compressed) size of the file
  1362. Ratio      Percent reduction in file size
  1363. Date       Date of the file (as it would appear in a directory listing)
  1364. Time       Time of the file
  1365. CRC-32     The value of the file as calculated by the CRC-32 routine
  1366. Attribute  The stored attributes of the file, (system, hidden, writable,
  1367.        read-only, *=encrypted)
  1368. Name       Name of the file
  1369.  
  1370. The -vb (brief) option will display an identical listing, minus the CRC-32
  1371. and Attribute columns.
  1372.  
  1373. The -vt option shows additional technical information about a file.  When
  1374. this option is active, a report similar to the following will be displayed:
  1375.  
  1376.    C:\>pkzip am70 -vt am.doc
  1377.  
  1378.    PKZIP (R)  FAST!  Create/Update Utility  Version 2
  1379.    Copr. 1989-1992 PKWARE Inc.  All Rights Reserved.  PKZIP/h for help
  1380.    PKZIP Reg. U.S. Pat. and Tm. Off.   Patent No. 5,051,745
  1381.  
  1382.    ■80486 CPU detected.
  1383.    ■XMS version 3.00 detected.
  1384.    ■Novell Netware version 3.11 detected.
  1385.  
  1386.    Searching ZIP: AM70.ZIP - PKWARE Support BBS (414)354-8670
  1387.  
  1388.          Filename: AM.DOC
  1389.         File type: text
  1390.        Attributes: --w-
  1391.     Date and Time: Jan 30,1992  12:03:54
  1392.    Compression Method: DeflatX
  1393.       Compressed Size: 23139
  1394.     Uncompressed Size: 76812
  1395.      32 bit CRC value: 971fea04
  1396.        Created by: PKZIP: 2.0 under MS-DOS
  1397.     Needed to extract: PKUNZIP: 2.0
  1398.  
  1399. The "File type" is a judgement made by PKZIP during compression based upon
  1400. the contents of the file.  It will be either "BINARY" or "TEXT".
  1401.  
  1402. The "Created By" lists both the version level of PKZIP  and the operating
  1403. system used when the .ZIP file was created.  Below that is listed the minimum
  1404. version of PKUNZIP that would be required to extract the file.
  1405.  
  1406.  
  1407.  
  1408.  
  1409. ════════════════════════════════════════════════════════════════════════════
  1410. PKWARE Inc.                        PKZIP                                  41
  1411.  
  1412.  
  1413. Sort Order
  1414.  
  1415. By adding one of the following letters to the -v, -vb, or -vt command you can
  1416. specify the sort order of the display.
  1417.  
  1418. d     File Date
  1419. e     File Extension
  1420. n     File Name
  1421. o     Natural Order (Sort order can be permanently specified in the
  1422.        configuration file, the "o" option will override this.)
  1423. p     Percentage of compression, smallest to largest
  1424. s     File Size, smallest to largest
  1425.  
  1426. Any of the above sort orders may be reversed with an "r".
  1427.  
  1428. r     Reverse display order
  1429.  
  1430. If you wish to also view the individual file comments with the listing
  1431. specify "c" on the command line.
  1432.  
  1433.    pkzip hildie.zip -vbcnr
  1434.  
  1435. This example would display a brief list of the file contents, including
  1436. individual file contents, and sorted in reverse name order.
  1437.  
  1438. View With MORE
  1439.  
  1440.    pkzip totoro.zip -vtrm
  1441.  
  1442. This example makes use of the "more" feature available with the view command.
  1443. This causes the display to pause after every 25 lines of information.  Adding
  1444. an `m' to any -v command will cause it to pause every screenful.
  1445.  
  1446. _____________________________________
  1447. -w<h,s>       Take hidden, system files
  1448. -W<h,s>       Skip hidden, system files (used to override configuration file)
  1449.  
  1450. Normally PKZIP will skip any Hidden or System files that fall within the
  1451. files specified for compression.  (See the -j option and your DOS manual for
  1452. an explanation of what Hidden and System files are).
  1453.  
  1454. If you wish to force PKZIP to take Hidden or System files you may do so by
  1455. specifying the -w option, combined with the appropriate
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465. ════════════════════════════════════════════════════════════════════════════
  1466. 42                              PKZIP                                PKZIP 2
  1467.  
  1468. attribute.  These attributes will normally be stored as part of the .ZIP file
  1469. information unless specified with the -J option.
  1470.  
  1471.    pkzip all.zip -whs a:\*.*
  1472.  
  1473. This example would zip all files in the root of the A: floppy drive,
  1474. including any hidden or system files.
  1475.  
  1476.    pkzip att_test -whs -Jhs c:\*.*
  1477.  
  1478. This would take all files as above, and would also discard the file
  1479. attributes. This option may be made the default. See PKZIP Configuration.
  1480.  
  1481.                             See Also: -j, PKUNZIP -j
  1482.  
  1483. _____________________________________
  1484. -x<filename>        Exclude files
  1485. -x@listfile.lst     Exclude a list of files
  1486.  
  1487. Using -x allows you to specify files that you do NOT want used as part of a
  1488. PKZIP operation.  Either a specific filename or a file pattern may be
  1489. specified.  You may use -x multiple times on the same command line, and you
  1490. may exclude a list of files.  The list file is structured and treated
  1491. identically to all other List Files.
  1492.  
  1493.    pkzip testfile.zip *.txt -xpizza.txt
  1494.  
  1495. This example would compress all the files with a "txt" extension that are in
  1496. the current directory, but would NOT compress the file "pizza.txt"
  1497.  
  1498.    pkzip test2.zip *.* -x*.txt
  1499.  
  1500. Here we take all of the files EXCEPT the files with a "txt" extension.
  1501.  
  1502.    pkzip test3.zip *.* -xcommand.com -xautoexec.* -xconfig.*
  1503.  
  1504. In this last example all files are specified for extraction, one specific file
  1505. is being excluded, and any files which match two file patterns are excluded.
  1506.  
  1507.                            See Also: -@ page 46, "Using
  1508.                             List Files" page 63
  1509.  
  1510. _____________________________________
  1511. -z Create or modify a .ZIP file comment
  1512.  
  1513. Each .ZIP file may have a comment embedded into it.  This comment will be
  1514. displayed when the file is extracted, viewed or modified.  A comment may be
  1515. added to an existing file, or added when a .ZIP file is first created.  PKZIP
  1516. will prompt you for the .ZIP file comment, and allow you to enter up to 127
  1517. characters.
  1518.  
  1519.  
  1520.  
  1521. ════════════════════════════════════════════════════════════════════════════
  1522. PKWARE Inc.                        PKZIP                                  43
  1523.  
  1524.  
  1525. It is possible to embed larger comments (up to 4096 characters) by
  1526. using the following procedure:
  1527.  
  1528. 1) Create the .ZIP file.
  1529.  
  1530. 2) Create the comment file (comment.txt).
  1531.  
  1532. This can be done with any editor that is able to output a standard DOS text
  1533. file.  It must be plain ASCII or ANSI text (if it is ANSI text you must also
  1534. use the -q option).  Although the filename comment.txt is used here, any
  1535. filename may be used.
  1536.  
  1537. 3) Issue the command:
  1538.  
  1539.    pkzip zipfile.zip -z < comment.txt
  1540.  
  1541. This makes use of the MS-DOS redirection ability, redirecting the contents of
  1542. the file COMMENT.TXT as the input for the comment of ZIPFILE.ZIP.
  1543.  
  1544. 3a) To add a comment to multiple .ZIP files (within the current directory)
  1545. Issue the command:
  1546.  
  1547.    for %f in (*.ZIP) do pkzip %f -z < comment.txt
  1548.  
  1549. Note that the text of a comment is not compressed.  If you have a large
  1550. message you wish to attach to the .ZIP file it is better to have a short
  1551. summary and put any longer message in the .ZIP file itself. Technically, a
  1552. .ZIP file comment may be as large as 64k, but PKUNZIP will not display a .ZIP
  1553. file comment this large.
  1554.  
  1555. _____________________________________
  1556. -!    Encrypt authenticity verifiable data into the .ZIP file
  1557.  
  1558. Using this command option will cause PKZIP to embed Authenticity Verification
  1559. (AV) information within the .ZIP file it is creating.
  1560.  
  1561. This option may only be used if you have received and installed the AV
  1562. information for your fully registered copy of PKZIP from PKWARE Inc.
  1563.  
  1564. Note that AV codes for PKZIP 2.0 and above are different than those used for
  1565. version 1.10.
  1566.  
  1567. Please see the section on Authenticity Verification for complete information.
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577. ════════════════════════════════════════════════════════════════════════════
  1578. 44                              PKZIP                                PKZIP 2
  1579.  
  1580. _____________________________________
  1581. @[filename]  Specify LIST file
  1582.  
  1583. This option specifies a plain ASCII text file to be used as the list
  1584. of files to be archived.  PKZIP will read in this file listing and generate
  1585. the complete list of files that must be processed.  A list file may contain
  1586. wild card specifications (?,*) as well as exact file names:
  1587.  
  1588. files.bbs                           *.txt
  1589. *.*                                 text\news.asc
  1590. d:\text\*.ans                       c:/dos/edit.com
  1591.  
  1592. All of the above would be valid entries in a list file.  Notice that both
  1593. forward and backward slashes may be used and mixed.
  1594.  
  1595. The size of a list file that may be processed is limited.  The total size of
  1596. the list file depends upon two factors.
  1597.  
  1598. The first is path storage.  If paths are specified in the list file and are
  1599. NOT stored with the -P option, the list file size is limited to approximately
  1600. 7000 bytes.
  1601.  
  1602. If paths are specified and are stored, the list file size is limited to 9700
  1603. bytes.
  1604.  
  1605. If a list file has drive letters specified as part of the file names within
  1606. the file, the maximum list file size is reduced.  When paths are not stored
  1607. the maximum size is 5100 bytes, when they are stored 6600 bytes.
  1608.  
  1609.       ╔════════════════════════════╤══════════════════╤═══════════════════╗
  1610.       ║ List File Size Limits      │  No Path Storage │ Path Storage (-P) ║
  1611.       ╟────────────────────────────┼──────────────────┼───────────────────╢
  1612.       ║ Drive Letters in List File │    5100 bytes*   │       6600        ║
  1613.       ╟────────────────────────────┼──────────────────┼───────────────────╢
  1614.       ║ No Drive Letter            │       7000       │       9700        ║
  1615.       ╚════════════════════════════╧══════════════════╧═══════════════════╝
  1616.       *These numbers are approximate and may vary depending on your
  1617.        configuration.
  1618.  
  1619. If the list file is too big, you will receive an "Insufficient Memory" error.
  1620. If you have a list file which is too big, you may split it into two or more
  1621. smaller list files and perform multiple PKZIP operations.
  1622.  
  1623.                          See Also: "Using List Files", -@
  1624.  
  1625. _____________________________________
  1626. -& Create multi-volume archive
  1627.  
  1628. When this option is specified PKZIP will create a .ZIP file which is larger
  1629. than a single floppy disk.  This option may only be specified when creating a
  1630. .ZIP file on removable media (i.e. a floppy disk or high capacity cartridge
  1631. drive).
  1632.  
  1633. ════════════════════════════════════════════════════════════════════════════
  1634. PKWARE Inc.                        PKZIP                                  45
  1635.  
  1636. If PKZIP encounters an unformatted floppy disk it will format it before it
  1637. continues. This means that you will not need to anticipate the exact number
  1638. of floppies that will be needed ahead of time. For complete information on
  1639. the use of this and related options, please see the PKZIP Backup Guide.
  1640.  
  1641. _____________________________________
  1642. -$[d]   Store Volume label as part of .ZIP archive
  1643.  
  1644. When this option is specified PKZIP will store the Volume Label of the
  1645. specified device as part of the information within the .ZIP file it is
  1646. creating or modifying.  The letter of the drive containing the desired label
  1647. should be specified in place of the [d] on the option statement.  Do not
  1648. include a colon.
  1649.  
  1650.    PKZIP doug.zip -rp -$b b:*.*
  1651.  
  1652. In this example a .ZIP file called "doug" is created in the current
  1653. directory. It consists of the complete contents of the B: drive including
  1654. it's subdirectories and Volume Label.
  1655.  
  1656. Volume Label────────────────────────────────────────────────────────────────
  1657. Every drive that can be accessed on your computer is referred to as a VOLUME.
  1658. This includes not only your hard disk but also floppy disks, and may include
  1659. other storage devices such as CD ROM drives or large capacity removable
  1660. drives such as those manufactured by SyQuest or Iomega.  Each of these drives
  1661. may have a VOLUME LABEL.  This is a text string which identifies it.  This is
  1662. particularly useful on removable media, such as floppy disks.  Each floppy
  1663. may have a label which is meaningful to you, or to a piece of software.  For
  1664. further information on VOLUME LABELS please refer to your DOS manual.
  1665. ────────────────────────────────────────────────────────────────────────────
  1666.  
  1667. _____________________________________
  1668. -@filename.lst    Generate LIST file
  1669.  
  1670. **  Please note that this option is different from using a list file.  When
  1671.     PKZIP is reading a list file there is no dash in front of the @.
  1672.  
  1673. This option causes PKZIP to generate a LIST file out the specified file name
  1674. instead of performing a ZIP operation.  The output file will be a plain ASCII
  1675. file with one file name per line, and will be identical to the listing of the
  1676. files PKZIP would have placed into a .ZIP file had the -@ option not been
  1677. used.
  1678.  
  1679. If the -rp is specified the list file will include paths in addition to the
  1680. file names.  If the pattern/filespec is on a different drive, the drive
  1681. letter will be included as well.
  1682.  
  1683.    pkzip dummy.zip -@test.lst *.*
  1684.  
  1685. This would generate a list file called "test.lst".  Note that the dummy
  1686. zipfile name is needed.  The name of the .ZIP file specified does not matter
  1687. as it is not actually used.
  1688.  
  1689. ════════════════════════════════════════════════════════════════════════════
  1690. 46                               PKZIP                               PKZIP 2
  1691.  
  1692.  
  1693.    pkzip dummy.zip -@test2.lst -rp d:\*.*
  1694.  
  1695. This would create a list file of the ENTIRE contents of the D drive.  If the
  1696. current directory is not D:\ when this command is issued the drive will be
  1697. included with each filename in the list file.
  1698.  
  1699. This option can also be useful in conjunction with an existing .ZIP file.
  1700. For example, to generate a list of all files which have been modified since
  1701. they were placed in the .ZIP file "akiko.zip":
  1702.  
  1703.    pkzip akiko.zip -f -@modified.lst *.*
  1704.  
  1705.                            See Also:  "Using List Files"
  1706.  
  1707. _____________________________________
  1708. -=     Open file in compatibility mode
  1709.  
  1710. This option will cause PKZIP to open files in "compatibility" mode, as
  1711. opposed to "sharing" mode.
  1712.  
  1713. Using this option will cause PKZIP to ignore most file locking, including
  1714. share.
  1715.  
  1716. In some networking situations this will allow you to read a file which would
  1717. otherwise not be accessible due to file locking.
  1718.  
  1719.                                        PKTMP
  1720. ════════════════════════════════════════════════════════════════════════════
  1721.  
  1722. During compression, PKZIP uses a temporary file.  As each file is added to
  1723. the .ZIP file it is first compressed into this temporary file and then
  1724. appended to the .ZIP file.
  1725.  
  1726. By default this temporary file is created in the current directory.
  1727.  
  1728. You may have this temporary file created in a different directory by setting
  1729. the environment variable PKTMP.  Set this equal to the drive you wish to use
  1730. as your temporary file location.
  1731.  
  1732. For optimal performance on your local harddrive, the PKTMP could be set equal
  1733. to a RAM drive if a large enough one is available.  The temporary file
  1734. location must have enough free space to hold the largest file in it's
  1735. compressed state.
  1736.  
  1737. For optimal performance when creating a .ZIP file on a Novell Netware volume,
  1738. set the PKTMP equal to any drive on the same server.  This will achieve the
  1739. best performance, and is superior to using the local hard drive or the RAM
  1740. drive.
  1741.  
  1742.    C:\>set pktmp=z:\
  1743.  
  1744.  
  1745. ════════════════════════════════════════════════════════════════════════════
  1746. PKWARE Inc.                        PKZIP                                  47
  1747.  
  1748. PKUNZIP
  1749. ════════════════════════════════════════════════════════════════════════════
  1750. Command Reference
  1751.  
  1752. Description of command options
  1753.  
  1754. Items contained in brackets are optional and need not be included.  Where
  1755. there is more than one item separated by commas you may use any ONE of those
  1756. options following the main option character.  Where there are options in
  1757. brackets you must include that option, or choose one of those in the series.
  1758. When choosing options from a bracketed series, you may use more than one of
  1759. these options if they are separated by commas.  If the options are separated
  1760. by a vertical bar (|) then you may only choose one.
  1761.  
  1762. Command option Guide
  1763.  
  1764. _____________________________________
  1765. -c      Extract files to the console
  1766. -cm     Extract files to the console with more (pause between screens)
  1767.  
  1768. This command will extract files from a .ZIP file and display them on the
  1769. monitor. The extracted files will scroll continuously on the screen.  The
  1770. software can be told to pause after each screen of output by using the -cm
  1771. option.
  1772.  
  1773.    pkunzip pkz200.exe -cm pkzip.doc
  1774.  
  1775. This example lists the text file pkzip.doc to the screen from the self-
  1776. extracting .ZIP file "pkz200.exe".  The display will pause and wait for a key
  1777. press between each screen of text.
  1778.  
  1779. _____________________________________
  1780. -d   Restore directory structure
  1781.  
  1782. This command option uses the path names that have been stored in the .ZIP
  1783. file by PKZIP.  If the stored paths do not exist at the extraction
  1784. destination, they will be created.
  1785.  
  1786. For example: If the following directory tree exists on drive C:
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801. ════════════════════════════════════════════════════════════════════════════
  1802. 48                               PKUNZIP                             PKZIP 2
  1803.  
  1804.  
  1805.        C:\─┬─ABC─┬─DIR1
  1806.        │     └─DIR2─┬─DIR3
  1807.        │            └─DIR4
  1808.        ├─XYZ
  1809.        └─PDQ
  1810.  
  1811. If you executed:
  1812.  
  1813.    pkzip -rp a:stuff c:\abc\*.*
  1814.  
  1815. A .ZIP file called STUFF would be created containing all the files in the
  1816. directory "abc", as well as any subdirectories below that directory.
  1817.  
  1818. If you then executed:
  1819.  
  1820.    pkunzip -d a:stuff c:\xyz\newabc
  1821.  
  1822. The directory structure of drive C: would now look like this:
  1823.  
  1824.       C:\─┬─ABC─┬─DIR1
  1825.       │     └─DIR2─┬─DIR3
  1826.       │            └─DIR4
  1827.       ├─XYZ───NEWABC─┬─DIR1
  1828.       └─PDQ          └─DIR2─┬─DIR3
  1829.                 └─DIR4
  1830.  
  1831. All of the files and subdirectories which were originally in the "abc"
  1832. directory are now located in the "newabc" directory (shown in the box).  Note
  1833. that the "newabc" directory was created by PKUNZIP because it was specified
  1834. on the command line.
  1835.  
  1836.                  See Also: Tutorial - "Storing and Rebuilding
  1837.                             Directory Structures"
  1838.  
  1839. _____________________________________
  1840. -e[r][c,d,e,n,p,s]  Extract files in a sorted order
  1841.  
  1842. This option is used to specify a particular order in which to extract files
  1843. from a .ZIP file.  These options are used along with the -e.  Each option
  1844. will cause extraction sorted in ascending order of the particular criteria.
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857. ════════════════════════════════════════════════════════════════════════════
  1858. PKWARE Inc.                       PKUNZIP                                 49
  1859.  
  1860.  
  1861. Sort Options
  1862.  
  1863. r     Reverse sort order
  1864.  
  1865. c     CRC Value
  1866.  
  1867. d     Date
  1868.  
  1869. e     File Extension
  1870.  
  1871. n     File Name
  1872.  
  1873. p     Percentage (ratio) of compression
  1874.  
  1875. s     File Size
  1876.  
  1877. The most useful of these options will normally be extraction in order of
  1878. Date, Name, or Extension.  Extraction in value of CRC order is in effect
  1879. a random extraction.
  1880.  
  1881. In this example the files contained within the .ZIP file ZUCKER would be
  1882. extracted in the order of their names.
  1883.  
  1884.    pkunzip -en zucker.zip
  1885.  
  1886. To reverse the order of extraction combine with the [r].
  1887.  
  1888.    pkunzip -ern zucker.zip
  1889.  
  1890. _____________________________________
  1891. -f    Freshen files in extract directory
  1892.  
  1893. This function is the inverse of the freshen function in PKZIP.  When this
  1894. option is used, the PKUNZIP command will be executed normally except that
  1895. files will be extracted only if:
  1896.  
  1897. -> The files already exist in the target directory or directories
  1898.  
  1899. AND
  1900.  
  1901. -> The files in the .ZIP file are newer than the files in the
  1902.    extract directory.
  1903.  
  1904. _____________________________________
  1905. -h Display command summary (Help)
  1906.  
  1907. This option will display a brief summary of the command switches available.
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913. ════════════════════════════════════════════════════════════════════════════
  1914. 50                               PKUNZIP                             PKZIP 2
  1915.  
  1916. _____________________________________
  1917. -j<h,r,s>     Specifies masking of file attributes (default)
  1918. -J<h,r,s>     Specifies extraction of file attributes
  1919.  
  1920. During normal use, PKUNZIP does not extract files as being hidden, system or
  1921. read-only.  If there are files stored within a .ZIP file that have any of
  1922. these attributes, you must specify the -J (upper case) option to keep the
  1923. attributes.
  1924.  
  1925.    pkunzip stuff.zip -Jhsr
  1926.  
  1927. In this example all the attributes would be preserved.  For an explanation of
  1928. what file attributes are see your DOS manual.
  1929.                          See Also: PKZIP -w, PKZIP -j
  1930.  
  1931. _____________________________________
  1932. -l    Display license information
  1933.  
  1934. This command will display the software license agreement.
  1935.  
  1936. _____________________________________
  1937. -n    Extract only newer files
  1938.  
  1939. This option is the compliment of the -u option in PKZIP.
  1940. When this option is used files will only be extracted if:
  1941.  
  1942. -> They do not exist already in the target directory
  1943.  
  1944. OR
  1945.  
  1946. -> They are newer than the file already in the target directory
  1947.  
  1948. This means that files which already exist and are more recent than those in
  1949. the .ZIP file will not be overwritten.
  1950.  
  1951. _____________________________________
  1952. -o     Overwrite previously existing files
  1953. -o-    Never overwrite files
  1954.  
  1955. This option will cause PKUNZIP to overwrite any files that already exist in
  1956. the target directory, without prompting.  When this option is not specified
  1957. PKUNZIP will pause if it attempts to extract a file that already exists.  It
  1958. will prompt you:
  1959.  
  1960.    PKUNZIP: Warning! File XXXXXX already exists.  Overwrite (y/n/a/r)?
  1961.  
  1962. If you forget to specify the -o when you give the PKUNZIP command, you may
  1963. respond to the above question with "a" (All).  PKUNZIP will continue as
  1964. though a -o had been specified originally.
  1965.  
  1966. The -o- option will cause PKUNZIP to skip any file which already exists,
  1967. regardless of file sizes or dates.
  1968.  
  1969. ════════════════════════════════════════════════════════════════════════════
  1970. PKWARE Inc.                       PKUNZIP                                 51
  1971.  
  1972. _____________________________________
  1973. -p[a/b] [c] [#] Extract files to the printer
  1974.  
  1975. This option is used to extract files from a .ZIP
  1976. file and send them to a printer (serial or parallel) for printing.  The
  1977. command parameters are defined and several examples are given here to make
  1978. this complex command clear.
  1979.  
  1980. -pa     Extract to the printer device in ASCII mode
  1981.  
  1982. -pb     Extract to the printer device in BINARY mode
  1983.  
  1984. ASCII mode is commonly used to print text.  It will form feed after each
  1985. file when multiple files are being extracted.
  1986.  
  1987. Binary mode does not send any extra characters, extracting purely the
  1988. contents of the file to the specified device.  This is commonly used to send
  1989. fonts or graphics to a laser printer.  It will not form feed between files.
  1990.  
  1991. The a and b options cannot be mixed in the same command line.
  1992.  
  1993. In combination with the -pa or -pb option you may specify the port to which
  1994. PKUNZIP should extract.  If only a number between 1 and 4 is specified, the
  1995. extraction will go to that number of printer port (LPT1 through LPT4).  If a
  1996. "c" is specified PKUNZIP will extract to the COM port.  The "c" option may
  1997. also be combined with a number from 1 to 4, specifying COM1 through COM4.
  1998.  
  1999. This example will extract the specified files to the parallel port LPT1.
  2000.  
  2001.    pkunzip sesame.zip *.doc -p
  2002.  
  2003. This example is extracting files in binary mode to a printer on the second
  2004. serial port.
  2005.  
  2006.    pkunzip graphix.zip *.eps -pbc2
  2007.  
  2008. Here the files are extracted to a printer on the second parallel port in
  2009. ASCII mode.
  2010.  
  2011.    pkunzip docs.zip -pa2
  2012. _____________________________________
  2013. -q    Enable ANSI comments
  2014. -q-   Ignore ANSI control codes (default)
  2015.  
  2016. By default, ANSI control codes embedded in comments are not displayed by
  2017. PKUNZIP.  When the -q option is used these ANSI sequences will be output and
  2018. interpreted by the ANSI device driver if one is present.
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025. ════════════════════════════════════════════════════════════════════════════
  2026. 52                              PKUNZIP                              PKZIP 2
  2027.  
  2028. This option can be forced on by default in the configuration file.  The
  2029. configuration option to add is:
  2030.  
  2031.    ANSI=enabled
  2032.  
  2033. The enabling of ANSI control codes in the configuration file may be
  2034. overridden at the command line by using -q-.
  2035.  
  2036. ANSI control codes provide the feature of adding color to text on a system
  2037. which has ANSI.SYS loaded in the CONFIG.SYS.
  2038.  
  2039. **  However, ANSI control codes also perform many other features, some of
  2040.     which can be potentially hazardous if you do not know the source and
  2041.     contents of the comment.  It is for this reason that PKZIP and PKUNZIP
  2042.     filter out ANSI control codes unless you explicitly tell them not to.
  2043.  
  2044. PKWARE has created an addition to the ANSI.SYS driver called PKSFANSI
  2045. (PK Safe ANSI).  By using this in conjunction with your normal ANSI.SYS you
  2046. can be sure of receiving only the ANSI characters that you want.  PKSFANSI
  2047. is provided by PKWARE free of charge.  It is included on the PKZIP
  2048. distribution disk.
  2049.  
  2050.                                See Also: PKZIP -q
  2051.  
  2052. _____________________________________
  2053. -s[password]       Decrypt files
  2054.  
  2055. This option is used to unscramble (decrypt) the files in a .ZIP file.  PKZIP
  2056. has a -s option which is used to encrypt the files.  If a password is not
  2057. specified the user will be prompted for it. When extracting a .ZIP file that
  2058. has been encrypted, the files will not be extracted unless the correct key
  2059. (password) is included on the command line or entered at the prompt.
  2060.  
  2061. **  Notice there is no space between the -s and the encryption key.
  2062.  
  2063.    pkunzip payroll.zip -o -sSecret *.dbf
  2064.  
  2065. In the above example, all files with a "dbf" extension will be extracted and
  2066. the key "Secret" applied to them.  This will only work if the files have been
  2067. compressed with the key of "Secret" applied to them.
  2068.  
  2069. **  This option is case sensitive.  This means that "Secret", "secret" and
  2070. "SECRET" are all different passwords.
  2071.  
  2072.                            See Also: "Using Data
  2073.                            Encryption", PKZIP -s
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081. ════════════════════════════════════════════════════════════════════════════
  2082. PKWARE Inc.                       PKUNZIP                                 53
  2083.  
  2084. _____________________________________
  2085. -t   Test .ZIP file integrity
  2086.  
  2087. This option is used to test files within a .ZIP file in order to verify that
  2088. they are valid and have not been corrupted.  PKUNZIP will perform all the
  2089. actions that would normally be taken during a .ZIP file extraction, except
  2090. that files will not be written to disk.
  2091.  
  2092. The data will be extracted and checked against the CRC to ensure it's val-
  2093. idity. After each file is checked it's name will be displayed with an "OK".
  2094.  
  2095.    C:\PKSTUFF>pkunzip zc102 -t
  2096.  
  2097.    Searching ZIP: ZC102.ZIP - PKWARE Support BBS (414)354-8670
  2098.    Testing: ZC.DOC        OK
  2099.    Testing: ZC.EXE        OK
  2100.    Testing: ORDER.FRM     OK
  2101.    Testing: VER-HIST.TXT  OK
  2102.  
  2103. In this example a command is issued which performs a test on the .ZIP file
  2104. "zc102". As each file is tested its name is displayed.  Note that the .ZIP
  2105. file comment is displayed.
  2106.  
  2107. If you test a file that is not a .ZIP file, or specify particular files
  2108. within the .ZIP file that do not exist, you will receive the message:
  2109.  
  2110.    PKUNZIP: (E11) No file(s) found.
  2111.  
  2112. Testing a .ZIP file with errors would produce a display something like this:
  2113.  
  2114.    Searching ZIP: PROBLEM.ZIP
  2115.    Testing: WORLD.M~      PKUNZIP: (W15) Warning! file fails CRC check
  2116.    Testing: CORELDRW.BPT  OK
  2117.  
  2118.    PROBLEM.ZIP has errors!
  2119.  
  2120. Normally, a CRC failure as above indicates that a file has been damaged
  2121. either in storage or transmission.  For instructions on attempting to repair
  2122. a .ZIP file that has been corrupted, see PKZIPFIX in the Trouble Shooting
  2123. section.
  2124.  
  2125.                        See Also: "Trouble Shooting", "F.A.Q."
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137. ════════════════════════════════════════════════════════════════════════════
  2138. 54                              PKUNZIP                              PKZIP 2
  2139.  
  2140.  
  2141. _____________________________________
  2142. -v[b][r,c|d|e|n|p|s][m]         View [brief] file information
  2143. -vt[m]                          View Technical file information
  2144.  
  2145. The -v option for PKUNZIP is the same as the -v option for PKZIP, with one
  2146. exception.  In PKUNZIP the `c' option for sorting refers to the CRC value.
  2147. For PKUNZIP this option refers to the Comment of a file.
  2148.  
  2149. For complete information, please see the -v option in the PKZIP Command
  2150. Reference.
  2151.  
  2152.                             See Also: PKZIP -v
  2153.  
  2154. _____________________________________
  2155. -x<filespec>    Exclude files from extraction
  2156. -x@list.lst     Exclude list of files from extraction
  2157.  
  2158. By specifying a -x as part of the PKUNZIP command, you may prevent a file or
  2159. group of files from being extracted.  Using -x with a list file will allow
  2160. you to exclude a list of files from extraction.
  2161.  
  2162.    pkunzip fd201.zip -x*.doc
  2163.  
  2164. In this example all files are extracted from the .ZIP file "fd201.zip" except
  2165. for those with a ".doc" extension.
  2166.  
  2167. -x may be used more than once on the command line, and may be used in
  2168. combination with specific filespecs and list files.
  2169.  
  2170.                              See Also: PKZIP -x
  2171.  
  2172. _____________________________________
  2173. -$   Restore volume label
  2174.  
  2175. This command is used to restore any volume label that has been stored in the
  2176. .ZIP file.  It is important to remember that the PKZIP command used to store
  2177. a volume label does not store a drive letter along with the label.  Upon
  2178. extraction, the volume label will be assigned to the target drive.
  2179.  
  2180.    C:\>pkunzip davebk.zip -$ a:
  2181.  
  2182. This example will extract the contents of "davebk.zip" to the A: drive.  If a
  2183. volume label was stored as part of the .ZIP file, the volume label for the
  2184. floppy in drive A: will be reset to the one contained in davebk.zip.
  2185.  
  2186.                              See Also: PKZIP -$
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193. ════════════════════════════════════════════════════════════════════════════
  2194. PKWARE Inc.                       PKUNZIP                                 55
  2195.  
  2196. _____________________________________
  2197. -@filename.lst     Generate LIST file
  2198.  
  2199. Please note that this option is different from using a list file.  When a
  2200. list file is to be read by PKZIP there is no dash in front of the @.
  2201.  
  2202. Using this option will cause a list file to be generated using the specified
  2203. file name instead of a normal PKUNZIP operation being performed.  The output
  2204. file will be a plain ASCII file with one file name per line, and will be
  2205. identical to the listing of files PKUNZIP would have extracted had the -@
  2206. option not been used.
  2207.  
  2208.    pkunzip underdem.zip -@showme.lst
  2209.  
  2210. This would create a list file called "showme.lst" containing a list of all
  2211. the files present within the .ZIP file.  File specs may be used in
  2212. conjunction with this type of command, in the same manner as a normal
  2213. extraction command.  Also the -e option may be used for sorting.  The
  2214. following example creates an alphabetized list file of only the ".doc" files
  2215. within it:
  2216.  
  2217.    pkunzip manuals.zip -en *.doc -@docs.lst
  2218.  
  2219. The extension of ".lst" on a list file is not mandatory, but recommended for
  2220. clarity.
  2221.  
  2222.                            See Also: "Using List Files",
  2223.                                  PKZIP @, -@
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249. ════════════════════════════════════════════════════════════════════════════
  2250. 56                               PKUNZIP                             PKZIP 2
  2251.  
  2252. PKSFX/ZIP2EXE
  2253. ════════════════════════════════════════════════════════════════════════════
  2254.  
  2255. The PKZIP utilities offer a self-extraction capability.  This means that you
  2256. can make a .ZIP file into an .EXE file.  This file will in effect be able to
  2257. extract itself. A  PKSFX (PK-Self Extracting) file consists of a .ZIP file
  2258. which has been transformed into a self-extracting file by the utility
  2259. ZIP2EXE. There is no utility or file called "SFX" or "PKSFX", but the
  2260. self-extracting file will show PKSFX on the banner in the same manner as
  2261. PKUNZIP:
  2262.  
  2263.    PKSFX (R)  FAST!  Self Extract Utility  Version 2
  2264.    Copr. 1989-1992 PKWARE Inc. All Rights Reserved. PKSFX/h for help
  2265.    PKSFX Reg. U.S. Pat. and Tm. Off.
  2266.  
  2267. Creating a Self-Extracting File
  2268.  
  2269. In order to create a self-extracting file, you must first create a .ZIP file.
  2270. Once this .ZIP file is created, use the ZIP2EXE utility to transform this
  2271. .ZIP file into an .EXE file.
  2272.  
  2273.    D:\>zip2exe test.zip
  2274.  
  2275.    ZIP2EXE (tm)     Self-Extract Creator     Version 2
  2276.    Copr. 1989-1992 PKWARE Inc. All Rights Reserved. ZIP2EXE/h for help
  2277.  
  2278.    TEST.ZIP => TEST.EXE
  2279.  
  2280.    D:\>
  2281.  
  2282. As you can see, an .EXE file by the same name as the .ZIP file is created.
  2283. The original .ZIP file is not deleted.
  2284.  
  2285. Meet Junior
  2286.  
  2287. **  Turning a .ZIP file into an .EXE file increases the size because of the
  2288.     included extraction program.  The added size is approximately 13.5K
  2289.     bytes. If space is at a premium, and you are willing to sacrifice
  2290.     functionality for size, try PKSFX Junior(TM).
  2291.  
  2292. The PKSFX Junior is somewhat smaller, and offers very few command line
  2293. options due to this reduced size.  The options which are available with
  2294. the PKSFX Junior are indicated on the PKSFX command summary.
  2295.  
  2296. To create a PKSFX Junior file, add the command line option -j when performing
  2297. the ZIP2EXE step.
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305. ════════════════════════════════════════════════════════════════════════════
  2306. PKWARE Inc.                  PKSFX/ZIP2EXE                                57
  2307.  
  2308.  
  2309.    D:\>zip2exe -j test.zip
  2310.  
  2311. **  PKSFX Junior adds approximately 3K bytes to the .ZIP file.
  2312.  
  2313. PKSFX Junior can handle a maximum of 512 files.  Although PKSFX Junior has
  2314. this limit to the number of files it can handle, there is no limit to the
  2315. file size.
  2316.  
  2317. PKUNZIP Junior
  2318. ════════════════════════════════════════════════════════════════════════════
  2319. PKUNZJR.COM
  2320.  
  2321. The PKUNZIP Junior program is an extremely small stand-alone extraction
  2322. program.  It is used in the same manner as PKUNZIP but it has only the
  2323. functionality of the PKSFX Junior self-extractor.
  2324.  
  2325.     PKUNZIP(R)  FAST!  Mini Extract Utility  Version 2
  2326.     Copr. 1989-1992 PKWARE Inc. All Rights Reserved.
  2327.     PKUNZIP Reg. U.S. Pat. and Tm. Off.
  2328.  
  2329. Usage:  pkunzjr [-o] filename[.zip] [output_path]
  2330.  
  2331. PKUNZIP Junior has one option, -o.  This option is the same as that for
  2332. PKUNZIP (Senior).
  2333.  
  2334. PKUNZIP Junior accepts the .ZIP file name on the command line, and may
  2335. optionally accept an output path.  PKUNZIP Junior cannot extract specific
  2336. files, but must extract the entire .ZIP file.
  2337.  
  2338. PKUNZIP Junior cannot extract a file containing more that 512 files, and does
  2339. not support multiple volume .ZIP files.
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361. ════════════════════════════════════════════════════════════════════════════
  2362. 58                           Introduction                            PKZIP 2
  2363.  
  2364. PKSFX Command Summary
  2365.  
  2366. Command line syntax and options are the same as PKUNZIP.  The options listed
  2367. below are offered by a self-extracting file.
  2368.  
  2369. Syntax:        pksfx [option] [d:\path] [file]* [file]*
  2370.  
  2371. PKSFX indicates the name of the self-extracting file you are executing.  No
  2372. options are necessary if you wish to simply extract all files to the current
  2373. directory.  If you wish to extract the contents to another directory,
  2374. indicate the drive and/or path the files should extract to.  To extract only
  2375. particular files, indicate the name(s) at the end of the command line.
  2376.  
  2377. Options:
  2378.  
  2379. @listfile.lst            Specify list of files for extraction*
  2380.  
  2381. -c[m]                    Extract to console*
  2382.  
  2383. -d                       Re-create directories stored in .ZIP file*
  2384.  
  2385. -l                       Display software license agreement*
  2386.  
  2387. -n                       Extract only newer files*
  2388.  
  2389. -o                       Overwrite existing files
  2390.  
  2391. -p[a|b][c][#]            Extract to printer*
  2392.  
  2393. -s<password>             Decrypt with password*
  2394.  
  2395. -t                       Test file integrity*
  2396.  
  2397. *Indicates options not available in the PKSFX Junior and PKUNZIP Junior
  2398.  programs.
  2399.  
  2400. Options should be placed after the self-extracting files name.  If multiple
  2401. options are used they must be separated by a space and each must have its own
  2402. option indicator (either - or /).
  2403.  
  2404. All options behave in the same manner as they do with PKUNZIP, with one
  2405. exception.  The -s option cannot accept keyboard entry.  A password entered
  2406. with a self-extracting file must be able to be entered from the command line.
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417. ════════════════════════════════════════════════════════════════════════════
  2418. PKWARE Inc.                  PKSFX/ZIP2EXE                                59
  2419.  
  2420.  
  2421. Modifying a Self-Extracting File
  2422.  
  2423. A self-extracting file can be operated upon by PKZIP and PKUNZIP in a manner
  2424. identical to normal .ZIP files.  You will need to specify the full file name
  2425. including the EXE extension.
  2426.  
  2427.    C:\>pkzip test.exe -f d:\*.*
  2428.  
  2429. There is no difference between operating on a self-extracting file and a
  2430. normal .ZIP file.
  2431.  
  2432. A Note About Self-Extracting Files
  2433.  
  2434. When you create a self-extracting file, you are adding a copy of the
  2435. extraction code to that file.  Since this code duplicates the functionality
  2436. of the PKUNZIP program, it makes sense to use the self-extractor only when
  2437. PKUNZIP will not be present on the machine to extract the file.
  2438.  
  2439. If you create many self-extracting files for your own use, you will be using
  2440. more space unnecessarily.  Therefore it is recommended that you only use the
  2441. self-extracting capability when you are sending a file to someone that you
  2442. know does not have a compatible PKUNZIP.
  2443.  
  2444. Stripping the PKSFX Code
  2445.  
  2446. You may have occasion to want to keep the contents of a self-extracting file,
  2447. but wish to turn it back to a normal .ZIP file.
  2448.  
  2449. The ZIP2EXE offers an option to reverse the process.  This is done with the
  2450. command line switch -e:
  2451.  
  2452.    F:\>zip2exe -e test.exe
  2453.  
  2454. ZIP2EXE will recognize normal and PKSFX Junior files automatically.
  2455.  
  2456. Sending a Self-Extractor
  2457.  
  2458. If you are sending a PKSFX file to somone who is not familiar with data
  2459. compression and/or PKWARE products, we recommend you tell them to do the
  2460. following:
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473. ════════════════════════════════════════════════════════════════════════════
  2474. 60                           Introduction                            PKZIP 2
  2475.  
  2476. With PKSFX Junior:
  2477.  
  2478. 1) Create a temporary directory on the hard drive to hold the
  2479.    files contained in the self-extracting file.
  2480.  
  2481.    C:\>md temp
  2482.  
  2483. 2) Change to the directory that was just created.
  2484.  
  2485.    C:\>cd temp
  2486.    C:\temp>
  2487.  
  2488. 3) Place the diskette containing the self-extracting file into
  2489.    the A: or B: drive. 4) Type the name of the self-extractor,
  2490.    including the path to the floppy drive.
  2491.  
  2492.    C:\temp>a:test
  2493.  
  2494. With normal PKSFX:
  2495.  
  2496. 1) Place the diskette containing the self-extracting file into
  2497.    the A: or B: drive and change to that drive.
  2498.  
  2499.    C:\>a:
  2500.  
  2501. 2) Type in the following;
  2502.  
  2503.    A:\>test -d c:\temp
  2504.  
  2505. You may also wish to create a batch file or text file on the floppy disk
  2506. containing the above steps. The contents of the self-extractor will be placed
  2507. into this temporary directory. They can then examine or move the files at
  2508. their leisure.  The -d option ensures that any subdirectory information
  2509. included will be re-created, and causes PKSFX to create the temporary
  2510. directory for the user.
  2511.  
  2512. ────────────────────────────────────────────────────────────────────────────
  2513. A site license is required by a corporation, company, educational
  2514. institution, or governmental agency for use of PKWARE software on the total
  2515. number of computers that will use the software.
  2516.  
  2517. Use of PKWARE programs for personal use is covered by your purchase of a
  2518. single license for PKZIP.  A Distribution License is required by a
  2519. corporation, company, educational institution or governmental agency to use
  2520. PKWARE programs to facilitate the distribution of software to outside parties.
  2521.  
  2522. Please note that if a self-extracting file is used, a Distribution License is
  2523. required, because PKWARE code is distributed in the form of the PKSFX program
  2524. combined with the file(s) being distributed.
  2525.  
  2526. Please contact PKWARE for more information if you intend to distribute self-
  2527. extracting files.
  2528.  
  2529. ════════════════════════════════════════════════════════════════════════════
  2530. PKWARE Inc.                  PKSFX/ZIP2EXE                                61
  2531.  
  2532.  
  2533. Confirm before extract
  2534.  
  2535. If a PKSFX file has a .ZIP file comment attached, this comment is displayed
  2536. before the file is extracted.  By imbedding a Control-S character (Hex 13,
  2537. ASCII 19), you can cause PKSFX to pause. The display will look like this:
  2538.  
  2539.    Searching EXE: XXXXX.EXE -
  2540.    .
  2541.    .
  2542.    .
  2543.    (ZIP file comment text)
  2544.    .
  2545.    .
  2546.    .
  2547.    Do you want to extract these files now (y/n)?
  2548.  
  2549. Press 'Y' to extract the files, 'N' o abort.  Note that the Control-S
  2550. character is not displayed.  This control character may be located anywhere
  2551. within the comment.
  2552.  
  2553. If the user aborts by pressing 'N', an exit code of  12 will be returned by
  2554. PKSFX. PKSFX Junior will return an exit code of 8.
  2555.  
  2556.                               See: PKZIP -z for more
  2557.                             information on .ZIP file
  2558.                             comments, Appendix D for
  2559.                          more information on exit codes.
  2560.  
  2561. Memory Requirements
  2562.  
  2563. The memory requirements for PKSFX are similar to those of PKUNZIP.
  2564.  
  2565. PKSFX Junior, and PKUNZIP Junior require a minimum of 50K RAM free, and a
  2566. maximum of 64K RAM free.
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585. ════════════════════════════════════════════════════════════════════════════
  2586. 62                           Introduction                            PKZIP 2
  2587.  
  2588. USING LIST FILES
  2589. ════════════════════════════════════════════════════════════════════════════
  2590.  
  2591. PKZIP, PKUNZIP and PKSFX offer a powerful feature; list files.  List files are
  2592. simply listings of files.  They are used to simplify command lines, and make
  2593. repetitive tasks less troublesome.
  2594.  
  2595. List files can allow you to perform some complex tasks which otherwise would
  2596. not be possible. List files can not only be read, but can also be created by
  2597. PKZIP and PKUNZIP. Also, list files can be created and used by other programs,
  2598. such as StupenDOS", PKZOOM" and PKZMENU".
  2599.  
  2600. PKZIP and PKUNZIP use List Files in two ways: files to be included and files
  2601. to be excluded.  If a List File is being created, the contents will reflect a
  2602. listing of those files which would have been added, deleted, extracted or
  2603. listed during a normal PKZIP/PKUNZIP operation.
  2604.  
  2605. List File text may contain:
  2606.  
  2607. -> Comments
  2608.  
  2609. -> File Names
  2610.  
  2611. -> Wild Cards
  2612.  
  2613. -> Exact Path Names and Files
  2614.  
  2615. -> Drive Letters
  2616.  
  2617. List File text consists of plain ASCII.  These files may be created using any
  2618. text editor which can produce plain ASCII files, sometimes referred to as "DOS
  2619. Text".
  2620.  
  2621. All of the following lines would be valid in a List File:
  2622.  
  2623.    clowns.bmp
  2624.    *.exe
  2625.    project.*
  2626.    MSLR????.QWK
  2627.    ;This is a comment
  2628.    emp\census.txt  ;This is also a valid comment
  2629.    D:\data\february.wk1
  2630.    D:\games\majong\*.*
  2631.    D:\QWK\*.REP
  2632.  
  2633. A line in a list file is treated in an identical manner to files specified on
  2634. the command line.  Note that only files and comments are valid in a list file.
  2635. Both forward and backward slashes may be used in a list file.
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641. ════════════════════════════════════════════════════════════════════════════
  2642. PKWARE Inc.                  Using List Files                             63
  2643.  
  2644.  
  2645. Reading List Files
  2646.  
  2647. A list file can be used in two different ways with PKZIP and PKUNZIP:
  2648.  
  2649. -> Files to be acted upon in a ZIP operation.
  2650.  
  2651. -> Files to be excluded from a ZIP operation.
  2652.  
  2653. List files are usually specified with an @ (ASCII 64, normally above the 2 on
  2654. your keyboard).  The list file character can be changed by modifying the
  2655. configuration file.  Please note that the list file generation option (-@))
  2656. will also change to the selected list file character.  Avoid using a character
  2657. already used for another option.
  2658.  
  2659. The simplest example of using a List File is when a .ZIP file is going to be
  2660. created containing the files specfied. If a List File called "test.lst" was
  2661. created containing the following lines:
  2662.  
  2663.    *.COM
  2664.    300Z.TXT
  2665.  
  2666. And then used in a PKZIP command:
  2667.  
  2668.    C:\>pkzip sample.zip @test.lst
  2669.  
  2670. All .COM files in the current directory would be added to the .ZIP file
  2671. "SAMPLE.ZIP", as well as the file "300Z.TXT" if it existed.
  2672.  
  2673. The contents of a List File that is specified are included.  The contents of a
  2674. List File specified after a -x are excluded.  Multiple List Files to be
  2675. included and excluded may be specified on the command line in addition to file
  2676. names being listed alone on the command line.
  2677.  
  2678. Following are several example usages of List Files, each with a short
  2679. description of what action would be caused.
  2680.  
  2681.    C:\>pkzip first.zip @abc.lst -x@xyz.lst
  2682.  
  2683. All files specified in "abc.lst" would be added to the .ZIP file "first.zip".
  2684. Any files that match the file specification in "xyz.lst" would not be added.
  2685.  
  2686.    C:\>pkzip second.zip -d @abc.lst -x*.txt
  2687.  
  2688. All files listed in "abc.lst" would be deleted from the .ZIP file "first.zip".
  2689. Any files matching the "*.txt" specification would not be deleted.
  2690.  
  2691.    C:\>pkzip -vc third.zip @xyz.lst
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697. ════════════════════════════════════════════════════════════════════════════
  2698. 64                           Introduction                            PKZIP 2
  2699.  
  2700. A file listing with comments will be shown for all files in "third.zip" which
  2701. are listed in "xyz.lst"
  2702.  
  2703.    C:\>pkzip -rp backup.zip *.* -x@noback.lst
  2704.  
  2705. A .ZIP file containing the entire drive would be created, excluding any files
  2706. which match those in "noback.lst"
  2707.  
  2708. **  Don't forget to use the @ in front of a list file name.  If you do not use
  2709.     the @, the list file itself will be added to the .ZIP file.
  2710.  
  2711. Generating List Files
  2712.  
  2713. The Generation of list files can have many uses.  Some suggested ways to use
  2714. this feature are:
  2715.  
  2716. -> Dividing Files to be Zipped into logical groups
  2717.  
  2718. -> Easy exclusion of files already Zipped from a PKZIP operation
  2719.  
  2720. -> Complex Batch File operations
  2721.  
  2722. Keep in mind that a plain ASCII list file can be fed through other programs,
  2723. like 'sort', and can be used by some other applications such as StupenDOS or
  2724. PKZMENU.
  2725.  
  2726. The list file generated by PKZIP or PKUNZIP when the -@ option is used
  2727. contains the names of all the files which would have been acted upon in a
  2728. normal ZIP operation.
  2729.  
  2730. In a simple PKZIP command, the list file will contain a listing of all the
  2731. files which would have been archived by PKZIP.  If the list file is generated
  2732. with a freshen or update command, the list file will contain those files which
  2733. would have been added/updated in the .ZIP file.
  2734.  
  2735. To generate a list file of your entire C: hard drive:
  2736.  
  2737.    C:\>pkzip dummy -rp -@cdrive.lst
  2738.  
  2739. Note that the "dummy" .ZIP file name is necessary to have a valid PKZIP
  2740. command.
  2741.  
  2742. The list file generated by PKUNZIP will contain those files which would have
  2743. been extracted.
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753. ════════════════════════════════════════════════════════════════════════════
  2754. PKWARE Inc.                  Using List Files                             65
  2755.  
  2756.  
  2757. Using List files to debug
  2758.  
  2759. You may find the generation of list files helpful when you are testing batch
  2760. files. Let's say you have created a batch file which should compress several
  2761. files as a backup procedure.  Perhaps these files are very large and it takes
  2762. several minutes to compress each one.  This means that if you were to test the
  2763. batch file simply by running it, it could take quite a while to find a problem
  2764. and fix it.
  2765.  
  2766. By generating a list file of what would have been compressed, you can check
  2767. very quickly to make certain that the proper files are being selected.
  2768.  
  2769. List file size
  2770.  
  2771. The size of a list file that may be processed is limited.  The total size of
  2772. the list file depends upon two factors.
  2773.  
  2774. The first is path storage.  If paths are specified in the list file and are
  2775. NOT stored with the -P option, the list file size is limited to 7000 bytes.
  2776.  
  2777. If paths are specified and ARE stored, the list file size is limited to 9700
  2778. bytes.
  2779.  
  2780. If a list file has drive letters specified as part of the file names within
  2781. the file, the maximum list file size is reduced.  When paths are not stored
  2782. the maximum List File size is 5100 bytes.  When they are stored the maximum
  2783. List File size is 6600 bytes.
  2784.  
  2785. Note that this table corresponds to the total size of all list files being
  2786. used in a single command.
  2787.  
  2788.       ╔════════════════════════════╤══════════════════╤═══════════════════╗
  2789.       ║ List File Size Limits      │  No Path Storage │ Path Storage (-P) ║
  2790.       ╟────────────────────────────┼──────────────────┼───────────────────╢
  2791.       ║ Drive Letters in List File │    5100 bytes*   │       6600        ║
  2792.       ╟────────────────────────────┼──────────────────┼───────────────────╢
  2793.       ║ No Drive Letter            │       7000       │       9700        ║
  2794.       ╚════════════════════════════╧══════════════════╧═══════════════════╝
  2795.       *These numbers are approximate and may vary depending on your
  2796.        configuration.
  2797.  
  2798. If the list file is too big, you will receive an "Insufficient Memory" error.
  2799. If you have a list file which is too big, you may split it into two or more
  2800. smaller list files and perform multiple PKZIP operations.
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809. ════════════════════════════════════════════════════════════════════════════
  2810. 66                           Introduction                            PKZIP 2
  2811.  
  2812.  
  2813. Be Creative
  2814.  
  2815. The list file functions give you a whole new level of power with PKZIP.  When
  2816. defining a problem and searching for a solution, don't forget to consider the
  2817. power of these features.
  2818.  
  2819. Using the list file features can give you access to new abilities PKZIP would
  2820. not have inherently.  Here are some example situtations:
  2821.  
  2822. Removing Old Files
  2823.  
  2824. Suppose a .ZIP file 'work' contains 45 files.  The contents of 'work' are
  2825. extracted to a work directory and several of the files are deleted.  How do
  2826. you delete these files that are no longer necessary from the 'work' archive?
  2827. Doing it manually would be very tedious.
  2828.  
  2829. First create a list of the contents of the directory.  By redirecting these
  2830. file names to a list file you can capture an image of what needs to be kept in
  2831. the .ZIP file.
  2832.  
  2833.    C:\work>pkzip dummy.zip *.* -@keep.lst
  2834.  
  2835. The list file 'keep.lst' now contains the files we want preserved in the .ZIP
  2836. file, files not in this list will be deleted:
  2837.  
  2838.    C:\work>pkzip work.zip -d *.* -x@keep.lstC:\work>del keep.lst
  2839.  
  2840. The WORK.ZIP file now contains only those files which are also in the work
  2841. directory.
  2842.  
  2843. Sorting .ZIP Files
  2844.  
  2845. Files will be added to a .ZIP file in the order that they are listed in the
  2846. list file.  This can be useful if you want the contents of a .ZIP file to be
  2847. in a particular order. After generating a list file, bring it into an editor
  2848. and modify it to meet your need. To create a .ZIP file that is sorted in
  2849. alphabetical order, you would use the following series of commands:
  2850.  
  2851.    C:\work>pkzip test.zip *.* -@test.lst
  2852.    C:\work>sort < test.lst > sort.lst
  2853.    C:\work>pkzip test.zip @sort.lst
  2854.    C:\work>del test.lst sort.lst
  2855.  
  2856. The SORT command used above is a standard DOS program.  See your DOS
  2857. manual for further information on this useful feature.
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865. ════════════════════════════════════════════════════════════════════════════
  2866. PKWARE Inc.                  Using List Files                             67
  2867.  
  2868. USING DATA ENCRYPTION
  2869. ════════════════════════════════════════════════════════════════════════════
  2870.  
  2871. The PKZIP utilities offer the ability to protect stored data through
  2872. encryption.  You should use PKZIP's encryption ability in place of any other
  2873. encryption on files you intend to compress.
  2874.  
  2875. This encryption ability has been made integral to the function of PKZIP and
  2876. PKUNZIP to prevent the encryption from interfering with PKZIP's ability to
  2877. compress. If you feel the need to encrypt your data to protect it, and are
  2878. intending to compress the data as well, you should then use the encryption of
  2879. PKZIP.  Using the encryption capability of a spreadsheet or database program
  2880. will prevent PKZIP from compressing the data efficiently.
  2881.  
  2882. Encryption is enabled in PKZIP by use of the -s option.  The encryption key,
  2883. sometimes referred to as a "password", follows directly after the -s
  2884.  
  2885.    C:\>pkzip test.zip -ssecret d:\payroll\*.dbf
  2886.  
  2887. Above, all the "dbf" files from the payroll directory have been compressed
  2888. into a .ZIP file called "test.zip".  During the compression they are also
  2889. being encrypted based upon the key of "secret".
  2890.  
  2891. The encryption scheme used by PKZIP is complex and robust.  The encryption key
  2892. is used to generate a number of binary encryption keys which are in turn used
  2893. to determine how the compressed data is altered.  Neither the original key or
  2894. the derived keys are stored with the .ZIP file, nor are they retained anywhere
  2895. else for that matter.  This means you must remember the encryption key.
  2896.  
  2897.  
  2898.      ╔═══════════════════════════════════════════════════════════════════╗
  2899.      ║ IF YOU LOSE THE ORIGINAL ENCRYPTION KEY YOU WILL NEVER BE ABLE TO ║
  2900.      ║ EXTRACT THE FILE(S).                                              ║
  2901.      ╚═══════════════════════════════════════════════════════════════════╝
  2902.  
  2903.  
  2904. It is also not possible to derive the original keys by examining the
  2905. compressed data, or by analysis of original data versus encrypted data.  This
  2906. means that if you loose the key, there is no way to find it.  PKWARE Inc. has
  2907. no special means or technology for deriving the key or extracting the data
  2908. without the key.
  2909.  
  2910. Also note that a minute change in the key completely alters the encryption
  2911. scheme.  This means that the key must be exact.  Any change in spelling,
  2912. capitalization or punctuation causes a key to be completely different.  Be
  2913. certain that you know what the encryption key is and will not lose, forget, or
  2914. mistype it.
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921. ════════════════════════════════════════════════════════════════════════════
  2922. 68                           Introduction                            PKZIP 2
  2923.  
  2924.           ╔════════════════════════════════════════════════╗
  2925.           ║ DO NOT TRUST YOUR MEMORY ALONE.  WRITE IT DOWN.║
  2926.           ╚════════════════════════════════════════════════╝
  2927.  
  2928. Capitalization is also important.  "Secret", "secret" and "SECRET" are all
  2929. completely different encryption keys.
  2930. You should realize that a person who knows you could attempt to extract a file
  2931. you have encrypted by using words they think you will use or can remember
  2932. easily.  This would be items such as:
  2933.  
  2934.   ≡ Your Spouse's name
  2935.  
  2936.   ≡ Your Social Security Number
  2937.  
  2938.   ≡ Your Address
  2939.  
  2940.   ≡ Your Dog's name
  2941.  
  2942.   ≡ Etc...
  2943.  
  2944. Long Keys
  2945.  
  2946. It is possible to have extremely long keys, or keys with spaces in them.  The
  2947. length of the encryption key is limited only by the length of a DOS command
  2948. line. To use a key with spaces in it, you must enclose the password in
  2949. quotation marks:
  2950.  
  2951.    C:\>pkzip test.zip -s"mary had a little lamb" *.dbf
  2952.  
  2953. Passwords of this sort may be easy to remember, while proving to be very
  2954. secure. Remember to use phrases that are not obvious to someone who knows you.
  2955.  
  2956. Complex Keys
  2957.  
  2958. If PKZIP or PKUNZIP is specified with only the -s and no encryption key
  2959. following, the user is prompted for an encryption key.
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977. ════════════════════════════════════════════════════════════════════════════
  2978. PKWARE Inc.                 Using Data Encryption                         69
  2979.  
  2980.    C:\>zip test -s *.com
  2981.  
  2982.    PKZIP (R)  FAST!  Create/Update Utility  Version 2
  2983.    Copr. 1989-1992 PKWARE Inc.  All Rights Reserved.  PKZIP/h for help
  2984.    PKZIP Reg. U.S. Pat. and Tm. Off.   Patent No. 5,051,745
  2985.  
  2986.    Password ? ******
  2987.  
  2988.    ■80486 CPU detected.
  2989.    ■XMS version 2.00 detected.
  2990.    ■Novell Netware version 3.11 detected.
  2991.    ■Using Super Fast Compression.
  2992.  
  2993.    Creating ZIP: TEST.ZIP
  2994.    Adding: COMMAND.COM  Deflating (36%), done.
  2995.    Adding: 4DOS.COM     Deflating (34%), done.
  2996.  
  2997. Asterisks are displayed in place of each character as you enter the encryption
  2998. key.  This feature offers added security in the event somone is watching as
  2999. you type in the password.
  3000.  
  3001. This method of entry may be easier or more comfortable to use.  This also
  3002. allows you to enter characters for the encryption key which cannot normally be
  3003. entered from the keyboard.
  3004.  
  3005. In order to enter one of these characters, hold down the [ALT] key and type
  3006. the ASCII value of the character you wish to enter on the number pad.  When
  3007. you release the [ALT] key the character equal to the value typed will be
  3008. entered into the Password field.
  3009.  
  3010. The [TAB] key and other keys which could not normally be used since they would
  3011. interfere with the PKZIP command line can be used when the password is entered
  3012. in this manner.
  3013.  
  3014. Passwords entered in this manner are limited to a maximum length of 64
  3015. characters.
  3016.  
  3017. Multiple Keys
  3018.  
  3019. Passwords can be used not only when creating a new .ZIP file but also when
  3020. files are being added to an already existing .ZIP file.  Let's assume you have
  3021. a .ZIP file called "keyfun.zip" and it contains two files:
  3022.  
  3023.    june91.wk1
  3024.    june91.wp
  3025.  
  3026. We'll also say that neither of these files are encrypted.  Now let's add
  3027. another file to this .ZIP file, and encrypt it while doing so:
  3028.  
  3029.    C:\>pkzip keyfun.zip -sPiZzA sensitiv.txt
  3030.  
  3031. This will add the file "sensitiv.txt" with a encryption key of "PiZzA".
  3032.  
  3033. ════════════════════════════════════════════════════════════════════════════
  3034. 70                        Using Data Encryption                      PKZIP 2
  3035.  
  3036.  
  3037. Now add another file to the same .ZIP file with a different key:
  3038.  
  3039.    C:\>pkzip keyfun.zip -sDukeNUKE diary.txt
  3040.  
  3041. At this point you have four files in "keyfun.zip".  Two are not encrypted at
  3042. all, and two are, but with different keys. A view of the file would appear
  3043. like this:
  3044.  
  3045.    C:\>pkunzip -v keyfun
  3046.    PKUNZIP (R)   FAST!   Extract Utility   Version 2
  3047.    Copr. 1989-1992 PKWARE Inc. All Rights Reserved. PKUNZIP/h for help
  3048.    PKUNZIP Reg. U.S. Pat. and Tm. Off.
  3049.  
  3050.    ■80486 CPU detected.
  3051.    ■EMS version 4.00 detected.
  3052.    ■XMS version 3.00 detected.
  3053.  
  3054.    Searching ZIP: KEYFUN.ZIP
  3055.  
  3056.    Length  Method     Size Ratio   Date    Time    CRC-32  Attr  Name
  3057.     -----  -------   -----  ---  --------  -----  -------- ----  ------------
  3058.     11664  Deflate    6937  41%  01-30-92  11:57  183b5606 --w-  JUNE91.WK1
  3059.     76812  Deflate   23404  70%  01-30-92  12:03  971fea04 --w-  JUNE91.WP
  3060.      5327  Deflate    2082  61%  10-14-91  11:25  924efc72 --w-* SENSITIV.TXT
  3061.      3664  Deflate    1654  55%  04-04-91  10:32  c8d5c9cf --w-* DIARY.TXT
  3062.     -----            -----  ---                                  ------------
  3063.     97467            34077  66%                                        4
  3064.  
  3065. Notice the * next to the Attribute column above.  This indicates that a file
  3066. is encrypted.
  3067.  
  3068. Now, if you try to extract the file with no decryption key present you will
  3069. only be able to extract the two files that are not encrypted:
  3070.  
  3071.    PKUNZIP (R)   FAST!   Extract Utility   Version 2
  3072.    Copr. 1989-1992 PKWARE Inc. All Rights Reserved. PKUNZIP/h for help
  3073.    PKUNZIP Reg. U.S. Pat. and Tm. Off.
  3074.  
  3075.    ■80486 CPU detected.
  3076.    ■EMS version 4.00 detected.
  3077.    ■XMS version 3.00 detected.
  3078.  
  3079.    Searching ZIP: KEYFUN.ZIP
  3080.     Inflating: JUNE91.WK1
  3081.     Inflating: JUNE91.WP
  3082.    PKUNZIP: (W12) Warning! Skipping encrypted file: SENSITIV.TXT
  3083.    PKUNZIP: (W12) Warning! Skipping encrypted file: DIARY.TXT
  3084.  
  3085. Extracting the file with a decryption key will extract any file that the key
  3086. is valid for, but an error will be reported on any files with a different key.
  3087.  
  3088.  
  3089. ════════════════════════════════════════════════════════════════════════════
  3090. PKWARE Inc.                 Using Data Encryption                         71
  3091.  
  3092.  
  3093.    C:\>pkunzip keyfun -sPiZzA -o
  3094.  
  3095.    PKUNZIP (R)   FAST!   Extract Utility   Version 2
  3096.    Copr. 1989-1992 PKWARE Inc. All Rights Reserved. PKUNZIP/h for help
  3097.    PKUNZIP Reg. U.S. Pat. and Tm. Off.
  3098.  
  3099.    ■80486 CPU detected.
  3100.    ■EMS version 4.00 detected.
  3101.    ■XMS version 3.00 detected.
  3102.  
  3103.    Searching ZIP: KEYFUN.ZIP
  3104.     Inflating: JUNE91.WK1
  3105.     Inflating: JUNE91.WP
  3106.     Inflating: SENSITIV.TXT
  3107.    PKUNZIP: (W14) Warning! Incorrect password for file: DIARY.TXT
  3108.  
  3109.  
  3110. How secure is PKZIP encryption?
  3111.  
  3112. There are many factors to consider when using PKZIP encryption.  There are
  3113. also several levels and implications to consider.
  3114.  
  3115. The first level of security is physical.  Who has access to the .ZIP file?
  3116. You need to be aware of who might be able to get to sensitive data located on
  3117. your machine, on your floppies, or on your personal network drive.
  3118.  
  3119. The potential hazards of using data encryption cannot be stressed strongly
  3120. enough.  Make certain that you will be able to recall what was used for the
  3121. encryption key.  Also be certain that all people who need to be able to access
  3122. this data have agreed upon how the encryption will be performed.
  3123.  
  3124. It does happen that people encrypt very important data, and then go on
  3125. "vacation" to a distant land, or meet their untimely demise, without first
  3126. passing on the encryption key.  In these sorts of eventualities the data is
  3127. gone.  So consider well before you encrypt or allow the encryption of
  3128. information.  If this information is so vital to you that you feel you must
  3129. encrypt it, consider what the loss of it would mean to you.
  3130.  
  3131. All forms of encryption, including the one used by PKZIP, are open to "brute
  3132. force" attacks.  This form of attack is simply the trying of many passwords
  3133. until you find one that works.
  3134.  
  3135. In order to help you protect your data from this sort of attack we present
  3136. figures on how long a brute force attack, using a computer, would take.  The
  3137. scenario we present here assumes that your encrypted .ZIP file is being
  3138. assaulted by a program which is designed specifically to do this.
  3139.  
  3140. An encryption key may contain any valid ASCII character, not just A-Z in upper
  3141. and lower case and punctuation marks.  However, most people will just use the
  3142. latter.  The following table is indexed by the complexity of the password.
  3143. Across the top is the range of
  3144.  
  3145. ════════════════════════════════════════════════════════════════════════════
  3146. 72                        Using Data Encryption                      PKZIP 2
  3147.  
  3148. characters used.  The simplest assumes that only lower case letters from a to
  3149. z were used.  The next column assumes that all printable characters were used
  3150. (a to z in upper and lower case, punctuation, brackets, etc.).  The last
  3151. column assumes a password containing the complete range of ASCII characters.
  3152.  
  3153. The vertical index is the length of the password used.  This impacts the
  3154. strength of the password greatly.  Think of it as a combination lock.  A
  3155. combination lock with only two numbers would be much easier to break than one
  3156. with three or four numbers.
  3157.  
  3158. We recommend that if you need a truly secure encrypted file, use an encryption
  3159. key of at least six characters.
  3160.  
  3161. The last assumption made is about the speed of the attacking program.  For the
  3162. purposes of this table, we assume that 10,000 possible keys are being
  3163. attempted per second.
  3164.  
  3165.  
  3166.             Password "Hacking" Time
  3167.     ╔════════╤═══════════════╤═══════════════╤════════════════════╗
  3168.     ║  Key   │ 26 characters │ 96 characters │   256 characters   ║
  3169.     ║ Length │    (a-z)      │ (a-z,A-Z,etc) │    (All ASCII)     ║
  3170.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3171.     ║    3   │ 2 seconds     │ 1 minute      │  27 minutes        ║
  3172.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3173.     ║    4   │ 1 minute      │ 2.35 hours    │  4 days            ║
  3174.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3175.     ║    5   │ 19 minutes    │ 9 days        │  3 years           ║
  3176.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3177.     ║    6   │ 8.6 hours     │ 2 years       │  891 years         ║
  3178.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3179.     ║    7   │ 9 days        │ 238 years     │  2283 centuries    ║
  3180.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3181.     ║    8   │ 241 days      │ 228 centuries │  584,546 cent.     ║
  3182.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3183.     ║    9   │ 17 years      │ 21,945 cent.  │  149,643,989 cent. ║
  3184.     ╟────────┼───────────────┼───────────────┼────────────────────╢
  3185.     ║   10   │ 447 years     │ 2,106,744     │  38,308,861,211    ║
  3186.     ║        │               │  centuries    │   centuries        ║
  3187.     ╚════════╧═══════════════╧═══════════════╧════════════════════╝
  3188.  
  3189.  
  3190. Choose the complexity that you feel meets your needs, but keep in mind all
  3191. that has been mentioned about losing and forgetting passwords.
  3192.  
  3193. These figures represent the state of technology today.  PKWARE Inc. cannot
  3194. predict future technologies which may allow faster attempts at decryption of a
  3195. .ZIP file.
  3196.  
  3197. Note that the above figures do not include the time needed to actually try all
  3198. valid passwords.  This would increase the time by several hundred percent,
  3199. dependent upon the length of the file.
  3200.  
  3201. ════════════════════════════════════════════════════════════════════════════
  3202. PKWARE Inc.                 Using Data Encryption                         73
  3203.  
  3204. PKZIP CONFIGURATION
  3205. ════════════════════════════════════════════════════════════════════════════
  3206. Configuring PKZIP with PKCFG.EXE and the PKZIP.CFG file
  3207.  
  3208. PKZIP can have several of its features configured semi-permanently.  These
  3209. configuration changes are made through a configuration file called PKZIP.CFG.
  3210.  
  3211. This configuration file can be located in one of three places:
  3212.  
  3213.   1) The current directory
  3214.   2) A directory specified with the environment variable PKZIP.CFG
  3215.   3) The directory in which PKZIP.EXE is located
  3216.  
  3217. PKZIP will search for the configuration in each location
  3218. in the order listed above. This means that you may have a default
  3219. configuration file that is easily overridden by using a configuration file in
  3220. either of the first two locations.
  3221.  
  3222. **  Any option that is set in the configuration file may be overridden from
  3223.     the command line.
  3224.  
  3225. The configuration file may either be created manually with a text editor, or
  3226. through the use of the included utility, PKCFG.EXE
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.  
  3255.  
  3256.  
  3257. ════════════════════════════════════════════════════════════════════════════
  3258. 74                         PKZIP Configuration                       PKZIP 2
  3259.  
  3260.  
  3261. PKCFG
  3262.  
  3263. The PKCFG program will look for an existing configuration file in the same
  3264. locations and order that PKZIP would.  If the PKCFG program finds an existing
  3265. configuration file it will load it.  The existing configuration values will be
  3266. shown in place of the defaults.
  3267.  
  3268. A list of options will be displayed on the screen.  A highlighted cursor
  3269. indicates the option you can modify.  Use the  [UP Arrow] and [DOWN Arrow]
  3270. keys to move up and down through the list.
  3271.  
  3272. Options may be toggled with either the the [LEFT Arrow] and [RIGHT Arrow] keys
  3273. or by pressing the [ENTER] key. Some options have complex possibilities.  When
  3274. one of these is modified, a small dialog box with options to be changed will
  3275. be displayed.
  3276.  
  3277. To reset all displayed options to the default values press [F5].  In order to
  3278. save the options you have selected to the configuration file, press [F1].
  3279. Press [F10] to exit the program.  If you exit without saving changes, you will
  3280. be prompted.
  3281.  
  3282. PKZIP.CFG
  3283.  
  3284. The options available in a configuration file are shown in the table on the next
  3285. page.  The "Default Value" column shows the default value of each option.
  3286.  
  3287. The default is the value that would be assumed if the option were not specified
  3288. in the configuration file.
  3289.  
  3290.  
  3291. ** NOTE: PKCFG is included with the registered version of PKZIP, and is
  3292.      not included with the shareware version.
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311. ════════════════════════════════════════════════════════════════════════════
  3312. PKWARE Inc.                 PKZIP Configuration                           75
  3313.  
  3314.                Configuration File Options
  3315. ╔═════════════════════╦═════════════════════════╤════════════════════════╗
  3316. ║       Option        ║     Alternate Value     │     Default Value      ║
  3317. ╠═════════════════════╬═════════════════════════╪════════════════════════╣
  3318. ║ ANSI                ║ enabled                 │ disabled               ║
  3319. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3320. ║ INCLUDE             ║ hidden/system           │ (none)                 ║
  3321. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3322. ║ MASK                ║ readonly/hidden/system  │ (none)                 ║
  3323. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3324. ║ RECURSE             ║ on                      │ off                    ║
  3325. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3326. ║ PATHS               ║ all, recurse            │ (none)                 ║
  3327. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3328. ║ ZIPDATE             ║ keep, latest            │ current                ║
  3329. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3330. ║ COMPRESS            ║ maximal, fast, speed    │ normal                 ║
  3331. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3332. ║ LISTCHAR            ║ (any)                   │ @                      ║
  3333. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3334. ║ OPTIONCHAR          ║ (any)                   │ -                      ║
  3335. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3336. ║ VIEW (Type)         ║ brief                   │ long                   ║
  3337. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3338. ║ VIEW (reverse sort) ║ reverse                 │ (none)                 ║
  3339. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3340. ║ VIEW (sort order)   ║ size, date, name, ratio │ natural                ║
  3341. ║                     ║ comments, extension     │                        ║
  3342. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3343. ║ EMS                 ║ disable                 │ enable                 ║
  3344. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3345. ║ XMS                 ║ disable                 │ enable                 ║
  3346. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3347. ║ NET                 ║ disable                 │ enable                 ║
  3348. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3349. ║ DPMI                ║ disable                 │ enable                 ║
  3350. ╟─────────────────────╫─────────────────────────┼────────────────────────╢
  3351. ║ 386                 ║ disable                 │ enable                 ║
  3352. ╚═════════════════════╩═════════════════════════╧════════════════════════╝
  3353.  
  3354. Options separated by a slash / character may be used alone or in combination
  3355. with others.  Options separated by a comma may not be combined with the
  3356. exception of VIEW.  With VIEW one option from each of the three categories may
  3357. be used in combination.
  3358.  
  3359. A configuration file consists of ASCII text.  This file may be created with
  3360. any text editor that can create a plain ASCII or `DOS Text' file.
  3361.  
  3362. Examples
  3363.  
  3364. Following are several example configuration files with explanations of what
  3365. they would accomplish.
  3366.  
  3367. ════════════════════════════════════════════════════════════════════════════
  3368. 76                         PKZIP Configuration                       PKZIP 2
  3369.  
  3370.  
  3371.    ;Example PKZIP.CFG #1
  3372.    ;Config files may contain comments if they are prefaced by a
  3373.    ;semi-colon
  3374.    PATHS=recurse
  3375.    VIEW=brief/reverse/size
  3376.    COMPRESS=speed
  3377.  
  3378. The first example configuration file does the following:
  3379.  
  3380. -> Turns on the storage of paths that are found during recursion.  This would
  3381.    make all commands using the -r option behave as though the -rp option was
  3382.    used.
  3383.  
  3384. -> Any view (-v) command used without options will be shown in brief format,
  3385.    sorted in reverse order of the file size.
  3386.  
  3387. -> All commands that do not specify the compression type will use the fastest
  3388.    (-es) method of compression.
  3389.  
  3390.    ;Example PKZIP.CFG #2
  3391.    INCLUDE=hidden/system
  3392.    RECURSE=on
  3393.    PATHS=all
  3394.    VIEW=extension
  3395.    EMS=off
  3396.    COMPRESS=maximal
  3397.  
  3398. The second example configuration file does the following:
  3399.  
  3400. -> Causes PKZIP to archive hidden and system files by default.  Hidden and
  3401.    system files are normally skipped by PKZIP and not visible in directory
  3402.    listings.
  3403.  
  3404. -> Any command will behave as though the -r option has been used
  3405.  
  3406. -> All paths will be stored, both those specified on the command line and
  3407.    those found through recursion(-r).
  3408.  
  3409. -> Any view (-v) command used without options will be shown sorted in order of
  3410.    file extension.  Note that the view would be long, the default value.  If
  3411.    the view command were specified with -vb using the configuration file, the
  3412.    view would be brief, but the sort order specified in the configuration file
  3413.    would still be in effect unless overridden with a command line option.
  3414.  
  3415. -> EMS usage is disabled.
  3416.  
  3417. -> All commands that do not specify the compression type would use the highest
  3418.    compression possible (-ex).
  3419.  
  3420. ** NOTE: The options for zipping to multiple floppy disks are documented
  3421.      in the ADDENDUM.DOC file.
  3422.  
  3423. ════════════════════════════════════════════════════════════════════════════
  3424. PKWARE Inc.                 PKZIP Configuration                        77-81
  3425.  
  3426. Application for Authenticity Verification
  3427.  
  3428. In order to receive a serial number to use with the PUTAV program, please fill
  3429. out and return this form to PKWARE.  When the enclosed information is
  3430. verified, you will receive your serial number from PKWARE.
  3431.  
  3432. Please note that this does not constitute a license from PKWARE to distribute
  3433. the executable programs PKZIP, PKUNZIP or self-extracting PKSFX files for
  3434. commercial purposes.  See LICENSE.DOC or contact PKWARE Inc. for more
  3435. information about distribution licenses for the software.
  3436.  
  3437. Please Read the entire chapter on AV before filling this out.
  3438.  
  3439.  1) My full registration for PKZIP/PKUNZIP/PKSFX   ($47+$3.50 S&H) is enclosed
  3440.     (circle one)  YES  NO
  3441.  
  3442.     If yes, skip to step 3.
  3443.  
  3444. 2) I have previously fully registered PKZIP/PKUNZIP/PKSFX in the  past. The
  3445. name under which the software is registered is:
  3446.  
  3447. Name:_________________________________________________________________
  3448.  
  3449. Company:______________________________________________________________
  3450.  
  3451. Title:_____________________________________ Date:_____________________
  3452.  
  3453. Address:______________________________________________________________
  3454.  
  3455. City:______________________________________ State:____________________
  3456.  
  3457. Zip Code:  ________________________
  3458.  
  3459. Telephone #:(______)__________________ Fax #:(_____)__________________
  3460.  
  3461. Approximate date of registration/purchase:____________________________
  3462.  
  3463. 3) Please list the name that you want displayed by PKUNZIP when an
  3464.    authentic file created by you is verified (51 characters max).
  3465.  
  3466. Since the purpose of the Authenticity Verification feature is to help provide
  3467. detection of tampered, hacked or virus infected files, we ask that you provide
  3468. only your company's name or individual's name for the AV string.
  3469.  
  3470. The "AVEXTRA.TXT" feature was designed to additionally display telephone
  3471. numbers, addresses, BBS numbers, BBS nodes or parameter, CompuServe addresses
  3472. and similar information.
  3473.  
  3474. ┌─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┐
  3475. │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
  3476. └─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘
  3477. ┌─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┐
  3478. │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
  3479. └─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘
  3480. PKZIP 2
  3481.  
  3482. F.A.Q.
  3483. ════════════════════════════════════════════════════════════════════════════
  3484. (Frequently Asked Questions)
  3485.  
  3486. This section lists some common questions about PKZIP and related subjects.  We
  3487. hope you will find this information helpful.
  3488.  
  3489. Why do I get the message "Bad Command or Filename"?
  3490. ===================================================
  3491.  
  3492. If you see this message, DOS is telling you it can't find the program
  3493. you are referring to.  This can happen because you are either not spelling the
  3494. name of the program properly, or you didn't put a space between the program
  3495. name and its options, or the program is not in your path.
  3496.  
  3497. Please see the Installation section and your DOS manual for more information.
  3498.  
  3499. Why is this program so complicated?
  3500. ===================================
  3501.  
  3502. PKZIP initially was used to compress files that would be sent by modem.  The
  3503. people using PKZIP were mostly hobbyists with a fair amount of computer
  3504. experience.  PKZIP was designed to be powerful and fast.
  3505.  
  3506. Someone who is familiar with the workings of PKZIP can be very efficient with
  3507. the command line.  The command line interface is vital for automated or batch
  3508. use of PKZIP.
  3509.  
  3510. Although PKZIP may seem very complex at first, it is easy to master if you
  3511. take one step at a time.  Start simply by following the Tutorial, then
  3512. experiment and build on that knowledge as you need more features.
  3513.  
  3514. Users who prefer using Graphical User Interfaces may wish to consider the
  3515. "PKZMENU" product from PKWARE.  This easy to use menu-driven program offers
  3516. PKZIP compatibility.  It features drop-down menus and a simple point and shoot
  3517. interface.
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535. ════════════════════════════════════════════════════════════════════════════
  3536. 82                              F.A.Q.                               PKZIP 2
  3537.  
  3538.  
  3539. Why didn't the files I Zipped get any smaller?
  3540. ==============================================
  3541.  
  3542. On occasion, you may find that the files you add to a .ZIP file do not
  3543. compress.  These files will be "stored".  This will happen when a file is
  3544. either already compressed or encrypted.
  3545.  
  3546. In both cases the redundancy of the file will be gone, making compression
  3547. difficult if not impossible.  If the file is encrypted you should first save
  3548. it without encryption, and then use the encryption feature of PKZIP.
  3549.  
  3550. You will often find that files distributed with commercial applications are
  3551. already compressed.  A common example would be the graphic data files that
  3552. come with games like Leisure Suit Larry or Ultima.
  3553.  
  3554. I zipped up a bunch of files but now I have LESS disk space!?
  3555. =============================================================
  3556.  
  3557. When PKZIP compresses files, it makes a copy of the original file.  The
  3558. original file(s) are still present.  If you wish to recover space that was
  3559. taken up by the original file(s), you must either delete them yourself, or
  3560. instruct PKZIP to delete the file(s) with the -m option.
  3561.  
  3562. What's the difference between -u and -f?
  3563. ========================================
  3564.  
  3565. The update and freshen options are very similar.  This may be confusing at
  3566. first, but the difference between them is fairly easy to understand.
  3567.  
  3568. The freshen option will tell PKZIP to archive any files which match those
  3569. already in the .ZIP file.  These files will only be re-compressed if they are
  3570. newer than the files already in the .ZIP file.  Each file is evaluated
  3571. individually.
  3572.  
  3573. The update option will archive all files, with one distinction.  If the -u is
  3574. not used, all files specified will be compressed and added to the .ZIP file,
  3575. even if they already exist in the .ZIP file.  By using the -u option, you
  3576. instruct PKZIP to compare what is already in the .ZIP file against what it was
  3577. asked to compress.  If a file is already present in the .ZIP file and is also
  3578. in the source directory, PKZIP will compress a file only if it is newer than
  3579. the copy of the file within the .ZIP file.  If a file in the source directory
  3580. is not already present in the target .ZIP file, PKZIP will add it to the .ZIP
  3581. file.
  3582.  
  3583. Is PKZIP compression "lossy" or "lossless"?
  3584. ===========================================
  3585.  
  3586. PKZIP uses a "lossless" compression scheme.  This means that 100% of the
  3587. original data is preserved and re-created.  There is  ...(continued)
  3588.  
  3589.  
  3590.  
  3591. ════════════════════════════════════════════════════════════════════════════
  3592. PKWARE Inc.                       F.A.Q                                   83
  3593.  
  3594.  
  3595. absolutely no difference between the data that you put in and the data which
  3596. you get back out.
  3597.  
  3598. There are other compression methods that are known as "lossy".  The idea
  3599. behind these compression methods is that if you throw away some of the data,
  3600. it becomes less complex and therefore can be compressed more.  This type of
  3601. compression is only useful for data that need not be precise.  This applies to
  3602. some applications that use pictures and sound.
  3603.  
  3604. How do I zip up subdirectories?
  3605. ===============================
  3606.  
  3607. In order to ZIP up subdirectories you must both recurse subdirectories and
  3608. preserve path names.  This is done with the -r and -p options in combination.
  3609. The options may be placed together as -rp.
  3610.  
  3611. When a .ZIP file is created with paths stored, these paths will be visible in
  3612. a view of the file (-v).
  3613.  
  3614. To re-create these subdirectories, or to place files into their original
  3615. subdirectories, the -d option must be used with PKUNZIP.
  3616.  
  3617. Please see the tutorial for more information.
  3618.  
  3619. I zipped up some subdirectories, but I can't get them to come back?
  3620. ===================================================================
  3621.  
  3622. Did you remember to use the -p option in addition to the -r option? You may
  3623. have stored files that are in subdirectories but not preserved the path names
  3624. as part of the .ZIP file.  To check if there are paths in the .ZIP file, do a
  3625. view of the file:
  3626.  
  3627.    pkunzip file.zip -v
  3628.  
  3629. If you do not see paths as part of the file names within the .ZIP file, then
  3630. paths were not stored and cannot be recovered.  If you do see paths all you
  3631. need to do is use the -d (directory creation) option when you extract the
  3632. files.
  3633.  
  3634. How do I unzip a single file that is in a subdirectory in the .ZIP file?
  3635. ========================================================================
  3636.  
  3637. Extracting a particular file from a .ZIP file is simple.  You type PKUNZIP
  3638. with the name of the .ZIP file and the name of the particular file you want.
  3639. With a .ZIP file that contains paths the procedure is basically the same.
  3640.  
  3641. Let's assume a "test" .ZIP file with these files in it:
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647. ════════════════════════════════════════════════════════════════════════════
  3648. 84                              F.A.Q.                               PKZIP 2
  3649.  
  3650.    file1.txt
  3651.    apple\file2.txt
  3652.    apple\banana\file3.txt
  3653.  
  3654. To extract only "file2.txt" from this .ZIP file you must specify the complete
  3655. name. This would include the path.
  3656.  
  3657.    pkunzip test.zip apple\file2.txt
  3658.  
  3659. Note there is no leading slash.  This is how PKUNZIP differentiates between
  3660. the files you are extracting with paths, and the target directory. "file2.txt"
  3661. would be extracted to the current directory.  If you wanted to extract it with
  3662. its subdirectory simply include the -d option on the command line.
  3663.  
  3664. How do I unzip a directory without also extracting its subdirectories?
  3665. ======================================================================
  3666.  
  3667. Using the above "test" .ZIP file we could extract the entire contents of the
  3668. apple subdirectory easily:
  3669.  
  3670.    pkunzip test.zip apple\*.* -d
  3671.  
  3672. If we did it as shown above we would not only extract all the files in the
  3673. "apple" subdirectory, but also the "banana" subdirectory below it and any
  3674. files it contains.
  3675.  
  3676. To extract only the "apple" subdirectories contents, and nothing else, we must
  3677. exclude those directories we do not wish to extract:
  3678.  
  3679.    pkunzip test.zip apple\*.* -d -xapple\banana\*.*
  3680.  
  3681. If the "apple" subdirectory had multiple subdirectories off it you would need
  3682. to exclude each one individually on the command line.
  3683.  
  3684. What is an AV?
  3685. ==============
  3686.  
  3687. AV is short for "Authenticity Verification".  AV is a process whereby a copy
  3688. of PKZIP has unique codes and information contained in it identifying the
  3689. owner of the copy of PKZIP.  This information is then encoded into a .ZIP file
  3690. when it is created.
  3691.  
  3692. When the file is extracted by PKUNZIP, this information is checked.  If the
  3693. .ZIP file has been modified by a copy of PKZIP other than the one which
  3694. initially created it, PKUNZIP will report that the file has been tampered
  3695. with.
  3696.  
  3697. The advantage of this feature is to offer a layer of protection between the
  3698. creator of an archive and the recipient.  The recipient knows that the file
  3699. received is the file that was sent, as well as being able to identify the
  3700. creator if it is not known.
  3701.  
  3702.  
  3703. ════════════════════════════════════════════════════════════════════════════
  3704. PKWARE Inc.                       F.A.Q                                   85
  3705.  
  3706. Where is my AV number?
  3707. ======================
  3708.  
  3709. As a licensed user of PKZIP you are entitled to one AV number.  In order to
  3710. receive an AV number, you must apply for it.
  3711.  
  3712. If you have a need to create AV encoded .ZIP files, fill out the form
  3713. contained in the file "authveri.frm" found in your PKZIP archive.  Mail or fax
  3714. this form to PKWARE. Please allow up to four weeks for processing time, plus
  3715. mail delays.  The codes needed to install your AV number will be returned to
  3716. you via US Mail.  AV codes will not be returned by FAX, telephone, or any
  3717. means other than US Mail.
  3718.  
  3719. Please note that although the initial AV code is included with your purchase
  3720. of a PKZIP license, changes or re-issues of an AV code may be at an additional
  3721. cost.
  3722.  
  3723. **  You must apply for your AV number.  The serial number on the disk PKWARE
  3724.     sent to you has no relation to the AV number.  The AV number is based
  3725.     solely on the information you provide for your AV identification string on
  3726.     the AV application form.
  3727.  
  3728. I forgot my password, what do I do?
  3729. ===================================
  3730.  
  3731.    1. Read the chapter "Using Data Encryption"
  3732.    2. Try to remember the password.
  3733.    3. Try passwords that are "close" to what you think it was.
  3734.    4. Try mixed upper and lower case versions of your password.
  3735.  
  3736. **  There really is nothing that can be done if you lose or forget your
  3737.     password.  Don't forget or lose your passwords!  PKWARE has no special
  3738.     means for "getting around" the encryption and may not be able to assist in
  3739.     the recovery of an encrypted file.
  3740.  
  3741.        ╔════════════════════════════════════════════════════════════════╗
  3742.        ║ YOU SHOULD KEEP A WRITTEN COPY OF YOUR PASSWORD(S) IN A SECURE ║
  3743.        ║ PLACE.  DO NOT TRUST YOUR MEMORY ALONE.                        ║
  3744.        ╚════════════════════════════════════════════════════════════════╝
  3745.  
  3746. What does "Don't Know How to Handle" mean?
  3747. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3748. There are many different methods of compression.  In the history of PKZIP
  3749. alone there have been seven different methods to date.  The .ZIP file format
  3750. was designed so that additional methods of compression can be added as they
  3751. are developed.  In this way the .ZIP file format will never need to be
  3752. abandoned. If you attempt to extract a .ZIP file that was created with version
  3753. 2.0 or higher with a lower version of PKUNZIP you will receive the message
  3754. "Don't Know How to Handle" for every file compressed with a more advanced
  3755. algorithm.
  3756.  
  3757.  
  3758.  
  3759. ════════════════════════════════════════════════════════════════════════════
  3760. 86                              F.A.Q.                               PKZIP 2
  3761.  
  3762.  
  3763. If you attempt to extract a .ZIP file created with a version of PKZIP that
  3764. includes a method PKZIP 2.0 does not use, you will receive a warning that will
  3765. tell you what version of PKUNZIP you need.
  3766.  
  3767.  
  3768. What is a CRC and why did it fail?
  3769. ==================================
  3770.  
  3771. CRC is short for Cyclic Redundancy Check.  A CRC is a value computed to
  3772. represent the data content of a file.  The CRC is computed by PKZIP when it
  3773. archives the file, and computed a second time when the file is extracted. If
  3774. the second CRC does not match the first CRC, then a change has occurred in the
  3775. data. The cause of a CRC failure can vary. Here are some possible causes for
  3776. CRC failures.
  3777.  
  3778.  
  3779. I.  Failure on the machine that created the .ZIP file.
  3780.  
  3781.     A.  Failure immediately after creation.
  3782.  
  3783.     1.  On a 386/486 or higher there may be an obsolete or poorly written
  3784.         TSR or device driver interfering with PK(UN)ZIP.  Use the -3
  3785.         option with both PKZIP and PKUNZIP to see if this is the problem.
  3786.         Consult the Trouble Shooting section for more information.
  3787.  
  3788.     2.  "Clean boot" your machine.  Either re-name your autoexec.bat and
  3789.         config.sys files so that they are not loaded, or insert a DOS boot
  3790.         floppy and reset your machine.  Attempt extraction and compression
  3791.         of the file again.
  3792.  
  3793.     3.  The floppy/hard disk controller may be failing.  See if there is
  3794.         any difference in behavior if you compress to/from the hard disk
  3795.         or floppy drive.
  3796.  
  3797.     4.  Failing diskette media.
  3798.  
  3799.     5.  A bad memory chip.
  3800.  
  3801.     6.  Your computer is suffering from the "cache flaw".  This is caused
  3802.         by problems with the external CPU cache on your computer's
  3803.         motherboard.  See the Trouble Shooting section, -( option.
  3804.  
  3805.     B.  Failure after a period of time.
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815. ════════════════════════════════════════════════════════════════════════════
  3816. PKWARE Inc.                       F.A.Q                                   87
  3817.  
  3818.  
  3819.     1.  Any the above causes.
  3820.  
  3821.     2.  The file has been damaged during the time it was stored on the
  3822.         hard disk.  The can be caused by cross-linking or "lost" clusters.
  3823.         Some faulty disk-defragmenters and deletion recovery programs may
  3824.         cause this.
  3825.  
  3826.     3.  Deleting and then undeleting a .ZIP file.  "Undelete" programs are
  3827.         by no means flawless.  An undeleted or recovered file is very
  3828.         likely to fail, as most disk recovery programs are imperfect at
  3829.         best.
  3830.  
  3831. II. Failure on a network server.
  3832.  
  3833.     A.  Some network server software does not run properly on 386/486
  3834.     machines.  If PKZIP is used on the server CPU running this faulty
  3835.     network software, it will be interfered with by the network software.
  3836.  
  3837. III.Failure after transfer of a file by modem.
  3838.  
  3839.     A.  Any of the problems cited in section I may be the cause of a failure.
  3840.  
  3841.     B.  There was an error in the transfer of the file.  Use an "error-
  3842.     correcting" protocol such as ZMODEM to avoid these types of problems.
  3843.  
  3844.     C.  The file was transferred with "Kermit".  If you use Kermit you must
  3845.     set it to Binary mode.  PKZIP files are binary.
  3846.  
  3847.     D.  One of the computers or modems involved in the transfer has a problem.
  3848.  
  3849. IV. Failure after transfer by disk.
  3850.  
  3851.     A.  Any of the problems cited in section I may be the cause of a failure.
  3852.  
  3853.     B.  Faulty disk controller/floppy drive.
  3854.  
  3855.     C.  Faulty floppy disk.
  3856.  
  3857.     1.  The drive alignment between the two computers may be off enough to
  3858.         cause a data error.  Normally you will get a "disk failure"
  3859.         message from DOS.
  3860.  
  3861.     2.  The disk was damaged by a magnetic or heat source.
  3862.  
  3863.     3.  The disk media is worn out or defective.
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871. ════════════════════════════════════════════════════════════════════════════
  3872. 88                              F.A.Q.                               PKZIP 2
  3873.  
  3874.  
  3875. What do "Bad Table" and "Inconsistent Local Header" mean?
  3876. =========================================================
  3877.  
  3878. If you receive either or both of the above messages, the .ZIP file is damaged
  3879. or has been tampered with.  These messages may also be accompanied by a CRC
  3880. failure.
  3881.  
  3882. All of the physical causes listed for CRC failures apply as possible causes of
  3883. these errors.
  3884.  
  3885. How can I make PKZIP run faster?
  3886. ================================
  3887.  
  3888. PKZIP defaults to a compression method that is average in both compression
  3889. amount and speed.  If you want to get the most speed out of PKZIP there are
  3890. several things you can do:
  3891.  
  3892.  1.  Specify a faster compression method with the -ef or -es option.
  3893.  
  3894.  2.  Use a large RAM disk as your temporary files drive.
  3895.      PKTMP=(RAM disk drive letter)
  3896.  
  3897.  3.  If you are creating the .ZIP file on a network drive, set your PKTMP
  3898.      equal to a drive on the same server.
  3899.  
  3900.  4.  Make as much conventional memory available as possible.
  3901.  
  3902. How many files can be in a .ZIP file?
  3903. =====================================
  3904.  
  3905. A .ZIP file may contain a maximum of 16,383 file entries under MS-DOS.  Due to
  3906. memory limitations this limit cannot actually be realized.  Under the current
  3907. memory scheme of DOS the largest number of files which may be in a .ZIP file
  3908. is approximately 9000 files.
  3909.  
  3910. The maximum number of files you can handle with a .ZIP file operation can be
  3911. calculated by the following formulas:
  3912.  
  3913. With No EMS or UMB's available:
  3914.  
  3915. (Free Conventional RAM - 375k) / 64 bytes = Maximum # of Files
  3916.  
  3917. With EMS available:
  3918.  
  3919. (Free Conventional RAM - 85k) / 64 bytes = Maximum # of Files
  3920.  
  3921. The "Super Fast" algorithm uses 32k less RAM than the other methods in PKZIP
  3922. 2. You will be able to compress an additional 500 files when using the "Super
  3923. Fast" method.
  3924.  
  3925. Note that the value of 64 bytes per file is approximate and may vary.
  3926.  
  3927. ════════════════════════════════════════════════════════════════════════════
  3928. PKWARE Inc.                       F.A.Q                                   89
  3929.  
  3930.  
  3931. When a .ZIP file is being updated, you must not only take into account the files
  3932. being added, but allow 70 bytes per file in the original .ZIP file.
  3933.  
  3934. Can I send a .ZIP file to a different type of computer?
  3935. =======================================================
  3936.  
  3937. As of the publication of this manual, PKWARE currently supports PKZIP
  3938. on MS-DOS and OS/2 platforms, PKWARE intends to support additional platforms
  3939. and will announce these as they become available.
  3940.  
  3941. Because PKWARE has dedicated the .ZIP file format to the public domain, it is
  3942. possible for other people to write programs which can read .ZIP files.
  3943.  
  3944.     ╔═══════════════════════════════════════════════════════════════════════╗
  3945.     ║ NOTE THAT THE PKZIP, PKUNZIP, PKSFX PROGRAMS AND THEIR ASSOCIATED     ║
  3946.     ║ SOURCE CODE AND SUPPORT PROGRAMS ARE THE EXCLUSIVE PROPERTY OF PKWARE ║
  3947.     ║ INC. AND ARE NOT PUBLIC DOMAIN SOFTWARE PROGRAMS.                     ║
  3948.     ╚═══════════════════════════════════════════════════════════════════════╝
  3949.  
  3950. We are currently aware of PKUNZIP compatible programs for a number of
  3951. different platforms.  A .ZIP file can be transferred to any platform for which
  3952. you can find a compatible extraction program.
  3953.  
  3954. Extraction and Compression programs not developed by PKWARE may not be
  3955. completely compatible with the .ZIP file standard.
  3956.  
  3957. Contact PKWARE for a list of platforms for which PKZIP and PKZIP compatible
  3958. software is available.
  3959.  
  3960. What is the difference between -b and pktmp?
  3961. ============================================
  3962.  
  3963. PKZIP creates two different types of temporary files, and allows
  3964. you to specify the location for these two types separately.  The two
  3965. situations where PKZIP creates temp files are:
  3966.  
  3967.  * When a file is being added to a .ZIP file.
  3968.  
  3969.  * When a .ZIP file is being modified.
  3970.  
  3971. It is advantageous to have the temporary files for the first instance written
  3972. on the fastest drive on your system, unless you are creating a .ZIP file on a
  3973. Novell Network.
  3974.  
  3975. The location for the temporary .ZIP file created when a .ZIP file is modified
  3976. is normally the same as the location of the original file.  In some cases you
  3977. may not have enough room on that drive.  When this occurs use the -b option to
  3978. relocate the temp file.
  3979.  
  3980.  
  3981.  
  3982.  
  3983. ════════════════════════════════════════════════════════════════════════════
  3984. 90                              F.A.Q.                               PKZIP 2
  3985.  
  3986. HOW DOES PKZIP WORK?
  3987. ════════════════════════════════════════════════════════════════════════════
  3988.  
  3989. This section has been omitted from the shareware manual to reduce the
  3990. download transmission time.  This section is contained in the registered
  3991. version.
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039. ════════════════════════════════════════════════════════════════════════════
  4040. PKWARE Inc.                 How Does PKZIP Work?                      91-100
  4041.  
  4042. TROUBLE SHOOTING
  4043. ════════════════════════════════════════════════════════════════════════════
  4044.  
  4045. This section offers some hints to aid you in locating and solving problems.
  4046. Part of this section includes PKZIP and PKUNZIP command line and configuration
  4047. file options that apply only to locating problems.
  4048. ╔═════════════════╤═══════════════════════════════════════════╤══════════════╗
  4049. ║  Problem        │       Solution/Reason                     │  See Also    ║
  4050. ╠═════════════════╪═══════════════════════════════════════════╪══════════════╣
  4051. ║"Error in .ZIP   │If you are just creating a .ZIP file for   │Use Tutorial  ║
  4052. ║ use PKZIPFIX"   │ the first time and receive this error,    │          ║
  4053. ║ When compressing│ your command line is wrong.               │              ║
  4054. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4055. ║"Warning:Bad      │PKZIP or PKUNZIP is not in your path, or   │Use Tutorial  ║
  4056. ║ Command or File │ you have mis-typed the command.           │              ║
  4057. ║ Name"       │                          │          ║
  4058. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4059. ║CRC Failure      │Get a new copy of the file.                │F.A.Q. Page XX║
  4060. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4061. ║File does not    │File is already compressed or is encrypted │F.A.Q. Page XX║
  4062. ║ compress        │                                           │              ║
  4063. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4064. ║Files are still  │PKZIP copies files by default, to move     │PKZIP -m      ║
  4065. ║ there after     │ (delete) them, use the -m option.         │ page XX      ║
  4066. ║ being Zipped    │                                           │              ║
  4067. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4068. ║Disk Full error  │Either the .ZIP file you are creating is   │PKZIP Backup  ║
  4069. ║                 │ too large to fit on the disk, or you do   │ Guide        ║
  4070. ║                 │ not have enough room to update an existing│              ║
  4071. ║                 │ .ZIP file.  Create a multi-volume .ZIP    │PKZIP -b page ║
  4072. ║                 │ file or use an alternate temporary drive. │ XX           ║
  4073. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4074. ║Can't find PKSFX │There is no program called PKSFX.  PKSFX   │PKSFX/ZIP2EXE ║
  4075. ║                 │ refers to a "Self-extracting .ZIP file".  │ page XX      ║
  4076. ║                 │ That is a .ZIP file that has been made    │              ║
  4077. ║                 │ into an executable file with the program  │              ║
  4078. ║                 │ ZIP2EXE.EXE                               │              ║
  4079. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4080. ║I have lots of   │Although PKZIP uses XMS/EMS memory, there  │"Using List   ║
  4081. ║ memory, but I'm │ are limitations that will occure due to   │ files"         ║
  4082. ║ getting an      │ your base (conventional) memory being     │ page XX      ║
  4083. ║ "Out of memory" │ limited. Try to clear up as much memory as│              ║
  4084. ║ error?          │ possible.  If you are attempting to       │              ║
  4085. ║                 │ compress more than 8,000 files at once you│              ║
  4086. ║                 │ will usually receive this error.          │              ║
  4087. ╟─────────────────┼───────────────────────────────────────────┼──────────────╢
  4088. ║Can't re-create  │Make certain you are using the -d option.  │F.A.Q. XX     ║
  4089. ║ subdirectories  │ If you are, and you still have this       │              ║
  4090. ║ or return files │ problem, subdirectories may not have been │              ║
  4091. ║ to their        │ stored in the .ZIP file.                  │              ║
  4092. ║ original dirs   │                                           │              ║
  4093. ╚═════════════════╧═══════════════════════════════════════════╧══════════════╝
  4094.  
  4095. ════════════════════════════════════════════════════════════════════════════
  4096. PKWARE Inc.                   Trouble Shooting                           101
  4097.  
  4098.  
  4099. _____________________________________
  4100. -3   Disable 32-bit instruction usage
  4101.  
  4102. This option is available for users with 80386/80486 type computers.  It is
  4103. used to turn OFF the added 32-bit instructions and register usage.  When 32-
  4104. bit instructions are available, PKZIP will utilize them to allow the program
  4105. to function even faster. However, if you are running a different program that
  4106. may conflict with the use of 32-bit instructions, you can disable them by
  4107. using this command.
  4108.  
  4109. 32-bit instructions will be disabled only for the current PKZIP operation.
  4110. They will then be enabled immediately after the command operation is
  4111. completed.
  4112.  
  4113. You can also disable 32-bit instructions all the time by using the PKNO386
  4114. environment variable.  To set the environment variable, type PKNO386=ON.  If
  4115. the string PKNO386 is present in the environment, then PKZIP (and PKUNZIP)
  4116. will not use 32-bit instructions or registers.
  4117.  
  4118. To enable 32-bit instructions after they have been disabled, type:
  4119.  
  4120.    SET PKNO386=[ENTER].
  4121.  
  4122. If you have persistent problems with another piece of software interfering with
  4123. PKZIP, and you cannot upgrade or discard that software, you may turn off 32-bit
  4124. instructions in the configuration file.  The pkzip.cfg option line is:
  4125.  
  4126.    386=DISABLE
  4127.  
  4128. Note that the configuration file is read only by PKZIP.  PKUNZIP can only be
  4129. set permanently by use of the environment variable.
  4130.  
  4131. You may override the configuration file or environment variable on PKZIP by
  4132. using a -3+ option.  This will cause PKZIP to use 32-bit instructions
  4133. regardless of the environment variable being set, or an entry in the
  4134. configuration file.
  4135.  
  4136. _____________________________________
  4137. -^   Echo the command line
  4138.  
  4139. This option is used to display the PKZIP command that you entered on the
  4140. console.  It is useful when you are debugging an application or batch file
  4141. which calls PKZIP.  The file specifications that you entered will be echoed on
  4142. the console along with the command output.
  4143.  
  4144. In this example, technical information about all of the *.doc files included
  4145. in the DOCS.ZIP file will be displayed.  The information will be sorted by
  4146. date, and the command line will be redisplayed on the screen above the output.
  4147.  
  4148.    E:\>pkzip docs.zip -vd -^ *.doc
  4149.  
  4150.  
  4151. ════════════════════════════════════════════════════════════════════════════
  4152. 102                           Trouble Shooting                       PKZIP 2
  4153.  
  4154.  
  4155. _____________________________________
  4156. -+   Disable EMS usage
  4157. --   Disable XMS/UMB usage
  4158.  
  4159. To use EMS/XMS/UMB features PKZIP and PKUNZIP require:
  4160.  
  4161. -> XMS version 2.0 or greater
  4162.  
  4163. -> EMS LIM 4.0 or greater
  4164.  
  4165. An XMS driver is required in order to have UMB and HMA support available.
  4166.  
  4167. PKZIP/PKUNZIP will use up to 256K of EMS memory.  If you are in a situation
  4168. where you need to preserve EMS memory for other use, such as when running a
  4169. multi-node BBS system, you may wish to disable this feature.
  4170.  
  4171. A conflict with your XMS/EMS driver can be eliminated by disabling EMS usage.
  4172. Problems relating to EMS usage would manifest themselves as:
  4173.  
  4174. -> Unexplainable machine lock-up.
  4175.  
  4176. -> Receiving "Warning:Bad Table" and "File fails CRC check" for every file in
  4177.    a .ZIP file being extracted.
  4178.  
  4179. EMS or XMS usage can be turned off in the configuration file with the
  4180. pkzip.cfg option:
  4181.  
  4182.    EMS=DISABLE
  4183.  
  4184.    XMS=DISABLE
  4185.  
  4186. If EMS has been disabled in the configuration file, you may force usage back
  4187. on with the -++ option.
  4188.  
  4189. If XMS has been disabled in the configuration file, you may force usage back
  4190. on with the --+ option.
  4191. _____________________________________
  4192. -~   Disable Network detection
  4193.  
  4194. When this option is specified, Network specific operations are disabled.  If
  4195. you feel you are experiencing problems due to a conflict with the Network
  4196. specific operations use this option.
  4197.  
  4198. If the problem is persistent enough that you wish to disable Network
  4199. operations all the time, you may do so with a configuration file command:
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207. ════════════════════════════════════════════════════════════════════════════
  4208. PKWARE Inc.                   Trouble Shooting                           103
  4209.  
  4210.  
  4211.    NET=DISABLE
  4212.  
  4213. If Network support has been disabled in the configuration file, you may force
  4214. usage back on with the -~+ option.
  4215. _____________________________________
  4216. -)   Disable DPMI Support
  4217.  
  4218. PKZIP and PKUNZIP require 32-BIT DPMI 0.90 or greater.
  4219. DPMI support uses an extra 6.5K of conventional or UMB memory.  If you are
  4220. extremely tight on memory you may wish to disable DPMI support.
  4221. If a failure occurs in the DPMI Support it can be disabled with this option.
  4222.  
  4223.    DPMI=DISABLE
  4224.  
  4225. If DPMI has been disabled in the configuration file, you may force usage back
  4226. on with the -)+ option.
  4227. _____________________________________
  4228. -(   Use "Slow" MemCopy
  4229.  
  4230. Some computers suffer from a flaw that causes them to have errors when
  4231. performing simple MemCopy functions.  This problem is generally caused the the
  4232. manufacturer's use of inferior grades or speeds of RAM chips for the external
  4233. CPU memory cache on the motherboard.
  4234.  
  4235. This behavior will most commonly be seen on on relatively fast machines
  4236. (486/25 and higher).
  4237.  
  4238. This feature is only available on 486 (or higher) CPU's.
  4239.  
  4240. This problem will most frequently exhibit itself in the form of unexplainable
  4241. CRC failures.
  4242.  
  4243. Use of this switch causes PKZIP to manipulate memory in a way that is less
  4244. susceptible to this problem.  Note that the added overhead in this process may
  4245. slow down PKZIP by 20% to 40%.
  4246.  
  4247.    SLOWMEMCOPY=ON
  4248.  
  4249. If normal MemCopy has been disabled in the configuration file, you may force
  4250. usage back on with the -(+ option.
  4251.  
  4252. PKUNZIP has been designed to be mostly immune to this problem.
  4253.  
  4254. Please note that the external CPU cache has no relation to printer or disk
  4255. caches.
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263. ════════════════════════════════════════════════════════════════════════════
  4264. 104                           Trouble Shooting                       PKZIP 2
  4265.  
  4266.  
  4267. PKWARE CUSTOMER SUPPORT FORM
  4268. ════════════════════════════════════════════════════════════════════════════
  4269.  
  4270. Please photocopy and complete this form as completely as possible before
  4271. contacting our customer support.  By providing this information you help us to
  4272. provide assistance in an efficient and exact manner.
  4273.  
  4274. It is recommended that you first fax this form, then call PKWARE customer
  4275. support. Indicate on this form that you will be calling.
  4276.  
  4277. If sending your problem by fax only, please specify how you would like to be
  4278. contacted.
  4279.  
  4280. **Please Print or Type, use "fine" fax mode if possible.**
  4281.  
  4282. PKWARE Inc.
  4283. 9025 N. Deerwood Dr.
  4284. Brown Deer, WI  53223
  4285. (414)354-8699
  4286. (414)354-8559 FAX
  4287. (414)354-8670 BBS
  4288.  
  4289. Problem Description
  4290.  
  4291. Be sure to include the following.  Use as many additional sheets as necessary
  4292.  
  4293. -> What you are trying to do
  4294.  
  4295. -> What do you expect to happen
  4296.  
  4297. -> What did happen and why it is a problem
  4298.  
  4299. -> Copies of CONFIG.SYS, AUTOEXEC.BAT and any error messages
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319. ════════════════════════════════════════════════════════════════════════════
  4320. PKWARE Inc.                   Trouble Shooting                       105-106
  4321.  
  4322. ERROR MESSAGES
  4323. ════════════════════════════════════════════════════════════════════════════
  4324. The following error messages may appear when using PKZIP. When the word
  4325. "WARNING" appears in the message, program execution will continue. Otherwise
  4326. the program will abort to DOS.
  4327.  
  4328. Each warning message is prefaced with an error code.  This error code consists
  4329. of the letter 'E' or 'W' and a number.  The letter corresponds to whether the
  4330. error indicates a "Warning" or "Error" condition.  The number corresponds to
  4331. the DOS error level that would be returned.
  4332.  
  4333. Errors are listed in order of return code or warning level.
  4334.  
  4335. A brief explanation of each message follows.
  4336.  
  4337.  
  4338.  
  4339. PKZIP Error Messages
  4340. ~~~~~~~~~~~~~~~~~~~~
  4341.  
  4342. PKZIP: (E01) Can't create: XXXXX.
  4343.  
  4344. The named file could not be created.  Either the target directory is full or
  4345. the file already exists and is read-only or locked by another application. On
  4346. a Network you may receive this message if you do not have file creation rights
  4347. in the directory.
  4348.  
  4349.  
  4350. PKZIP: (E[2,3]) XXXXX.ZIP - error in ZIP, use PKZIPFIX.
  4351.  
  4352. The named .ZIP file has a corrupted file index.  Use PKZIPFIX to attempt
  4353. reconstruction of the .ZIP file.  In some cases the damage to the .ZIP file
  4354. may be very extensive.  If the file is too badly damaged PKZIPFIX will not be
  4355. able to recover the file.
  4356.  
  4357. NOTE: Many novice users receive this message because of improper command line
  4358. syntax.  If you specify a command line with only one file name following PKZIP
  4359. and it is NOT a .ZIP file you will receive this message.  PKZIP assumes that
  4360. the file is a .ZIP file because you specified it as the first file name on the
  4361. command line, and it attempts to place all files from the current directory
  4362. into that file.  Upon examination of the file it will not find any .ZIP file
  4363. information (due to its not being a .ZIP file) and will then report this
  4364. message.  Please see the tutorial for further information.
  4365.  
  4366.  
  4367. PKZIP: (E[4-11]) Insufficient memory.
  4368.  
  4369. Insufficient memory is available to process the .ZIP file. Try making more
  4370. memory available to PKZIP.  If this does not rectify the problem then the .ZIP
  4371. file might be corrupted and PKZIPFIX should be used to fix the .ZIP file.  If
  4372. you are creating a new .ZIP file and receive this
  4373.  
  4374.  
  4375. ════════════════════════════════════════════════════════════════════════════
  4376. PKWARE Inc.                    Error Messages                            107
  4377.  
  4378. message, it is due to an attempt to ZIP a large number of files.  Reduce the
  4379. scope of your command and try again.  If you are using a LIST file in your
  4380. PKZIP command you may be receiving this error because the LIST file is too
  4381. large.  See "List Files" for more information.
  4382.  
  4383. PKZIP:  (E12) No file(s) found.
  4384.  
  4385. No matching files were found to list using the View option.  This means the
  4386. filespec you specified on the command line has no match within the .ZIP file.
  4387.  
  4388. PKZIP: (E12) No files specified for deletion!
  4389.  
  4390. The -d (Delete) option was specified but no filenames were given to delete.
  4391. This option does NOT default to *.* if no filenames are given.  See the -d
  4392. option on page 32 for further information.
  4393.  
  4394. PKZIP: (E12) Nothing to do!
  4395.  
  4396. No matching files, or files with the specified attributes, or files after the
  4397. specified date etc., were found to compress.  Often you will receive this
  4398. message because the command line you entered is not correct.  Check the exact
  4399. name of the file you are specifying as well as the path, if any.
  4400.  
  4401. PKZIP: (E13) Can't find:  XXXXX.ZIP.
  4402.  
  4403. The named .ZIP file could not be found.  Either it does not exist or is not in
  4404. the specified directory.
  4405.  
  4406. PKZIP: (E14) Insufficient disk space for ZIP comment.
  4407.  
  4408. There is insufficient disk space to hold the comment as entered. You will need
  4409. to move the .ZIP file somewhere with more free space, or clear up more storage
  4410. space in its current location.  Note that a temporary copy of the .ZIP file is
  4411. not created.  The .ZIP file comment is appended directly to the existing .ZIP
  4412. file.
  4413.  
  4414. PKZIP: (E14) Insufficient disk space for updated file:  XXXXX.ZIP.
  4415.  
  4416. The -b option was used, and there is not enough space on the original drive
  4417. containing the .ZIP file to receive the updated .ZIP file.  (The update
  4418. operation has added additional or larger files to the .ZIP file, causing it to
  4419. grow larger than the original).  Try to free up some space on the drive
  4420. containing the .ZIP file, and retry the operation.  Also, make sure that the
  4421. drive specified with the -b option is different than the drive containing the
  4422. .ZIP file.
  4423.  
  4424. PKZIP: (E14) Disk full, file:  XXXXX.
  4425.  
  4426. A disk full error occurred while writing to the specified file.  Try freeing
  4427. up some disk space on the target drive.  Also, see the -b option and the PKTMP
  4428. environment variable.
  4429.  
  4430.  
  4431. ════════════════════════════════════════════════════════════════════════════
  4432. 108                            Error Messages                        PKZIP 2
  4433.  
  4434.  
  4435. PKZIP: (E15) Can't open XXXXX.ZIP for write access!
  4436.  
  4437. The named .ZIP file is read-only or locked by another application and can not
  4438. be modified.  This may also occur on a Network drive if you do not have
  4439. adequate access to that file to allow you to modify it.
  4440.  
  4441.  
  4442. PKZIP: (E17) Too many files!
  4443.  
  4444. An attempt was made to compress more than 16,383 files at one time.  This
  4445. message could be received if you update a .ZIP file which has a corrupted
  4446. central end directory.
  4447.  
  4448.  
  4449. PKZIP: (E24) Fatal EMS error: XXXXXXXX
  4450. PKZIP: (E25) Fatal XMS error: XXXXXXXX
  4451.  
  4452. An error has occured in the interaction between PKZIP and your EMS or XMS
  4453. handler.  You may have a faulty EMS/XMS driver.
  4454.  
  4455. To be able to use PKZIP in spite of this problem, disable EMS/XMS usage with
  4456. either the - + or - - option or the configuration file options EMS=DISABLE and
  4457. XMS=DISABLE.
  4458.  
  4459. Please contact PKWARE Technical Support with a description of the situation in
  4460. which the error occured, the brand and version of your EMS driver, and the HEX
  4461. code printed at the end of this error message.
  4462.  
  4463.  
  4464. PKZIP: (E26) Warning!  DOS 3.0 or later needed to span disks
  4465.  
  4466. DOS versions below 3.0 do not support the features needed by PKZIP in order to
  4467. span a .ZIP file across multiple disks.  You will need to upgrade to a newer
  4468. version of DOS in order to make use of this feature.
  4469.  
  4470. PKZIP: (E27) Warning!  Non-removable or unsupported device
  4471.  
  4472. .ZIP files can only be spanned to a device which supports multiple storage
  4473. units (i.e. multiple floppy disks can be inserted in series into a floppy
  4474. drive). The device must also be a standard writable DOS device.  .ZIP files
  4475. may not be spanned onto a device such as a Hard drive which cannot be removed.
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.  
  4487. ════════════════════════════════════════════════════════════════════════════
  4488. PKWARE Inc.                    Error Messages                            109
  4489.  
  4490. PKZIP Warning Messages
  4491. ~~~~~~~~~~~~~~~~~~~~~~
  4492.  
  4493. PKZIP: (W01) Warning!  Can't open XXXXX.CFG
  4494.  
  4495. When PKZIP runs it looks for a configuration file.  The three places that
  4496. PKZIP will look for it's configuration file are: The current directory, the
  4497. directory where PKZIP.EXE is located, and the directory pointed to by the
  4498. environment variable PKZIP.CFG.
  4499.  
  4500. If the PKZIP.CFG environment variable is set, and PKZIP cannot locat a
  4501. configuration file in any of the three places it looks, you will receive this
  4502. error message.
  4503.  
  4504.  
  4505. PKZIP: (W02) Warning!  Can't open XXXXX
  4506.  
  4507. This error usually occurs on Networks where you either do not have read access
  4508. to a file or another process/user has the file open in an exclusive mode.
  4509.  
  4510. If the file is held open by another process you may be able to overcome this
  4511. problem by using the -= switch.
  4512.  
  4513. PKZIP will exit with an error level of 18 when this warning is received.
  4514.  
  4515.  
  4516. PKZIP: (W03) Warning!  Can't delete XXXXX.
  4517.  
  4518. The -m (Move) option was specified to delete files after the .ZIP file was
  4519. constructed.  However, the named file could not be deleted, and is probably
  4520. read-only.  You may also receive this message if the file is on a network
  4521. drive and you do not have access to delete the file, or it is locked by
  4522. another application.
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543. ════════════════════════════════════════════════════════════════════════════
  4544. 110                           Error Messages                       PKZIP 2
  4545.  
  4546. PKUNZIP Error Messages
  4547. ~~~~~~~~~~~~~~~~~~~~~~
  4548.  
  4549. PKUNZIP: (E[4-8]) Warning!  Insufficient memory.
  4550.  
  4551. Insufficient memory is available to process the .ZIP file. Try making more
  4552. memory available to PKUNZIP.  If this does not rectify the problem, then the
  4553. .ZIP file might be corrupted, and PKZIPFIX should be used to fix the .ZIP
  4554. file.  The more files present in a .ZIP file, the more memory it will take to
  4555. process the file.
  4556.  
  4557. In some cases the .ZIP file may be too complex.  Too many files are contained
  4558. within the .ZIP file for PKZIP to handle.  This may occur if the .ZIP file is
  4559. created under an operating system other than DOS.
  4560.  
  4561.  
  4562. PKUNZIP: (E09) Can't open: XXXXX.ZIP.
  4563.  
  4564. The named .ZIP or list file(s) could not be found.  It does not exist, was
  4565. spelled incorrectly, or is not in the specified directory.
  4566.  
  4567.  
  4568. PKUNZIP: (E09) Can't find: XXXXX
  4569.  
  4570. PKUNZIP was unable to locate the specified .ZIP or @list file.  The filespec
  4571. specified was in error or a disk error has occured.
  4572.  
  4573.  
  4574. PKUNZIP: (E11) No file(s) found.
  4575.  
  4576. No files were found to extract, test, update or list.  The filespec specified
  4577. on the command line does not match any files present in the .ZIP file, or all
  4578. files found could not be extracted due to an incorrect password or
  4579. incompatible compression type.
  4580.  
  4581.  
  4582. PKUNZIP: (E50) Disk full, file:  XXXXX.
  4583.  
  4584. There is not enough free room on the destination drive/directory for the file
  4585. being extracted.  The program will abort and exit to DOS.
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599. ════════════════════════════════════════════════════════════════════════════
  4600. PKWARE Inc.                    Error Messages                            111
  4601.  
  4602. PKUNZIP Warning Messages
  4603. ~~~~~~~~~~~~~~~~~~~~~~~~
  4604.  
  4605. PKUNZIP: (W[01,02]) Warning! File has bad table
  4606.  
  4607. The Imploded file being tested or extracted has an error in its encoding.  The
  4608. file is probably corrupt or not a .ZIP file.  Files that have been damaged in
  4609. this way cannot be recovered.
  4610.  
  4611. PKUNZIP: (W03) Warning! File has bad table
  4612.  
  4613. The Reduced file being tested or extracted has an error in its encoding.  The
  4614. file is probably corrupt or not a .ZIP file.  Files that have been damaged in
  4615. this way cannot be recovered.
  4616.  
  4617. PKUNZIP: (W04) Warning!  XXXXX.ZIP - error in ZIP, use PKZIPFIX.
  4618.  
  4619. The named .ZIP file has a corrupted file index.  Use PKZIPFIX to reconstruct
  4620. the .ZIP file.  You may also receive this message if you attempt to extract a
  4621. file which is not a .ZIP file.
  4622.  
  4623. If the file is less than 22 bytes in length it cannot be a .ZIP file and the
  4624. "use PKZIPFIX" message will not be shown.
  4625.  
  4626. PKUNZIP: (W[05-07]) Warning! Insufficient memory
  4627.  
  4628. Insufficient memory is available to process the .ZIP file. Try making more
  4629. memory available to PKUNZIP.  If this does not rectify the problem, then the
  4630. .ZIP file might be corrupted, and PKZIPFIX should be used to fix the .ZIP
  4631. file.  The more files present in a .ZIP file, the more memory it will take to
  4632. process the file.
  4633.  
  4634. In some cases the .ZIP file may be too complex.  Too many files are contained
  4635. within the .ZIP file for PKZIP to handle.  This may  occur if the .ZIP file
  4636. was created under an operating system other than DOS.
  4637.  
  4638. PKUNZIP: (W08) Warning!  Can't open XXXXX.ZIP
  4639. PKUNZIP: (W09) Warning!  Can't open printer device
  4640.  
  4641. The named file or printer device could not be opened.  Either a disk error
  4642. occurred, or the file is locked by another application.  You may receive this
  4643. error on a network drive if you do not have read access to that file.
  4644.  
  4645. The printer device may not exist, or may be off-line.
  4646.  
  4647. PKUNZIP: (W10) Warning!  Can't create: XXXXX.
  4648. PKUNZIP: (W10) Warning!  Invalid file name: XXXXX.
  4649.  
  4650. The named file could not be created.  The output directory is invalid because
  4651. it does not exist, is spelled incorrectly, or is full.  You may also receive
  4652. this message on a Network drive if you do not have file creation rights there
  4653. or the directory is full.
  4654.  
  4655. ════════════════════════════════════════════════════════════════════════════
  4656. 112                           Error Messages                       PKZIP 2
  4657.  
  4658. In the case of an invalid file name error, the name stored in the .ZIP file is
  4659. invalid.  This may indicate a damaged .ZIP file, or one that has been tampered
  4660. with.
  4661.  
  4662. PKUNZIP: (W11) Warning!  I don't know how to handle:  XXXXX.
  4663.  
  4664. The file XXXXX is compressed or encoded in a way that this version of PKUNZIP
  4665. is unable to handle.  Either a different version of PKUNZIP is required to
  4666. properly extract this file, or the .ZIP file is possibly corrupted.
  4667.  
  4668. PKUNZIP: (W12) Skipping encrypted file.
  4669.  
  4670. Only the files that are password protected will be skipped (not extracted)
  4671. because they are encrypted and the correct password was not entered.
  4672.  
  4673. PKUNZIP: (W13) Warning!  Inconsistent local header for file:  XXXXX.
  4674.  
  4675. The local header for file XXXXX is different than the central header
  4676. information.  Use PKZIPFIX to reconstruct the .ZIP file.
  4677.  
  4678. PKUNZIP: (W14) Incorrect password for file.
  4679.  
  4680. The .ZIP file is password protected, and cannot be opened unless the correct
  4681. password is entered.  The password entered is not the correct password.  See
  4682. "Passwords" in the Advanced Features section for further information.
  4683.  
  4684. PKUNZIP: (W15) Warning!  File fails CRC check.
  4685.  
  4686. The CRC-32 check for the file being extracted or tested did not match the
  4687. stored value for the file.  The file is probably corrupted.  See the "Trouble
  4688. Shooting" section for more details.
  4689.  
  4690. PKUNZIP: (W16) Warning! File fails Authenticity Verification check
  4691.  
  4692. The .ZIP file is AV encoded but the AV could not be verified. Failure of AV
  4693. indicates a file which has been tampered with or damaged.  If the file has
  4694. failed the AV check the contents are suspect.
  4695.  
  4696. PKUNZIP: (W17) Warning! File fails Authenticity Verification check
  4697.  
  4698. The .ZIP file is AV encoded and has been tampered with or damaged.  File
  4699. should be discarded and a new copy obtained.
  4700.  
  4701. PKUNZIP: (W18) Warning!  File XXXXX already exists.  Overwrite (y/n/a/r)?
  4702.  
  4703. The file XXXXX already exists on the disk.  Pressing N will leave the original
  4704. file on the disk, and not extract the file from the .ZIP file.  Pressing Y
  4705. will extract the file from the .ZIP file, and overwrite the file on the disk.
  4706. If you want to overwrite this file, and ALL FOLLOWING FILES, press A for ALL.
  4707. If you wish to extract this file, but not overwrite an existing file, you may
  4708. press R for RENAME.  PKUNZIP will prompt you for a new name for the file.  See
  4709. Also: -o and -n options.
  4710.  
  4711. ════════════════════════════════════════════════════════════════════════════
  4712. PKWARE Inc.                    Error Messages                            113
  4713.  
  4714.  
  4715. PKUNZIP: (W19) Warning!  Invalid Shrunk file
  4716.  
  4717. The Shrunk file being tested or extracted has an error in its encoding.  The
  4718. file is probably corrupt or not a .ZIP file.  Files that have been damaged in
  4719. this way cannot be recovered.
  4720.  
  4721. PKUNZIP: (W20) Warning! Insufficient memory
  4722.  
  4723. Insufficient memory is available to process the .ZIP file. Try making more
  4724. memory available to PKUNZIP.  If this does not rectify the problem, then the
  4725. .ZIP file might be corrupted, and PKZIPFIX should be used to fix the .ZIP
  4726. file.  The more files present in a .ZIP file, the more memory it will take to
  4727. process the file.
  4728.  
  4729. PKUNZIP: (W21) Warning!  File has bad table.
  4730.  
  4731. The Deflated file being tested or extracted has an error in its encoding.  The
  4732. file is probably corrupt or not a .ZIP file.  Files that have been damaged in
  4733. this way cannot be recovered.
  4734.  
  4735. PKUNZIP: (W23) Warning!  File has bad table.
  4736.  
  4737. The Deflated file being tested or extracted has an error in its encoding (bad
  4738. block type).  The file is probably corrupt or not a .ZIP file.  Files that
  4739. have been damaged in this way cannot be recovered.
  4740.  
  4741. PKUNZIP: (W24) Warning!
  4742. You need PKUNZIP version: X.X or later to extract XXXXX
  4743.  
  4744. The file XXXXX is compressed or encoded in a way that this version of PKUNZIP
  4745. is unable to handle.  A more recent version of PKUNZIP is required to properly
  4746. extract this file.  The version number is listed as X.X.  Contact PKWARE for
  4747. upgrade information.
  4748.  
  4749. PKUNZIP: (W25) Warning! .ZIP file comment too big
  4750.  
  4751. The file comment attached to this .ZIP file is too large.  The .ZIP file can
  4752. still be handled normally but will not be displayed.
  4753.  
  4754. PKUNZIP: (W26) XXXXX.ZIP has errors.
  4755.  
  4756. The named .ZIP file had one or more errors detected in it.  This message is
  4757. displayed after PKUNZIP is finished acting upon a file.  You may receive this
  4758. message if you attempt to extract a file that is not a .ZIP file.
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767. ════════════════════════════════════════════════════════════════════════════
  4768. 114                           Error Messages                       PKZIP 2
  4769.  
  4770.  
  4771. ZIP2EXE Error Messages
  4772. ~~~~~~~~~~~~~~~~~~~~~~
  4773.  
  4774. ZIP2EXE: (E01) Error in .ZIP file
  4775. ZIP2EXE: (E02) Error in .ZIP file, use PKZIPFIX
  4776.  
  4777. The .ZIP file you are attempting to process is corrupt.  You may attempt
  4778. recovery of the file by using PKZIPFIX.  PKZIPFIX will work on either standard
  4779. .ZIP files or self-extracting .EXE files.
  4780.  
  4781. ZIP2EXE: (E03-04) Insufficient memory to process file
  4782.  
  4783. The .ZIP file you are attempting to process is too complex.  This may indicate
  4784. a .ZIP file which contains too many files.  In some cases you may receive this
  4785. error because the file being processed is corrupt.
  4786.  
  4787. ZIP2EXE: (E07) Can't open Source file
  4788.  
  4789. The source .ZIP or .EXE file specified on the command line cannot be opened
  4790. due to a disk error or insufficient network access.
  4791.  
  4792. ZIP2EXE: (E08) Error in .ZIP file
  4793.  
  4794. The .ZIP file you are attempting to process is corrupt.  You may attempt
  4795. recovery of the file by using PKZIPFIX.  PKZIPFIX will work on either standard
  4796. .ZIP files or self-extracting .EXE files.
  4797.  
  4798. ZIP2EXE: (E09) Disk full writing target file during EXE to ZIP process
  4799. ZIP2EXE: (E11) Disk full writing target file during ZIP to EXE process
  4800.  
  4801. During the process of converting a file there must be enough disk space
  4802. available to contain both the original file and the file which will be
  4803. created.  If there is not enough room to process the file on the current drive
  4804. you may direct the output to another drive by specifying it on the command
  4805. line.
  4806.  
  4807. ZIP2EXE: (E12) Compression method not supported
  4808.  
  4809. The .ZIP file being converted contains a file compressed with a method not
  4810. supported by the version of PKSFX being attached by ZIP2EXE.
  4811.  
  4812. You can only perform the ZIP2EXE process on .ZIP files created using the
  4813. compression method(s) supported by the self-extracting module you are
  4814. attaching.
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823. ════════════════════════════════════════════════════════════════════════════
  4824. PKWARE Inc.                    Error Messages                            115
  4825.  
  4826. PKSFX  Warning/Error Messages
  4827. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4828.  
  4829. PKSFX: (W01) File fails CRC checkPKSFX: (W01) Unknown compression method
  4830.  
  4831. A warning may indicate any of several problems.  See the corresponding PKUNZIP
  4832. error message for explanation.
  4833.  
  4834. PKSFX: (E03) Can't find .EXE file
  4835.  
  4836. The self-extractor was unable to locate itself.  When the self-extractor runs
  4837. it must determine what the name of its executable file is. Anything which can
  4838. prevent this from happening will generate this error.
  4839.  
  4840. This error usually indicates an incorrect installation of DOS on the target
  4841. machine.
  4842.  
  4843. PKSFX: (E[4-8]) Insufficient memory
  4844.  
  4845. Insufficient memory is available to process the .ZIP file. Try making more
  4846. memory available to the Self-extractor.  If this does not rectify the problem,
  4847. then the self-extracting file might be corrupted, and PKZIPFIX should be used
  4848. to fix the .EXE file.  The more files present in a self-extracting .ZIP file,
  4849. the more memory it will take to process the file.
  4850.  
  4851. PKSFX: (E09) Unable to locate listfile
  4852.  
  4853. The @list file specified on the command line could not be found.
  4854.  
  4855. PKSFX: (E13) Error in .EXE file
  4856.  
  4857. The self-extracting file is corrupt.  This may occur due to a disk error, a
  4858. transmission error, or a software problem.
  4859.  
  4860. PKSFX: (E50) Disk full
  4861.  
  4862. The self-extractor has run out of space while extracting the files it
  4863. contains.  You may either free up more disk space or direct the self-extractor
  4864. to place the files on a different drive.
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879. ════════════════════════════════════════════════════════════════════════════
  4880. 116                           Error Messages                       PKZIP 2
  4881.  
  4882. PKSFX/PKUNZIP Junior Error Messages
  4883. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4884.  
  4885. PKSFXJR: (W01) Warning error
  4886.  
  4887. A warning may indicate any of several problems.  See the corresponding PKUNZIP
  4888. error message for explanation.
  4889.  
  4890. PKSFXJR: (W02) Can't find .EXE file
  4891.  
  4892. The self-extractor was unable to locate itself.  When the self-extractor runs
  4893. it must determine what the name of its executable file is. Anything which can
  4894. prevent this from happening will generate this error.
  4895.  
  4896. This error usually indicates an incorrect installation of DOS on the target
  4897. machine.
  4898.  
  4899. PKSFXJR: (W03) Error in .EXE file
  4900.  
  4901. The self-extracting file is corrupt.  This may occur due to a disk error, a
  4902. transmission error, or a software problem.
  4903.  
  4904. PKSFXJR: (W04) File has a bad table
  4905.  
  4906. The compressed data is corrupt.  This can indicate a damaged self-extracting
  4907. file or data that was originally corrupt when the self-extracting file was
  4908. created.
  4909.  
  4910. PKSFXJR: (W05) Can't create file
  4911.  
  4912. The self-extractor was unable to create a file it intended to extract.  This
  4913. may occur because you either do not have sufficient rights to a directory, or
  4914. because all the directory entries are full.
  4915.  
  4916. PKSFXJR: (W06) Disk full
  4917.  
  4918. The self-extractor has run out of space while extracting the files it
  4919. contains.  You may either free up more disk space or direct the self-extractor
  4920. to place the files on a different drive.
  4921.  
  4922. PKSFXJR: (W07) Too many files
  4923.  
  4924. A junior self-extractor may only contain 512 or fewer files.  This error
  4925. indicates either that more than 512 files are within the self-extractor or
  4926. that the file is corrupt.
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935. ════════════════════════════════════════════════════════════════════════════
  4936. PKWARE Inc.                    Error Messages                            117
  4937.  
  4938. Error Levels
  4939. ~~~~~~~~~~~~
  4940.  
  4941. In order to enhance the power of using PKZIP and PKUNZIP from within another
  4942. program or within a batch file, they return error levels.  These error levels
  4943. are listed below.
  4944.  
  4945. **  Please note that if testing error levels in a batch file, DOS tests the
  4946.     error level not for equality, but for greater than or equal to.
  4947.  
  4948.  
  4949. PKZIP:
  4950.      0     No error.
  4951.      1     Bad file name or file specification.
  4952.      2,3   Error in .ZIP file.
  4953.      4-11  Insufficient Memory.
  4954.      12    No files were found to add to the .ZIP file, or no files
  4955.        were specified for deletion.
  4956.      13    File not found.  The specified .ZIP file or list file was
  4957.        not found.
  4958.      14    Disk full.
  4959.      15    .ZIP file is read-only and can not be modified.
  4960.      16    Bad or illegal parameters specified. (help screen displayed)
  4961.      17    Too many files.
  4962.      18    Could not open file.
  4963.      255   User pressed control-c or control-break
  4964.  
  4965.  
  4966. PKUNZIP:
  4967.      0     No error.
  4968.      1     Warning error (such as failed CRC check).
  4969.      2,3   Error in .ZIP file.
  4970.      4-8   Insufficient Memory.
  4971.      9     File not found.  No .ZIP files found.
  4972.      10    Bad or illegal parameters specified. (help screen displayed)
  4973.      11    No files found to extract/view etc.
  4974.      50    Disk Full.
  4975.      51    Unexpected EOF in .ZIP file.
  4976.      255   User pressed control-c or control-break
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991. ════════════════════════════════════════════════════════════════════════════
  4992. 118                           Error Messages                       PKZIP 2
  4993.  
  4994.  
  4995. ZIP2EXE:
  4996.      0     No error
  4997.      1     Error in .ZIP file
  4998.      2     Error in .ZIP file, use PKZIPFIX
  4999.      3-4   Insufficient memory to process file
  5000.      7     Can't open Source file
  5001.      8     Error in .ZIP file
  5002.      9     Disk full writing target file during EXE to ZIP process
  5003.      11    Disk full writing target file during ZIP to EXE process
  5004.      12    .ZIP file being converted contains a file compressed with a
  5005.        method not supported by the version of PKSFX being
  5006.        attached by ZIP2EXE
  5007.      13    User answered "NO" in response to an "overwrite(y/n)?" prompt
  5008.  
  5009.  
  5010. PKSFX:
  5011.      1     Warning error such as:
  5012.        File fails CRC check, Unknown compression method.
  5013.      3     Can't find .EXE file
  5014.      4-8   Insufficient memory
  5015.      9     Unable to located listfile
  5016.      12    User aborted at comment pausing "Extract now (y/n)?" prompt
  5017.      13    Error in .EXE file
  5018.      50    Disk full
  5019.  
  5020.  
  5021. PKSFX/PKUNZIP Junior:
  5022.      1     Warning error such as:
  5023.        File fails CRC check, Unknown compression method.
  5024.      2     Can't find .EXE file
  5025.      3     Error in .EXE file
  5026.      4     File has a bad table
  5027.      5     Can't create file
  5028.      6     Disk full
  5029.      7     Too many files
  5030.      8     User aborted at comment pausing "Extract now (y/n)?" prompt
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047. ════════════════════════════════════════════════════════════════════════════
  5048. PKWARE Inc.                    Error Messages                            119
  5049.  
  5050. PK SAFE ANSI
  5051. ════════════════════════════════════════════════════════════════════════════
  5052. PKSFANSI.COM
  5053.  
  5054. PKSFANSI (PK Safe ANSI) is a Terminate and Stay Resident program that disables
  5055. ANSI Keyboard Key Reassignments, thereby preventing "ANSI bombs" embedded in
  5056. any text file (such as README files) or output by any program.
  5057.  
  5058. Normally, ANSI sequences that redefine the keyboard could be hidden inside ANY
  5059. text file or program, and could be executed completely unnoticed until it is
  5060. too late.  PKSFANSI intercepts calls to the ANSI.SYS or other ANSI device
  5061. drivers, and filters out any keyboard reassignments, while allowing other ANSI
  5062. sequences through unaltered.
  5063.  
  5064. If a keyboard key reassignment is attempted, PKSFANSI will intercept the
  5065. sequence and discard it.  PKSFANSI also will BEEP to alert you that a
  5066. reassignment was attempted.
  5067.  
  5068. PKSFANSI requires less than 1k bytes resident RAM, and should work with any
  5069. ANSI driver, such as the standard ANSI.SYS driver, NANSI, ZANSI, DVANSI, etc.
  5070. Note that if you use a memory resident ANSI driver, such as the DESQview
  5071. DVANSI.COM driver, PKSFANSI should be loaded after the ANSI driver is loaded.
  5072.  
  5073. Usage
  5074.  
  5075. Add PK Safe ANSI to your AUTOEXEC.BAT command file.  Early in your
  5076. AUTOEXEC.BAT file add the line:
  5077.  
  5078.    C:\PKWARE\PKSFANSI.COM This will cause the PK Safe ANSI TSR to be
  5079.  
  5080. loaded into memory, allowing you to safely use ANSI codes.  Once this is
  5081. installed you may wish to turn on ANSI in your PKZIP configuration file. There
  5082. should be this line present in your PKZIP.CFG file:
  5083.  
  5084.    ANSI=ENABLED
  5085.  
  5086. To turn on ANSI for a particular PKZIP operation, or for a PKUNZIP operation,
  5087. use the command option -q.
  5088.  
  5089.    pkunzip -v test.zip -q
  5090.  
  5091.  
  5092.  
  5093.  
  5094.  
  5095.  
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103. ════════════════════════════════════════════════════════════════════════════
  5104. 120                            PK SAFE ANSI                          PKZIP 2
  5105.  
  5106.  
  5107. Monochrome
  5108.  
  5109. Option PK Safe ANSI has one option.  This option will cause PK Safe ANSI to
  5110. discard color codes.  This is useful if you are using a laptop computer with a
  5111. monochrome display.
  5112.  
  5113.    PKSFANSI -c
  5114.  
  5115. Please note that this only affects programs which use ANSI for their display
  5116. control.
  5117.  
  5118. NOTE: PK Safe Ansi is included with the registered version of the software.
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159. ════════════════════════════════════════════════════════════════════════════
  5160. PKWARE Inc.                     PK SAFE ANSI                             121
  5161.  
  5162.  
  5163. INDEX
  5164. ════════════════════════════════════════════════════════════════════════════
  5165.  
  5166.  
  5167. -! Use AV feature                              44
  5168.  
  5169. 32-bit Instructions, Disabling                 102
  5170. 386/486 Instructions                           See 32-Bit 102
  5171. @List files                                    45
  5172. @List                                          See List Files
  5173.  
  5174.  ---
  5175. | A |
  5176.  ---
  5177.  
  5178. Addendum File                                  7
  5179. ANSI
  5180.        Comments, enabling
  5181.      and disabling                         37
  5182.        Enabling during PKUNZIP                 52
  5183. Archive file structure                         95
  5184. Archive attribute
  5185.        -a+ Turn off archive attribute
  5186.      of added files                        30
  5187.        Defined                                 34
  5188.        Clearing                                30
  5189.        Turning off (-i)                        34
  5190. Attrib DOS command                             27
  5191. Authenticity Verification                      See AV
  5192. AUTOEXEC.BAT, Changes to                       6
  5193. AV
  5194.        Application form                        81
  5195.        Defined                                 78, 85
  5196.        Using                                   78, 79
  5197.        PUTAV                                   78
  5198.  
  5199.  ---
  5200. | B |
  5201.  ---
  5202.  
  5203. Bad Command or Filename                        82
  5204. Bad Table                                      89
  5205. Banner, PKZIP                                  10, 23
  5206. BBS
  5207.        PKWARE                                  3
  5208.        Support Conferences                     3
  5209. Bracket
  5210.        Angle                                   2
  5211.        Square                                  2
  5212. Brief View                                     40
  5213.  
  5214.  ---
  5215. | C |
  5216.  ---
  5217.  
  5218. Cache failure (CPU)                            Slow MemCopy 104
  5219. Checking a .ZIP file                           See Testing
  5220. Command Syntax                                 2
  5221. Comment
  5222.        .ZIP file                               27 - 28, 43-44
  5223.        Adding                                  31
  5224.        Displaying                              28
  5225.        Maximum size                            28, 43
  5226.        Per file                                27
  5227. Compatibility mode                             47
  5228. Compression
  5229.        Displaying method                       41
  5230.        How it works                            91-95
  5231.        Lossy and Lossless                      83
  5232.        Specifying Method                       32
  5233.        Speed vs. Size                          21-23
  5234.        Theory                                  91-95
  5235.        Type                                    23
  5236. Configuration options                          76
  5237. Configuring PKZIP                              74-77
  5238. Console, extracting file to                    48
  5239. Conventions                                    1
  5240. CRC
  5241.        Defined                                 11
  5242.        Failures explained                      87
  5243.        Failures, disabling 32-bit
  5244.      instructions                          102
  5245.        Viewing                                 40-41
  5246. Creating file comments                         31
  5247. Customer Support                               3, 105-106
  5248. Customer Support Form                          106
  5249. Cyclic Redundancy Check                        See CRC
  5250.  
  5251.  ---
  5252. | D |
  5253.  ---
  5254.  
  5255. Date
  5256.        Compressing by range                    38-39
  5257.        Format                                  38-39
  5258.        of .ZIP file                            36
  5259. Delete
  5260.        Files while compressing                 32, 12-13
  5261.        From a .ZIP file                        19,32
  5262.        Files with a list file                  67
  5263. Directory
  5264.        of a .ZIP file                          40-41
  5265.        Restoring structure                     48-49
  5266.                            See also Path
  5267. Disable ANSI                                   37
  5268. Disk Full, Overcoming                          30-31
  5269. Disk Space, Conserving                         30-31, 32
  5270. Don't Know How to Handle                       86
  5271. DPMI, Disabling                                104
  5272.  
  5273.  ---
  5274. | E |
  5275.  ---
  5276.  
  5277. EMS, Disabling                                 103
  5278. Encryption                                     38
  5279.        Decrypting encrypted files              53
  5280.        Lost password, what to do.              86
  5281.        Security                                72-73
  5282.        Using                                   68
  5283. Error Levels
  5284.   (Exit Codes)                                 118
  5285.        PKSFX                                   119
  5286.        PKSFX/PKUNZIP Junior                    119
  5287.        PKUNZIP                                 118
  5288.        PKZIP                                   118
  5289.        ZIP2EXE                                 119
  5290. Error Messages                                 107 - 119
  5291.        Error Levels                            118
  5292.        PKSFX                                   116
  5293.        PKSFX Junior                            117
  5294.        PKUNZIP                                 111-114
  5295.        PKUNZIP Junior                          117
  5296.        PKZIP                                   107-109
  5297.        ZIP2EXE                                 115
  5298.  
  5299. Exclude
  5300.        Files from extraction                   55
  5301.        From ZIP process                        43
  5302.        List files from extraction
  5303.      process                               55
  5304.        List files from ZIP process             43
  5305. Exit Codes                                     See Error Levels
  5306. Extra Compression                              32-33
  5307. Extract
  5308.        Files to printer                        52
  5309.        In sorted order                         49-50
  5310.        Newer files only                        51
  5311.        To console                              48
  5312. Extracting files                               13
  5313.  
  5314.  ---
  5315. | F |
  5316.  ---
  5317.  
  5318. Fast Compression                               32-33
  5319. File Attributes
  5320.        Defined                                 26
  5321.        Masking                                 34-35
  5322.        Masking during extraction               51
  5323.        Restoring during extraction             51
  5324.        Retaining                               34-35
  5325.        Storing                                 26
  5326.        Viewing                                 40-41
  5327. File Comments                                  27-28
  5328. File List                                      See List File
  5329. Freshen                                        83
  5330.        a .ZIP file                             33-34
  5331.        Files in extract directory              50
  5332.  
  5333.  ---
  5334. | H |
  5335.  ---
  5336.  
  5337. Help
  5338.        Displaying help screen (-h)             34, 50
  5339.        For PKUNZIP (-h)                        50
  5340.        Trouble Shooting                        101 - 106
  5341. Hidden Files                                   34-35
  5342.        Compressing                             26, 42
  5343.        Restoring                               51
  5344.  
  5345.  ---
  5346. | I |
  5347.  ---
  5348.  
  5349. Inconsistent Local Header                      89
  5350. Information Content                            91-92
  5351. Installation                                   5 - 7
  5352.  
  5353.  ---
  5354. | J |
  5355.  ---
  5356.  
  5357. Junior
  5358.        Error Messages                          117
  5359.        PKSFX                                   57-58
  5360.        PKUNZIP                                 58
  5361.  
  5362.  ---
  5363. | L |
  5364.  ---
  5365.  
  5366. Label, Volume                                  See Volume Label
  5367. List Files
  5368.        Excluding                               43
  5369.        @List File                              45
  5370.        Excluding from Extraction               55
  5371.        Generating                              46-47, 56, 65
  5372.        Maximum size                            45, 66
  5373.        Possible contents of                    63
  5374.        Reading                                 64-65
  5375.        Specifying                              44-45
  5376.        Using for compression                   64
  5377. Locked files, Overcoming with -=               47
  5378.  
  5379.  ---
  5380. | M |
  5381.  ---
  5382.  
  5383. Manual Conventions                             1
  5384. Maximum
  5385.        Number of files in a .ZIP file          89
  5386.        Size of .ZIP file comment               43-44
  5387.        Size of list file                       45, 66
  5388. Maximum Compression                            32-33
  5389. Memory
  5390.        Requirements of PKSFX                   62
  5391.        Usage of PKZIP                          89
  5392. Multi-Volume                                   See also PKZIP Backup Guide
  5393.  
  5394.  ---
  5395. | N |
  5396.  ---
  5397.  
  5398. Network
  5399.        Disabling Network detection             103-104
  5400.        Failure of PKZIP on server              88
  5401.        Overcoming file locking                 47
  5402. Never overwrite files                          51
  5403. New files, Extracting                          51
  5404. Normal Compression                             32-33
  5405.  
  5406.  ---
  5407. | O |
  5408.  ---
  5409.  
  5410. Optimizing PKZIP                               89
  5411. Order
  5412.        of extraction                           49-50
  5413.        of View sort                            40-42
  5414. Overwriting files (-o)                         51
  5415.  
  5416.  ---
  5417. | P |
  5418.  ---
  5419.  
  5420. Password                                       See Encryption
  5421. Path
  5422.        Defined                                 5
  5423.        Extracting from a .ZIP file             18
  5424.        Modifying                               6
  5425.        Restoring                               84
  5426.        Restoring structure                     48-49
  5427.        Storing                                 36-37
  5428.        Storing in a .ZIP file                  16
  5429.        Storing with recursion                  37-38
  5430. PK Safe ANSI                                   120
  5431. PKSFX
  5432.        Command Summary                         59
  5433.        Creating a Self-Extracting file         57
  5434.        Error Messages                          116
  5435.        Junior                                  57-58
  5436.        Legal Use of                            61
  5437.        Memory Requirements                     62
  5438.        Options                                 59
  5439.        Sending to somone else                  60-61
  5440. PKTMP                                          47, 89
  5441.  
  5442. PKUNZIP
  5443.        -$ Restore Volume Label                 55
  5444.        -@ Generate List file                   56
  5445.        -c extract files to console             48
  5446.        -d Restore directory structure          48-49
  5447.        -e Sorted extraction                    49-50
  5448.        -f Freshen extract directory            50
  5449.        -j Mask of file attributes              51
  5450.        -n Extract only newer files             51
  5451.        -o Overwriting files                    51
  5452.        -o- Never overwrite files               51
  5453.        -p Extract files to the printer         52
  5454.        -q ANSI disabling/enabling              52-53
  5455.        -s Extract encrypted files              53
  5456.        -t Test .ZIP file integrity             54
  5457.        -v View a .ZIP file                     55
  5458.        -x Exclude files                        55
  5459.        Error Messages                          111
  5460.        Junior                                  58
  5461.        Warning Messages                        112-114
  5462.  
  5463. PKZIP
  5464.        -! Use AV                               44
  5465.        -$ Store Volume label                   46
  5466.        -& Create multi-volume archive          45-46
  5467.        -= File compatibility mode              47
  5468.        -@ generate List file                   46
  5469.        -a+ Turn off archive attribute
  5470.         of added files                     30
  5471.        -ac Create/Edit file comments           31-32
  5472.        -b Create temporary .ZIP file           30-31
  5473.        -C Add file comments to new
  5474.         files only                         31-32
  5475.        -c Create/Edit file comments            31-32
  5476.        -d Deleting files from a .ZIP file      32
  5477.        -e[x|n|f|s|0] Specify
  5478.        compression method                  32-33
  5479.        -f Freshen file in a .ZIP file          33-34
  5480.        -i Add files that have the
  5481.       archive attribute                    34
  5482.        -jh,r,s Specify masking of file
  5483.       attributes  34-35
  5484.        -k Retain original .ZIP file date       35
  5485.        -m Move file                            35-36
  5486.        -o Set .ZIP file date                   36
  5487.        -P Preserve specified and
  5488.        recursed path                       36-37
  5489.        -q ANSI comments                        37
  5490.        -r Recurse subdirectories               37-38
  5491.        -s Encrypt files                        38
  5492.  
  5493.        -t Take files according to date         38-39
  5494.        -u Update files                         39-40
  5495.        -v View files                           40-42
  5496.        -W Specify hidden and
  5497.        system files                        42-43
  5498.        -x Exclude files                        43
  5499.        -z Create or modify .ZIP file
  5500.        comment                             43-44
  5501.        @ specify list file                     45
  5502.        Banner                                  23
  5503.        Configuration file                      74-77
  5504.        Error Messages                          107-109
  5505.        How does it work?                       91-100
  5506.        Simple Commands                         10
  5507.        Warning Messages                        110
  5508. PKZIP Configuration File                       75
  5509. PKZIP Configuration Program                    74
  5510. PKZIP.CFG                                      75
  5511. PKZIPFIX                                       See the PKZIP Backup Guide
  5512. Printer, Extracting files to                   24, 52
  5513. Printer Dump                                   24
  5514. Product Support                                3
  5515. PUTAV                                          See AV
  5516.  
  5517.  ---
  5518. | R |
  5519.  ---
  5520.  
  5521. Read Only
  5522.        Defined                                 26
  5523.        Files                                   34-35
  5524.        Restoring files                         51
  5525.        Storage of attribute                    26
  5526. Reading, Suggested                             29
  5527. Recurse subdirectories                         37-38
  5528. Restoring Volume Label                         55
  5529.  
  5530.  ---
  5531. | S |
  5532.  ---
  5533.  
  5534. Scramble                                       See Encryption
  5535. Self-extracting                                57
  5536. Sort
  5537.        Order of extraction                     49-50
  5538.        Order of View                           40-42
  5539. Speed Of Compression                           21
  5540. Speed vs. Size, Theory                         21, 95
  5541. Storing (archive method)                       32-33
  5542. Subdirectories                                 84
  5543.        Storing                                 36-38
  5544. Suggested Reading                              29
  5545. Super Fast compression                         32-33
  5546. Support, Technical                             3
  5547. Syntax                                         2
  5548. System Files                                   34-35
  5549.        Restoring                               51
  5550.        Compressing                             42-43
  5551.  
  5552.  ---
  5553. | T |
  5554.  ---
  5555.  
  5556. Technical Support, CompuServe                  3
  5557. Technical View                                 40-42
  5558. Temporary  .ZIP file location                  30-31
  5559. Testing                                        15, 54
  5560.        .ZIP files                              54
  5561. Tree   Storing structure                       18-19
  5562. Tutorial                                       8 - 29
  5563.  
  5564.  ---
  5565. | U |
  5566.  ---
  5567.  
  5568. Update                                         83
  5569.        See also Freshen
  5570.        Update files                            39-40
  5571.  
  5572.  ---
  5573. | V |
  5574.  ---
  5575.  
  5576. View
  5577.        a .ZIP file                             11-12
  5578.        Compressed files                        25
  5579.        Options                                 40-42
  5580.        Sort order                              42
  5581. Volume Label
  5582.        Defined                                 25
  5583.        Restoring                               55
  5584.        Saving and Restoring                    25
  5585.        Storing                                 46
  5586.  
  5587.  ---
  5588. | W |
  5589.  ---
  5590.  
  5591. Wildcards
  5592.        Defined                                 8
  5593.                            See DOS manual for usage
  5594.  ---
  5595. | X |
  5596.  ---
  5597.  
  5598. XMS, Disabling                                 103
  5599.  
  5600.  ---
  5601. | Z |
  5602.  ---
  5603.  
  5604. .ZIP file , Date                               35
  5605. .ZIP file comment                              43-44
  5606. ZIP2EXE                                        57
  5607.        Error Messages                          115
  5608.  
  5609.  
  5610.