內容

名稱

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 檔案中所有可能的錯誤。如果您有建議的用例可以改善此功能,請考慮建立增強要求(請參閱 "支援")。

在 zip 檔案中找到的日期/時間欄位會以當地時間顯示。請使用 --utc 選項以協調世界時間 (UTC) 顯示這些欄位。

掃描模式

如果您有潛在損毀的 zip 檔案,特別是檔案末端的中央目錄不存在/不完整時,您可以嘗試使用 --scan 選項來搜尋仍存在的 zip 記錄。

當 Scan 模式啟用時,程式會從 zip 檔案的開頭開始,盲目尋找每個 zip 資料結構前方的 4 位元組簽章。如果找到任何已識別的簽章,它將嘗試傾印相關的 zip 記錄。對於非常大的 zip 檔案,此操作可能需要很長的時間才能執行。

請注意,zip 檔案中使用的 4 位元組簽章有時可能會與儲存在 zip 檔案中的隨機資料相符,因此在解讀結果時需要小心。

選項

-h

顯示說明

--redact

模糊輸出中的檔案名稱。對於 zip 檔案包含無法共用的敏感資料的使用案例非常方便。

--scan

尋找可能的 zip 記錄,走訪 zip 檔案。可能會容易出錯。請參閱 "Scan 模式"

--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 appnote。此文件可從 ftp://ftp.info-zip.org/pub/infozip/doc/ 取得。

有關 WinZip AES 加密的詳細資訊,請參閱 AES 加密資訊:加密規範 AE-1 和 AE-2

info-zip 發行版(http://www.info-zip.org/)附帶的 zipinfo 程式也可以顯示 zip 檔案結構的詳細資訊。

作者

Paul Marquess pmqs@cpan.org

著作權

著作權所有 (c) 2011-2022 Paul Marquess。保留所有權利。

此程式為自由軟體;您可以在與 Perl 相同的條款下重新散布或修改它。