list_threads_in_process
Retrieve threads from a specific process using its upid or name. Supports pagination with limit and offset to navigate large thread lists.
Instructions
List threads in one process or same-named process set: tid, thread_name, pid, upid, machine_id. Limit 2000, cap 5000.
Use when: drilling into a process from list_processes.
Don't use for: ALL trace threads — use execute_sql on thread.
Parameters: pass either upid (trace-internal id, precise — prefer when multiple processes share a name like 'Renderer') or process_name (exact match). upid wins when both are set. Optional limit and offset page large result sets; both accept numbers or numeric strings.
Output: exact row_count, returned_rows, truncated/has_more; rows are ordered by pid/tid. process_counts reports per-upid counts for same-name fan-out.
Empty result: returned as an error pointing at list_processes for available candidates.
When truncated=true, increase offset or drill down with upid.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| upid | No | Process upid (the trace-internal unique id from `list_processes`). Takes precedence over `process_name` when both are set — useful for disambiguating same-named processes (e.g. multiple Renderer instances). Accepts both numbers and numeric strings. | |
| limit | No | Optional max rows to return. Defaults to 2000, capped at 5000. Accepts both numbers and numeric strings. Must be > 0 when set. | |
| offset | No | Optional row offset for pagination. Defaults to 0. Accepts both numbers and numeric strings. | |
| trace_id | No | Optional trace id returned by `load_trace`. Omit to use the active trace. | |
| process_name | No | Process name to match exactly (e.g. "com.android.chrome", "/system/bin/init"). Either this or `upid` must be provided. |