From e43eb99902b8c10a2b200732065fde271e41c14c Mon Sep 17 00:00:00 2001 From: Andrzej Janik Date: Mon, 23 Dec 2024 17:19:38 +0100 Subject: Update README --- GeekBench_5_2_3.svg | 1 - README.md | 17 ++++++++++------- geekbench.svg | 1 + 3 files changed, 11 insertions(+), 8 deletions(-) delete mode 100644 GeekBench_5_2_3.svg create mode 100644 geekbench.svg diff --git a/GeekBench_5_2_3.svg b/GeekBench_5_2_3.svg deleted file mode 100644 index 900e2b1..0000000 --- a/GeekBench_5_2_3.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/README.md b/README.md index 2b6a815..578829c 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ ZLUDA is a drop-in replacement for CUDA on non-NVIDIA GPU. ZLUDA allows to run unmodified CUDA applications using non-NVIDIA GPUs with near-native performance. +![GeekBench 5.5.1 chart](geekbench.svg) + ZLUDA is work in progress. Follow development here and say hi on [Discord](https://discord.gg/sg6BNzXuc7). For more details see the announcement: https://vosen.github.io/ZLUDA/blog/zludas-third-life/ ## Usage @@ -12,8 +14,8 @@ ZLUDA is work in progress. Follow development here and say hi on [Discord](https ### Windows You should have recent AMD GPU driver ("AMD Software: Adrenalin Edition") installed.\ To run your application you should etiher: -* (Recommended approach) Copy ZLUDA-provided `nvcuda.dll` and `nvml.dll` into a path which your application uses to load CUDA. Paths vary application to application, but usually it's the directory where the .exe file is located -* Use ZLUDA launcher like below. ZLUDA launcher is known to be buggy and unfinished +* (Recommended approach) Copy ZLUDA-provided `nvcuda.dll` and `nvml.dll` from `target\release` (if built from sources) or `zluda` (if downloaded a zip package) into a path which your application uses to load CUDA. Paths vary application to application, but usually it's the directory where the .exe file is located +* Use ZLUDA launcher like below. ZLUDA launcher is known to be buggy and incomplete: ``` \zluda_with.exe -- ``` @@ -25,7 +27,7 @@ Run your application like this: LD_LIBRARY_PATH= ``` -where `` is the directory which contains ZLUDA-provided `libcuda.so`: `target\release` if you built from sources or `zluda` if you downloaded prebuilt package. +where `` is the directory which contains ZLUDA-provided `libcuda.so`: `target/release` if you built from sources or `zluda` if you downloaded prebuilt package. ### MacOS @@ -54,9 +56,10 @@ Not supported If you are building on Linux you must also symlink the ZLUDA output binaries after ZLUDA build finishes: ``` cd target/release -ln -s libnvcuda.so target/release/libcuda.so -ln -s libnvcuda.so target/release/libcuda.so.1 -ln -s libnvml.so target/release/libnvidia-ml.so +ln -s libnvcuda.so libcuda.so +ln -s libnvcuda.so libcuda.so.1 +ln -s libnvml.so libnvidia-ml.so +ln -s libnvml.so libnvidia-ml.so.1 ``` ## Contributing @@ -70,7 +73,7 @@ If you want to contribute a code fix or documentation update feel free to open a There's no architecture document (yet). Two most important crates in ZLUDA are `ptx` (PTX compiler) and `zluda` (AMD GPU runtime). A good starting point to tinkering the project is to run one of the `ptx` unit tests under a debugger and understand what it is doing. `cargo test -p ptx -- ::add_hip` is a simple test that adds two numbers. -Github issues tagged with ["help wanted"](https://github.com/vosen/ZLUDA/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) are tasks that are self-containted. Their level of difficulty varies, they are not always great starting points, but they have a relatively clear definition of "done". +Github issues tagged with ["help wanted"](https://github.com/vosen/ZLUDA/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) are tasks that are self-containted. Their level of difficulty varies, they are not always good beginner tasks, but they defined unambiguously. If you have questions feel free to ask on [#devtalk channel on Discord](https://discord.com/channels/1273316903783497778/1303329281409159270). diff --git a/geekbench.svg b/geekbench.svg new file mode 100644 index 0000000..55c1ca5 --- /dev/null +++ b/geekbench.svg @@ -0,0 +1 @@ + \ No newline at end of file -- cgit v1.2.3