ADDENDUM to PKZIP 2 Manual
----- ----- ----------------
This file contains the most up-to-date information, additions and
changes to the PKZIP version 2 manual.
AUTHENTICITY VERIFICATION FEATURE
-------- ----- ------
The Authenticity Verification information you receive from PKWARE
will include two AV Serial Numbers and one checksum. The Serial
Numbers and checksum include BOTH letters and numbers. ALL
LETTERS are LOWER CASE, with the exception of the letter L. The
letter L will be printed in upper case to avoid confusion with
the number one.
After both Serial Numbers are ente 747t1911h red using the PUTAV.EXE, the
program will return a checksum value. This checksum must match
the one provided by PKWARE. If the checksums do not match, then
the installation was not performed correctly and PUTAV.EXE should
be run again to ensure that the Serial Numbers and Name were
entered correctly.
If you run PUTAV.EXE and you encounter the error, "WRONG VERSION
OF PKZIP.EXE", verify that you are running PUTAV on the
REGISTERED version of PKZIP.EXE.
AVEXTRA.TXT
-----------
With the PKZIP 2 Authenticity Verification feature, additional
text can be displayed on subsequent lines following the
verification message. An ASCII text file named AVEXTRA.TXT is
created containing the additional text you want displayed. When
the AVEXTRA.TXT file is in the current directory when you use the
"PKZIP -!" option, PKZIP will add this text to the .ZIP file and
PKUNZIP will display it after the normal Authenticity
Verification message. The Authenticity Verification feature is
available only to registered users of PKZIP.
SELF-EXTRACTING FILES ACROSS MULTIPLE DISKETTES
-------- ----- ------ ----- ----- ----
PKZIP 2 has the ability to compress a large .ZIP file across
multiple diskettes.
Self-extracting files CAN NOT span multiple disks. This would
make the PKSFX code extremely large.
A simple batch file can be created that would uncompress across
multiple diskettes. All that would be required is to have the
batch file follow this procedure:
1. Create a batch file called install.bat
2. Edit install.bat and in that file have the following line:
pkunzip -d a:program c:\test
This batch file would create the directory C:\TEST on your
computer and then unzip the file called PROGRAM.ZIP into the c:\test
directory. PKUNZIP will prompt the user to enter the diskettes
in the extraction order.
PKCFG.EXE
---------
* PKCFG.EXE is only included in the registered version of PKZIP.
PKZIP.EXE can have many of its features configured with a
configuration file called PKZIP.CFG. This configuration file can
be located in either your current directory, a directory
specified with the environment variable PKZIP.CFG, or in the
directory that PKZIP.EXE is located. PKZIP.EXE will search for the
configuration in each location in the order listed above. This
means that you may have a default configuration file that is
easily overridden by using a configuration file in either of the
first two locations. Any option that is set in the configuration
file may be overridden from the command line. The configuration
file may be created manually with a text editor.
The PKCFG.EXE program will look for an existing configuration file
in the same locations and order that PKZIP.EXE would look. If the
PKCFG.EXE program finds an existing configuration file it will load
it. The existing configuration values will be shown in the place of
the defaults. A list of options will be displayed on the screen,
and a highlighted cursor indicates the option that you can
modify.
PK SAFE ANSI
-----------
* PKSFANSI.COM is only included in the registered version of PKZIP.
Another program included with registration of PKZIP 2 is called
PKSFANSI.COM. PKSFANSI is a terminate and stay resident program
that disables ANSI keyboard key Reassignments, thereby preventing
ANSI "bombs" embedded in any text file (such as README files) or
output by any program. Normally, ANSI sequences that redefine
the keyboard could be hidden inside ANY text file or program, and
could be executed completely unnoticed until it is too late.
PKSFANSI intercepts calls to the ANSI.SYS or other ANSI device
drivers, and filters out any keyboard reassignments, while
allowing other ANSI sequences through unaltered. If a keyboard
reassignment is attempted, PKSFANSI will intercept the sequence
and discard it. PKSFANSI will also BEEP to alert you that a
reassignment was attempted.
PKSFANSI requires less than 1K bytes resident RAM, and should
work with any ANSI driver, such as the standard ANSI.SYS driver,
NANSI, ZANSI, DVANSI, etc. Note that if you use a memory
resident ANSI driver, such as the DESQview DVANSI.COM driver,
PKSFANSI should be loaded after the ANSI driver is loaded.
Using PKZIP and DPMI
----- ----- ----------
If you experience difficulties when using PKZIP in a DOS window
under Windows, use the -) option to disable DPMI support. If
this eliminates the problem, you may default this option for
PKZIP by using the configuration file (see manual for details).
With PKUNZIP, this option may be set as an environment variable
(see below for details).
PKUNZIP as an Environment Variable
-------- ----- ------ -
PKUNZIP includes the ability to use an environment variable as a
continuation of the command line. An option, or number of options
may be specified by an environment variable. PKUNZIP will treat
the variables as if they were passed on the command line.
example: set PKUNZIP=-)
This example would disable DPMI usage.
Note that since the PKUNZIP environment variable is a
continuation of the command line; it will supersede any
preceding option on the command line.
Minimum DOS Requirements for SPANNING & FORMATTING
-------- ----- ------ ----- ----- -------
For PKZIP 2 to span multiple disks with a .ZIP file, DOS 3.0 or
greater is required.
To be able to format diskettes on-the-fly, DOS 3.2 or greater is
required.
PKUNZJR.COM & PKSFX Junior
----- ----- ----------------
When using PKUNZJR or PKSFX Junior, remember to end your output
path with a : or a \. Because the PKUNZJR and PKSFX Junior were
designed to be as small as possible, please note that they
perform minimal error checking.
CHANGE TO "MOVE" OPTION
----- ----- -------------
When using the -m option in PKZIP.EXE PKZIP will now remove the
directories and subdirectories after the compression process has
been completed. This feature is turned on by default. If you
wish PKZIP not to remove the directories/subdirectories, use a
-m- option to disable this feature.
PKNOFASTCHAR= Environment Variable
-------- ----- ------
This tells PKZIP/PKUNZIP to use the slow DOS 1.x/2.x character
output function calls rather than the 'DOS Fast Character
Output' function. This option is designed for compatability with
TSR's or BBS doors etc. that do not intercept the DOS Fast
Character Output function.
ERROR MESSAGES
----- ----- ----
This is an addendum to the ERROR MESSAGES found in the manual.
PKZIP: (E[19-23] and E29) Insufficient Memory
PKZIP: (E26) DOS 3.0 or later needed to span disks
PKZIP: (E26) DOS 3.2 or later needed to format disks
PKZIP: (E28) Destination for .ZIP file is same as temporary file
PKZIP: (E28) Source and destination is the same
PKZIP: (W07) Warning! Bad System Track
PKZIP: (W08) Warning! Can't write FAT
PKZIP: (W09) Warning! Can't write root directory
PKZIP: (W10) Warning! Can't write boot sector
ZIP2EXE: (E09) Can't create ouput file
ZIP2EXE: (W01) Warning! The file already exists, overwrite (y/n)?
PKSFX: Warnings numbers are the same as PKUNZIP
[9-18,20,21,23,24]
PKSFX: (E02,E03) Error in .EXE file
PKSFXJR: No numbers are printed by PKSFXJR. The manual states
that PKSFXJR will report error numbers, but this is
incorrect. It will print only a message, no number
is printed. The errorlevel will be returned to DOS
however.
SUMMARY
-------
PKZIP:
0 No Error
1 Bad file name or file specification
2,3 Error in .ZIP file
4-11 Insufficient Memory
12 No files were found to add to the .ZIP, or no files
were specified for deletion
13 File not found. The specified .ZIP file or list file
was not found
14 Insufficient disk space for .ZIP comment
or
Insufficient disk space for update file
or
Disk Full, file XXXXX
15 .ZIP file is read-only and can not be modified
16 Bad or illegal parameters specified. (help screen displayed)
17 Too many files
18 Could not open file
19-23,29 Insufficient Memory
26 DOS 3.2 or later needed to span disks
28 Destination for .ZIP is same as temporary file
or
Source and destination is the same
255 User pressed control-c or control-break
ZIP2EXE:
0 No error
1 Error in .ZIP file
2 Error in .ZIP file, use PKZIPFIX
3-4 Insufficient memory to process file
6 Bad or illegal parameters specified. (help screen displayed)
7 Can't open Source file
8 Error in .ZIP file
9 Disk full writing target file during EXE to ZIP process
11 Disk full writing target file during ZIP to EXE process
12 .ZIP file being converted contains a file compressed with
a method not supported by the version of PKSFX being
attached by ZIP2EXE
13 User answered "No" in response to an "overwrite(y/n)?" prompt
PKSFX:
1 Warning error such as:
File fails CRC check, Unknown compression method.
2,3 Can't find .EXE file
4-8 Insufficient memory
9 Unable to locate listfile
10 Bad or illegal parameters specified. (help screen displayed)
12 User aborted at comment pausing, "Extract now (y/n)?" prompt
2,3,13 Error in .EXE file
50 Disk full
NOTES
-----
Note, the -x option in PKUNZIP now is used to specify files
to eXclude. As stated in the PKUNZIP 1.1 documenation, use
of '-x' to mean eXtract would not be supported in future
versions of PKUNZIP. The -e option of PKUNZIP specifies
extraction.
Note, the -o and -k, as well as the ZIPDATE= options in the
pkzip.cfg file, will be ignored when used with the -& option.
Note, PKZIP requires 206K of memory if no EMS or XMS is available,
and 108K if enough EMS/XMS is available.
Note, In the PKZIP manual, it states that the -o option will set
.ZIP file date to oldest file in .ZIP file. This should read
set .ZIP file date to latest, not oldest.
Note, Page 76 of the PKZIP manual incorrectly lists the default
value of view as Long. The default value of view is normal.
Note, When using either the -&l or -&u, both of these options
will format the destination diskette(s).
PKZIP BACKUP GUIDE
----- ----- --------
PKZIP can now create .ZIP files that exceed the size of a floppy
disk. You can use PKZIP to backup your entire hard disk and
unlike most backup programs, PKZIP can use disks formatted by
DOS, or it can format the disk for you. PKZIP can optionally
erase all files on the destination disk(s), or leave those files
intact. PKZIP can optionally quick format the destination
disk(s), or do a normal (unconditional) format. A quick format
erases the information on the disk without formatting each
track, greatly reducing the time required to format a disk.
Option Description
-------- ----- ------ -------- ----- ------ --
-& Span disks if necessary.
You must specify this option if you wish to create a .ZIP file
on multiple disks. If this option is not specified and you
exceed the capacity of a floppy disk, a DISK FULL error message
will result.
-&f Format the destination disk.
PKZIP will format the destination disk(s) if you specify this
option. If the disk has been formatted previously, a quick
format will be performed, otherwise a full format will be
performed.
-&fl The destination disk is to be formatted to low density.
If you plan to use low density disks in a high density disk
drive, this option is required. For example, if you have a 1.44
meg floppy disk drive, and plan to zip to 720K disks and your
disks are not formatted, you must specify this option. If your
disk drive is a 360K or 720K drive, this option is not required.
If any information was previously contained on the disk, it will
be erased.
-&u Unconditionally (always) format the disk.
Always format the disk before being used. A full format will be
used, a quick format will never be performed. If any information
was previously contained on the disk, it will be erased.
-&ul Unconditionally (always) format a low density disk in a
high density disk drive.
Always format the disk before being used. A full format will be
used, a quick format will never be performed. If any information
was previously contained on the disk, it will be erased.
-&w Wipe the disk. (Erase all files and subdirectories)
This is similar to -&f, except the files are deleted, rather than
formatting the disk. This is for usage with non floppy removable
devices, such as Bernoulli boxes.
-&s[d:] Include subdirectories in zipping process (similar to
-rp \*.*).
-&v Turn on DOS verify when spanning. This may also be set
by using BACKUP=verify in the pkzip.cfg file.
This option tells PKZIP that you wish to backup the entire disk
drive. The current disk drive will be used if no disk drive is
specifed. You do not need to specify the -rp option (recurse and
store pathnames). If you also specify files on another disk
drive, these files will be compressed, as well as all files on the
default drive. (Please see following examples.)
All options are case insensitive, but this may change in future
versions. We suggest you USE LOWER CASE LETTERS FOR FUTURE
COMPATIBILITY. The -&l option must be specified with -&u or -&f.
* Note: If you create a .ZIP file with the same name as exists
on a disk set, you do not need to use the WIPE or FORMAT
options. PKZIP will create a new .ZIP file with the same name;
this method is faster.
* Note: All the PKZIP Configuration File options can be
overridden on the command line by specifying the option and a
'-'. For example, -&f- will override "BACKUP=FORMAT" in the
Configuration File and turn off formatting.
* Note: When using PKUNZIP.EXE to restore a from a spanned
backup set, it is most efficient to start by inserting the
last diskette.
* Note: If you would like to use PKZIP.EXE for full and
incremental backups, use the -a+ for the full backup.
This will turn off the archive attribute after the
files have been compressed. Then to perform a
incremental backup, use the -i option. This will
compress only files that have changed since they
were last backed up.
Examples
--------
Command Line Description
-------- ----- ------ ----- ----- --------- ----- --------
pkzip a:zipfile -& Zip the current directory to drive A:, and
span disks if necessary. The files
currently on drive A: will not be affected.
C:\>pkzip a:zipfile -&s Zip all files on drive C: to the A: drive.
C:\>pkzip b:zipfile -&s d:\sd\*.* Zip all files on drive C:
(the current drive), and all files
in the D:\SD directory to the B:
drive.
C:\>pkzip a:zipfile -&s d:\*.BAT Zip all the files on drive C: and
all .BAT files on drive D: to the
A: drive.
pkzip a:zipfile -&f -rp Zip the current directory and its
subdirectories to drive A:, and
format each disk. A quick format
will be performed if possible,
which is much faster than a
unconditional format.
pkzip a:zipfile -&u -rp Same as above, except the disk
will be unconditionally formatted.
pkzip a:zipfile -&fl Zip the current directory to drive
A:, and format each disk to low
density. This option only applies
to users using a 360K floppy disk
in a 1.2 meg drive, or users using
a 720K floppy disk in a 1.44 meg
drive. A quick format will be
performed if possible, which is
much faster than a unconditional
format.
pkzip a:zipfile -&ul Same as above, except the disk
will be unconditionally formatted
(do not quick format).
pkzip a:zipfile -&w -rp Zip the current directory and its
subdirectories to drive A:, and
wipe each disk. All files and
subdirectories will be erased from
the A: drive. The disk will not
be formatted or quick formatted.
pkzip a:zipfile -&fs Zip the current disk drive
(including subdirectories) to drive
A:, and format each disk. If the
destination disk has previously
been formatted, a quick format will
be performed. Otherwise, an
unconditional format will be
performed.
New Options For the PKZIP.CFG Configuration File
-------- ----- ------ ----- ----- -----
The keyword BACKUP= can be followed by the following keywords:
SPAN The -& option is enabled. If this keyword is not
specified, the following options will only be
enabled when -& is specified on the command line.
Same as -&.
UNCONDITIONAL Format the disk unconditionally. Same as -&u.
LOW Using low density disks. Same as -&l
FORMAT Format the disks. Same as -&f.
WIPE Wipe the disks. Same as -&w.
FULL Do a full backup. Same as -&s.
VERIFY Turn on DOS verify when spanning. Same as -&v
Examples Same as
-------- ----- ------ ----- ----- -------------
BACKUP=SPAN FORMAT -&f
BACKUP=SPAN FORMAT UNCONDITIONAL -&u
BACKUP=LOW VERIFY SPAN -&lv
BACKUP=FORMAT WIPE Illegal -- WIPE and FORMAT are exclusive.
BACKUP=FULL -&s
BACKUP=FULL WIPE -&sw
PKWARE, PKZIP, PKUNZIP and PKSFX are registered trademarks of PKWARE,
Inc. PKSFANSI and PKCFG are trademarks of PKWARE, Inc.
Trademarks of other companies mentioned appear for identification
purposes only and are the property of their respective companies.
|