zip.1

汇编大全 中国矿业大学计算机学院 汇编实验5

.\" Copyright (C) 1990-1993 Mark Adler, Richard B. Wales, Jean-loup Gailly,
.\" Kai Uwe Rommel, Igor Mandrichenko and John Bush.
.\" Permission is granted to any individual or institution to use, copy, or
.\" redistribute this software so long as all of the original files are
.\" included, that it is not sold for profit, and that this copyright notice
.\" is retained.
.\" zip.1 by Mark Adler, Jean-loup Gailly and  R. P. C. Rodgers
.\"
.TH ZIP 1L "2 Sept 1993"
.SH NAME
zip, zipcloak, zipnote, zipsplit \- package and compress (archive) files
.SH SYNOPSIS
.B zip
.RB [ \-cdDeEfFghjklLmoqrSTuvVwyz@$ ]
.RB [ \-b\ path ]
.RB [ \-n\ suffixes ]
.RB [ \-t\ mmddyy ]
.I [ zipfile
.I [ file1
.IR file2 " .\|.\|." ]]
.RB [ \-xi\ list ]
.PP
.B zipcloak
.RB [ \-dhL ]
.RB [ \-b\ path ]
.I zipfile
.PP
.B zipnote
.RB [ \-hwL ]
.RB [ \-b\ path ]
.I zipfile
.PP
.B zipsplit
.RB [ \-hitL ]
.RB [ \-b\ path ]
.I zipfile
.SH DESCRIPTION
.I zip
is a compression and file packaging utility for Unix, VMS, MSDOS,
OS/2, Windows NT, Minix, Atari and Macintosh.
It is analogous to a combination of the UNIX commands
.IR tar (1)
and
.IR compress (1)
and is compatible with PKZIP (Phil Katz's ZIP for MSDOS systems).
.LP
A companion program
.RI ( unzip (1L)),
unpacks
.I zip
archives.
The
.I zip
and
.IR unzip (1L)
programs can work with archives produced by PKZIP,
and PKZIP and PKUNZIP can work with archives produced by
.IR zip .
.I zip
version 2.0 is compatible with PKZIP 2.04
Note that PKUNZIP 1.10 cannot extract files produced by PKZIP 2.04
or
.I zip
2.0. You must use PKUNZIP 2.04g or
.I unzip
5.0p1 (or later versions) to extract them.
.PP
For a brief help on
.I zip
and
.I unzip,
run each without specifying any parameters on the command line.
.PP
The program is useful for packaging a set of files for distribution;
for archiving files;
and for saving disk space by temporarily
compressing unused files or directories.
.LP
The
.I zip
program puts one or more compressed files into a single
.I zip
archive,
along with information about the files
(name, path, date, time of last modification, protection,
and check information to verify file integrity).
An entire directory structure can be packed into a
.I zip
archive with a single command.
Compression ratios of 2:1 to 3:1 are common for text files.
.I zip
has one compression method (deflation) and can also store files without
compression.
.I zip
automatically chooses the better of the two for each file to be compressed.
.LP
When given the name of an existing
.I zip
archive,
.I zip
will replace identically named entries in the
.I zip
archive or add entries for new names.
For example,
if
.I foo.zip
exists and contains
.I foo/file1
and
.IR foo/file2 ,
and the directory
.I foo
contains the files
.I foo/file1
and
.IR foo/file3 ,
then:
.IP
\fCzip -r foo foo\fP
.LP
will replace
.I foo/file1
in
.I foo.zip
and add
.I foo/file3
to
.IR foo.zip .
After this,
.I foo.zip
contains
.IR foo/file1 ,
.IR foo/file2 ,
and
.IR foo/file3 ,
with
.I foo/file2
unchanged from before.
.LP
If the file list is specified as
.BR \-@ ,
.I zip
takes the list of input files from standard input.
Under UNIX,
this option can be used to powerful effect in conjunction with the
.IR find (1)
command.
For example,
to archive all the C source files in the current directory and
its subdirectories:
.IP
\fCfind . -name "*.[ch]" -print | zip source -@\fP
.LP
(note that the pattern must be quoted to keep the shell from expanding it).
.I zip
will also accept a single dash ("-") as the zip file name, in which case it
will write the zip file to standard output, allowing the output to be piped
to another program. For example:
.IP
\fCzip -r - . | dd of=/dev/nrst0 obs=16k\fP
.LP
would write the zip output directly to a tape with the specified block size
for the purpose of backing up the current directory.
.LP
.I zip
also accepts a single dash ("-") as the name of a file to be compressed, in
which case it will read the file from standard input, allowing zip to take
input from another program. For example:
.IP
\fCtar cf - . | zip backup -\fP
.LP
would compress the output of the tar command for the purpose of backing up
the current directory. This generally produces better compression than
the previous example using the -r option, because
.I zip
can take advantage of redundancy between files. The backup can be restored
using the command
.IP
\fCunzip -p backup | tar xf -\fP
.LP
When no zip file name is given and stdout is not a terminal,
.I zip
acts as a filter, compressing standard input to standard output.
For example,
.IP
\fCtar cf - . | zip | dd of=/dev/nrst0 obs=16k\fP
.LP
is equivalent to
.IP
\fCtar cf - . | zip - - | dd of=/dev/nrst0 obs=16k\fP
.LP
.I zip
archives created in this manner can be extracted with the program
.I funzip
which is provided in the
.I unzip
package, or by
.I gunzip
which is provided in the
.I gzip
package. For example:
.LP
\fPdd if=/dev/nrst0  ibs=16k | funzip | tar xvf -\fC
.LP
When changing an existing
.I zip
archive,
.I zip
will write a temporary file with the new contents,
and only replace the old one when the process of creating the new version
has been completed without error.
.LP
If the name of the
.I zip
archive does not contain an extension, the extension
.IR .zip
is added. If the name already contains an extension other than
.IR .zip
the existing extension is kept unchanged.
.SH "OPTIONS"
.TP
.BI \-b\ path
Use the specified
.I path
for the temporary
.I zip
archive. For example:
.RS
.IP
\fCzip -b /tmp stuff *\fP
.RE
.IP
will put the temporary
.I zip
archive in the directory
.IR /tmp ,
copying over
.I stuff.zip
to the current directory when done. This option is only useful when
updating an existing archive, and the file system containing this
old archive does not have enough space to hold both old and new archive
at the same time.
.TP
.B \-c
Add one-line comments for each file.
File operations (adding, updating) are done first,
and the user is then prompted for a one-line comment for each file.
Enter the comment followed by return, or just return for no comment.
.TP
.B \-d
Remove (delete) entries from a
.I zip
archive.
For example:
.RS
.IP
\fCzip -d foo foo/tom/junk foo/harry/\\* \\*.o\fP
.RE
.IP
will remove the entry
.IR foo/tom/junk ,
all of the files that start with
.IR foo/harry/ ,
and all of the files that end with
.I \&.o
(in any path).
Note that shell pathname expansion has been inhibited with backslashes,
so that
.I zip
can see the asterisks,  
enabling
.I zip
to match on the contents of the
.I zip
archive instead of the contents of the current directory.
.IP
Under MSDOS,
.B \-d
is case sensitive when it matches names in the
.I zip
archive.
This requires that file names be entered in upper case if they were
zipped by PKZIP on an MSDOS system.
.TP
.B \-D
Do not create entries in the
.I zip
archive for directories.  Directory entries are created by default so that
their attributes can be saved in the zip archive.
The environment variable ZIPOPT can be used to change the default options. For
example under Unix with sh:
.RS
.IP
ZIPOPT="-D"; export ZIPOPT
.RE
.IP
(The variable ZIPOPT can be used for any option except
.B \-i
and
.B \-x
and can include several options.) The option
.B \-D
is a shorthand
for
.B \-x
"*/" but the latter cannot be set as default in the ZIPOPT environment
variable.
.TP
.B \-e
Encrypt the contents of the
.I zip
archive using a password which is entered on the terminal in response
to a prompt
(this will not be echoed; if standard error is not a tty,
.I zip
will exit with an error).
.TP
.B \-ee
Encrypt contents, prompting for the password
.IR twice ,
checking that the two entries are identical before using the password.
.TP
.B \-f
Replace (freshen) an existing entry in the
.I zip
archive only if it has been modified more recently than the
version already in the
.I zip
archive;
unlike the update option
.RB ( \-u )
this will not add files that are not already in the
.I zip
archive.
For example:
.RS
.IP
\fCzip -f foo\fP
.RE
.IP
This command should be run from the same directory from which the original
.I zip
command was run,
since paths stored in
.I zip
archives are always relative.
.TP
.B \-F
Fix the
.I zip
archive. This option can be used if some portions of the archive
are missing. It is not guaranteed to work, so you MUST make a backup
of the original archive first.
.IP
When doubled as in
.B \-FF
the compressed sizes given inside the damaged archive are not trusted
and zip scans for special signatures to identify the limits between
the archive members. The single
.B \-F
is more reliable if the archive is not too much damaged, for example
if it has only been truncated, so try this option first.
.IP
Neither option will recover archives that have been incorrectly
transferred in ascii mode instead of binary. After the repair, the
.B \-t
option of
.I unzip
may show that some files have a bad CRC. Such files cannot be recovered;
you can remove them from the archive using the
.B \-d
option of
.I zip.
.TP
.B \-g
Grow (append to) the specified
.I zip
archive, instead of creating a new one. If this operation fails,
.I zip
attempts to restore the archive to its original state. If the restoration
fails, the archive might become corrupted.
.TP
.B \-h
Display the
.I zip
help information (this also appears if
.I zip
is run with no arguments).
.TP
.BI \-i\ files
Include only the specified files, as in:
.RS
.IP
\fCzip -r foo . -i \\*.c\fP
.RE
.IP
which will include only the files that end in
.IR \& .c
in the current directory and its subdirectories. (Note for PKZIP
users: the equivalent command is
.RS
.IP
\fCpkzip -r foo *.c\fP
.RE
.IP
PKZIP does not allow recursion in directories other than the current one.)
The backslash avoids the shell filename substitution, so that the
name matching is performed by
.I zip
at all directory levels.
.TP
.B \-j
Store just the name of a saved file (junk the path), and do not store
directory names. By default,
.I zip
will store the full path (relative to the current path).
.TP
.B \-k
Attempt to convert the names and paths to conform to MSDOS,
store only the MSDOS attribute (just the user write attribute from UNIX),
and mark the entry as made under MSDOS (even though it was not);
for compatibility with PKUNZIP under MSDOS which cannot handle certain
names such as those with two dots.
.TP
.B \-l
Translate the Unix end-of-line character LF into the
MSDOS convention CR LF. This option should not be used on binary files.
This option can be used on Unix if the zip file is intended for PKUNZIP
under MSDOS. If the input files already contain CR LF, this option adds
an extra CR. This ensure that
.I unzip -a
on Unix will get back an exact copy of the original file,
to undo the effect of
.I zip -l.
.TP
.B \-ll
Translate the MSDOS end-of-line CR LF into Unix LF.
This option should not be used on binary files.
This option can be used on MSDOS if the zip file is intended for unzip
under Unix.
.TP
.B \-L
Display the
.I zip
license.
.TP
.B \-m
Move the specified files into the
.I zip
archive; actually,
this deletes the target directories/files after making the specified
.I zip
archive. If a directory becomes empty after removal of the files, the
directory is also removed. No deletions are done until
.I zip
has created the archive without error.
This is useful for conserving disk space,
but is potentially dangerous so it is recommended to use it in
combination with
.B \-T
to test the archive before removing all input files.
.TP
.BI \-n\ suffixes
Do not attempt to compress files named with the given
.I suffixes.
Such files are simply stored (0% compression) in the output zip file,
so that
.I zip
doesn't waste its time trying to compress them.
The suffixes are separated by
either colons or semicolons.  For example:
.RS
.IP
\fCzip -rn .Z:.zip:.tiff:.gif:.snd  foo foo\fP
.RE
.IP
will copy everything from
.I foo
into
.IR foo.zip ,
but will store any files that end in
.IR .Z ,
.IR .zip ,
.IR .tiff ,
.IR .gif ,
or