Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rodionovd/SWRoute
PoC of function hooking in Swift
https://github.com/rodionovd/SWRoute
Last synced: 3 months ago
JSON representation
PoC of function hooking in Swift
- Host: GitHub
- URL: https://github.com/rodionovd/SWRoute
- Owner: rodionovd
- License: wtfpl
- Archived: true
- Created: 2014-06-14T21:28:07.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2014-08-21T20:00:23.000Z (over 10 years ago)
- Last Synced: 2024-07-31T18:17:45.740Z (6 months ago)
- Language: Swift
- Homepage: https://github.com/rodionovd/SWRoute/wiki/Function-hooking-in-Swift
- Size: 461 KB
- Stars: 586
- Watchers: 28
- Forks: 47
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- awesome-swift - SWRoute - A tiny Swift wrapper. Allows you to route (hook) quite any function/method with another function/method or even a closure. (Extensions)
README
`SWRoute` is a tiny Swift wrapper over [`rd_route()`](https://github.com/rodionovd/rd_route). It allows you to route (hook) quite any function/method with another function/method or even a closure.
**This code hasn't been updated since Xcode beta 1, so it may be outdated. Remember, it's just a proof-of-concept of what you can do in Swift.**
If you're curious how it works, check out an article [„Function hooking in Swift“](https://github.com/rodionovd/SWRoute/wiki/Function-hooking-in-Swift).
> Going to use it in your iOS project? Please, read [the corresponding section](#swroute-and-ios) below.
#### Exported interface
```swift
class SwiftRoute {
class func replace(function targetMethod : MethodT, with replacement : MethodT) -> Int
}
```
##### Arguments
Argument | Type (in/out) | Description
:--------: | :-----------: | :----------
`function` | in | _**(required)**_ a function/method to override
`with` | in| _**(required)**_ any other function/method or closure to overrride a `function` with
##### Return value
`KERN_SUCCESS` (== 0) upon success, `> 0` otherwise.
##### Example usage
(see `SWRouteTests/SWRouteTests.swift` for more)
```swift
class DemoClass {
func demoMethod(arg: Int) -> Int {
return (42 + arg);
}
}
var err = SwiftRoute.replace(function: DemoClass().demoMethod, with: {
(arg : Int) -> Int in
return (90 + arg)
})
```
## SWRoute and iOS
Unfortunately `rd_route` (the back-end of `SWRoute`) doesn't work well on iOS (until jailbroken), because it does some tricks with memory pages that aren't allowed there. But you can choose any other library for function hooking instead! I recommend [`libevil`](https://github.com/landonf/libevil_patch) by Landon Fuller.
You'll only need `rd_get_func_impl.c` source file included into your project to create your version of SWRoute:
```swift
// Route functions in Swift using libevil and rd_get_func_impl()
import Darwin
@asmname("_rd_get_func_impl")
func rd_get_func_impl(Q) -> UInt64;
@asmname("evil_init")
func evil_init();
@asmname("evil_override_ptr")
func evil_override_ptr(UInt64, UInt64, CMutablePointer) -> CInt;
class EvilRoute {
struct onceToken {
static var token : dispatch_once_t = 0
}
class func replace(function targetMethod : MethodT, with replacement : MethodT) -> Int
{
dispatch_once(&onceToken.token, {
evil_init()
})
let err: CInt = evil_override_ptr(rd_get_func_impl(DemoClass().demoMethod),
rd_get_func_impl(someFunction),
nil)
return Int(err)
}
}
```
### License
[WTFPL](http://www.wtfpl.net/).
```cpp
// Copyright © 2014 Dmitry Rodionov
// This work is free. You can redistribute it and/or modify it under the
// terms of the Do What The Fuck You Want To Public License, Version 2,
// as published by Sam Hocevar. See the COPYING file for more details.
```
------
If you found any bug(s) or something, please open an issue or a pull request — I'd appreciate your help! `(^,,^)`
------
*Dmitry Rodionov, 2014*
*[email protected]*