diff --git a/README.md b/README.md index d7f99b9..d419864 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,18 @@ ![GitHub](https://img.shields.io/github/license/Eraden/amdgpud) -[![amdgpud](https://badgen.net/badge/Discord%20Activity/Currently%20Online/green?icon=discord)](https://discord.gg/HXN2QXj3Gv) +[![amdgpud](https://badgen.net/badge/Discord%20Activity/Online/green?icon=discord)](https://discord.gg/HXN2QXj3Gv) +[![amdgpud](https://badgen.net/badge/Discord%20Activity/Online/green?icon=buymeacoffee)](https://discord.gg/HXN2QXj3Gv) + +[![Buy me a coffee](https://static.ita-prog.pl/buy-me-a-coffee-64x64.png) This project is created with love. Please, support me](https://www.buymeacoffee.com/eraden) # AMD GPU management tools This repository holds couple tools for AMD graphic cards -* `amdfand` - fan speed daemon -* `amdvold` - voltage and overclocking tool -* `amdmond` - monitor daemon -* `amdguid` - GUI manager -* `amdgui-helper` - daemon with elevated privileges to scan for `amdfand` daemons, reload them and save config files +* `amdfand` - fan speed daemon (MUSL) +* `amdvold` - voltage and overclocking tool (MUSL) +* `amdmond` - monitor daemon (MUSL) +* `amdguid` - GUI manager (GLIBC) +* `amdgui-helper` - daemon with elevated privileges to scan for `amdfand` daemons, reload them and save config files (MUSL) For more information please check README each of them. @@ -25,3 +28,86 @@ For more information please check README each of them. ## License This work is dual-licensed under Apache 2.0 and MIT. You can choose between one of them if you use this work. + +## Supported OS + +Only Linux is supported. + +BSD OS may work if compiled from source, but it wasn't tested. +I also don't know how to enable all amd gpu features on BSD. + +### Officially supported + +* Arch Linux +* Ubuntu 18.04 +* Ubuntu 20.04 + +### Other + +It should be possible to run MUSL programs on any Linux distribution. + +GLIBC applications depends on shared glibc libraries and version of this library MUST match. + +If you have other version you may download linked version and place it in application directory. + +Or you can compile it from source + +#### Compile + +```bash +./scripts/build.sh +``` + +#### Download missing shared libraries + +##### Check linked versions + +```bash +ldd ./amdguid +``` + +Example output: + +``` + linux-vdso.so.1 (0x00007ffd706df000) + libxcb.so.1 => /usr/lib/libxcb.so.1 (0x00007f4254a50000) + libxcb-render.so.0 => /usr/lib/libxcb-render.so.0 (0x00007f4254a40000) + libxcb-shape.so.0 => /usr/lib/libxcb-shape.so.0 (0x00007f4254a3b000) + libxcb-xfixes.so.0 => /usr/lib/libxcb-xfixes.so.0 (0x00007f4254a31000) + libdl.so.2 => /usr/lib/libdl.so.2 (0x00007f4254a2c000) + libgcc_s.so.1 => /usr/lib/libgcc_s.so.1 (0x00007f4254a11000) + librt.so.1 => /usr/lib/librt.so.1 (0x00007f4254a0a000) + libpthread.so.0 => /usr/lib/libpthread.so.0 (0x00007f4254a05000) + libm.so.6 => /usr/lib/libm.so.6 (0x00007f425491d000) + libc.so.6 => /usr/lib/libc.so.6 (0x00007f4254713000) + /lib64/ld-linux-x86-64.so.2 => /usr/lib64/ld-linux-x86-64.so.2 (0x00007f42556a6000) + libXau.so.6 => /usr/lib/libXau.so.6 (0x00007f425470e000) + libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0x00007f4254706000) +``` + +If anything is missing you may download is and place it side-by-side with binary + +##### Example: + +``` +opt/ +├─ amdguid/ +│ ├─ amdguid +│ ├─ shared_lib_a/ +│ ├─ shared_lib_b/ +usr/ +├─ bin/ +│ ├─ amdguid +``` + +Where: + +* `/opt/amdguid/amdguid` is binary file +* `/usr/bin/amdguid` is shell script with following content + +```bash +#!/usr/bin/env bash + +cd /opt/amdguid +./amdguid +```