{"id":44862848,"url":"https://github.com/everettjf/atosl-rs","last_synced_at":"2026-02-17T10:41:19.618Z","repository":{"id":45146145,"uuid":"443441598","full_name":"everettjf/atosl-rs","owner":"everettjf","description":"🦀️atos for linux by rust - A partial replacement for Apple's atos tool for converting addresses within a binary file to symbols.","archived":false,"fork":false,"pushed_at":"2026-02-07T07:19:06.000Z","size":23,"stargazers_count":85,"open_issues_count":0,"forks_count":18,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-07T07:33:44.575Z","etag":null,"topics":["apple","atos","atosl","cli","dsym","ios","macho","macos","rust","rust-lang","symbolization"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/everettjf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-31T23:40:41.000Z","updated_at":"2026-02-07T07:19:09.000Z","dependencies_parsed_at":"2023-01-25T13:16:34.499Z","dependency_job_id":null,"html_url":"https://github.com/everettjf/atosl-rs","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/everettjf/atosl-rs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everettjf%2Fatosl-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everettjf%2Fatosl-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everettjf%2Fatosl-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everettjf%2Fatosl-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/everettjf","download_url":"https://codeload.github.com/everettjf/atosl-rs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everettjf%2Fatosl-rs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29540287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T08:11:05.436Z","status":"ssl_error","status_checked_at":"2026-02-17T08:09:38.860Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["apple","atos","atosl","cli","dsym","ios","macho","macos","rust","rust-lang","symbolization"],"created_at":"2026-02-17T10:41:19.065Z","updated_at":"2026-02-17T10:41:19.605Z","avatar_url":"https://github.com/everettjf.png","language":"Rust","readme":"# atosl-rs\n\n\u003cdiv align=\"center\"\u003e\n\n[![Crates.io](https://img.shields.io/crates/v/atosl.svg?style=flat-square\u0026color=EA5312)](https://crates.io/crates/atosl)\n[![GitHub Stars](https://img.shields.io/github/stars/everettjf/atosl-rs?style=flat-square\u0026color=FF6B6B)](https://github.com/everettjf/atosl-rs/stargazers)\n[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)\n[![Rust](https://img.shields.io/badge/Rust-1.60+-orange?style=flat-square\u0026logo=rust)](https://www.rust-lang.org)\n\nA partial replacement for Apple's `atos`.\n\nConvert memory addresses to symbols (function names, source files, line numbers) from binaries with symbol info.\n\n\u003c/div\u003e\n\n## Overview\n\n`atosl-rs` is a Rust CLI tool that resolves addresses to readable symbols.\n\n- Works with Mach-O symbol table and DWARF debug info\n- Supports verbose output for troubleshooting\n- Supports file-offset mode for raw offsets\n- Runs on macOS, Linux, and Windows (Rust target support)\n\n## Install\n\n### From crates.io\n\n```bash\ncargo install atosl\n```\n\n### From source\n\n```bash\ngit clone https://github.com/everettjf/atosl-rs.git\ncd atosl-rs\ncargo build --release\n```\n\nBinary path:\n\n```bash\n./target/release/atosl\n```\n\n## Usage\n\nCLI help:\n\n```bash\natosl --help\n```\n\nCurrent syntax:\n\n```bash\natosl [OPTIONS] -o \u003cOBJECT_PATH\u003e -l \u003cLOAD_ADDRESS\u003e [ADDRESSES]...\n```\n\nRequired arguments:\n\n- `-o \u003cOBJECT_PATH\u003e`: binary/symbol file path\n- `-l \u003cLOAD_ADDRESS\u003e`: load address (hex like `0x100000000` or decimal)\n- `[ADDRESSES]...`: one or more addresses to symbolize\n\nOptions:\n\n- `-f`: treat input addresses as file offsets\n- `-v`: verbose debug output\n- `-a, --arch \u003cARCH\u003e`: select architecture for Mach-O fat files (for example `arm64`, `arm64e`, `armv7`, `x86_64`, `i386`)\n- `--uuid \u003cUUID\u003e`: select Mach-O slice by UUID (with or without `-`)\n\n### Examples\n\nResolve one address:\n\n```bash\natosl -o MyApp.app/MyApp -l 0x100000000 0x100001234\n```\n\nResolve multiple addresses:\n\n```bash\natosl -o MyApp.app/MyApp -l 0x100000000 0x100001234 0x100005678\n```\n\nUse file-offset mode:\n\n```bash\natosl -f -o MyApp.app/MyApp -l 0x0 0x1234\n```\n\nEnable verbose output:\n\n```bash\natosl -v -o MyApp.app/MyApp -l 0x100000000 0x100001234\n```\n\nSelect slice from a fat Mach-O by architecture:\n\n```bash\natosl -o Flutter -l 0x100000000 -a arm64 0x100001234\n```\n\nSelect slice from a fat Mach-O by UUID:\n\n```bash\natosl -o Flutter -l 0x100000000 --uuid 34FBD46D-4A1F-3B41-A0F1-4E57D7E25B04 0x100001234\n```\n\n## Output\n\nTypical output format:\n\n```text\n\u003csymbol\u003e (in \u003cbinary\u003e) (\u003cfile\u003e:\u003cline\u003e)\n```\n\nIf only symbol table match is available:\n\n```text\n\u003csymbol\u003e (in \u003cbinary\u003e) + \u003coffset\u003e\n```\n\nIf not found:\n\n```text\nN/A - \u003creason\u003e\n```\n\n## Development\n\n```bash\ncargo check\ncargo build\ncargo build --release\ncargo fmt\ncargo clippy -- -D warnings\n```\n\n## Known limitations\n\n- Not a 1:1 feature-complete clone of Apple's `atos`\n- Accuracy depends on available symbols/DWARF sections in the input binary\n\n## Contributing\n\nIssues and pull requests are welcome.\n\n## License\n\nMIT. See `LICENSE`.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feverettjf%2Fatosl-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feverettjf%2Fatosl-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feverettjf%2Fatosl-rs/lists"}