{"id":13484226,"url":"https://github.com/frida/frida-tools","last_synced_at":"2025-06-26T13:37:04.597Z","repository":{"id":37730810,"uuid":"140466708","full_name":"frida/frida-tools","owner":"frida","description":"Frida CLI tools","archived":false,"fork":false,"pushed_at":"2025-06-23T16:41:35.000Z","size":826,"stargazers_count":396,"open_issues_count":47,"forks_count":111,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-06-23T17:44:52.594Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frida.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"frida"}},"created_at":"2018-07-10T17:31:13.000Z","updated_at":"2025-06-23T16:41:39.000Z","dependencies_parsed_at":"2024-01-13T19:15:25.349Z","dependency_job_id":"5c58cff7-c497-4d20-8860-752864dd3861","html_url":"https://github.com/frida/frida-tools","commit_stats":null,"previous_names":[],"tags_count":114,"template":false,"template_full_name":null,"purl":"pkg:github/frida/frida-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frida%2Ffrida-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frida%2Ffrida-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frida%2Ffrida-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frida%2Ffrida-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frida","download_url":"https://codeload.github.com/frida/frida-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frida%2Ffrida-tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262077174,"owners_count":23255134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T17:01:21.004Z","updated_at":"2025-06-26T13:37:04.575Z","avatar_url":"https://github.com/frida.png","language":"Python","funding_links":["https://github.com/sponsors/frida"],"categories":["Python","Weapons","逆向破解"],"sub_categories":["All"],"readme":"# Frida CLI tools\n\nCLI tools for [Frida](https://frida.re).\n\n### Installing Fish completions\n\nCurrently there is no mechanism to install Fish completions through the setup.py\nscript so if you want to have completions in Fish you will have to install it\nmanually. Unless you've changed your XDG_CONFIG_HOME location, you should just\ncopy the completion file into `~/.config/fish/completions` like so:\n\n    cp completions/frida.fish ~/.config/fish/completions\n\n### frida-itrace file format\n\nFile starts with a 4-byte magic: \"ITRC\"\nhttps://github.com/frida/frida-tools/blob/1ea077fdb49440e5807cf25fae41e389e3d2bd4a/frida_tools/itracer.py#L365-L366\n\nThen, following that, there are two different types of records, MESSAGE and\nCHUNK. Each record starts with a big-endian uint32 specifying the type of\nrecord, where 1 means MESSAGE, 2 means CHUNK.\n\n#### MESSAGE\n\n- `length`: uint32 (big-endian)\n- `message`: JSON, UTF-8 encoded\n- `data_size`: uint32 (big-endian)\n- `data_values`: uint8[data_size]\n\nGenerated [here](https://github.com/frida/frida-tools/blob/1ea077fdb49440e5807cf25fae41e389e3d2bd4a/frida_tools/itracer.py#L451-L458).\n\nThere are three different kinds of MESSAGEs:\n\n- [\"itrace:start\"](https://github.com/frida/frida-tools/blob/1ea077fdb49440e5807cf25fae41e389e3d2bd4a/agents/itracer/agent.ts#L68-L76):\n  Signals that the trace is starting, providing the initial register values.\n  Contains register names and sizes in the JSON portion, and register values in\n  the data portion.\n  Generated [here](https://github.com/frida/frida-itrace/blob/ad7780bde9e518e325d7aaf848e9a29e1a53b7d2/lib/backend.ts#L341-L359).\n- \"itrace:end\": Signals that the endpoint was reached, when specifying a range\n  with an end address included.\n- \"itrace:compile\": Signals that a basic block was discovered, providing the\n  schema of future CHUNKs pertaining to it.\n  Generated [here](https://github.com/frida/frida-itrace/blob/ad7780bde9e518e325d7aaf848e9a29e1a53b7d2/lib/backend.ts#L277-L323)\n  and by the [code](https://github.com/frida/frida-itrace/blob/ad7780bde9e518e325d7aaf848e9a29e1a53b7d2/lib/backend.ts#L398-L401)\n  above it that computes the \"writes\" array.\n\n  The \"writes\" array contains tuples (arrays) that look like this:\n\n    (block_offset, cpu_ctx_offset)\n\n  Where `block_offset` is how many bytes into the basic block the write happens,\n  and `cpu_ctx_offset` is the index into the registers declared by\n  \"itrace:start\".\n\n#### CHUNK\n\n- `size`: uint32 (big-endian)\n- `data`: uint8[size]\n\nGenerated [here](https://github.com/frida/frida-tools/blob/1ea077fdb49440e5807cf25fae41e389e3d2bd4a/frida_tools/itracer.py#L464-L465).\n\nThe CHUNK records combine to a stream of raw register values at different parts\nof the given basic block. Each record looks like this:\n\n- `block_start_address`: uint64 (target-endian, i.e. little-endian on arm64)\n- `link_register_value`: uint64 (target-endian)\n- `block_register_values`: uint64[n], where n depends on the specific basic\n  block. (See above docs on \"itrace:compile\" and its \"writes\" array.)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrida%2Ffrida-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrida%2Ffrida-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrida%2Ffrida-tools/lists"}