{"id":21048173,"url":"https://github.com/hikariknight/ls-iommu","last_synced_at":"2025-05-15T19:32:09.335Z","repository":{"id":143165212,"uuid":"609888538","full_name":"HikariKnight/ls-iommu","owner":"HikariKnight","description":"A tool to list devices in iommu groups, useful for setting up VFIO","archived":false,"fork":false,"pushed_at":"2024-06-19T20:51:40.000Z","size":108,"stargazers_count":36,"open_issues_count":1,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-12T05:38:40.271Z","etag":null,"topics":["gpu-pass-through","gpu-passthrough","iommu","iommu-group","lspci","pci-passthrough","qemu","utility","vfio","vfio-passthrough","vfio-pci","virtual-machine","virtualization"],"latest_commit_sha":null,"homepage":"","language":"Go","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/HikariKnight.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"HikariKnight","patreon":null,"open_collective":null,"ko_fi":"HikariKnight","tidelift":null,"community_bridge":null,"liberapay":"HikariKnight","issuehunt":null,"otechie":null,"custom":null}},"created_at":"2023-03-05T14:44:35.000Z","updated_at":"2025-03-08T19:41:10.000Z","dependencies_parsed_at":"2024-01-07T14:46:30.179Z","dependency_job_id":"143dcd75-3fde-4d6b-9c86-bb900cbb2f69","html_url":"https://github.com/HikariKnight/ls-iommu","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HikariKnight%2Fls-iommu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HikariKnight%2Fls-iommu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HikariKnight%2Fls-iommu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HikariKnight%2Fls-iommu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HikariKnight","download_url":"https://codeload.github.com/HikariKnight/ls-iommu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254407448,"owners_count":22066249,"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":["gpu-pass-through","gpu-passthrough","iommu","iommu-group","lspci","pci-passthrough","qemu","utility","vfio","vfio-passthrough","vfio-pci","virtual-machine","virtualization"],"created_at":"2024-11-19T14:42:25.402Z","updated_at":"2025-05-15T19:32:09.092Z","avatar_url":"https://github.com/HikariKnight.png","language":"Go","funding_links":["https://github.com/sponsors/HikariKnight","https://ko-fi.com/HikariKnight","https://liberapay.com/HikariKnight"],"categories":[],"sub_categories":[],"readme":"# ls-iommu\nA tool to list devices in iommu groups, useful for setting up VFIO and is a dependency for [quickpassthrough](https://github.com/HikariKnight/quickpassthrough)\n\nThis tool is a go implementation and extension to the small bash script provided by Wendell from Level1Techs.\nIt's purpose was to just list every device and their associated IOMMU group.\n\nThis project does the same thing, but extends the functionality by implementing arguments to list the output in different ways or provide just the details needed without having to hop through grep, sed, awk or perl pipe hoops.\n\nYou can [download the latest release](https://github.com/HikariKnight/ls-iommu/releases/) from the releases page\n\n## Features\nCurrently the program supports the same behavior as Wendell's ls-iommu script but can also be told to display:\n- Output sorted properly by IOMMU group\n- Only devices in selected IOMMU groups\n- Only specific devices (ex: GPUs, USB controllers, SATA controllers, etc)\n- Tailor the output to show only what you care about\n- Locate relative devices sharing the same IOMMU group\n- Display currently used kernel driver for listed devices\n- Display only device IDs for queried devices\n- Display only PCI addresses queried devices\n- Display rom path for GPUs (or the selected GPU using `-i` to only show devices in a specific IOMMU group)\n\nMore functionality can be added if it is deemed useful, just open an issue with the request.\n\u003cbr\u003e\n**Note:** arm64 builds are generated but not tested as I lack the relevant hardware.\n\n![helptext](https://github.com/HikariKnight/ls-iommu/assets/2557889/4c04e171-5b21-4858-8810-76daa7d15303)\n![gpu output](https://github.com/HikariKnight/ls-iommu/assets/2557889/a6ef282b-dc25-493b-8a7c-3f5cd8fcff3f)\n![getting info from specific devices](https://github.com/HikariKnight/ls-iommu/assets/2557889/19bf09d6-76e6-47c7-8875-3aa73c327e15)\n![display specific info](https://github.com/HikariKnight/ls-iommu/assets/2557889/c0453d50-db09-4d41-8701-59477a567654)\n\n\n## Build instructions\nPrerequisites: \n* Go 1.20+\n* git\n\nThis will build the latest `ls-iommu` and set the version to the latest commit hash.\n```bash\ngit clone https://github.com/HikariKnight/ls-iommu.git\ncd ls-iommu\ngo mod download\nCGO_ENABLED=0 go build -ldflags=\"-X github.com/HikariKnight/ls-iommu/internal/version.Version=$(git rev-parse --short HEAD)\" -o ls-iommu cmd/main.go\n```\nNOTE: you can build with newer dependencies (can break things) by running `go get -u ./cmd` after `go mod download`\n\nThe binary `ls-iommu` will now be located the root of the project directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhikariknight%2Fls-iommu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhikariknight%2Fls-iommu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhikariknight%2Fls-iommu/lists"}