Struct minidump_writer::ptrace_dumper::PtraceDumper

pub struct PtraceDumper {
    pub pid: Pid,
    pub threads: Vec<Thread>,
    pub auxv: HashMap<u64, u64>,
    pub mappings: Vec<MappingInfo>,
    /* private fields */
}

Fields

pid: Pid

threads: Vec<Thread>

auxv: HashMap<u64, u64>

mappings: Vec<MappingInfo>

Implementations

impl PtraceDumper

pub fn new(pid: Pid) -> Result<Self, InitError>

Constructs a dumper for extracting information of a given process with a process ID of |pid|.

pub fn init(&mut self) -> Result<(), InitError>

pub fn late_init(&mut self) -> Result<(), InitError>

pub fn copy_from_process(
    child: Pid,
    src: *mut c_void,
    num_of_bytes: usize
) -> Result<Vec<u8>, DumperError>

Copies content of |length| bytes from a given process |child|, starting from |src|, into |dest|. This method uses ptrace to extract the content from the target process. Always returns true.

pub fn suspend_thread(child: Pid) -> Result<(), DumperError>

Suspends a thread by attaching to it.

pub fn resume_thread(child: Pid) -> Result<(), DumperError>

Resumes a thread by detaching from it.

pub fn suspend_threads(&mut self) -> Result<(), DumperError>

pub fn resume_threads(&mut self) -> Result<(), DumperError>

pub fn get_thread_info_by_index(
    &self,
    index: usize
) -> Result<ThreadInfo, ThreadInfoError>

Read thread info from /proc/$pid/status. Fill out the |tgid|, |ppid| and |pid| members of |info|. If unavailable, these members are set to -1. Returns true if all three members are available.

pub fn get_stack_info(
    &self,
    int_stack_pointer: usize
) -> Result<(usize, usize), DumperError>

pub fn sanitize_stack_copy(
    &self,
    stack_copy: &mut [u8],
    stack_pointer: usize,
    sp_offset: usize
) -> Result<(), DumperError>

pub fn find_mapping(&self, address: usize) -> Option<&MappingInfo>

pub fn find_mapping_no_bias(&self, address: usize) -> Option<&MappingInfo>

pub fn elf_file_identifier_from_mapped_file(
    mem_slice: &[u8]
) -> Result<Vec<u8>, DumperError>

pub fn elf_identifier_for_mapping_index(
    &mut self,
    idx: usize
) -> Result<Vec<u8>, DumperError>

pub fn elf_identifier_for_mapping(
    mapping: &mut MappingInfo,
    pid: Pid
) -> Result<Vec<u8>, DumperError>

Trait Implementations

impl Debug for PtraceDumper

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

Formats the value using the given formatter.

impl Drop for PtraceDumper

fn drop(&mut self)

Executes the destructor for this type.