Skip to content
/ redhook Public
forked from geofft/redhook

Dynamic function call interposition / hooking (LD_PRELOAD) for Rust

License

Notifications You must be signed in to change notification settings

sarvi/redhook

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

redhook

redhook is a helper crate for writing interposition libraries (LD_PRELOAD, DYLD_INSERT_LIBRARIES, etc.) in Rust.

To use redhook, edit your Cargo.toml to add redhook as a dependency and configure your library to build as a dylib:

[dependencies]
redhook = "1.0"

[lib]
name = "mylib"
crate_type = ["dylib"]

Then use the hook! macro to declare the function you want to hook, and the name you want to give to your hook function:

redhook::hook! {
    unsafe fn existing_function(x: i32) -> i32 => my_function {
        42
    }
}

To access the underlying function, use redhook::real!(existing_function).

Build your library as usual, find the resulting .so file (or .dylib, for macOS) inside the target directory, and set the LD_PRELOAD (or DYLD_INSERT_LIBRARIES) environment variable to that.

(You can also use redhook without Cargo, with rustc --crate-type=dylib.)

There are a few examples included, as separate crates:

geofft@cactuar:~/src/rust/redhook/examples/readlinkspy$ cargo build
   Compiling redhook v0.0.1 (file:///home/geofft/src/rust/redhook/examples/readlinkspy)
   Compiling redhook_ex_readlinkspy v0.0.1 (file:///home/geofft/src/rust/redhook/examples/readlinkspy)
geofft@cactuar:~/src/rust/redhook/examples/readlinkspy$ LD_PRELOAD=target/debug/libreadlinkspy.so ls -l /bin/sh
readlink("/bin/sh")
lrwxrwxrwx 1 root root 4 Feb 19  2014 /bin/sh -> dash
geofft@cactuar:~/src/rust/redhook/examples/fakeroot$ cargo build
geofft@cactuar:~/src/rust/redhook/examples/fakeroot$ LD_PRELOAD=target/debug/libfakeroot.so id
uid=0(root) gid=1001(geofft) euid=1001(geofft) groups=1001(geofft),27(sudo),111(sbuild)

redhook currently supports building interposition libraries for LD_PRELOAD on glibc (GNU/Linux) and DYLD_INSERT_LIBRARIES on Apple's libc (macOS) from the same source code. If you're interested in support for other platforms, please file an issue or pull request.

redhook is named after the Red Hook neighborhood in Brooklyn, New York. Portions of the implementation borrow heavily from concepts in @Kimundi's lazy_static! macro.

redhook is free software, available under the terms of the 2-clause BSD license.

Build Status

About

Dynamic function call interposition / hooking (LD_PRELOAD) for Rust

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 83.6%
  • Shell 16.4%