Struct Dtb 

pub struct Dtb<'a>(/* private fields */);

设备树二进制对象。

Implementations

impl Dtb<'static>

pub unsafe fn from_raw_parts(ptr: *const u8) -> Result<Self, HeaderError>

构造设备树二进制对象。

Safety

如果指针指向一个有效的 DTB 首部，其中描述的整个二进制对象会被切片。

pub unsafe fn from_raw_parts_filtered( ptr: *const u8, f: impl Fn(&HeaderError) -> bool, ) -> Result<Self, HeaderError>

构造设备树二进制对象。

Safety

如果指针指向一个有效的 DTB 首部，其中描述的整个二进制对象会被切片。

Examples found in repository

examples/qemu-virt.rs (lines 15-20)

fn main() {
    let mut aligned = vec![0usize; DEVICE_TREE.len() / core::mem::size_of::<usize>()];
    unsafe {
        aligned
            .as_mut_ptr()
            .copy_from_nonoverlapping(DEVICE_TREE.as_ptr() as _, aligned.len());
    }

    let dtb = unsafe {
        Dtb::from_raw_parts_filtered(aligned.as_ptr() as _, |e| {
            matches!(
                e,
                HeaderError::Misaligned(4) | HeaderError::LastCompVersion(16)
            )
        })
    }
    .unwrap();
    dtb.walk(|path, obj| match obj {
        DtbObj::SubNode { name } => {
            println!("{}{path}/{}", indent(path.level(), INDENT_WIDTH), unsafe {
                core::str::from_utf8_unchecked(name)
            });
            WalkOperation::StepInto
        }
        DtbObj::Property(prop) => {
            let indent = indent(path.level(), INDENT_WIDTH);
            println!("{indent}{prop:?}");
            WalkOperation::StepOver
        }
    });
    println!("ok");
}

pub unsafe fn from_raw_parts_unchecked(ptr: *const u8) -> Self

不检查首部正确性，直接构造设备树二进制对象。

Safety

假设指针指向一个正确的设备树二进制对象，其首部描述的整个二进制对象会被切片。

impl<'a> Dtb<'a>

pub fn from_slice(slice: &'a [u8]) -> Result<Self, ConvertError>

从内存切片安全地创建设备树二进制对象。

impl Dtb<'_>

pub const fn total_size(&self) -> usize

返回整个二进制对象的尺寸。

pub fn walk(&self, f: impl FnMut(&Path<'_>, DtbObj<'_>) -> WalkOperation)

遍历。

Examples found in repository

examples/qemu-virt.rs (lines 23-35)

fn main() {
    let mut aligned = vec![0usize; DEVICE_TREE.len() / core::mem::size_of::<usize>()];
    unsafe {
        aligned
            .as_mut_ptr()
            .copy_from_nonoverlapping(DEVICE_TREE.as_ptr() as _, aligned.len());
    }

    let dtb = unsafe {
        Dtb::from_raw_parts_filtered(aligned.as_ptr() as _, |e| {
            matches!(
                e,
                HeaderError::Misaligned(4) | HeaderError::LastCompVersion(16)
            )
        })
    }
    .unwrap();
    dtb.walk(|path, obj| match obj {
        DtbObj::SubNode { name } => {
            println!("{}{path}/{}", indent(path.level(), INDENT_WIDTH), unsafe {
                core::str::from_utf8_unchecked(name)
            });
            WalkOperation::StepInto
        }
        DtbObj::Property(prop) => {
            let indent = indent(path.level(), INDENT_WIDTH);
            println!("{indent}{prop:?}");
            WalkOperation::StepOver
        }
    });
    println!("ok");
}