{
    "content": [
        {
            "type": "text",
            "text": "# zipdetails(1) (man)\n\n**Summary:** zipdetails - display the internal structure of zip files\n\n**Synopsis:** zipdetails [-v][--scan] zipfile.zip\nzipdetails -h\nzipdetails --version\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| — | --scan | — | Walk the zip file loking for possible zip records. Can be error-prone. See \"Scan-Mode\" -v Enable Verbose mode. See \"Verb |\n| — | --version | — | Display version number of the program and exit. |\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (7 lines) — 6 subsections\n  - Default Behaviour (11 lines)\n  - Scan-Mode (15 lines)\n  - --scan (4 lines)\n  - --version (2 lines)\n  - Default Output (15 lines)\n  - Verbose Output (8 lines)\n- **LIMITATIONS** (6 lines)\n- **TODO** (3 lines)\n- **SUPPORT** (4 lines)\n- **SEE ALSO** (11 lines)\n- **AUTHOR** (2 lines)\n- **COPYRIGHT** (8 lines)\n\n## Full Content\n\n### NAME\n\nzipdetails - display the internal structure of zip files\n\n### SYNOPSIS\n\nzipdetails [-v][--scan] zipfile.zip\nzipdetails -h\nzipdetails --version\n\n### DESCRIPTION\n\nZipdetails displays information about the internal record structure of zip files. It is not\nconcerned with displaying any details of the compressed data stored in the zip file.\n\nThe program assumes prior understanding of the internal structure of a Zip file. You should\nhave a copy of the Zip APPNOTE file at hand to help understand the output from this program\n(\"SEE ALSO\" for details).\n\n#### Default Behaviour\n\nBy default the program expects to be given a well-formed zip file.  It will navigate the Zip\nfile by first parsing the zip central directory at the end of the file.  If that is found, it\nwill then walk through the zip records starting at the beginning of the file. Any badly\nformed zip data structures encountered are likely to terminate the program.\n\nIf the program finds any structural problems with the zip file it will print a summary at the\nend of the output report. The set of error cases reported is very much a work in progress, so\ndon't rely on this feature to find all the possible errors in a zip file. If you have\nsuggestions for use-cases where this could be enhanced please consider creating an\nenhancement request (see \"SUPPORT\").\n\n#### Scan-Mode\n\nIf you do have a potentially corrupt zip file, particulatly where the central directory at\nthe end of the file is absent/incomplete, you can try usng the \"--scan\" option to search for\nzip records that are still present.\n\nWhen Scan-mode is enabled, the program will walk the zip file from the start blindly looking\nfor the 4-byte signatures that preceed each of the zip data structures. If it finds any of\nthe recognised signatures it will attempt to dump the associated zip record. For very large\nzip files, this operation can take a long time to run.\n\nNote that the 4-byte signatures used in zip files can sometimes match with random data stored\nin the zip file, so care is needed interpreting the results.\n\nOPTIONS\n-h   Display help\n\n#### --scan\n\nWalk the zip file loking for possible zip records. Can be error-prone.  See \"Scan-Mode\"\n\n-v   Enable Verbose mode. See \"Verbose Output\".\n\n#### --version\n\nDisplay version number of the program and exit.\n\n#### Default Output\n\nBy default zipdetails will output the details of the zip file in three columns.\n\nColumn 1\nThis contains the offset from the start of the file in hex.\n\nColumn 2\nThis contains a textual description of the field.\n\nColumn 3\nIf the field contains a numeric value it will be displayed in hex. Zip stores most\nnumbers in little-endian format - the value displayed will have the little-endian\nencoding removed.\n\nNext, is an optional description of what the value means.\n\n#### Verbose Output\n\nIf the \"-v\" option is present, column 1 is expanded to include\n\n•    The offset from the start of the file in hex.\n\n•    The length of the field in hex.\n\n•    A hex dump of the bytes in field in the order they are stored in the zip file.\n\n### LIMITATIONS\n\nThe following zip file features are not supported by this program:\n\n•    Multi-part archives.\n\n•    The strong encryption features defined in the \"APPNOTE\" document.\n\n### TODO\n\nError handling is a work in progress. If the program encounters a problem reading a zip file\nit is likely to terminate with an unhelpful error message.\n\n### SUPPORT\n\nGeneral feedback/questions/bug reports should be sent to\n<https://github.com/pmqs/IO-Compress/issues> (preferred) or\n<https://rt.cpan.org/Public/Dist/Display.html?Name=IO-Compress>.\n\n### SEE ALSO\n\nThe primary reference for Zip files is the \"APPNOTE\" document available at\n<http://www.pkware.com/documents/casestudies/APPNOTE.TXT>.\n\nAn alternative reference is the Info-Zip appnote. This is available from\n<ftp://ftp.info-zip.org/pub/infozip/doc/>\n\nThe \"zipinfo\" program that comes with the info-zip distribution (<http://www.info-zip.org/>)\ncan also display details of the structure of a zip file.\n\nSee also Archive::Zip::SimpleZip, IO::Compress::Zip, IO::Uncompress::Unzip.\n\n### AUTHOR\n\nPaul Marquess pmqs@cpan.org.\n\n### COPYRIGHT\n\nCopyright (c) 2011-2021 Paul Marquess. All rights reserved.\n\nThis program is free software; you can redistribute it and/or modify it under the same terms\nas Perl itself.\n\n\n\nperl v5.34.0                                 2025-07-25                                ZIPDETAILS(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "zipdetails",
        "section": "1",
        "mode": "man",
        "summary": "zipdetails - display the internal structure of zip files",
        "synopsis": "zipdetails [-v][--scan] zipfile.zip\nzipdetails -h\nzipdetails --version",
        "flags": [
            {
                "flag": "",
                "long": "--scan",
                "arg": null,
                "description": "Walk the zip file loking for possible zip records. Can be error-prone. See \"Scan-Mode\" -v Enable Verbose mode. See \"Verbose Output\"."
            },
            {
                "flag": "",
                "long": "--version",
                "arg": null,
                "description": "Display version number of the program and exit."
            }
        ],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 7,
                "subsections": [
                    {
                        "name": "Default Behaviour",
                        "lines": 11
                    },
                    {
                        "name": "Scan-Mode",
                        "lines": 15
                    },
                    {
                        "name": "--scan",
                        "lines": 4,
                        "long": "--scan"
                    },
                    {
                        "name": "--version",
                        "lines": 2,
                        "long": "--version"
                    },
                    {
                        "name": "Default Output",
                        "lines": 15
                    },
                    {
                        "name": "Verbose Output",
                        "lines": 8
                    }
                ]
            },
            {
                "name": "LIMITATIONS",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "TODO",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SUPPORT",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 11,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 8,
                "subsections": []
            }
        ]
    }
}