vmi-core 0.7.0

Core VMI library
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

use super::{VmiOs, impl_predicate};
use crate::{Va, VmiDriver, VmiError, VmiVa};

impl_predicate! {
    /// Predicate used for filtering user modules.
    pub trait UserModulePredicate & impl for &str {
        fn matches(&self, module: &Os::UserModule<'_>) -> Result<bool, VmiError> {
            Ok(module.name()?.eq_ignore_ascii_case(self))
        }
    }

    #[any]
    pub struct AnyUserModule;
}

/// A trait for user-mode modules.
///
/// This trait provides an abstraction over modules loaded into a process
/// address space, such as executables and shared libraries.
pub trait VmiOsUserModule<'a, Driver>: VmiVa + 'a
where
    Driver: VmiDriver,
{
    /// The VMI OS type.
    type Os: VmiOs<Driver = Driver, UserModule<'a> = Self>;

    /// Returns the base address of the module.
    ///
    /// # Platform-specific
    ///
    /// - **Windows**: `LDR_DATA_TABLE_ENTRY.DllBase`
    fn base_address(&self) -> Result<Va, VmiError>;

    /// Returns the size of the module.
    ///
    /// # Platform-specific
    ///
    /// - **Windows**: `LDR_DATA_TABLE_ENTRY.SizeOfImage`
    fn size(&self) -> Result<u64, VmiError>;

    /// Returns the name of the module.
    ///
    /// # Platform-specific
    ///
    /// - **Windows**: `LDR_DATA_TABLE_ENTRY.BaseDllName`
    fn name(&self) -> Result<String, VmiError>;
}