use super::{ParseError, get_u32, put_u32};
pub const ORPHAN_BLOCK_MAGIC: u32 = 0x0b10_ca04;
pub const ORPHAN_TAIL_LEN: usize = 8;
#[must_use]
pub const fn orphan_entries_len(block_size: usize) -> usize {
block_size - ORPHAN_TAIL_LEN
}
#[must_use]
pub fn orphan_tail_bytes(checksum: u32) -> [u8; ORPHAN_TAIL_LEN] {
let mut tail = [0u8; ORPHAN_TAIL_LEN];
put_u32(&mut tail, 0, ORPHAN_BLOCK_MAGIC);
put_u32(&mut tail, 4, checksum);
tail
}
pub fn read_orphan_tail(block: &[u8]) -> Result<u32, ParseError> {
if block.len() < ORPHAN_TAIL_LEN {
return Err(ParseError::TooShort {
structure: "OrphanBlockTail",
need: ORPHAN_TAIL_LEN,
got: block.len(),
});
}
let tail = orphan_entries_len(block.len());
let magic = get_u32(block, tail);
if magic != ORPHAN_BLOCK_MAGIC {
return Err(ParseError::BadMagic {
structure: "OrphanBlockTail",
found: magic,
expected: ORPHAN_BLOCK_MAGIC,
});
}
Ok(get_u32(block, tail + 4))
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn the_tail_round_trips_through_a_block() {
let mut block = vec![0u8; 4096];
let tail = orphan_tail_bytes(0xdead_beef);
block[orphan_entries_len(4096)..].copy_from_slice(&tail);
assert_eq!(read_orphan_tail(&block).expect("valid tail"), 0xdead_beef);
}
#[test]
fn a_block_without_the_magic_is_rejected() {
let block = vec![0u8; 4096];
assert!(matches!(
read_orphan_tail(&block),
Err(ParseError::BadMagic { .. })
));
assert!(matches!(
read_orphan_tail(&[0u8; 4]),
Err(ParseError::TooShort { .. })
));
}
}