zipdetails

СОДЕРЖАНИЕ

• ИМЯ
• СИНТАКСИС
• ОПИСАНИЕ
  • Поведение по умолчанию
  • Режим сканирования
  • ПАРАМЕТРЫ
  • Вывод по умолчанию
  • Подробный вывод
• ОГРАНИЧЕНИЯ
• ЗАДАЧИ
• ПОДДЕРЖКА
• СМОТРИТЕ ТАКЖЕ
• АВТОР
• АВТОРСКИЕ ПРАВА

ИМЯ

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, которые всё ещё присутствуют.

При включённом режиме сканирования программа будет проходить по zip-архиву с начала, слепо ища 4-байтовые подписи, которые предшествуют каждой структуре данных zip. Если она найдёт какую-либо из распознанных подписей, она попытается вывести связанную запись zip. Для очень больших zip-архивов эта операция может занять много времени.

Обратите внимание, что 4-байтовые подписи, используемые в zip-архивах, иногда могут совпадать с случайными данными, хранящимися в zip-архиве, поэтому при интерпретации результатов требуется осторожность.

ПАРАМЕТРЫ

-h

Показать справку

--redact

Замаскировать имена файлов в выводе. Полезно в тех случаях, когда zip-архив содержит конфиденциальные данные, которые нельзя передавать.

--scan

Пройтись по zip-архиву в поисках возможных записей zip. Может быть подвержено ошибкам. См. Режим сканирования

--utc

По умолчанию поля даты/времени отображаются в местном времени. Используйте этот параметр, чтобы отображать их в координированном всемирном времени (UTC).

-v

Включить режим подробного вывода. См. Подробный вывод.

--version

Показать номер версии программы и выйти.

Вывод по умолчанию

По умолчанию zipdetails выведет детали zip-архива в трёх колонках.

Колонка 1

Содержит смещение с начала файла в шестнадцатеричном формате.

Колонка 2

Содержит текстовое описание поля.

Колонка 3

Если поле содержит числовое значение, оно будет отображено в шестнадцатеричном формате. Zip хранит большинство чисел в формате little-endian — отображаемое значение будет иметь удалённый little-endian код.

Далее идёт необязательное описание того, что означает значение.

Например, предположим, что у вас есть 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 дополнена

• Смещением с начала файла в шестнадцатеричном формате.

• Длиной поля в шестнадцатеричном формате.

• Шестнадцатеричным дампом байтов в поле в том порядке, в котором они хранятся в zip-архиве.

Вот тот же zip-архив, выведенный с помощью параметра zipdetails -v:

$ 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-архивов не поддерживаются этой программой:

• Многочастотные архивы.

• Сильные функции шифрования, определённые в документе APPNOTE.TXT.

ЗАДАЧИ

Обработка ошибок находится в стадии разработки. Если программа столкнётся с проблемой при чтении zip-архива, она, скорее всего, завершится с неинформативным сообщением об ошибке.

ПОДДЕРЖКА

Обратная связь, вопросы и сообщения об ошибках следует направлять по адресу https://github.com/pmqs/zipdetails/issues.

СМОТРИТЕ ТАКЖЕ

Основной ресурс для zip-архивов — APPNOTE.TXT.

Альтернативный ресурс — приложение Info-Zip appnote. Его можно найти по адресу ftp://ftp.info-zip.org/pub/infozip/doc/

Подробную информацию о шифровании WinZip AES см. в AES Encryption Information: Encryption Specification AE-1 and AE-2.

Программа zipinfo, поставляемая с дистрибутивом Info-Zip (http://www.info-zip.org/), также может отображать подробности структуры zip-архива.

АВТОР

Пол Маркесс pmqs@cpan.org.

АВТОРСКИЕ ПРАВА

Copyright (c) 2011-2022 Пол Маркесс. Все права защищены.

Эта программа является свободной программой; вы можете перераспределять её и/или изменять её в соответствии с условиями Perl.