Struct inject_lib::Injector

pub struct Injector<'a> {
    pub dll: &'a str,
    pub pid: u32,
}

This Crate Provides functionality, for injecting dlls into other processes. Most of the crate is right now accessible through the Injector class.

You will need to provide a pid, and a dll to inject. This crate will do the rest for you.

The main focus will always be on performing the injection reliable.

If you have any suggestions, on improving the outfacing api of this crate create an issue, or pr. I am not sure yet, if I like this design.

Linux support will probably not come. It is insanely hard and platform specific, because

1. we would need to write raw machinecode/shellcode to the target process.
2. which then has the necessary code to load the .so
3. we need to somehow redirect the target program’s execution, to execute our code
4. we need to do that, without somehow disrupting ANY of the program’s code
5. we need to return the EXACT state before we did anything, because the other program may need that

If this library is supposed to be helpful I’d want to not require to run it as root. Unfortunately some steps involve calling ptrace. Access to the command is restricted, if you are not the parent process of the process you are trying to trace. These requirements would mean, that we can only inject so files to processes, that the program this library itself created. This struct will expose certain module private functions, to actually use the api.

Fields

dll: &'a str

The path to a dll. This may be in any format, that rust understands

pid: u32

The pid the dll should be injected into

Implementations

impl<'a> Injector<'a>

pub fn find_pid<P: AsRef<Path>>(name: P) -> Result<Vec<u32>, Error>

This Function will find all currently processes, with a given name. Even if no processes are found, an empty Vector should return.

pub fn eject(&self) -> Result<(), Error>

This function will attempt, to eject a dll from another process. Notice:This implementation blocks, and waits, until the library is ejected?, or the ejection failed.

pub fn inject(&self) -> Result<(), Error>

Inject a DLL into another process Notice:This implementation blocks, and waits, until the library is injected, or the injection failed.

pub fn find_pid_selector<F>(select: F) -> Result<Vec<u32>, Error> where
    F: Fn(&PROCESSENTRY32W) -> bool, 

Find a PID, where the process-name matches some user defined selector

pub fn get_is_dll_x64(&self) -> Result<bool, Error>

This function will return, whether a dll is x64, or x86. The Return value will be Ok(true), if the dll is x64(64bit), and Ok(false), if the dll is x86(32bit).

impl<'a> Injector<'a>

pub fn new(dll: &'a str, pid: u32) -> Self

Create a new Injector object.

pub fn set_dll(&mut self, dll: &'a str)

Sets the dll

pub fn set_pid(&mut self, pid: u32)

Sets the pid

Trait Implementations

impl<'a> Clone for Injector<'a>

fn clone(&self) -> Injector<'a>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for Injector<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Default for Injector<'a>

fn default() -> Self

Returns the “default value” for a type.