Code Monkey home page Code Monkey logo

optool's Introduction

optool

optool is a tool which interfaces with MachO binaries in order to insert/remove load commands, strip code signatures, resign, and remove aslr. Below is its help.

optool v0.1

USAGE:
  install -c <command> -p <payload> -t <target> [-o=<output>] [-b] [--resign] In
  serts an LC_LOAD command into the target binary which points to the payload. T
  his may render some executables unusable.

  uninstall -p <payload> -t <target> [-o=<output>] [-b] [--resign] Removes any L
  C_LOAD commands which point to a given payload from the target binary. This ma
  y render some executables unusable.

  strip [-w] -t <target> Removes a code signature load command from the given bi
  nary.

  restore -t <target> Restores any backup made on the target by this tool.

  aslr -t <target> [-o=<output>] [-b] [--resign] Removes an ASLR flag from the m
  acho header if it exists. This may render some executables unusable


OPTIONS:
  [-w --weak] Used with the STRIP command to weakly remove the signature. Withou
  t this, the code signature is replaced with null bytes on the binary and its L
  OAD command is removed.

  [--resign] Try to repair the code signature after any operations are done. Thi
  s may render some executables unusable.

  -t|--target <target> Required of all commands to specify the target executable
   to modify

  -p|--payload <payload> Required of the INSTALL and UNINSTALL commands to speci
  fy the path to a DYLIB to point the LOAD command to

  [-c --command] Specify which type of load command to use in INSTALL. Can be re
  export for LC_REEXPORT_DYLIB, weak for LC_LOAD_WEAK_DYLIB, upward for LC_LOAD_
  UPWARD_DYLIB, or load for LC_LOAD_DYLIB

  [-b --backup] Backup the executable to a suffixed path (in the form of _backup
  .BUNDLEVERSION)

  [-h --help] Show this message


(C) 2014 Alexander S. Zielenski. Licensed under BSD

License

optool is licensed under BSD. Below is the license reproduced in its entirety:

Copyright (c) 2014, Alex Zielenski
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this
  list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice,
  this list of conditions and the following disclaimer in the documentation
  and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

optool's People

Contributors

alexzielenski avatar chihoc avatar loddan avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

optool's Issues

some bug for remove!

BOOL removeLoadEntryFromBinary(NSMutableData *binary, struct thin_header macho, NSString *payload) {
// parse load commands to see if our load command is already there
binary.currentOffset = macho.offset + macho.size;

uint32_t num = 0;
uint32_t cumulativeSize = 0;
uint32_t removedOrdinal = -1;

...........
if ([dylibname isEqualToString:payload] && removedOrdinal != -1) {
// if ([dylibname isEqualToString:payload] && removedOrdinal == -1) { ???
............

removedOrdinal =-1, it will never remove the payload!!!

Installing optool

I'm trying to use optool with patchapp.sh to inject my theos tweak into an .ipa file. However, I can't figure out how to build the xcodeproj or find any way to get the optool binary, help would be appreciated.

Reinject after uninstall some dylib with optool

Hi alexzielenski,
Thank you. I've used it in many projects. It's very great.
Recently I found a problem, when I uninstall a dylib using optool. and then reinject another dylib using yololib (https://github.com/KJCracks/yololib). but It seems wrong. I am not sure whether it is a defect of optool or a defect of yololib. Can you help me? Please see the attachment.

can't clone your repository - it has a submodule to which I don't have access rights.

Hi, I cloned the repo, but it didn't bring with it its submodule.

So, naturally, I tried
git submodule init
git submodule update

and it failed because I didn't have "access rights" to the submodule.

Above this - you set your Xcode project "Base SDK" to 10.9, which no longer exists in recent Xcode releases (Xcode 6.4, Xcode 7.x)

Can you please verify your repository is still usable?

Uninstalling a load command breaks another DYLIBs

Hello! I'm trying to uninstall system lib:
optool uninstall -p "/usr/lib/libsqlite3.dylib" -t "$TARGET_APP_PATH/$APP_BINARY"
All looks like fine, see before and after otool -l output
before.txt
after.txt

But I'm getting an error in runtime about another lib:

dyld: Symbol not found: OBJC_CLASS$_NSFileManager
Referenced from: /var/containers/Bundle/Application/7AFFEF62-62B4-4C44-BF78-4E20467B31AF/IPAPatch-DummyApp.app/Wrapping Test
Expected in: /usr/lib/libobjc.A.dylib
in /var/containers/Bundle/Application/7AFFEF62-62B4-4C44-BF78-4E20467B31AF/IPAPatch-DummyApp.app/Wrapping Test

Can I do something with that?

Please add support for inserting/removing the LC_VERSION_MIN_MACOSX load command

Hi there

I need to do some slightly grim Mach-O header hacking on some precompiled binaries I've been given in order to make Xcode deal with them properly.

It would be great if optool had support for inserting/removing the LC_VERSION_MIN_MACOSX load command - that would be the simplest path to getting those binaries working with Xcode (although perhaps not the cleanest!).

If you're feeling generous, support for LC_VERSION_MIN_IPHONEOS might be an extra bonus for our iOS developer friends.

Can't clone your repository - it has a submodule to which I don't have access rights.

git -c diff.mnemonicprefix=false -c core.quotepath=false -c credential.helper=sourcetree fetch origin
git -c diff.mnemonicprefix=false -c core.quotepath=false -c credential.helper=sourcetree pull origin master
From https://github.com/alexzielenski/optool

  • branch master -> FETCH_HEAD
    Already up-to-date.

git -c diff.mnemonicprefix=false -c core.quotepath=false -c credential.helper=sourcetree submodule update --init --recursive
Cloning into 'optool/FSArgumentParser'...
warning: templates not found /usr/local/git/share/git-core/templates
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
Clone of '[email protected]:NSError/ArgumentParser.git' into submodule path 'optool/FSArgumentParser' failed
Cloning into 'optool/FSArgumentParser'...
warning: templates not found /usr/local/git/share/git-core/templates
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
Clone of '[email protected]:NSError/ArgumentParser.git' into submodule path 'optool/FSArgumentParser' failed
Cloning into 'optool/FSArgumentParser'...
warning: templates not found /usr/local/git/share/git-core/templates
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
Clone of '[email protected]:NSError/ArgumentParser.git' into submodule path 'optool/FSArgumentParser' failed
Cloning into 'optool/FSArgumentParser'...
warning: templates not found /usr/local/git/share/git-core/templates
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
Clone of '[email protected]:NSError/ArgumentParser.git' into submodule path 'optool/FSArgumentParser' failed
Completed with errors, see above

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.