Skip to main content

A set of tools for Mach-O executables analysis on OS X

Project description Code Climate

A Python toolbox for Mach-O files analysis. Heavily relies on macholib.


For usage

$ [sudo] pip install machobot

For development

$ pip install nose macholib
$ git clone machobot
$ cd ./machobot
$ nosetests # run the test suite


  • As a command-line util:

    $ inject_dylib ./target "@rpath/mylib.dylib"
  • As a Python module:

    import machobot

    Example usage:

    import machobot.dylib as dylib
    dylib.insert_load_command("output.a", "@executable_path/../../libk.dylib")



insert_load_command (target_path, library_install_name)

Inserts a new LC_LOAD_DYLIB load command into the target Mach-O header.

Argument Description
target_path A path to the target Mach-O executable file. This file will be overwritten.
library_install_name An install name for the library to inject. This string is used as a part of the load command.
Return value
Returns True if everything is OK. Otherwise rises an exception.
macho_dependencies_list (target_path, header_magic=None)

Generates a list of libraries the given Mach-O file depends on.

In that list a single library is represented by its “install path”: for some libraries it would be a full file path, and for others it would be a relative path (sometimes with dyld templates like @executable_path or @rpath in it).

Note: I don’t know any reason why would some architectures of a fat Mach-O depend on certain libraries while others don’t, but it’s technically possible. So that’s why you may want to specify the header_magic value for a particular header.

Argument Description
target_path A path to the target Mach-O executable file.
header_magic Mach-O MAGIC value for a header you want to inspect. If this argument is not provided, the function returns a list of the first header’s dependencies.
Return value
An object with two properties: weak and strong that hold lists of weak and strong dependencies respectively.

See machobot/tests/ for usage examples.

Found an issue? Submit an issue! :shipit:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

machobot-0.1.5.tar.gz (6.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page