TypeInformation

Struct TypeInformation 

Source
pub struct TypeInformation { /* private fields */ }
Expand description

Type information acquired from the BTF data

Implementations§

Source§

impl TypeInformation

Source

pub fn new(readable: &dyn Readable) -> BTFResult<Self>

Creates a new TypeInformation object

Examples found in repository?
examples/dump-btf.rs (line 44)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 2 {
36        println!("Usage:\n\tdump-btf /path/to/btf/file\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    println!("Opening BTF file: {btf_file_path:?}");
42
43    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
44    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
45    println!("{:?}", type_information.get());
46}
More examples
Hide additional examples
examples/get-type-size.rs (line 46)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 3 {
36        println!("Usage:\n\tget-type-size /path/to/btf/file <type_name>\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    let btf_type_name = &argument_list[2];
42
43    println!("Opening BTF file: {btf_file_path:?}");
44
45    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
46    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
47
48    let type_id = type_information.id_of(btf_type_name).unwrap();
49    let type_size = type_information.size_of(type_id).unwrap();
50    println!("Type {btf_type_name} has ID {type_id} and requires {type_size} bytes in total");
51}
examples/get-type-offset.rs (line 47)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 4 {
36        println!("Usage:\n\tget-type-offset /path/to/btf/file <type_name> <path>\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    let btf_type_name = &argument_list[2];
42    let type_path = &argument_list[3];
43
44    println!("Opening BTF file: {btf_file_path:?}");
45
46    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
47    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
48    let offset = type_information
49        .offset_of(type_information.id_of(btf_type_name).unwrap(), type_path)
50        .unwrap();
51
52    println!("{btf_type_name} => {type_path}: {offset:?}");
53}
Source

pub fn get(&self) -> &BTreeMap<u32, TypeVariant>

Returns the entire type map

Examples found in repository?
examples/dump-btf.rs (line 45)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 2 {
36        println!("Usage:\n\tdump-btf /path/to/btf/file\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    println!("Opening BTF file: {btf_file_path:?}");
42
43    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
44    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
45    println!("{:?}", type_information.get());
46}
Source

pub fn id_of(&self, type_name: &str) -> Option<u32>

Returns the type id for the given type name

Examples found in repository?
examples/get-type-size.rs (line 48)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 3 {
36        println!("Usage:\n\tget-type-size /path/to/btf/file <type_name>\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    let btf_type_name = &argument_list[2];
42
43    println!("Opening BTF file: {btf_file_path:?}");
44
45    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
46    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
47
48    let type_id = type_information.id_of(btf_type_name).unwrap();
49    let type_size = type_information.size_of(type_id).unwrap();
50    println!("Type {btf_type_name} has ID {type_id} and requires {type_size} bytes in total");
51}
More examples
Hide additional examples
examples/get-type-offset.rs (line 49)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 4 {
36        println!("Usage:\n\tget-type-offset /path/to/btf/file <type_name> <path>\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    let btf_type_name = &argument_list[2];
42    let type_path = &argument_list[3];
43
44    println!("Opening BTF file: {btf_file_path:?}");
45
46    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
47    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
48    let offset = type_information
49        .offset_of(type_information.id_of(btf_type_name).unwrap(), type_path)
50        .unwrap();
51
52    println!("{btf_type_name} => {type_path}: {offset:?}");
53}
Source

pub fn from_id(&self, tid: u32) -> Option<TypeVariant>

Returns the type object for the given type id

Source

pub fn name_of(&self, tid: u32) -> Option<String>

Returns the name of the given type id

Source

pub fn pointee_tid(&self, tid: u32) -> BTFResult<u32>

Returns the pointee type id

Source

pub fn size_of(&self, tid: u32) -> BTFResult<usize>

Returns the size of the given type id

Examples found in repository?
examples/get-type-size.rs (line 49)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 3 {
36        println!("Usage:\n\tget-type-size /path/to/btf/file <type_name>\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    let btf_type_name = &argument_list[2];
42
43    println!("Opening BTF file: {btf_file_path:?}");
44
45    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
46    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
47
48    let type_id = type_information.id_of(btf_type_name).unwrap();
49    let type_size = type_information.size_of(type_id).unwrap();
50    println!("Type {btf_type_name} has ID {type_id} and requires {type_size} bytes in total");
51}
Source

pub fn offset_of(&self, tid: u32, path: &str) -> BTFResult<(u32, Offset)>

Returns a tuple containing the next type id and the current offset

Examples found in repository?
examples/get-type-offset.rs (line 49)
33fn main() {
34    let argument_list: Vec<String> = env::args().collect();
35    if argument_list.len() != 4 {
36        println!("Usage:\n\tget-type-offset /path/to/btf/file <type_name> <path>\n");
37        return;
38    }
39
40    let btf_file_path = Path::new(&argument_list[1]);
41    let btf_type_name = &argument_list[2];
42    let type_path = &argument_list[3];
43
44    println!("Opening BTF file: {btf_file_path:?}");
45
46    let vmlinux_btf_file = ReadableFile::new(btf_file_path);
47    let type_information = TypeInformation::new(&vmlinux_btf_file).unwrap();
48    let offset = type_information
49        .offset_of(type_information.id_of(btf_type_name).unwrap(), type_path)
50        .unwrap();
51
52    println!("{btf_type_name} => {type_path}: {offset:?}");
53}

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.