Struct Device

pub struct Device<'a> { /* private fields */ }

Access to a Frida device.

Implementations

impl<'a> Device<'a>

pub fn get_name(&self) -> &str

Returns the device’s name.

pub fn get_id(&self) -> &str

Returns the device’s id.

pub fn get_type(&self) -> DeviceType

Returns the device’s type

Example

assert_eq!(device.get_type(), DeviceType::Local);

pub fn query_system_parameters(&self) -> Result<HashMap<String, Variant>>

Returns the device’s system parameters

Example

let params = device.query_system_parameters().unwrap();
let os_version = params
    .get("os")
    .expect("No parameter \"os\" present")
    .get_map()
    .expect("Parameter \"os\" was not a mapping")
    .get("version")
    .expect("Parameter \"os\" did not contain a version field")
    .get_string()
    .expect("Version is not a string");

pub fn is_lost(&self) -> bool

Returns if the device is lost or not.

pub fn enumerate_processes<'b>(&'a self) -> Vec<Process<'b>>

where 'a: 'b,

Returns all processes.

pub fn attach<'b>(&'a self, pid: u32) -> Result<Session<'b>>

where 'a: 'b,

Creates Session and attaches the device to the current PID.

pub fn spawn<S: AsRef<str>>( &mut self, program: S, options: &SpawnOptions<'_>, ) -> Result<u32>

Spawn a process on the device

Returns the PID of the newly spawned process. On spawn, the process will be halted, and resume will need to be called to continue execution.

pub fn resume(&self, pid: u32) -> Result<()>

Resumes the process with given pid.

pub fn kill(&mut self, pid: u32) -> Result<()>

Kill a process on the device

Trait Implementations

impl Drop for Device<'_>

fn drop(&mut self)

Executes the destructor for this type.

impl Inject for Device<'_>

fn inject_library_file_sync<D, E, P>( &mut self, pid: u32, path: P, entrypoint: E, data: D, ) -> Result<u32>

where D: Into<Vec<u8>>, P: AsRef<Path>, E: AsRef<str>,

Inject a library into a target process

fn inject_library_blob_sync<D, E>( &mut self, pid: u32, blob: &[u8], entrypoint: E, data: D, ) -> Result<u32>

where D: Into<Vec<u8>>, E: AsRef<str>,

Inject a library blob into a target process