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
48
49

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

impl_ops! {
    /// A thread ID within a system.
    pub struct ThreadId(pub u32);
}

impl_ops! {
    /// A thread object within a system.
    ///
    /// Equivalent to `ETHREAD*` on Windows.
    pub struct ThreadObject(pub Va);
}

impl VmiVa for ThreadObject {
    fn va(&self) -> Va {
        self.0
    }
}

impl ThreadObject {
    /// Checks if the thread object is a null reference.
    pub fn is_null(&self) -> bool {
        self.0.0 == 0
    }

    /// Converts the thread object to a 64-bit unsigned integer.
    pub fn to_u64(&self) -> u64 {
        self.0.0
    }
}

/// A trait for thread objects.
///
/// This trait provides an abstraction over threads within a guest OS.
pub trait VmiOsThread<'a, Driver>: VmiVa + 'a
where
    Driver: VmiDriver,
{
    /// The VMI OS type.
    type Os: VmiOs<Driver = Driver, Thread<'a> = Self>;

    /// Returns the thread ID.
    fn id(&self) -> Result<ThreadId, VmiError>;

    /// Returns the thread object.
    fn object(&self) -> Result<ThreadObject, VmiError>;
}