{"id":17952138,"url":"https://github.com/rfratto/viceroy","last_synced_at":"2025-03-25T00:31:39.483Z","repository":{"id":56870709,"uuid":"449081299","full_name":"rfratto/viceroy","owner":"rfratto","description":"Docker base image for C cross compilers","archived":false,"fork":false,"pushed_at":"2024-04-18T03:09:44.000Z","size":199,"stargazers_count":13,"open_issues_count":3,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-19T05:42:15.604Z","etag":null,"topics":["c","cross-compilation","docker","go"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rfratto.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"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}},"created_at":"2022-01-17T23:42:42.000Z","updated_at":"2023-11-24T14:36:33.000Z","dependencies_parsed_at":"2024-04-19T15:37:05.461Z","dependency_job_id":null,"html_url":"https://github.com/rfratto/viceroy","commit_stats":{"total_commits":26,"total_committers":1,"mean_commits":26.0,"dds":0.0,"last_synced_commit":"144f6418cddd1b0cd4f364025cc088b0b4f6f50e"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfratto%2Fviceroy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfratto%2Fviceroy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfratto%2Fviceroy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfratto%2Fviceroy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rfratto","download_url":"https://codeload.github.com/rfratto/viceroy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245377920,"owners_count":20605374,"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":["c","cross-compilation","docker","go"],"created_at":"2024-10-29T09:54:56.318Z","updated_at":"2025-03-25T00:31:39.178Z","avatar_url":"https://github.com/rfratto.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"docs/assets/logo_and_name.png\" alt=\"Viceroy logo\"\u003e\u003c/p\u003e\n\nViceroy is a base Docker image which provides a `viceroycc` binary to cross\ncompile to multiple architectures. It was designed to help ease the burden of\ncross compiling Go projects which have C dependencies.\n\nViceroy is not very useful on its own; it should be extended to add libraries\nand other tools needed to build projects.\n\n## Supported Platforms\n\nViceroy examines the following environment variables to determine which target\nsystem to cross-compile for:\n\n* `VICEROYOS` (or `GOOS`)\n* `VICEROYARCH` (or `GOARCH`)\n* `VICEROYARM` (or `GOARM`)\n\nThese environment variables determine which compiler toolchain to use and some\ndefaults for environment variables (such as `LD_LIBRARY_PATH`). The environment\nvariables will default to values appropriate for the worker container's\nenvironment when unspecified.\n\nThe following target platforms are currently supported:\n\n|          | linux | darwin | freebsd | windows |\n| -------- | ----- | ------ | ------- | ------- |\n| amd64    |     x |      x |       x |       x |\n| 386      |     x |        |       x |       x |\n| armv5    |     x |        |         |         |\n| armv6    |     x |        |         |         |\n| armv7    |     x |        |         |         |\n| arm64    |     x |      x |       x |         |\n| ppc64le  |     x |        |         |         |\n| s390x    |     x |        |         |         |\n\n## Usage\n\n1. Use `rfratto/viceroy` as your Docker base image.\n2. Set `CC=viceroycc`.\n3. Set `VICEROYOS`, `VICEROYARCH`, and `VICEROYARM` as appropriate.\n4. Compile!\n\n## Building locally\n\nThe Viceroy image can be built for your local platform by running `make build`.\n\nThe `OSXCROSS_SDK_URL` environment variable should be set to a URL or path on\nthe host machine to a .tar.xz of an [osxcross][] packaged macOS 11.1 SDK.\n\n[osxcross]: https://github.com/tpoechtrager/osxcross\n\n## Legal note\n\nOSX/Darwin/Apple builds:\n**[Please ensure you have read and understood the Xcode license\n   terms before continuing.](https://www.apple.com/legal/sla/docs/xcode.pdf)**\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frfratto%2Fviceroy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frfratto%2Fviceroy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frfratto%2Fviceroy/lists"}