hadris-apfs 2.5.0

An experimental, read-only APFS container and filesystem reader
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

//! APFS on-disk types and endian-aware parsers.

pub mod btree;
pub mod checksum;
pub mod common;
pub mod container;
pub mod filesystem;
pub mod object;
pub mod object_map;
pub mod space_manager;
pub mod volume;

pub use btree::{BTreeInfo, BTreeInfoFixed, BTreeNode, FixedEntry};
#[cfg(any(feature = "alloc", feature = "std"))]
pub use btree::{OwnedBTreeNode, OwnedEntry};
pub use common::{ObjectId, PhysicalAddress, TransactionId, Uuid};
pub use container::{
    CONTAINER_SUPERBLOCK_MAGIC, CheckpointMapBlock, CheckpointMapping, ContainerSuperblock,
};
#[cfg(any(feature = "alloc", feature = "std"))]
pub use filesystem::OwnedDirectoryEntryRecord;
pub use filesystem::{
    DirectoryEntryRecord, FileExtentRecord, FileSystemKey, InodeRecord, XattrRecord,
};
pub use object::{ObjectHeader, ObjectType};
#[cfg(any(feature = "alloc", feature = "std"))]
pub use object_map::VirtualObjectMap;
pub use object_map::{ObjectMapBlock, ObjectMapKey, ObjectMapValue};
#[cfg(any(feature = "alloc", feature = "std"))]
pub use space_manager::{ChunkInfo, parse_chunk_info_block};
pub use space_manager::{SpaceManagerDevice, SpaceManagerSummary};
pub use volume::{VOLUME_MAGIC, VolumeSuperblock};

pub(crate) fn take<const N: usize>(data: &[u8], offset: usize) -> crate::Result<[u8; N]> {
    let end = offset
        .checked_add(N)
        .ok_or(crate::ApfsError::AddressOverflow)?;
    let slice = data
        .get(offset..end)
        .ok_or(crate::ApfsError::InputTooSmall)?;
    Ok(slice.try_into().expect("fixed-size slice"))
}

pub(crate) fn le_u32(data: &[u8], offset: usize) -> crate::Result<u32> {
    Ok(u32::from_le_bytes(take(data, offset)?))
}
pub(crate) fn le_u64(data: &[u8], offset: usize) -> crate::Result<u64> {
    Ok(u64::from_le_bytes(take(data, offset)?))
}