内容

名称

zipdetails - 显示 zip 文件的内部结构

概要

zipdetails [-v][--scan][--redact][--utc] zipfile.zip
zipdetails -h
zipdetails --version

描述

该程序会生成关于 zip 文件内部结构的详细报告。对于 zip 文件中的每个元数据项,程序会输出

该项在 zip 文件中的偏移量。
该项的文本表示。
该项的可选十六进制转储。

该程序假设您已了解 Zip 文件的内部结构。您应该手边有一份 Zip APPNOTE.TXT 文件,以帮助您理解该程序的输出。

默认行为

默认情况下,该程序期望接收一个格式良好的 zip 文件。它将首先解析文件末尾的 zip 中央目录来导航 Zip 文件。如果找到该目录,它将从文件开头开始遍历 zip 记录。遇到任何格式错误的 zip 数据结构都可能导致程序终止。

如果程序发现 zip 文件存在任何结构问题,它将在输出报告的末尾打印摘要。报告的错误案例集仍在不断完善中,因此不要依赖此功能来查找 zip 文件中所有可能的错误。如果您有关于如何增强此功能的用例建议,请考虑创建增强请求(请参阅 "SUPPORT")。

zip 文件中的日期/时间字段以本地时间显示。使用 --utc 选项以协调世界时 (UTC) 显示这些字段。

扫描模式

如果您有一个可能损坏的 zip 文件,特别是当文件末尾的中央目录缺失/不完整时,您可以尝试使用 --scan 选项来搜索仍然存在的 zip 记录。

启用扫描模式后,该程序将从开头遍历 zip 文件,盲目地查找每个 zip 数据结构之前的 4 字节签名。如果找到任何已识别的签名,它将尝试转储关联的 zip 记录。对于非常大的 zip 文件,此操作可能需要很长时间才能完成。

请注意,zip 文件中使用的 4 字节签名有时会与存储在 zip 文件中的随机数据匹配,因此在解释结果时需要谨慎。

选项

-h

显示帮助

--redact

在输出中隐藏文件名。对于 zip 文件包含无法共享的敏感数据的用例非常有用。

--scan

遍历 zip 文件以查找可能的 zip 记录。可能会出现错误。请参阅 "扫描模式"

--utc

默认情况下,日期/时间字段以本地时间显示。使用此选项以协调世界时 (UTC) 显示它们。

-v

启用详细模式。请参阅 "详细输出"

--version

显示程序的版本号并退出。

默认输出

默认情况下,zipdetails 将以三列输出 zip 文件的详细信息。

列 1

这包含从文件开头开始的十六进制偏移量。

列 2

这包含字段的文本描述。

列 3

如果字段包含数值,则将以十六进制显示。Zip 以小端格式存储大多数数字 - 显示的值将删除小端编码。

接下来,是对值含义的可选描述。

例如,假设您有一个包含两个条目的 zip 文件,如下所示

$ unzip -l test.zip
Archive:  setup/test.zip
Length      Date    Time    Name
---------  ---------- -----   ----
        6  2021-03-23 18:52   latters.txt
        6  2021-03-23 18:52   numbers.txt
---------                     -------
    12                     2 files

运行 zipdetails 将给出以下输出

$ zipdetails test.zip

0000 LOCAL HEADER #1       04034B50
0004 Extract Zip Spec      0A '1.0'
0005 Extract OS            00 'MS-DOS'
0006 General Purpose Flag  0000
0008 Compression Method    0000 'Stored'
000A Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
000E CRC                   0F8A149C
0012 Compressed Length     00000006
0016 Uncompressed Length   00000006
001A Filename Length       000B
001C Extra Length          0000
001E Filename              'letters.txt'
0029 PAYLOAD               abcde.

002F LOCAL HEADER #2       04034B50
0033 Extract Zip Spec      0A '1.0'
0034 Extract OS            00 'MS-DOS'
0035 General Purpose Flag  0000
0037 Compression Method    0000 'Stored'
0039 Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
003D CRC                   261DAFE6
0041 Compressed Length     00000006
0045 Uncompressed Length   00000006
0049 Filename Length       000B
004B Extra Length          0000
004D Filename              'numbers.txt'
0058 PAYLOAD               12345.

005E CENTRAL HEADER #1     02014B50
0062 Created Zip Spec      1E '3.0'
0063 Created OS            03 'Unix'
0064 Extract Zip Spec      0A '1.0'
0065 Extract OS            00 'MS-DOS'
0066 General Purpose Flag  0000
0068 Compression Method    0000 'Stored'
006A Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
006E CRC                   0F8A149C
0072 Compressed Length     00000006
0076 Uncompressed Length   00000006
007A Filename Length       000B
007C Extra Length          0000
007E Comment Length        0000
0080 Disk Start            0000
0082 Int File Attributes   0001
     [Bit 0]               1 Text Data
0084 Ext File Attributes   81B40000
0088 Local Header Offset   00000000
008C Filename              'letters.txt'

0097 CENTRAL HEADER #2     02014B50
009B Created Zip Spec      1E '3.0'
009C Created OS            03 'Unix'
009D Extract Zip Spec      0A '1.0'
009E Extract OS            00 'MS-DOS'
009F General Purpose Flag  0000
00A1 Compression Method    0000 'Stored'
00A3 Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
00A7 CRC                   261DAFE6
00AB Compressed Length     00000006
00AF Uncompressed Length   00000006
00B3 Filename Length       000B
00B5 Extra Length          0000
00B7 Comment Length        0000
00B9 Disk Start            0000
00BB Int File Attributes   0001
     [Bit 0]               1 Text Data
00BD Ext File Attributes   81B40000
00C1 Local Header Offset   0000002F
00C5 Filename              'numbers.txt'

00D0 END CENTRAL HEADER    06054B50
00D4 Number of this disk   0000
00D6 Central Dir Disk no   0000
00D8 Entries in this disk  0002
00DA Total Entries         0002
00DC Size of Central Dir   00000072
00E0 Offset to Central Dir 0000005E
00E4 Comment Length        0000
Done

详细输出

如果存在 -v 选项,则列 1 将扩展为包括

以下是使用 zipdetails -v 选项转储的相同 zip 文件

$ zipdetails -v test.zip

0000 0004 50 4B 03 04 LOCAL HEADER #1       04034B50
0004 0001 0A          Extract Zip Spec      0A '1.0'
0005 0001 00          Extract OS            00 'MS-DOS'
0006 0002 00 00       General Purpose Flag  0000
0008 0002 00 00       Compression Method    0000 'Stored'
000A 0004 3D 98 77 52 Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
000E 0004 9C 14 8A 0F CRC                   0F8A149C
0012 0004 06 00 00 00 Compressed Length     00000006
0016 0004 06 00 00 00 Uncompressed Length   00000006
001A 0002 0B 00       Filename Length       000B
001C 0002 00 00       Extra Length          0000
001E 000B 6C 65 74 74 Filename              'letters.txt'
          65 72 73 2E
          74 78 74
0029 0006 61 62 63 64 PAYLOAD               abcde.
          65 0A

002F 0004 50 4B 03 04 LOCAL HEADER #2       04034B50
0033 0001 0A          Extract Zip Spec      0A '1.0'
0034 0001 00          Extract OS            00 'MS-DOS'
0035 0002 00 00       General Purpose Flag  0000
0037 0002 00 00       Compression Method    0000 'Stored'
0039 0004 3D 98 77 52 Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
003D 0004 E6 AF 1D 26 CRC                   261DAFE6
0041 0004 06 00 00 00 Compressed Length     00000006
0045 0004 06 00 00 00 Uncompressed Length   00000006
0049 0002 0B 00       Filename Length       000B
004B 0002 00 00       Extra Length          0000
004D 000B 6E 75 6D 62 Filename              'numbers.txt'
          65 72 73 2E
          74 78 74
0058 0006 31 32 33 34 PAYLOAD               12345.
          35 0A

005E 0004 50 4B 01 02 CENTRAL HEADER #1     02014B50
0062 0001 1E          Created Zip Spec      1E '3.0'
0063 0001 03          Created OS            03 'Unix'
0064 0001 0A          Extract Zip Spec      0A '1.0'
0065 0001 00          Extract OS            00 'MS-DOS'
0066 0002 00 00       General Purpose Flag  0000
0068 0002 00 00       Compression Method    0000 'Stored'
006A 0004 3D 98 77 52 Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
006E 0004 9C 14 8A 0F CRC                   0F8A149C
0072 0004 06 00 00 00 Compressed Length     00000006
0076 0004 06 00 00 00 Uncompressed Length   00000006
007A 0002 0B 00       Filename Length       000B
007C 0002 00 00       Extra Length          0000
007E 0002 00 00       Comment Length        0000
0080 0002 00 00       Disk Start            0000
0082 0002 01 00       Int File Attributes   0001
                      [Bit 0]               1 Text Data
0084 0004 00 00 B4 81 Ext File Attributes   81B40000
0088 0004 00 00 00 00 Local Header Offset   00000000
008C 000B 6C 65 74 74 Filename              'letters.txt'
          65 72 73 2E
          74 78 74

0097 0004 50 4B 01 02 CENTRAL HEADER #2     02014B50
009B 0001 1E          Created Zip Spec      1E '3.0'
009C 0001 03          Created OS            03 'Unix'
009D 0001 0A          Extract Zip Spec      0A '1.0'
009E 0001 00          Extract OS            00 'MS-DOS'
009F 0002 00 00       General Purpose Flag  0000
00A1 0002 00 00       Compression Method    0000 'Stored'
00A3 0004 3D 98 77 52 Last Mod Time         5277983D 'Tue Mar 23 19:01:58 2021'
00A7 0004 E6 AF 1D 26 CRC                   261DAFE6
00AB 0004 06 00 00 00 Compressed Length     00000006
00AF 0004 06 00 00 00 Uncompressed Length   00000006
00B3 0002 0B 00       Filename Length       000B
00B5 0002 00 00       Extra Length          0000
00B7 0002 00 00       Comment Length        0000
00B9 0002 00 00       Disk Start            0000
00BB 0002 01 00       Int File Attributes   0001
                      [Bit 0]               1 Text Data
00BD 0004 00 00 B4 81 Ext File Attributes   81B40000
00C1 0004 2F 00 00 00 Local Header Offset   0000002F
00C5 000B 6E 75 6D 62 Filename              'numbers.txt'
          65 72 73 2E
          74 78 74

00D0 0004 50 4B 05 06 END CENTRAL HEADER    06054B50
00D4 0002 00 00       Number of this disk   0000
00D6 0002 00 00       Central Dir Disk no   0000
00D8 0002 02 00       Entries in this disk  0002
00DA 0002 02 00       Total Entries         0002
00DC 0004 72 00 00 00 Size of Central Dir   00000072
00E0 0004 5E 00 00 00 Offset to Central Dir 0000005E
00E4 0002 00 00       Comment Length        0000
Done

限制

此程序不支持以下 zip 文件功能

待办事项

错误处理正在进行中。如果程序在读取 zip 文件时遇到问题,它可能会以无用的错误消息终止。

支持

一般反馈/问题/错误报告应发送至 https://github.com/pmqs/zipdetails/issues

另请参阅

Zip 文件的主要参考资料是 APPNOTE.TXT

另一个参考资料是 Info-Zip 应用说明。这可从 ftp://ftp.info-zip.org/pub/infozip/doc/ 获取

有关 WinZip AES 加密的详细信息,请参阅 AES 加密信息:加密规范 AE-1 和 AE-2

随 info-zip 发行版提供的 zipinfo 程序 (http://www.info-zip.org/) 也可以显示 zip 文件结构的详细信息。

作者

Paul Marquess [email protected]

版权

版权所有 (c) 2011-2022 Paul Marquess。保留所有权利。

本程序是自由软件;您可以在 Perl 本身相同的条款下重新发布和/或修改它。