isoinfo
Extract information from ISO 9660 images
TLDR
List all the files included in an ISO image
E[x]tract a specific file from an ISO image and send it out stdout
Show header information for an ISO disk image
SYNOPSIS
isoinfo [ <options> ] [ -i <iso_image> ]
PARAMETERS
-h
Displays a help message and exits.
-d
Dumps the primary volume descriptor of the ISO image.
-i <iso_image>
Specifies the path to the ISO 9660 image file to be analyzed. This option is usually required.
-f
Prints all filenames found within the ISO image, one per line.
-l
Performs a long listing of directory contents, similar to ls -l, showing permissions, owner, group, size, and modification time.
-J
Enables the display and interpretation of Joliet extensions, which provide support for longer filenames and Unicode characters.
-R
Enables the display and interpretation of Rock Ridge extensions, which provide Unix-like file attributes such as permissions, UIDs/GIDs, and symbolic links.
-N <filename>
Searches for the specified filename or directory within the ISO image.
-x <file>
Extracts the specified file from the ISO image to standard output (stdout). Users must redirect stdout to a file to save the extracted content.
-s
Shows the size of the ISO image in blocks.
-T <sector>
Displays the file located at the given sector offset within the ISO image. Useful for debugging or advanced analysis.
-k
Shows the block size of the ISO image.
-o <offset>
Applies a byte offset to the beginning of the ISO image file. Useful when the ISO image is embedded within another file.
-p
Shows the full path for entries when listing directory contents.
-M
Calculates and displays the MD5 checksum of a specified file within the ISO image. Requires specifying a file with -N.
-y
Shows the target of symbolic links when using long listing (-l).
-v
Enables verbose output, providing more detailed information about the scanning process and image structure.
-t
Enables very verbose trace output, primarily for debugging purposes.
-C <charset>
Specifies the character set to use for converting Joliet names.
-D
Enables debugging output.
DESCRIPTION
isoinfo is a command-line utility used to examine and extract information from ISO 9660 images, which are common file formats for CD-ROMs, DVDs, and Blu-ray discs. It allows users to list directory contents, inspect volume descriptors, retrieve file information, and even extract individual files directly from an ISO image without needing to mount it.
It supports various extensions like Rock Ridge and Joliet, making it versatile for different types of ISOs. This tool is invaluable for verifying the contents of an ISO image, troubleshooting issues, or extracting specific data for analysis or further use. It serves as a non-destructive way to explore ISO content.
CAVEATS
isoinfo is solely for inspecting and extracting data; it cannot modify ISO images. Tools like genisoimage or mkisofs are used for creating or altering ISO files.
Processing very large ISO images or performing extensive file listings (e.g., with -f or -l) can be resource-intensive and take a significant amount of time.
When extracting files using -x, the output is sent to standard output (stdout). To save the extracted file, it is crucial to redirect stdout to a new file (e.g., isoinfo -x file.txt -i image.iso > extracted_file.txt).
USAGE EXAMPLES
To list all files within an ISO image:
isoinfo -f -i my_image.iso
To perform a long listing of the root directory of an ISO, including Rock Ridge extensions:
isoinfo -l -R -i my_image.iso
To extract a specific file named document.pdf from an ISO:
isoinfo -x /path/to/document.pdf -i my_image.iso > extracted_document.pdf
To dump the primary volume descriptor for detailed image information:
isoinfo -d -i my_image.iso
HISTORY
isoinfo is a long-standing utility that originated as part of the cdrtools package, initially developed by Jörg Schilling. Due to various licensing and development philosophy differences, some Linux distributions and open-source projects have forked parts of cdrtools into distinct projects, such as genisoimage and wodim.
Despite these forks, isoinfo has remained a consistent and widely available utility within these different packages, serving as a core tool for interacting with ISO 9660 filesystems. Its development has focused on robustly supporting various ISO 9660 standards and their extensions (like Rock Ridge and Joliet) to ensure compatibility with a broad range of optical disc images.
SEE ALSO
genisoimage(1), mkisofs(1), mount(8), dd(1), isovfy(1)