trace_data_flow
Trace data flow by following cross-references from or to an address, traversing forward (xrefs-from) or backward (xrefs-to) through multiple hops to reveal code paths and data dependencies.
Instructions
Follow cross-references from or to an address, automatically traversing multiple hops. 'forward' follows xrefs-from, 'backward' follows xrefs-to. Returns nodes (with function name, instruction, code/data classification) and edges. Do not use for call graph traversal — use callgraph for that.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"addr": "<addr>",
"instance_id": "<instance_id>"
},
"name": "trace_data_flow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| addr | Yes | Starting address | |
| direction | No | 'forward' (xrefs from) or 'backward' (xrefs to) | |
| max_depth | No | Maximum traversal depth (default 5, max 20) | |
| instance_id | Yes | Target IDA instance ID (required) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start | No | ||
| direction | No | ||
| depth_reached | No | ||
| nodes | No | ||
| edges | No | ||
| error | No |