Section: User Contributed Perl Documentation (1)
zipdetails - display the internal structure of zip files
zipdetails [-v][--scan] zipfile.zip
Zipdetails displays information about the internal record structure of zip
files. It is not concerned with displaying any details of the compressed
data stored in the zip file.
The program assumes prior understanding of the internal structure of a Zip
file. You should have a copy of the Zip APPNOTE file at hand to help
understand the output from this program (``SEE ALSO'' for details).
By default the program expects to be given a well-formed zip file. It will
navigate the Zip file by first parsing the zip central directory at the end
of the file. If that is found, it will then walk through the zip records
starting at the beginning of the file. Any badly formed zip data structures
encountered are likely to terminate the program.
If the program finds any structural problems with the zip file it will
print a summary at the end of the output report. The set of error cases
reported is very much a work in progress, so don't rely on this feature to
find all the possible errors in a zip file. If you have suggestions for
use-cases where this could be enhanced please consider creating an
enhancement request (see ``SUPPORT'').
If you do have a potentially corrupt zip file, particulatly where the
central directory at the end of the file is absent/incomplete, you can try
usng the "--scan"
option to search for zip records that are still present.
When Scan-mode is enabled, the program will walk the zip file from the
start blindly looking for the 4-byte signatures that preceed each of the
zip data structures. If it finds any of the recognised signatures it will
attempt to dump the associated zip record. For very large zip files, this
operation can take a long time to run.
Note that the 4-byte signatures used in zip files can sometimes match with
random data stored in the zip file, so care is needed interpreting the
Walk the zip file loking for possible zip records. Can be error-prone.
Enable Verbose mode. See ``Verbose Output''.
Display version number of the program and exit.
By default zipdetails will output the details of the zip file in three
- Column 1
This contains the offset from the start of the file in hex.
- Column 2
This contains a textual description of the field.
- Column 3
If the field contains a numeric value it will be displayed in hex. Zip
stores most numbers in little-endian format - the value displayed will have
the little-endian encoding removed.
Next, is an optional description of what the value means.
If the "-v"
option is present, column 1 is expanded to include
The offset from the start of the file in hex.
The length of the field in hex.
A hex dump of the bytes in field in the order they are stored in the zip
The following zip file features are not supported by this program:
The strong encryption features defined in the ``APPNOTE'' document.
Error handling is a work in progress. If the program encounters a problem
reading a zip file it is likely to terminate with an unhelpful error
General feedback/questions/bug reports should be sent to
> (preferred) or
The primary reference for Zip files is the ``APPNOTE''
document available at
An alternative reference is the Info-Zip appnote. This is available from
The "zipinfo" program that comes with the info-zip distribution
(<http://www.info-zip.org/>) can also display details of the structure of
a zip file.
See also Archive::Zip::SimpleZip, IO::Compress::Zip,
Paul Marquess firstname.lastname@example.org
Copyright (c) 2011-2020 Paul Marquess. All rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.