Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
xmrig authored Oct 28, 2019
1 parent 32d64d2 commit eee367f
Showing 1 changed file with 39 additions and 1 deletion.
40 changes: 39 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,40 @@
# xmrig-cuda
NVIDIA CUDA plugin for XMRig miner
This repository is NVIDIA CUDA plugin for XMRig miner v4.5+ and it adds support for NVIDIA GPUs in XMRig miner.

Main reasons why this plugin is separated project is:
1. CUDA support is optional, not all users need it, but it is very heavy.
2. CUDA has very strict compiler version requirements, it may conflicts with CPU mining code, for example now possible build the miner with gcc on Windows (CUDA works only with MSVC).


## Windows usage

* [Download](https://github.com/xmrig/xmrig-cuda/releases) plugin, you must choose CUDA version, usually it recent version (CUDA 10.1), but builds with older CUDA version also provided, alternative you can build the plugin from source.
* Place **`xmrig-cuda.dll`** and other dll files near to **`xmrig.exe`**.
* Edit **`config.json`** to enable CUDA support.
```
{
...
"cuda": {
"enabled": true,
...
}
...
}
```
### Advanced
Path to plugin can be specified via `loader` option:
```
{
...
"cuda": {
"enabled": true,
"loader": "c:/some/path/xmrig-cuda.dll",
...
}
...
}
```
Due of restrictions of JSON format directory separator must be written in Linux style `/` or escaped `\\`.

## Linux usage
Linux usage almost same with Windows expept we don't provide binaries and you must build the plugin form source and name of plugin is different **`libxmrig-cuda.so`**.

0 comments on commit eee367f

Please sign in to comment.