PKZIP 6.0 Command Line User's Manual - CacheFly

SecureZIP for WindowsCommand LineUsers Manual

Copyright 1997-2007 PKWARE, Inc. All Rights Reserved.No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system,or translated into any other language in whole or in part, in any form or by any means, whether it beelectronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent ofPKWARE, Inc.PKWARE, INC., DISCLAIMS ALL WARRANTIES AS TO THIS SOFTWARE,WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,FUNCTIONALITY, DATA INTEGRITY, OR PROTECTION. PKWARE IS NOT LIABLE FORINCIDENTAL OR CONSEQUENTIAL DAMAGES.Portions of this software include RSA BSAFE cryptographic or security protocolsoftware from RSA Security Inc.This software includes portions that are copyright The OpenLDAP Foundation, 19982003 and are used under the OpenLDAP Public License. The text of this license isindented below:The OpenLDAP Public LicenseVersion 2.7, 7 September 2001Redistribution and use of this software and associated documentation("Software"), with or without modification, are permitted provided that thefollowing conditions are met:1. Redistributions of source code must retain copyright statementsand notices,2. Redistributions in binary form must reproduce applicable copyrightstatements and notices, this list of conditions, and the followingdisclaimer in the documentation and/or other materials providedwith the distribution, and3. Redistributions must contain a verbatim copy of this document.The OpenLDAP Foundation may revise this license from time to time. Eachrevision is distinguished by a version number. You may use this Software underterms of this license revision or under the terms of any subsequent revision of thelicense.THIS SOFTWARE IS PROVIDED BY THE OPENLDAP FOUNDATION AND ITSCONTRIBUTORS AS IS'' AND ANY EXPRESSED OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULARPURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OPENLDAPFOUNDATION, ITS CONTRIBUTORS, OR THE AUTHOR(S) OR OWNER(S)OF THE SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUTNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER INCONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The names of the authors and copyright holders must not be used in advertisingor otherwise to promote the sale, use or other dealing in this Software withoutspecific, written prior permission. Title to copyright in this Software shall at alltimes remain with copyright holders.OpenLDAP is a registered trademark of the OpenLDAP Foundation.Copyright 1999-2001 The OpenLDAP Foundation, Redwood City, California,USA. All Rights Reserved. Permission to copy and distribute verbatim copies ofthis document is granted.PKWARE, the PKWARE logo, the zipper logo, PKZIP, PKUNZIP, PKSFX, and SecureZIPare registered trademarks of PKWARE, Inc.Trademarks of other companies mentioned in this documentation appear for identificationpurposes only and are the property of their respective companies.RSA and BSAFE are registered trademarks of RSA Security Inc.2007-08-01

ivTable of Contents1WELCOME. 1Introduction.1About This Manual .1Your Work Environment: The Command Line. 2Entering Commands .2Setting PKZIP in the Path .3Strong Encryption .4Digital Signatures .4Using Digital Certificates .4Smart Card Compatibility .5Using Help .5Getting License Information.6Getting Version Information .6Technical Support .72THE BASICS. 8An Overview of What PKZIP Does .8Supported Archive Types .9Entering Commands: Syntax .10Adding Files to an Archive .11Archive File Naming Conventions. 11Adding a Single File .12Adding Multiple Files.13Moving Files into an Archive .14Viewing Files in an Archive .15Extracting Files from an Archive .15Extracting All Files .16Extracting Some Files .16Extracting Files to a Different Directory .16Extracting New and Newer Files.16

vUsing Filters When Selecting Files.17Selecting Files by Date .17Selecting Files by Age .17Selecting Files by Size.18Selecting Files to Include or Exclude.18Understanding Commands and Options .20Difference between a Command and Option.20Including an Option in Your Command Line .20Abbreviating Commands and Options .21Using Multiple Options .21Commands and Options That Have Values .21Conventions in This Guide .223ADDING FILES TO AN ARCHIVE. 23Default Values for Commands and Options .23Creating and Updating Archives.23Adding All Files in a Directory.23Adding New and Modified Files .24Adding Only Files That Have Changed .24Clearing Archive Attributes .25Incremental Archiving .25Writing an Archive to STDOUT and Special Files .26Writing an Archive to STDOUT.26Writing an Archive to a Named Pipe.27Encrypting Files That You Add to an Archive .28Encrypting Files with a Passphrase.28Encrypting Files with a Recipient List .31Encrypting File Names.33Encrypting Using Only FIPS-Approved Algorithms . 35Accessing Recipients in an LDAP Directory .37Contingency Keys .39Working with Digital Signatures .39Compressing Files in Subdirectories.43Storing Directory Path Information .44Additional Methods for Storing Directory Path Information.44Storing and Recreating Directory Path Information . 45Setting the Compression Level.46Specifying a Compression Level from 0-9 . 47Specifying a Compression Level by Name . 47Compressing Files with a List File .48Getting a List of Files from Standard Input .49Compressing Files with the Deflate64 Method.49

viCompressing Files with the BZIP2 Method.50Compressing Files Compatible with the Data Compression Library. 50Compressing Files to a Specified Type of Archive. 51Compressing Files to Diskette .52Creating a Spanned Archive .52Creating a Split Archive .52Preserving International Characters in File Names .53Creating Multiple, Respective Archives .54Storing File Information .55Compressing Files with Specified Attributes.55Extended Attribute Storage.56Including Additional Information in a ZIP File .57Including a Text Comment .58Including a Header Comment .58Specifying the Date of a .ZIP File .59Removing File Attributes .60Sorting Files Within a .ZIP File .61Moving Files to a .ZIP File.62Shredding Deleted Files.62Working with Self-Extracting (PKSFX) Archives.63Converting a Standard Archive to a Self-Extractor.65Converting to a Self-Extractor with a Different Name.65Options for Creating Self-Extractors .65Run Programs with the Self-Extractor .67Extraction Options for the Native Self-Extractor .684EXTRACTING FILES. 70Introduction.70Default Values for Commands and Options .70Extracting New and Existing Files.70Extracting All Files from an Archive .71Extracting Newer Versions of Existing Files and New Files .71Extracting Only Newer Versions of Files . 71Extracting from an Archive Embedded in An Archive. 72Extracting an Archive on STDIN or a Special File.72Extracting from an Archive on STDIN.73Extracting an Archive from a Named Pipe.73

viiChecking for Viruses when Extracting.74Extracting Files in Lower Case .75Preserving File Times .75Translating End of Line Sequence .75Retaining Directory Structure while Extracting.76Sorting Files in the Extract Directory .76Extracting Files Only for Display .77Extracting Files with a List File .77Authenticating Digital Signatures.77Extracting Only Trusted Archives .79Specifying Trusted Signers .795MISCELLANEOUS OPERATIONS . 82Introduction.82Overwriting Files .82Viewing the Contents of a .ZIP File.83Displaying a Brief View of a .ZIP File.83Displaying a Detailed View of the .ZIP File.83Converting File Names to a Short Format .84Inserting a Timestamp in the Archive File Name .85Printing the Contents of a .ZIP File.86Testing the Integrity of a .ZIP File .86Apply Strict Checking to Certificates .87Checking for Revoked Certificates.88Obtaining a CRL .89Pausing on Warnings.89Treating Warnings as Errors .90Previewing Command and Option Operations.91Fixing a Corrupt .ZIP File .91Create a Temporary .ZIP File on a Alternate Drive.92

viiiSuppressing Screen Output .92Setting Internal Attributes .93Encoding an Archive to Another Type .93Removing an Intermediate Archive .94Generate a List File .946CHANGING DEFAULTS FOR COMMANDS AND OPTIONS. 96Viewing the Configuration File.96How Default Settings Work.97Filter Options .98Changing a Default Value .99Changing Defaults for Filter Options.99Changing Defaults for Compression Method.100Using the Options Dialog to Change Defaults .100Resetting to Original Defaults .101Resetting Individual Defaults .101Resetting All Defaults.102Using an Alternate Configuration File.102Creating an Alternate Configuration File.102Using an Alternate Configuration File .1037COMMAND CHARACTERISTICS. 104Introduction.104Changing Date and Time Environment Variables .104Changing the List Character for List Files.105Changing the Command/Option Character .105A REFERENCE TO COMMANDS AND OPTIONS. 107B ERROR AND WARNING MESSAGES. 150Error Messages.150Warning Messages .156C FREQUENTLY ASKED QUESTIONS . 162

ixD HOW PKZIP WORKS . 166Two Processes .166Compression.166Information Content .166Binary Data Representation.167Speed vs. Size .170Archiving .170How PKZIP builds a .ZIP File .170CRC .172Deleting Files from a .ZIP File .173Adding to an Existing .ZIP File.173INDEX . 174

11WelcomeIntroductionWelcome to SecureZIP for Windows Command Line. SecureZIP for WindowsCommand Line provides a command-line interface to SecureZIP for use in creatingscripts and batch files. With SecureZIP Command Line, you execute SecureZIPcommands and options by entering them at a character-based command prompt andrunning the resulting command line.SecureZIP Command Line supports the full range of compression and archivingfeatures of the graphical SecureZIP for Windows Desktop. SecureZIP Command Linealso supports both traditional ZIP encryption and strong encryption. SecureZIPCommand Line decrypts files encrypted with any other version of SecureZIP orPKZIP and authenticates digital signatures attached to archives and archived files.About This ManualThis manual describes how to use SecureZIP Command Line. SecureZIP CommandLine contains a superset of the commands and options of PKZIP Command Line. Ingeneral, references to PKZIP in the text should be taken to apply equally toSecureZIP. If a feature has special requirements or comes only with SecureZIPEnterprise, this is noted in the text.The chapters group related commands and options and describe how to use them.Chapter 2 provides an overview of program features and includes brief tutorials. Seein particular the section “Understanding Commands and Options” for an explanationof how commands and options work.You can customize the default behavior of most commands and options. Chapter 6describes how.Appendix A contains a complete reference to the commands and options of theprogram. Experienced users may find much of the information they need in thisappendix.