Struct Disk 

pub struct Disk { /* private fields */ }

The primary interface for disk operations. The “Disk Parameter Block” that is provided upon creation should be in correspondence with DRI specifications.

Implementations

impl Disk

pub fn from_img( img: Box<dyn DiskImage>, dpb: DiskParameterBlock, cpm_vers: [u8; 3], ) -> Result<Self, Box<dyn Error>>

Create a disk file system using the given image as storage. The DiskFS takes ownership of the image and DPB.

pub fn test_img( img: &mut Box<dyn DiskImage>, dpb: &DiskParameterBlock, cpm_vers: [u8; 3], ) -> bool

Test an image for the CP/M file system, changes method to Auto. Usually called before user parameters are applied. Will not accept images with directory structures corresponding to CP/M versions higher than cpm_vers.

pub fn format( &mut self, vol_name: &str, time: Option<NaiveDateTime>, ) -> Result<(), Box<dyn Error>>

Format disk for the CP/M file system. If CP/M version is 2.x, arguments are ignored. If CP/M version is 3.x:

• vol_name.len()>0 causes creation of a label with the specified name
• time.is_some() causes creation of a label (maybe default name) and timestamps

Trait Implementations

impl DiskFS for Disk

fn new_fimg( &self, chunk_len: Option<usize>, set_time: bool, path: &str, ) -> Result<FileImage, Box<dyn Error>>

Create an empty file image appropriate for this file system. To use the block size of this specific disk set chunk_len to None.

fn stat(&mut self) -> Result<Stat, Box<dyn Error>>

Stat the file system

fn catalog_to_stdout(&mut self, opt: &str) -> Result<(), Box<dyn Error>>

Directory listing to standard output in the file system’s native style

fn catalog_to_vec(&mut self, path: &str) -> Result<Vec<String>, Box<dyn Error>>

Get directory listing as a Vec. The rows are in an easily parsed fixed column format that is the same for all file systems. Columns 0..4 are the type/extension, 5..10 are the block count, 12.. is the basename. For flat file systems, the path must be “” or “/”, or else an error is returned. For any file system, if the path resolves to a file, an error is returned.

fn glob( &mut self, pattern: &str, case_sensitive: bool, ) -> Result<Vec<String>, Box<dyn Error>>

Return vector of paths based on the glob pattern

fn tree( &mut self, include_meta: bool, indent: Option<u16>, ) -> Result<String, Box<dyn Error>>

Get the file system tree as a JSON string

fn create(&mut self, _path: &str) -> Result<(), Box<dyn Error>>

Create a new directory

fn delete(&mut self, xname: &str) -> Result<(), Box<dyn Error>>

Delete a file or directory

fn set_attrib( &mut self, xname: &str, permissions: Attributes, maybe_password: Option<&str>, ) -> Result<(), Box<dyn Error>>

Set permissions or other attributes for the given path, flags that are not Some will be left as they are

fn rename( &mut self, old_xname: &str, new_xname: &str, ) -> Result<(), Box<dyn Error>>

Rename a file or directory

fn retype( &mut self, xname: &str, new_type: &str, _sub_type: &str, ) -> Result<(), Box<dyn Error>>

Change the type and subtype of a file, strings may contain numbers as appropriate.

fn read_block(&mut self, num: &str) -> Result<Vec<u8>, Box<dyn Error>>

Get a native file system allocation unit

fn write_block( &mut self, num: &str, dat: &[u8], ) -> Result<usize, Box<dyn Error>>

Put a native file system allocation unit N.b. this simply zaps the block and can break the file system.

fn get(&mut self, xname: &str) -> Result<FileImage, Box<dyn Error>>

Get file image from the path within this disk image.

fn put(&mut self, fimg: &FileImage) -> Result<usize, Box<dyn Error>>

Write file image to this disk image at the path stored in fimg.

fn standardize(&mut self, _ref_con: u16) -> HashMap<Block, Vec<usize>>

Standardize for comparison with other sources of disk images. Returns a map from blocks to offsets within the block that are to be zeroed or ignored. Typically it is important to call this before deletions happen. May be recursive, ref_con can be used to initialize each recursion.

fn compare(&mut self, path: &Path, ignore: &HashMap<Block, Vec<usize>>)

Compare this disk with a reference disk for testing purposes. Panics if comparison fails.

fn get_img(&mut self) -> &mut Box<dyn DiskImage>

Mutably borrow the underlying disk image

fn put_at( &mut self, path: &str, fimg: &mut FileImage, ) -> Result<usize, Box<dyn Error>>

Convenience function to set path and put (default method)

fn bload(&mut self, path: &str) -> Result<(usize, Vec<u8>), Box<dyn Error>>

Convenience function to get (load_addr,binary_data) (default method)

fn bsave( &mut self, path: &str, dat: &[u8], load_addr: Option<usize>, trailing: Option<&[u8]>, ) -> Result<usize, Box<dyn Error>>

Convenience function to save binary file (default method)

fn load(&mut self, path: &str) -> Result<(usize, Vec<u8>), Box<dyn Error>>

Convenience function to get (load_addr,tokens) (default method)

fn save( &mut self, path: &str, dat: &[u8], lang: ItemType, trailing: Option<&[u8]>, ) -> Result<usize, Box<dyn Error>>

Convenience function to save tokens (default method)

fn read_text(&mut self, path: &str) -> Result<String, Box<dyn Error>>

Convenience function to load text (default method)

fn write_text(&mut self, path: &str, txt: &str) -> Result<usize, Box<dyn Error>>

Convenience function to save text (default method)

fn read_records( &mut self, path: &str, rec_len: Option<usize>, ) -> Result<Records, Box<dyn Error>>

Convenience function to load records (default method)

fn write_records( &mut self, path: &str, recs: &Records, ) -> Result<usize, Box<dyn Error>>

Convenience function to save records (default method)