ldid

From iPhone Development Wiki
Revision as of 05:07, 10 March 2022 by CKatri (talk | contribs) (Use Procursus Team's maintained ldid fork for manual installation instructions.)


ldid is a tool made by saurik for modifying a binary's entitlements easily. ldid also generates SHA1 and SHA256 hashes for the binary signature, so the iPhone kernel executes the binary. The package name in Cydia is "Link Identity Editor".

Usage

ldid -e <binary> dumps the binary's entitlements.

ldid -Sent.xml <binary> sets the binary's entitlements, where ent.xml is the path to an entitlements file.

ldid -S <binary> pseudo-signs a binary with no entitlements.

For example, if you wanted to add the entitlements in a file on your desktop named Entitlements.xml to debugserver in your current directory, you would run:

ldid -S/Users/you/Desktop/Entitlements.xml ./debugserver

Man page

LDID(1) 		FreeBSD General Commands Manual 	       LDID(1)

NAME
     ldid – Link Identity Editor

SYNOPSIS
     ldid [-aDdehMPqu] [-Acputype:subtype]
	  [-C[adhoc | enforcement | expires |
	  hard | host | kill | library-validation | restrict | runtime]]
	  [-Kkey.p12] [-r | -Sfile | -s] [-Ttimestamp] file ...

DESCRIPTION
     ldid adds SHA1 and SHA256 hashes to a Mach-O file so that they can be run
     on a system that has validation but not signature verification.

     -a       Print the CPU types and subtypes in hexadecimal.

     -Acputype:subtype
	      When used with -a, -D, -e, -h, -q, or -u, only act on the slice
	      specified by cputype and subtype.  cputype and subtype should
	      both be integers.

     -C[adhoc | enforcement | expires | hard | host | kill |
	      library-validation | restrict | runtime]
	      Specify the option flags to embed in the code signature.	See
	      codesign(1) for details about these options.

     -D       Reset the cryptid.

     -d       Print the cryptid in the binaries if it exists.  For
	      compatibility reasons it also acts as -h, but this will be
	      removed in the future.

     -e       Print the entitlements in each slice, or the slice specified by
	      -A, to stdout.

     -h       Print information about the signature, such as hash types,
	      flags, CDHash, and CodeDirectory version to stdout.

     -Kkey.p12
	      Sign using the identity in key.p12.  This will give the binary a
	      valid signature so that it can be run on a system with signature
	      validation.  key.p12 must not have a password.

     -M       When used with -S, merge the new and existing entitlements
	      instead of replacing the existing entitlements, this is useful
	      for adding a few specific entitlements to a handful of binaries.

     -P       Mark the Mach-O as a platform binary.

     -Qfile   Embed the requirements found in file.

     -q       Print embedded requirements of the binaries.

     -r       Remove the signature from the Mach-O.

     -S[file]
	      Pseudo sign the Mach-O binaries.	If file is specified then the
	      entitlements found in file will be embedded in the Mach-O.

     -s       Resign the Mach-O binaries while keeping the existing
	      entitlements.

     -Ttimestamp
	      When signing a dylib, set the timestamp to timestamp.  timestamp
	      should be an UNIX timestamp in seconds, if timestamp is a single
	      dash (‘-’), the timestamp will be set to a hash of the Mach-O
	      header.

     -u       If the binary was linked against UIKit, then print the UIKit
	      version that the Mach-O binaries was linked against.

EXAMPLES
     The command:

	   ldid -S file

     will fakesign file with no entitlements.

     The command:

	   ldid -Cadhoc -K/path/to/key.p12 -Sent.xml file

     will sign file using the key in /path/to/key.p12 with the entitlements
     found in ent.xml, and mark it as an adhoc signature.

     The command:

	   ldid -Sent.xml -M file

     will add the entitlements in ent.xml to the entitlements already in file.

     The command:

	   ldid -e file > ent.xml

     will save the entitlements found in each slice of file to ent.xml.

SEE ALSO
     codesign(1)

HISTORY
     The ldid utility was written by Jay "Saurik" Freeman.  iPhoneOS 1.2.0 and
     2.0 support was added on April 6, 2008.  -S was added on June 13, 2008.
     SHA256 support was added on August 25, 2016, fixing iOS 11 support.  iOS
     14 support was added on July 31, 2020 by Kabir Oberai.  iOS 15 support
     was added on June 11, 2021.

iPhoneDevWiki			October 8, 2021 		 iPhoneDevWiki

Installation

Via Procursus, Brew, Fink, or from source:

git clone https://github.com/ProcursusTeam/ldid
cd ldid
make
install -m755 ldid $THEOS/bin/ldid

Mirrors

External links