5
5

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

CydiaSubstrate target.

Posted at

この記事は iOS Jailbreaking Advent Calendar 2015 の4日目の記事です。

ターゲット

SIMBLもそうですが、当然dylibをロードしたいプロセスとそうでないプロセス、つまりターゲットがあります。
CydiaSubstrateではdylibと同名のplistファイルに所定の書式で記述しておくことでターゲットのフィルタリングがされます。

フォーマット

OpenStep方式でフルに書くと以下のようになります。※厳密にはCoreFoundationVersionキーを使う場合はOpenStep形式では小数点のある数値を扱えないのでXMLで書く必要があります。

{
  Filter = {
    Bundles = ("com.apple.mobilesafari", "com.apple.springboard");
    Executables = ("backboardd", "mediaserverd");
    Classes = ("WKWebView", "AVPlayer");
    CoreFoundationVersion = (1140.00, 1240.00);
    Mode = "Any";
    Flags = 2;
  };
}

Bundles

NSBundle.mainBundle.bundleIdentifierで得られるStringでターゲットを記述します。Arrayなので複数をターゲットに出来ます。

Executables

NSBundle.mainBundle.bundleIdentifierが設定されていないプロセス(おもにデーモン)をターゲットにする場合にその実行ファイル名を記述します。Arrayなので複数をターゲットに出来ます。

Classes

プロセスに記述したクラスがロードされているかどうかでフィルタリングします。NSClassFromString()がNULLかどうかになります。Arrayなので複数をターゲットに出来ます。

Mode

その昔は前述の3種類のフィルター、Bundles, Executables, Classesは1種類のみを利用する事を想定されていました。判断順序はExecutables -> Bundles -> Classesの順なので例の場合backboarddとmediaserverdのみがターゲットとなりSpringBoardやSafariそしてWKWebViewかAVPlayerクラスがロードされているプロセスへはロードされない実装でした。
これを組み合わせて使えるようにModeパラメータが追加されました。取りうる値は"Any"のみで、これが指定されていると3種類のフィルターのどれかに合致すればロードされます。

CoreFoundationVersion

先日説明したkCFCoreFoundationVersionでiOSバージョンに応じてフィルタリング出来ます。Arrayで値を1つか2つ記述します。
1つの場合はgreater判定のみで上述の例だと1140.00 > kCFCoreFoundationVersionNumberになります。
2つ記述がある場合はgreater thanとless equalになり
1140.00 > kCFCoreFoundationVersionNumber && 1240.00 <= kCFCoreFoundationVersionNumberになります。
1140.10がiOS 8.0で1240.10がiOS 9のバージョンなのでそれぞれ少し値を減らす事で例ではiOS 8.xがターゲットになります。

Flags

隠しパラメータのFlagsキー。2を指定するとロードせずにスキップしてくれます。デバッグ用でしょうか。Stringで記述するとエラーになりますのでIntegerで書く必要があります。

<key>Flags</key>
<integer>2</integer>

注意

元祖CoreFoundationVersionフィルター機能がこのターゲットフィルターの記述ですが、PreferenceLoaderにおけるCoreFoundationVersionフィルターはgreater than, less equalではなくgreater equal, less thanとなっていますのでご注意を。個人的にはPreferenceLoaderの形式の方が使いやすいと思います。

5
5
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
5
5

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?