LinuxCommandLibrary

isoinfo

Extract information from ISO 9660 images

TLDR

List all the files included in an ISO image

$ isoinfo -f -i [path/to/image.iso]
copy

E[x]tract a specific file from an ISO image and send it out stdout
$ isoinfo -i [path/to/image.iso] -x [/PATH/TO/FILE/INSIDE/ISO.EXT]
copy

Show header information for an ISO disk image
$ isoinfo -d -i [path/to/image.iso]
copy

SYNOPSIS

isoinfo [options] [isofile]

PARAMETERS

-i, --input=FILE
    Path to ISO 9660 image file or block device (default stdin if omitted)

-d, --debug
    Enable debug output

-T, --todisk
    Use todisk mode for output

-f, --find
    List all files (recursive)

-l, --list
    List directory contents

-R, --rock
    Use Rock Ridge extensions

-J, --joliet
    Use Joliet extensions

-r, --rational-rock
    Rationalized Rock Ridge extensions

-j CHARSET, --joliet-charset=CHARSET
    Joliet character set (e.g., UTF-8)

-x PATH, --extract=PATH
    Extract file at specified path

-g ID
    Group ID for Rock Ridge

-p ID
    Publisher ID

-N LASTSECTOR
    Last sector to read

-b BLOCKSIZE
    Sector size (default 2048)

DESCRIPTION

isoinfo is a command-line tool from the cdrkit package for inspecting and extracting information from ISO 9660 filesystems, typically used in CD-ROM or DVD images. It enables users to list directory structures, retrieve volume descriptors, and extract specific files without mounting the image. Supports extensions like Joliet (for Windows long filenames), Rock Ridge (Unix attributes), and HFS hybrid images.

Common use cases include verifying ISO contents during creation, scripting backups from optical media, or debugging burned discs. For example, list files with isoinfo -i image.iso -f, or extract a file via -x path/to/file. It operates directly on files or block devices, making it efficient for automation.

Unlike graphical tools, isoinfo provides precise control and output suitable for parsing. It's especially valuable in server environments or embedded systems where mounting is undesirable.

CAVEATS

Requires read permissions on input file/device; limited support for deeply nested paths or corrupted images; output charset may need manual handling for non-ASCII.

STANDARDS SUPPORT

Full ISO 9660 Level 1/2/3; Joliet Level 1/2/3; Rock Ridge Interchange; HFS hybrids.

EXIT CODES

0: success; 1: usage error; 2: I/O error; others: filesystem issues.

HISTORY

Part of cdrkit (2006), a GPL-licensed fork of Joerg Schilling's cdrtools due to licensing disputes. Maintains compatibility with original isoinfo from cdrtools 1.x, with ongoing updates for modern filesystems.

SEE ALSO

genisoimage(1), cdrecord(1), isodump(8), isovfy(8), mount(8)

Copied to clipboard