Example of code injection using mach_star on Mac OS X
Objective-C Shell
Latest commit 5b5a290 Dec 22, 2011 @samdeane samdeane fixed double release
Failed to load latest commit information.


About ECInjection

This is an evolution of the ECHelper project.

Like ECHelper, it installs a helper application that is launched by launchd and runs with enhanced privileges.

In this project though, the helper's purpose is to inject a code bundle into another application.

The project includes some sample injected code which adds a menu to the application that it is injected into.

The Parts

This sample consists of three targets, and also builds one target from a subproject:

  • host: this is the application that provides a user interface for the sample, performs the installation of the helper if necessary, and lets you trigger the injection.
  • injector: this is the helper application that gets installed into /Library and launched by launchd.
  • injected: this is the code bundle that gets injected into whatever application you choose
  • mach_inject_bundle_stub.bundle: this is a small bundle that is part of the mach_star code injection project; the injector application uses it to perform the injection

How It Works

The way the project is set up, the host application provides an interface with a couple of buttons and some text.

Whilst running it tries to use IPC to communicate with the injector helper app and the injected code, and reports back on whether or not they seem to be available.

A button in the UI allows us to install the helper if it's not present. This bit requires root permissions so we get a authentication dialog.

Once the helper is installed and running, we can use it to inject code with the other button in the UI.

The host invokes the inject command in the helper, passing it the bundle to inject and the app to target as parameters.

This is clearly not very secure, but hey - it's an example. At this point the injector also needs to be able to find the mach_inject_bundle_stub.bundle. In theory this could live anywhere. Ideally we'd put it inside the injector helper so it could never lose track of it, but we can't do that because the injector is a plain vanilla executable and not a bundle.

So for convenience in the demo, we put the stub bundle inside the injected code bundle - since we're passing that to the injector anyway. In a more real-world scenario where the injector ran autonomously rather than being triggered by something external, we might pass the stub bundle to the injector during the installation phase, and have it copy it somewhere inside /Library so that it can always find it later.

The injected code just adds a menu to the application's menubar called "Injector", with a single item in it that just logs stuff to the console.


Once again I should point out that this example pretty much ignores security when it comes to the inter-process communication between the host application, the injection helper, and the injected code. Which isn't to say that it's not useful, simply that you'd have to batten it down far tighter if you want to avoid opening up some potentially horrible security holes.

In the sample, the helper is launched on demand, and only does the injection in response to a command from something else. In a real-world scenario, I guess it would make more sense for it to watch for the target app to launch and do the injection then, assuming that you want the code to be injected whenever the target is running.

It would also make more sense if the various parameters were embedded into the helper to lock it down tighter and avoid it being subverted.

In it's current form, you can view the sample as the basis for an "injection server". This in turn could form the basis of some sort of application-enhancer style system allowing multiple client applications to inject code into multiple targets. I leave that as an exercise for the reader.


The project is based on existing examples, but attempts to present things in a slightly cleaner / simpler way.

It uses Wolf Rentzsch's mach_star to do the heavy lifting for the injection task.

The helper app part of the example is based on my ECHelper example