Observe Native Calls
observe_native_callsLaunch the active Mach-O under LLDB to auto-record entries into chosen functions or Objective-C methods, capturing thread, module, addresses, arguments, selector, receiver class, and caller frames.
Instructions
Launch the active Mach-O as an owned process under LLDB and record each entry into caller-selected functions or Objective-C methods: thread, module, symbol, load and file address, raw argument registers, selector, receiver class and optional caller frames. Every hit auto-continues. No expression is evaluated and no other process is attached. The process is killed when max_events or duration_ms is reached; exit status, captured stdout/stderr, unresolved breakpoints and limitations are returned inline. The process runs with the current user's permissions and may change files, show UI or use the network. A hardened-runtime target needs the get-task-allow entitlement.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"arguments": [
"--help"
],
"breakpoints": [
{
"kind": "objc-method",
"selector": "dataTaskWithRequest:completionHandler:",
"class_name": "NSURLSession"
},
{
"kind": "function",
"name": "open",
"module": "libsystem_kernel.dylib"
}
],
"duration_ms": 5000,
"backtrace_frames": 4
},
"name": "observe_native_calls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| arguments | No | ||
| max_events | No | Stop observing and kill the process after this many recorded entries. | |
| breakpoints | Yes | ||
| duration_ms | No | Observation window; the process is killed if it is still running. | |
| environment | No | Overrides on top of the environment REA runs with. | |
| backtrace_frames | No | Caller frames to record per entry. | |
| working_directory | No | ||
| argument_registers | No | Integer argument registers to record per entry (arm64 has 8, x86_64 has 6). |