Difference between revisions of "RocketBootstrap"

From iPhone Development Wiki
Jump to: navigation, search
m (Reverted edits by Uroboro (talk) to last revision by Abcdev)
m (How to use this library: New format.)
Line 11: Line 11:
 
== How to use this library ==
 
== How to use this library ==
  
Headers are available from [https://github.com/rpetrich/RocketBootstrap/tree/master RocketBootstrap's GitHub project] and the library can be found at <code>/usr/lib/librocketbootstrap.dylib</code> on a device where RocketBootstrap is installed. If using Theos, place the headers in <code>$THEOS/include/RocketBootstrap</code>, the library in <code>$THEOS/lib/</code> and add <code>rocketbootstrap</code> to the <code>XXX_LIBRARIES</code> Makefile variable. Further more make sure to add <code>AppSupport</code> to the <code>XXX_PRIVATE_FRAMEWORKS</code> and declare the interface of <code>CPDistributedMessagingCenter</code> when using the sample code.
+
Headers are available from [https://github.com/rpetrich/RocketBootstrap/tree/master RocketBootstrap's GitHub project] and the library can be found at <code>/usr/lib/librocketbootstrap.dylib</code> on a device where RocketBootstrap is installed. If using Theos, place the headers in <code>$THEOS/include/RocketBootstrap</code>, the library in <code>$THEOS/lib/</code>.
  
You should add <code>, com.rpetrich.rocketbootstrap (>= 1.0.2) | firmware (<< 7.0)</code> to your <code>Depends</code> field on your package's control file.
+
=== Include directive ===
 +
 
 +
<source lang="objc">
 +
#import <rocketbootstrap/rocketbootstrap.h>
 +
</source>
 +
 
 +
=== Makefile ===
 +
 
 +
Add to your Makefile:
 +
 
 +
* <code>rocketbootstrap</code> to the <code>XXX_LIBRARIES</code> variable.
 +
* <code>AppSupport</code> to the <code>XXX_PRIVATE_FRAMEWORKS</code> variable.
 +
 
 +
=== Packaging ===
 +
 
 +
Add to your package's control file:
 +
 
 +
* <code>, com.rpetrich.rocketbootstrap (>= 1.0.2) | firmware (<< 7.0)</code> to the <code>Depends</code> field.
  
 
== Example Usage ==
 
== Example Usage ==

Revision as of 22:00, 6 August 2016

RocketBootstrap
Cydia Package
Developer Ryan Petrich
Package ID com.rpetrich.rocketbootstrap
Latest Version 1.0.2


RocketBootstrap is a library that solves a denied lookup error of IPC services on iOS 7 and above[1].

"One common way processes communicate with each other on iOS and OS X is through a messaging system called mach ports. Each port is a channel that can either receive or send messages. There is a central registration system for these ports called bootstrap, where ports can be registered and accessed by a service name assigned to them. Recent versions of iOS restrict which names a process can access—MobileMail, MobileSafari and App Store apps are only allowed to access a very specific set of services that come with iOS. RocketBootstrap adds a secondary lookup service that doesn't restrict which processes can access which services."

How to use this library

Headers are available from RocketBootstrap's GitHub project and the library can be found at /usr/lib/librocketbootstrap.dylib on a device where RocketBootstrap is installed. If using Theos, place the headers in $THEOS/include/RocketBootstrap, the library in $THEOS/lib/.

Include directive

#import <rocketbootstrap/rocketbootstrap.h>

Makefile

Add to your Makefile:

  • rocketbootstrap to the XXX_LIBRARIES variable.
  • AppSupport to the XXX_PRIVATE_FRAMEWORKS variable.

Packaging

Add to your package's control file:

  • , com.rpetrich.rocketbootstrap (>= 1.0.2) | firmware (<< 7.0) to the Depends field.

Example Usage

Server inside a SpringBoard tweak

#import "rocketbootstrap.h"
    
CPDistributedMessagingCenter *c = [CPDistributedMessagingCenter centerNamed:@"com.mycompany.myCenter"];
// apply rocketbootstrap regardless of iOS version (via rpetrich)
rocketbootstrap_distributedmessagingcenter_apply(c);
[c runServerOnCurrentThread];
[c registerForMessageName:@"myMessageName" target:myTarget selector:@selector(handleMessageNamed:withUserInfo:)];

Client from sandboxed app

#import "rocketbootstrap.h"
    
CPDistributedMessagingCenter *c = [%c(CPDistributedMessagingCenter) centerNamed:@"com.mycompany.myCenter"];
rocketbootstrap_distributedmessagingcenter_apply(c);
[c sendMessageName:@"myMessageName" userInfo:nil]; //send an NSDictionary here to pass data

Usage notes

If you want to run a server inside a daemon, then you still need a simple SpringBoard tweak, that just has to call bootstrap_unlock with the service name (take the code from the rocket bootstrap header and include bootstrap.h). Then you can run a server with the same name inside your daemon. rocketbootstrap_distributedmessagingcenter_apply must still be called on both the server and on the clients. It even works for sendMessageAndReceiveReplyName.

You shouldn't be registering Mach services in sandboxed apps; RocketBootstrap allows exposing services to sandboxed apps, but can't allow exposing services from sandboxed apps without exposing a very large security flaw.

Assuming there aren't any security problems, actually calling a service that's running inside of an app from SpringBoard (which is usually what people want to do) is problematic. Backgrounding apps causes them to enter a frozen "SIGSTOP" state, which means any calls to the service running inside of the app will block indefinitely.

Even if that is suppressed, it could happen that the SpringBoard part attempts to call the service running in the app at the same time as the app is trying to call any of the usual SpringBoard services. When that happens, they deadlock. This might happen infrequently, but it's a really bad failure case in that the system just hangs. Real users will encounter it, if it's present.

You can call from a background thread (not good, it could stay alive for a long time), or use timeouts (not good, now you have to tune it and you get UI hitches) or use asynchronous code (not bad, but it's more work than you may be willing to go through).

See also

References

External links