mmor 0.1.3

mmor provides an OS-agnostic API for enumerating memory-mapped objects in the current process and resolving a symbol's address to its name and parent library. Useful for finding the addresses of libraries or the process' executable, as well as mapping the process global offset table without hardcoding each entry's offset in the table in your program.
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
50
51
52
53
54

# libgib

libgib is a collection of Rust libraries that support building programs
that run inside other programs via code injection. libgib's libraries
provide OS-agnostic tooling to help locate code and data in the current
process and manipulate the underlying memory.

The main goal of libgib is to make Rust usable for dynamic analysis
when reverse engineering other programs. For example: by overwriting
an external function pointer in a process' global offset table to
point at a proxy function written in Rust.

## Libraries

- `afnative` - afnative provides an abstraction for operating-system-specific
  sockets like Unix sockets and Windows named pipes
- `dlrkit` - dlrkit provides an API for interacting with the dynamic linker
  and loading libraries at runtime such as .so files and .dll files. Useful
  for executing code from external libraries using the C ABI
- `mmor` - mmor provides an OS-agnostic API for enumerating memory-mapped
  objects in the current process and resolving a symbol's address to its
  name and parent library. Useful for finding the addresses of libraries
  or the process' executable, as well as mapping the process global offset
  table without hardcoding each entry's offset in the table in your program
- `mrevise` - mrevise abstracts operating on the current process' memory,
  including: modifying memory protections (permissions), allocating memory,
  and finding byte patterns. This library is a fork of Jacob Read's [mem][pr]
  crate from their Pocket Relay project

## Examples

For examples of composing libgib's libraries together, refer to the
[examples/](examples/) directory.

For individual library API examples, refer to each library's rustdoc.

## Special thanks

This codebase (namely the `mrevise` library) started as a fork of
Jacob Read's `mem` crate from their [Mass Effect 3 PocketRelay project][pr].
Even if you are not interested in gaming, you should check out Jacob's
work - their Rust code is an excellent reference resource.

The `dlrkit` library started as yet-another take on dynamic loading
of libraries at run time (but with minimal external dependencies).
I adopted the "phantom data" lifetime enforcement idea from OpenByteDev's
[dlopen2][dlopen2] library.

The `afnative` library is a fork of Daniel Griffen's excellent
[windows-named-pipe][wnp] library.

[pr]: https://github.com/PocketRelay/PocketRelayClientPlugin/blob/2faa7a2f718fec3cc90345bc9b3a84aa282a1e57/src/hooks/mem.rs
[dlopen2]: https://github.com/OpenByteDev/dlopen2
[wnp]: https://gitlab.com/dgriffen/windows-named-pipe/