Struct ISO9660

pub struct ISO9660<T: ISO9660Reader> { /* private fields */ }

Struct representing an ISO 9660 / ECMA-119 filesystem.

Implementations

impl<T: ISO9660Reader> ISO9660<T>

pub fn new(reader: T) -> Result<ISO9660<T>>

Returns a new ISO9660 instance from an ISO9660Reader instance. ISO9660Reader has a blanket implementation for all types that implement Read and Seek, so this function can be called with e.g. a File or Cursor.

Errors

Upon encountering an error parsing the filesystem image or an I/O error, an error variant will be returned.

Example

let file = File::open("images/test.iso")?;
let iso = ISO9660::new(file)?;

pub fn open(&self, path: &str) -> Result<Option<DirectoryEntry<T>>>

Returns a DirectoryEntry for a given path.

Arguments

• path - Path to the object on the filesystem

Errors

Upon encountering an I/O error or an error parsing the filesystem, an error variant is returned. If the path cannot be found on the filesystem Ok(None) is returned.

Example

let entry = iso.open("/README.TXT")?;

pub fn is_rr(&self) -> bool

Returns true if Rock Ridge extensions are present

pub fn root(&self) -> &ISODirectory<T>

Returns the most featureful root directory.

Root selection

• If the primary volume descriptor has Rock Ridge SUSP entries, use it
• ElseIf a supplementary volume descriptor (e.g. Joliet) exists, use it
• Else fall back on the primary volume descriptor with short filenames

See Also

ISO-9660 / ECMA-119 §§ 8.4, 8.5

pub fn root_at(&self, index: usize) -> Option<&ISODirectory<T>>

Returns the root directory entry.

Arguments

• index - An integer indicating which root entry to return
  • 0 = primary
  • 1 = secondary (if not present, None is returned)

See Also

ISO-9660 / ECMA-119 §§ 8.4, 8.5

pub fn block_size(&self) -> u16

Returns BLOCK_SIZE.

This implementation hardcodes the block size to 2048.

See Also

ISO-9660 / ECMA-119 § 6.1.2

pub fn volume_set_identifier(&self) -> &str

See Also

ISO-9660 / ECMA-119 § 8.5.13

pub fn publisher_identifier(&self) -> &str

See Also

ISO-9660 / ECMA-119 § 8.5.14

pub fn data_preparer_identifier(&self) -> &str

See Also

ISO-9660 / ECMA-119 § 8.5.15

pub fn application_identifier(&self) -> &str

See Also

ISO-9660 / ECMA-119 § 8.5.16

pub fn copyright_file_identifier(&self) -> &str

See Also

ISO-9660 / ECMA-119 § 8.5.17

pub fn abstract_file_identifier(&self) -> &str

See Also

ISO-9660 / ECMA-119 § 8.5.18

pub fn bibliographic_file_identifier(&self) -> &str

See Also

ISO-9660 / ECMA-119 § 8.5.19