Skip to content

Latest commit

 

History

History
412 lines (328 loc) · 9.28 KB

README.md

File metadata and controls

412 lines (328 loc) · 9.28 KB
Raw

libidevice

A library to communicate with services on iOS devices using native protocols.

Based on libimobiledevice, additionally implemented instrument_service.

​

Build

  1. Compile the libimobiledevice project first, and then set its pkgconfig output directory to the IMB_PKG_CONFIG_PATH environment variable.

e.g.:

$ export IMB_PKG_CONFIG_PATH="../libimobiledevice/built/darwin-arm64/lib/pkgconfig"
  1. Compile with CMake.
$ mkdir build && cd build
$ cmake ..
// or cmake -G "Xcode" ..

​

Usage

libidevice

idevice_t device = ...;

DTXTransport* transport = new DTXTransport(device, false);
DTXConnection* connection = new DTXConnection(transport);
connection->Connect();

std::shared_ptr<DTXChannel> channel = connection->MakeChannelWithIdentifier(
    "com.apple.instruments.server.services.deviceinfo");
std::shared_ptr<DTXMessage> message = DTXMessage::Create("runningProcesses");
channel->SendMessageAsync(message,  [&](auto msg) {
    printf("reply handler\n");
    msg->Dump();
});

​

idevice

running_processes

Print the list of running processes on your iPhone:

$ idevice instruments running_processes

output:

[
    {
        "isApplication": false,
        "name": "FamilyControlsAgent",
        "pid": 4417,
        "realAppName": "/System/Library/Frameworks/FamilyControls.framework/FamilyControlsAgent",
        "startDate": {
            "time": "1661865623.956983"
        }
    },
    {
        "isApplication": false,
        "name": "routined",
        "pid": 40,
        "realAppName": "/usr/libexec/routined",
        "startDate": {
            "time": "1661787079.115298"
        }
    }
]

​

request_device_gpu_info

Query the GPU infomation of your iPhone:

$ idevice instruments request_device_gpu_info

output:

[
    {
        "accelerator-id": 4294967943,
        "agx-tracecode-version": "3.24.4",
        "device-name": "A13",
        "displays": [
            {
                "accelerator-id": 4294967943,
                "built-in": true,
                "device-name": "LCD",
                "display-id": 1,
                "framebuffer-index": 0,
                "pixel-height": 2688,
                "pixel-width": 1242,
                "resolution": [
                    1242,
                    2688
                ]
            }
        ],
        "family-name": "A13",
        "headless": false,
        "low-power": false,
        "min-collection-interval": 0,
        "mobile": true,
        "perf-state": {
            "accelerator-id": 4294967943,
            "available": true,
            "enabled": false,
            "level": 0,
            "mapping": 16975360,
            "sustained": false
        },
        "product-name": "",
        "recommended-max-working-set-size": 2620473344,
        "removable": false,
        "supported-counter-profiles": [
            0,
            3,
            4,
            1
        ],
        "vendor-name": "Apple"
    }
]

​

hardware_information

Query the hardware infomation of your iPhone:

$ idevice instruments hardware_information

output:

{
    "hwCPU64BitCapable": 1,
    "hwCPUsubtype": 2,
    "hwCPUtype": 16777228,
    "numberOfCpus": 6,
    "numberOfPhysicalCpus": 6
}

​

network_information

Query the network infomation of your iPhone:

$ idevice instruments network_information

output:

{
    "en0": "Wi-Fi",
    "en1": "Ethernet Adapter (en1)",
    "en2": "Ethernet Adapter (en2)",
    "lo0": "Loopback"
}

​

mach_time_info

Query the Mach time infomation of your iPhone:

$ idevice instruments mach_time_info

output:

[
    1627750298767,
    125,
    3,
    3382495349528,
    1661927999.285198,
    "Asia/Shanghai"
]

​

execname_for_pid

Get the binary executable name of the pid:

$ idevice instruments execname_for_pid --pid <pid>

output:

"/private/var/containers/Bundle/Application/36430233-EAA7-40DC-A9B8-25AD189342E6/WeChat.app/WeChat"

​

graphics_opengl

Get the profile data of graphics opengl in real-time:

$ idevice instruments graphics_opengl

output:

{
    "Alloc system memory": 556269568,
    "Allocated PB Size": 3145728,
    "CoreAnimationFramesPerSecond": 0,
    "Device Utilization %": 0,
    "IOGLBundleName": "Built-In",
    "In use system memory": 16449536,
    "Renderer Utilization %": 0,
    "SplitSceneCount": 0,
    "TiledSceneBytes": 0,
    "Tiler Utilization %": 0,
    "XRVideoCardRunTimeStamp": 9164067,
    "recoveryCount": 0
}
{
    "Alloc system memory": 556269568,
    "Allocated PB Size": 3145728,
    "CoreAnimationFramesPerSecond": 0,
    "Device Utilization %": 0,
    "IOGLBundleName": "Built-In",
    "In use system memory": 16449536,
    "Renderer Utilization %": 0,
    "SplitSceneCount": 0,
    "TiledSceneBytes": 0,
    "Tiler Utilization %": 0,
    "XRVideoCardRunTimeStamp": 10180084,
    "recoveryCount": 0
}

​

networking

Get the profile data of networking in real-time:

$ idevice instruments networking

output:

[1,["EALz2goL6h4AAAAAAAAAAA==","EAIBuxH9V9AAAAAAAAAAAA==",12,18446744073709551614,0,0,84,1]]
[2,[4,24,5,284,0,0,0,0.018500,0.016750,84,135]]
[2,[0,0,0,0,0,0,0,0.123781,0.123781,147,120]]

​

energy

Get the profile data of energy in real-time:

$ idevice instruments energy --pid <pid>

output:

{
    "12408": {
        "energy.appstate.cost": 2,
        "energy.appstate.overhead": 0,
        "energy.cost": -10,
        "energy.cpu.cost": 0,
        "energy.cpu.overhead": 0,
        "energy.display.cost": 0,
        "energy.display.overhead": 0,
        "energy.gpu.cost": 0,
        "energy.gpu.overhead": 0,
        "energy.inducedthermalstate.cost": 18446744073709551615,
        "energy.location.cost": 0,
        "energy.location.overhead": 0,
        "energy.networking.cost": 0,
        "energy.networkning.overhead": 0,
        "energy.overhead": -10,
        "energy.thermalstate.cost": 0,
        "energy.version": 1,
        "kIDEGaugeSecondsSinceInitialQueryKey": 5
    }
}

​

get_value

Get Developer mode status:

$ idevice get_value com.apple.security.mac.amfi DeveloperModeStatus

output:

DeveloperModeStatus: 1

​

set_developer_mode

$ idevice set_developer_mode 0

mode:

  • 0: reveal toggle in settings
  • 1: enable developer mode (only if no passcode is set)
  • 2: answers developer mode enable prompt post-restart?

​

decode

This command is used to decode the binary records of communication messages with Xcode:

$ idevice decode --hex received_outfile.bin transmit_outfile.bin

output:

==== DTXMessage ====
message_type: 2
identifier: 5100
conversation_index: 0
channel_code: 0
expects_reply: 1
auxiliary:
DTXPrimitiveArray, size=2: 
	item #0: [type=kSignedInt32, size=4, value=18]
	item #1: [type=kBuffer, size=184, value="com.apple.instruments.server.services.assets"]
  00000000h:  62 70 6C 69 73 74 30 30 D4 01 02 03 04 05 06 07  bplist00........
  00000010h:  0A 58 24 76 65 72 73 69 6F 6E 59 24 61 72 63 68  .X$versionY$arch
  00000020h:  69 76 65 72 54 24 74 6F 70 58 24 6F 62 6A 65 63  iverT$topX$objec
  00000030h:  74 73 12 00 01 86 A0 5F 10 0F 4E 53 4B 65 79 65  ts....._..NSKeye
  00000040h:  64 41 72 63 68 69 76 65 72 D1 08 09 54 72 6F 6F  dArchiver...Troo
  00000050h:  74 80 01 A2 0B 0C 55 24 6E 75 6C 6C 5F 10 2C 63  t.....U$null_.,c
  00000060h:  6F 6D 2E 61 70 70 6C 65 2E 69 6E 73 74 72 75 6D  om.apple.instrum
  00000070h:  65 6E 74 73 2E 73 65 72 76 65 72 2E 73 65 72 76  ents.server.serv
  00000080h:  69 63 65 73 2E 61 73 73 65 74 73 08 11 1A 24 29  ices.assets...$)
  00000090h:  32 37 49 4C 51 53 56 5C 00 00 00 00 00 00 01 01  27ILQSV\........
  000000a0h:  00 00 00 00 00 00 00 0D 00 00 00 00 00 00 00 00  ................
  000000b0h:  00 00 00 00 00 00 00 8B                          ........
payload(size=175):
  00000000h:  62 70 6C 69 73 74 30 30 D4 01 02 03 04 05 06 07  bplist00........
  00000010h:  0A 58 24 76 65 72 73 69 6F 6E 59 24 61 72 63 68  .X$versionY$arch
  00000020h:  69 76 65 72 54 24 74 6F 70 58 24 6F 62 6A 65 63  iverT$topX$objec
  00000030h:  74 73 12 00 01 86 A0 5F 10 0F 4E 53 4B 65 79 65  ts....._..NSKeye
  00000040h:  64 41 72 63 68 69 76 65 72 D1 08 09 54 72 6F 6F  dArchiver...Troo
  00000050h:  74 80 01 A2 0B 0C 55 24 6E 75 6C 6C 5F 10 23 5F  t.....U$null_.#_
  00000060h:  72 65 71 75 65 73 74 43 68 61 6E 6E 65 6C 57 69  requestChannelWi
  00000070h:  74 68 43 6F 64 65 3A 69 64 65 6E 74 69 66 69 65  thCode:identifie
  00000080h:  72 3A 08 11 1A 24 29 32 37 49 4C 51 53 56 5C 00  r:...$)27ILQSV\.
  00000090h:  00 00 00 00 00 01 01 00 00 00 00 00 00 00 0D 00  ................
  000000a0h:  00 00 00 00 00 00 00 00 00 00 00 00 00 00 82     ...............
"_requestChannelWithCode:identifier:"
==== /DTXMessage ====

==== DTXMessage ====
message_type: 0
identifier: 5100
conversation_index: 1
channel_code: 0
expects_reply: 0
auxiliary:
none
payload(size=0):
==== /DTXMessage ====