use crate::bytes::{ascii, le_u64};
use crate::error::RefsError;
pub const SUPB_SIGNATURE: &[u8; 4] = b"SUPB";
pub const REFS_SUPERBLOCK_CLUSTER: u64 = 30;
const BLOCK_NUMBER_OFFSET: usize = 0x20;
const BLOCK_HEADER_MIN_LEN: usize = 40;
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub struct MetadataBlockRef {
pub signature: [u8; 4],
pub block_number: u64,
}
impl MetadataBlockRef {
pub fn parse(data: &[u8], expected: &'static str, offset: u64) -> Result<Self, RefsError> {
let mut signature = [0u8; 4];
if let Some(s) = data.get(0..4) {
signature.copy_from_slice(s);
}
if signature.as_slice() != expected.as_bytes() {
return Err(RefsError::BadBlockSignature {
found: signature,
found_ascii: ascii(&signature),
expected,
offset,
});
}
if data.len() < BLOCK_HEADER_MIN_LEN {
return Err(RefsError::Truncated {
structure: "metadata-block header",
need: BLOCK_HEADER_MIN_LEN,
have: data.len(),
});
}
Ok(Self {
signature,
block_number: le_u64(data, BLOCK_NUMBER_OFFSET),
})
}
}
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub struct Superblock {
pub block: MetadataBlockRef,
}
impl Superblock {
pub fn parse_at(data: &[u8], offset: u64) -> Result<Self, RefsError> {
let start = usize::try_from(offset).unwrap_or(usize::MAX);
let slice = data.get(start..).ok_or(RefsError::Truncated {
structure: "superblock (image slice)",
need: start,
have: data.len(),
})?;
let block = MetadataBlockRef::parse(slice, "SUPB", offset)?;
Ok(Self { block })
}
}