Struct IsoImage 

pub struct IsoImage<DATA: Seek> { /* private fields */ }

Available on crate features alloc and sync only.

A struct representing an open ISO9660 Image

This struct is interior mutable.

Implementations

impl<DATA: Seek> IsoImage<DATA>

pub fn into_inner(self) -> DATA

Consumes the image handle and returns its underlying data source.

impl<DATA: Read + Seek> IsoImage<DATA>

pub fn open(data: DATA) -> Result<Self>

Opens a ISO9660 Image

pub fn read_bytes_at(&self, byte_offset: u64, buf: &mut [u8]) -> Result<()>

Read raw bytes from an absolute byte position in the image.

pub fn find_path(&self, path: &str) -> Result<Option<DirEntry>>

Finds an entry by a slash- or backslash-delimited path.

Leading and repeated separators and . components are ignored. The root itself has no directory entry, so an empty or root-only path returns None. Parent (..) components are rejected.

pub fn read_file(&self, entry: &DirEntry) -> Result<Vec<u8>>

Read the complete contents of a file, handling multi-extent files.

For single-extent files, this reads from the entry’s extent. For multi-extent files (using NOT_FINAL flag), this reads and concatenates all extents in order.

impl<DATA: Read + Seek> IsoImage<DATA>

pub fn root_dir(&self) -> RootDir

Performs the root_dir operation.

pub fn root_dirs(&self) -> &RootDirs

Performs the root_dirs operation.

pub fn supports_rrip(&self) -> bool

Returns whether RRIP (Rock Ridge) extensions were detected in the image.

pub fn has_evd(&self) -> bool

Returns whether an ISO 9660:1999 Enhanced Volume Descriptor was found.

pub fn open_dir(&self, dir_ref: DirectoryRef) -> IsoDir<'_, DATA>

Open a directory by its DirectoryRef, enabling navigation into subdirectories.

pub fn path_table(&self) -> PathTableInfo

Returns the path table information for this image.

pub fn read_volume_descriptors(&self) -> VolumeDescriptorIter<'_, DATA>

Creates a volume-descriptor cursor starting at logical sector 16.

Async callers use VolumeDescriptorIter::next_descriptor. In sync builds the cursor also implements Iterator.

pub fn path_table_entries(&self) -> &[PathTableEntry]

Returns the cached path table entries, parsed once during open().

Each entry contains a directory name, its LBA, and its parent index, enabling fast directory hierarchy traversal without repeated seeks.

impl<DATA: Read + Seek> IsoImage<DATA>

pub fn read_pvd(&self) -> Result<PrimaryVolumeDescriptor>

Reads the primary volume descriptor.

Returns an I/O error if the descriptor sequence is malformed, truncated, or contains no primary descriptor.

Trait Implementations

impl<DATA: Debug + Seek> Debug for IsoImage<DATA>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.