Crate cdfs

cdfs

cdfs is a portable, userland implementation of the ISO 9660 / ECMA-119 filesystem typically found on CDs and DVDs.

Usage

To open an ISO image:

use cdfs::{DirectoryEntry, ISO9660};

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

To read a file:

let mut contents = Vec::new();
if let Some(DirectoryEntry::File(file)) = iso.open("README.md")? {
  file.read().read_to_end(&mut contents)?;
}

To iterate over items in a directory:

if let Some(DirectoryEntry::Directory(dir)) = iso.open("/tmp")? {
  for entry in dir.contents() {
    println!("{}", entry?.identifier());
  }
}

To get information about a file:

let file = File::open("images/test.iso")?;
let iso = ISO9660::new(file)?;
let obj = iso.open("GPL_3_0.TXT")?.expect("GPL_3_0.TXT doesn't exist");
println!("Last modified at: {:?}", obj.modify_time());

See Also

The examples.

Structs

• ExtraMeta
  Holds information from system use (SUSP) entries.
• ISO9660
  Struct representing an ISO 9660 / ECMA-119 filesystem.
• ISODirectory
  DirectoryEntry for directories.
• ISODirectoryIterator
  Iterator for the contents of ISODirectory constructed by contents(). Similar to POSIX.1’s readdir.
• ISOFile
  DirectoryEntry for regular files.
• ISOFileReader
  A struct providing read-only access to a file on the filesystem.
• PosixAttributes
  POSIX.1 attributes from a PX entry.
• PosixFileMode
  The mode from a PX entry. Equivalent to POSIX.1’s st_mode field.
• PosixTimestamp
  Timestamps from a TF entry.
• Symlink
  DirectoryEntry for symbolic links. Typically generated from SL entries.

Enums

• DirectoryEntry
  An entry inside of a directory on the filesystem. Returned by the ISODirectoryIterator iterator.
• ISOError
  The master error structure.
• SuspExtension
  System Use extensions registered as being used in a directory hierarchy

Constants

• BLOCK_SIZE
  The size of a filesystem block, currently hardcoded to 2048 although the ISO spec allows for other sizes.

Traits

• BlockBufferCtor
  A quick hack to allow for a constructor even though blocks are defined as a primitive type.
• ExtraAttributes
  ExtraAttributes encapsulates various metadata specified by ISO-9660 / ECMA-119 extensions.
• ISO9660Reader
  A trait for objects which can be read by logical block addresses.

Type Aliases

• BlockBuffer
  A u8 array big enough to hold an entire filesystem block.
• Result
  Result that returns an ISOError.