proxmox-backup/src/tape/tape_read.rs

use std::io::Read;

/// Read trait for tape devices
///
/// Normal Read, but allows to query additional status flags.
pub trait TapeRead: Read {
    /// Return true if there is an "INCOMPLETE" mark at EOF
    ///
    /// Raises an error if you query this flag before reaching EOF.
    fn is_incomplete(&self) -> Result<bool, std::io::Error>;

    /// Return true if there is a file end marker before EOF
    ///
    /// Raises an error if you query this flag before reaching EOF.
    fn has_end_marker(&self) -> Result<bool, std::io::Error>;
}

pub enum BlockReadStatus {
    Ok(usize),
    EndOfFile,
    EndOfStream,
}

/// Read streams of blocks
pub trait BlockRead {
    /// Read the next block (whole buffer)
    fn read_block(&mut self, buffer: &mut [u8]) -> Result<BlockReadStatus, std::io::Error>;
}