Skip to content

Circleci project setup #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 128 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
128 commits
Select commit Hold shift + click to select a range
920a334
AMD: workaround driver memory leaks
psychocrypt Mar 22, 2019
ac03aba
simple miner startup
psychocrypt Mar 21, 2019
d3a7dc1
Merge pull request #2363 from psychocrypt/topic-simpleStartup
fireice-uk Mar 23, 2019
5f84ed0
Merge pull request #2366 from psychocrypt/fix-driverMemoryLeakAMD_block
fireice-uk Mar 23, 2019
87e146e
format all files
Mar 24, 2019
18b0483
Merge pull request #2367 from psychocrypt/topic-formatAllFiles
fireice-uk Mar 28, 2019
253864e
use different issue templates
psychocrypt Mar 26, 2019
9e237e9
update version to 2.10.3
psychocrypt Mar 28, 2019
25f3334
Merge pull request #2376 from psychocrypt/topic-issueTemplates
fireice-uk Mar 28, 2019
47c5029
Merge pull request #2378 from psychocrypt/topic-versionUpdateTo2.10.3
fireice-uk Mar 28, 2019
d27e3a6
Merge pull request #2379 from fireice-uk/dev
fireice-uk Mar 28, 2019
3e73a3d
fix execution issue template
psychocrypt Mar 28, 2019
3d1d37a
Merge pull request #2380 from psychocrypt/fix-executionIssueTemplate
fireice-uk Mar 28, 2019
2cd84c8
Merge pull request #2381 from fireice-uk/dev
fireice-uk Mar 28, 2019
d8d24bb
fix simple start
psychocrypt Mar 29, 2019
50c7bb3
avoid hash rate drop during dev pool mining
psychocrypt Mar 29, 2019
21c1796
Merge pull request #2385 from psychocrypt/fix-simpleStart
fireice-uk Mar 30, 2019
41cdbaf
Merge pull request #2387 from psychocrypt/topic-noDevPoolHashRate2
fireice-uk Mar 30, 2019
38e7eb0
fix cn_r block 1802223 bug
psychocrypt Apr 1, 2019
8e07b13
version increase to 2.10.4
psychocrypt Apr 1, 2019
3af3653
Merge pull request #2390 from psychocrypt/fix-cnR1802223
fireice-uk Apr 1, 2019
c2618d7
Merge pull request #2391 from psychocrypt/topic-versionIncreaseTo2.10.4
fireice-uk Apr 1, 2019
a5b8fb7
Merge pull request #2392 from fireice-uk/dev
fireice-uk Apr 1, 2019
0840778
concurrent hash rate calculation
psychocrypt Apr 2, 2019
711c088
fix benchmark mode
psychocrypt Apr 17, 2019
726fa32
Merge pull request #2393 from psychocrypt/topic-concurrentHashRateCalc
fireice-uk Apr 23, 2019
0f5e20d
Merge pull request #2409 from psychocrypt/fix-benchmarkMode
fireice-uk Apr 23, 2019
94063f3
--log CLI parameter
o2genum Apr 27, 2019
2854b31
change lethean POW to cn_r
psychocrypt Apr 30, 2019
cf1be39
Merge pull request #2415 from o2genum/topic-log-parameter
psychocrypt Apr 30, 2019
e9a8563
change xmr pool suggestion
psychocrypt Apr 30, 2019
08492ea
rename intense to lethean
psychocrypt May 1, 2019
a83b48c
change stellite to torque
psychocrypt May 1, 2019
5df0f1b
remove freehaven support
psychocrypt May 1, 2019
3c9c904
Autoconf fallback
o2genum Oct 23, 2018
e6c3f7b
--h-print-time CLI option
o2genum May 3, 2019
b2e4316
Enabling/disabling GPUs from CLI
o2genum May 3, 2019
268eba0
Merge pull request #2419 from psychocrypt/topic-letheanPowUpdate
fireice-uk May 15, 2019
6f873d1
Merge pull request #2420 from psychocrypt/topic-changeXmrPoolSuggestion
fireice-uk May 15, 2019
93d5a6b
Merge pull request #2423 from psychocrypt/fix-missedCoinRename
fireice-uk May 15, 2019
db5ea91
Merge pull request #2425 from psychocrypt/topic-renameFreehavenSupport
fireice-uk May 15, 2019
ec11363
Merge pull request #2426 from psychocrypt/topic-renameCoinStellite
fireice-uk May 18, 2019
89bc144
Merge pull request #2430 from o2genum/topic-cpu-autoadjust-fallback
psychocrypt May 18, 2019
d551d07
Merge pull request #2431 from o2genum/topic-cli-hashrate-print-time
psychocrypt May 19, 2019
0347fce
Store GPU index in miner thread
amoiseev May 20, 2019
55fd122
Accepted/rejected share: print responsible GPU and pool
amoiseev May 20, 2019
6fa64d6
Do not fail with "use_slow_memory" : "warn" and --noUAC on Windows 7…
o2genum Apr 28, 2019
743273c
NVIDIA: optimize cryptonight_gpu
psychocrypt May 31, 2019
4968514
Merge pull request #2442 from o2genum/topic-shares-print-gpu-and-pool
psychocrypt May 31, 2019
4211295
dev release option
psychocrypt May 31, 2019
c0ea66b
Merge pull request #2443 from psychocrypt/topic-cng-tune
fireice-uk Jun 1, 2019
4ce226b
Merge pull request #2444 from psychocrypt/topic-dev_release
fireice-uk Jun 1, 2019
92780ad
increase version to 2.10.5
psychocrypt Jun 8, 2019
a2d6c1a
OpenCL: rocm shuffle
psychocrypt Jun 8, 2019
1b0686c
Merge pull request #2416 from o2genum/topic-nouac-dont-fail
fireice-uk Jun 9, 2019
c6f0217
Merge pull request #2447 from psychocrypt/topic-amdShuffleRocm
fireice-uk Jun 9, 2019
27dc1ec
Merge pull request #2448 from psychocrypt/topic-versionIncreaseTo2.10.5
fireice-uk Jun 9, 2019
38dbae9
Merge pull request #2432 from o2genum/topic-cli-enabled-gpus
psychocrypt Jun 9, 2019
b846a6f
Merge pull request #2449 from fireice-uk/dev
fireice-uk Jun 9, 2019
0745a5d
Updated the broken links in usage.md
smirzaei Jun 19, 2019
9c25bc7
doc edits and fixes
Ryo-RU Jun 24, 2019
b74ff88
NVIDIA: fix cryptonight_v8 and derived pows
psychocrypt Jun 30, 2019
442581e
NVIDIA: releax 'threads' config
psychocrypt Jun 30, 2019
3a4708e
Merge pull request #2463 from Ryo-RU/dev
psychocrypt Jun 30, 2019
fa08b26
Merge pull request #2467 from psychocrypt/fix-cn8
fireice-uk Jul 2, 2019
00a8479
Merge pull request #2468 from psychocrypt/topic-relaxNvidiaThreads
fireice-uk Jul 2, 2019
3092595
Make explicit the architecture of the project at beginning
waltercool Jul 16, 2019
e8565a8
fix AMD driver 19.7.X bug
psychocrypt Jul 20, 2019
ad846c4
increase version to 2.10.6
psychocrypt Jul 20, 2019
b9c86b4
Merge pull request #2482 from psychocrypt/tfix-crappyAMDDriverBUG
fireice-uk Jul 21, 2019
8ae44a0
Merge pull request #2483 from psychocrypt/topic-versionIncreaseTo2.10.6
fireice-uk Jul 21, 2019
5869b9e
Merge pull request #2485 from fireice-uk/dev
fireice-uk Jul 21, 2019
38ecd0d
NVIDIA: fix broken phase 3
psychocrypt Jul 31, 2019
59d0147
AMD: optimize VEGA auto suggestion
psychocrypt Jul 31, 2019
ad47040
set version to 2.10.7
psychocrypt Jul 31, 2019
5f6f7b4
Merge pull request #2477 from waltercool/dev
psychocrypt Jul 31, 2019
d1afcec
remove unsupported currencies
psychocrypt Jul 31, 2019
644c882
Merge pull request #2495 from psychocrypt/fix-nvidiaBrokenPhase3
fireice-uk Jul 31, 2019
e35d4a9
Merge pull request #2494 from psychocrypt/topic-betterVegaCNGPUAutosu…
fireice-uk Jul 31, 2019
0d66879
Merge pull request #2497 from psychocrypt/topic-removeUnsupportedCurr…
fireice-uk Jul 31, 2019
7f261e9
Merge pull request #2496 from psychocrypt/topic-versionIncreaseTo2.10.7
fireice-uk Jul 31, 2019
bb189ad
Merge pull request #2458 from smirzaei/dev
psychocrypt Jul 31, 2019
fd19a5d
Merge pull request #2498 from fireice-uk/dev
fireice-uk Jul 31, 2019
506942a
Update compile_Windows.md
joey741019 Aug 19, 2019
292db29
AMD: optimize auto adjustement
psychocrypt Aug 24, 2019
28be412
AMD: optimize fiji and radeon VII auto config cn-gpu
psychocrypt Aug 24, 2019
8251393
fix used `empty()` instead of `clear()`
psychocrypt Aug 24, 2019
d048bf7
fix useless mutex
psychocrypt Aug 24, 2019
8fe6928
Merge pull request #2521 from psychocrypt/fix-usedEmtyINsteadOfClear
fireice-uk Aug 26, 2019
cd540b5
Merge pull request #2522 from psychocrypt/fix-uselessMutex
fireice-uk Aug 26, 2019
bfd0ccd
Merge pull request #2520 from psychocrypt/topic-optmimizeFijiCnGPU
fireice-uk Aug 30, 2019
08eff30
Merge pull request #2518 from psychocrypt/topic-amdOptimzeAutoadjustment
fireice-uk Aug 30, 2019
54dae74
Faster xmrstak_backend initialization, prevents unsupported binary in…
ddobreff Sep 12, 2019
e92ebc1
Merge pull request #2528 from blindmisfits/master
psychocrypt Sep 19, 2019
bca9255
fix singletons
psychocrypt Sep 19, 2019
ab65c97
Merge pull request #2529 from psychocrypt/fix-singletons
fireice-uk Sep 20, 2019
f626f07
AMD: optimize unroll for rx5700
psychocrypt Aug 24, 2019
0b1f88c
fix locking to secure affinity update
psychocrypt Sep 24, 2019
ae15a68
Merge pull request #2519 from psychocrypt/topic-optimizeUnrollrx5700
fireice-uk Oct 13, 2019
ffdfa53
Merge pull request #2530 from psychocrypt/fix-threadLockingDuringStartup
fireice-uk Oct 14, 2019
bab1ee8
remove aeon support
psychocrypt Oct 22, 2019
6212745
Merge pull request #2508 from joey741019/patch-1
psychocrypt Oct 22, 2019
2494d96
[NVIDIA] fix possible out of memory with auto cfg
psychocrypt Oct 22, 2019
b339c5d
fix tsl not used on first start
psychocrypt Nov 17, 2019
fc6200a
fix hwloc warning
psychocrypt Nov 17, 2019
d5e0d31
fix benchmark mode
psychocrypt Nov 20, 2019
08ee713
Merge pull request #2537 from psychocrypt/topic-removeAeonSupport
psychocrypt Nov 25, 2019
d146533
Merge pull request #2538 from psychocrypt/fix-possibleOutOfMemoryWith…
psychocrypt Nov 25, 2019
2745c5b
Merge pull request #2557 from psychocrypt/fix-hwlocMembindWarning
psychocrypt Nov 25, 2019
af93f65
Merge pull request #2559 from psychocrypt/fix-irgnoringTLSOnFirstStart
psychocrypt Nov 25, 2019
2182d77
Merge pull request #2562 from psychocrypt/fix-benchmarkModeBlockVersion
psychocrypt Nov 25, 2019
d89b504
update README
Ryo-RU Nov 30, 2019
fa9dbc0
version increase to 2.10.8
psychocrypt Nov 30, 2019
e85c15c
remove monero support
psychocrypt Nov 30, 2019
be51020
Merge pull request #2579 from psychocrypt/topic-updateReadme
fireice-uk Nov 30, 2019
9d0e515
Merge pull request #2580 from psychocrypt/topic-versionIncreaseTo2.10.8
fireice-uk Nov 30, 2019
fd59ef0
Merge pull request #2581 from psychocrypt/topic-removeMoneroSupport
fireice-uk Nov 30, 2019
6bad220
Merge pull request #2600 from fireice-uk/dev
fireice-uk Dec 1, 2019
52a93b2
fix broken link
psychocrypt Dec 1, 2019
066d73d
Merge pull request #2603 from psychocrypt/topic-fixBrokenLink
fireice-uk Dec 1, 2019
0e9a8ab
Merge pull request #2604 from fireice-uk/dev
fireice-uk Dec 1, 2019
c052887
add youtube link
psychocrypt Dec 2, 2019
52091b6
Merge pull request #2608 from psychocrypt/topic-addYoutubeLink
fireice-uk Dec 2, 2019
67cf951
Merge pull request #2610 from fireice-uk/dev
fireice-uk Dec 2, 2019
418b23a
Add .circleci/config.yml
sdf0000 Jun 25, 2021
bdc8bec
Add .circleci/config.yml
sdf0000 Jun 25, 2021
c4bba8d
Add .circleci/config.yml
sdf0000 Jun 25, 2021
737f7a8
Add .circleci/config.yml
sdf0000 Jun 25, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .circleci/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
version: 2
jobs:
build:
machine: true
working_directory: /home/circleci/project

steps:
- checkout

- run:
name: Build the docker image
command: docker build -t xmr-stak:$CIRCLE_BRANCH /home/circleci/project

- run:
name: Run a benchmark with Monero V8
command: docker run --rm -t xmr-stak:$CIRCLE_BRANCH /usr/local/bin/xmr-benchmark.sh
14 changes: 14 additions & 0 deletions .clang-format
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
IndentWidth: 4
TabWidth: 4
ColumnLimit: 0
BreakBeforeBraces: Allman
AllowShortIfStatementsOnASingleLine: false
IndentCaseLabels: false
SpaceBeforeParens: Never
UseTab: Always
AlignAfterOpenBracket: DontAlign
PointerBindsToType: true
BreakConstructorInitializers: AfterColon
ConstructorInitializerAllOnOneLineOrOnePerLine: true
ConstructorInitializerIndentWidth: 4
ContinuationIndentWidth: 4
30 changes: 0 additions & 30 deletions .github/ISSUE_TEMPLATE.md

This file was deleted.

35 changes: 35 additions & 0 deletions .github/ISSUE_TEMPLATE/compile_bug_report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
name: Compile bug report
about: You have an issue to compile xmr-stak.

---

`...` are the placeholder for your answers. Please answer each question!


**Describe the bug**
A clear and concise description of what the bug is.

**Which operating system do you use? **

```
...
```

**To Reproduce**
```
# Please post all commands and the output.
...
```

**Additional information.**

```
# run `cmake -LA .` in the build folder and add the output here
...
```

**Feel free to add more information.**
```
...
```
7 changes: 7 additions & 0 deletions .github/ISSUE_TEMPLATE/execution_bug_report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: Execution bug report
about: You have an issue to execute xmr-stak.

---

**Most execution issues are caused by driver problems. Please use the [xmr-stak sub-reddit](https://www.reddit.com/r/XmrStak/) to ask for help instead of opening an issue here.**
7 changes: 7 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: Feature request
about: Suggest an idea for xmr-stak.

---

**Please explain the feature as good as possible.**
7 changes: 7 additions & 0 deletions .github/ISSUE_TEMPLATE/tuning_help.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: Need help for optimization.
about: You need help to optimize your setup.

---

**Please use the [xmr-stak sub-reddit](https://www.reddit.com/r/XmrStak/) to discuss optimizations.**
19 changes: 16 additions & 3 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -44,13 +44,13 @@ endif()
set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "${BUILD_TYPE}")

set(XMR-STAK_COMPILE "native" CACHE STRING "select CPU compute architecture")
set_property(CACHE XMR-STAK_COMPILE PROPERTY STRINGS "native;generic")
set_property(CACHE XMR-STAK_COMPILE PROPERTY STRINGS "native;generic;dev_release")
if(XMR-STAK_COMPILE STREQUAL "native")
if(NOT CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
set(CMAKE_CXX_FLAGS "-march=native -mtune=native ${CMAKE_CXX_FLAGS}")
set(CMAKE_C_FLAGS "-march=native -mtune=native ${CMAKE_C_FLAGS}")
endif()
elseif(XMR-STAK_COMPILE STREQUAL "generic")
elseif(XMR-STAK_COMPILE STREQUAL "generic" OR XMR-STAK_COMPILE STREQUAL "dev_release")
add_definitions("-DCONF_ENFORCE_OpenCL_1_2=1")
else()
message(FATAL_ERROR "XMR-STAK_COMPILE is set to an unknown value '${XMR-STAK_COMPILE}'")
Expand Down Expand Up @@ -496,6 +496,10 @@ if(${CMAKE_CXX_COMPILER_ID} STREQUAL "GNU")
set(CMAKE_C_FLAGS "-Wl,-z,noexecstack ${CMAKE_C_FLAGS}")
endif()

if(XMR-STAK_COMPILE STREQUAL "dev_release")
add_definitions(-DXMRSTAK_DEV_RELEASE)
endif()

# activate static libgcc and libstdc++ linking
if(CMAKE_LINK_STATIC)
set(BUILD_SHARED_LIBRARIES OFF)
Expand Down Expand Up @@ -586,7 +590,16 @@ if(CUDA_FOUND)
)
endif()

set(CUDA_LIBRARIES ${CUDA_LIB} ${CUDA_NVRTC_LIB} ${CUDA_LIBRARIES})
set(CUDA_LIBRARIES ${CUDA_LIB} ${CUDA_LIBRARIES})
if(XMR-STAK_COMPILE STREQUAL "dev_release")
# do not link nvrtc for linux binaries, cn-r will be disabled
if(WIN32)
set(CUDA_LIBRARIES ${CUDA_LIBRARIES} ${CUDA_NVRTC_LIB})
endif()
else()
set(CUDA_LIBRARIES ${CUDA_LIBRARIES} ${CUDA_NVRTC_LIB})
endif()

target_link_libraries(xmrstak_cuda_backend ${CUDA_LIBRARIES})
target_link_libraries(xmrstak_cuda_backend xmr-stak-backend xmr-stak-asm)
endif()
Expand Down
112 changes: 10 additions & 102 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,102 +1,10 @@
###### fireice-uk's and psychocrypt's
# XMR-Stak - Cryptonight All-in-One Mining Software

XMR-Stak is a universal Stratum pool miner. This miner supports CPUs, AMD and NVIDIA GPUs and can be used to mine the crypto currencies Monero, Aeon and many more Cryptonight coins.

## HTML reports
<img src="https://gist.githubusercontent.com/fireice-uk/2da301131ac01695ff79539a27b81d68/raw/4c09cdeee86f94df2e9dd86b927e64aded6184f5/xmr-stak-cpu-hashrate.png" width="260"> <img src="https://gist.githubusercontent.com/fireice-uk/2da301131ac01695ff79539a27b81d68/raw/4c09cdeee86f94df2e9dd86b927e64aded6184f5/xmr-stak-cpu-results.png" width="260"> <img src="https://gist.githubusercontent.com/fireice-uk/2da301131ac01695ff79539a27b81d68/raw/4c09cdeee86f94df2e9dd86b927e64aded6184f5/xmr-stak-cpu-connection.png" width="260">

## Video setup guide on Windows

[<img src="https://gist.githubusercontent.com/fireice-uk/3621b179d56f57a8ead6303d8e415cf6/raw/f572faba67cc9418116f3c1dfd7783baf52182ce/vidguidetmb.jpg">](https://youtu.be/YNMa8NplWus)
###### Video by Crypto Sewer

## Overview
* [Features](#features)
* [Supported altcoins](#supported-altcoins)
* [Download](#download)
* [Usage](doc/usage.md)
* [HowTo Compile](doc/compile.md)
* [FAQ](doc/FAQ.md)
* [Developer Donation](#default-developer-donation)
* [Developer PGP Key's](doc/pgp_keys.md)

## Features

- support all common backends (CPU/x86, AMD-GPU and NVIDIA-GPU)
- support all common OS (Linux, Windows and macOS)
- supports algorithm cryptonight for Monero (XMR) and cryptonight-light (AEON)
- easy to use
- guided start (no need to edit a config file for the first start)
- auto-configuration for each backend
- open source software (GPLv3)
- TLS support
- [HTML statistics](doc/usage.md#html-and-json-api-report-configuraton)
- [JSON API for monitoring](doc/usage.md#html-and-json-api-report-configuraton)

## Supported altcoins

Besides [Monero](https://getmonero.org), following coins can be mined using this miner:

- [Aeon](http://www.aeon.cash)
- [BBSCoin](https://www.bbscoin.xyz)
- [BitTube](https://coin.bit.tube/)
- [Conceal](https://conceal.network)
- [Graft](https://www.graft.network)
- [Haven](https://havenprotocol.com)
- [Lethean](https://lethean.io)
- [Masari](https://getmasari.org)
- [Plenteum](https://www.plenteum.com/)
- [QRL](https://theqrl.org)
- **[Ryo](https://ryo-currency.com) - Upcoming xmr-stak-gui is sponsored by Ryo**
- [Stellite](https://stellite.cash/)
- [TurtleCoin](https://turtlecoin.lol)
- [Zelerius](https://zelerius.org/)
- [X-CASH](https://x-network.io/)

Ryo currency is a way for us to implement the ideas that we were unable to in
Monero. See [here](https://github.com/fireice-uk/cryptonote-speedup-demo/) for details.

If your prefered coin is not listed, you can choose one of the following algorithms:
- 256Kib scratchpad memory
- cryptonight_turtle
- 1MiB scratchpad memory
- cryptonight_lite
- cryptonight_lite_v7
- cryptonight_lite_v7_xor (algorithm used by ipbc)
- 2MiB scratchpad memory
- cryptonight
- cryptonight_gpu (for Ryo's 14th of Feb fork)
- cryptonight_masari (used in 2018)
- cryptonight_v7
- cryptonight_v7_stellite
- cryptonight_v8
- cryptonight_v8_double (used by X-CASH)
- cryptonight_v8_half (used by masari and stellite)
- cryptonight_v8_reversewaltz (used by graft)
- cryptonight_v8_zelerius
- 4MiB scratchpad memory
- cryptonight_haven
- cryptonight_heavy

Please note, this list is not complete and is not an endorsement.

## Download

You can find the latest releases and precompiled binaries on GitHub under [Releases](https://github.com/fireice-uk/xmr-stak/releases).

## Default Developer Donation

By default, the miner will donate 2% of the hashpower (2 minutes in 100 minutes) to my pool. If you want to change that, edit [donate-level.hpp](xmrstak/donate-level.hpp) before you build the binaries.

If you want to donate directly to support further development, here is my wallet

fireice-uk:
```
4581HhZkQHgZrZjKeCfCJxZff9E3xCgHGF25zABZz7oR71TnbbgiS7sK9jveE6Dx6uMs2LwszDuvQJgRZQotdpHt1fTdDhk
```

psychocrypt:
```
45tcqnJMgd3VqeTznNotiNj4G9PQoK67TGRiHyj6EYSZ31NUbAfs9XdiU5squmZb717iHJLxZv3KfEw8jCYGL5wa19yrVCn
```
<a href="doc/README.md" _target="blank"><img src="doc/_img/gpu.png"></a>
<a href="#select_coin" _target="blank"><img src="doc/_img/cpu.png"></a>
<table>
<p id="select_coin">
<tr>
<td align="center"><a href=https://github.com/xmrig/xmrig><img src="doc/_img/xmrig.png"></a></td>
<td align="center"><a href=https://ragerx.lol><img src="doc/_img/ragerx.png"></a></td>
<td align="center"><a href=https://github.com/fireice-uk/xmr-stak/tree/xmr-stak-rx/doc/README.md><img src="doc/_img/rx.png"></a></td>
</tr>
</table>
89 changes: 6 additions & 83 deletions doc/FAQ.md
Original file line number Diff line number Diff line change
@@ -1,104 +1,27 @@
# FAQ
To improve our support we created [Xmr-Stak forum](https://www.reddit.com/r/XmrStak). Check it out if you have a problem, or you are looking for most up to date config for your card and [guides](https://www.reddit.com/r/XmrStak/wiki/index).


## Content Overview
* ["Obtaining SeLockMemoryPrivilege failed."](#obtaining-selockmemoryprivilege-failed)
* [VirtualAlloc failed](#virtualalloc-failed)
* [Error msvcp140.dll and vcruntime140.dll not available](#error-msvcp140dll-and-vcruntime140dll-not-available)
* [Error: MEMORY ALLOC FAILED: mmap failed](#error-memory-alloc-failed-mmap-failed)
* [Illegal instruction (core dumped)](#illegal-instruction)
* [Virus Protection Alert](#virus-protection-alert)
* [Change Currency to Mine](#change-currency-to-mine)
* [How can I mine Monero](#how-can-i-mine-monero)
* [Which currency must be chosen if my fork coin is not listed](#which-currency-must-be-chosen-if-my-fork-coin-is-not-listed)
* [Internal compiler error: Killed (program cc1plus)](#internal-compiler-error)

## "Obtaining SeLockMemoryPrivilege failed."

For professional versions of Windows see [this article](https://msdn.microsoft.com/en-gb/library/ms190730.aspx).
Make sure to reboot afterwards!

For Windows 7/10 Home:

1) Download and install [Windows Server 2003 Resource Kit Tools](https://www.microsoft.com/en-us/download/details.aspx?id=17657). Ignore any incompatibility warning during installation.

2) Open cmd or PowerShell as an administrator.

3) Use `ntrights -u %USERNAME% +r SeLockMemoryPrivilege` where %USERNAME% is the user that will be running the program.

4) Reboot.

Reference: http://rybkaforum.net/cgi-bin/rybkaforum/topic_show.pl?pid=259791#pid259791

*Warning: Do not download ntrights.exe from any other site other than the offical Microsoft download page.*

## VirtualAlloc failed

If you set up the user rights properly ([see above](https://github.com/fireice-uk/xmr-stak/blob/master/doc/FAQ.md#selockmemoryprivilege-failed)), and your system has 4-8GB of RAM (50%+ use), there is a significant chance that there simply won't be a large enough chunk of contiguous memory because Windows is fairly bad at mitigating memory fragmentation.

If that happens, disable all auto-starting applications and run the miner after a reboot.

## Error msvcp140.dll and vcruntime140.dll not available

Download and install this [runtime package](https://go.microsoft.com/fwlink/?LinkId=746572) from Microsoft. *Warning: Do NOT use "missing dll" sites - dll's are exe files with another name, and it is a fairly safe bet that any dll on a shady site like that will be trojaned. Please download offical runtimes from Microsoft above.*


## Error: MEMORY ALLOC FAILED: mmap failed

On Linux you will need to configure large page support and increase your memlock limit (`ulimit -l`).

Never put settings directly into `/etc/sysctl.conf` or `/etc/security/limits.conf` as those are system defaults and can be replaced in upgrades, and custom settings in that file are deprecated in all distros since at least wheezy/trusty (has been illegal in RedHat based distros for longer than that), and will be even more deprecated with systemd (it no longer even reads sysctl.conf, ONLY sysctl.d files, for example - there is a link to the old `/etc/sysctl.conf` for backward compatibility but that can go away at any time). Also adding to `/etc/rc.local` is extra incorrect, systemd does not even use that file anymore (once the sysvinit compatibility layer is gone, rc.local will no longer work).

To check current settings, run `/sbin/sysctl vm.nr_hugepages ; ulimit -l` as whatever user you will run `xmr-stak` as (example shows bad/low sample defaults):

$ /sbin/sysctl vm.nr_hugepages ; ulimit -l
vm.nr_hugepages = 0
16

To set large page support, add the following lines to `/etc/sysctl.d/60-hugepages.conf`:

vm.nr_hugepages=128

You WILL need to run `sudo sysctl --system` for these settings to take effect on your system (or reboot). In some cases (many threads, very large CPU, etc) you may need more than 128 (try 256 if there are still complaints from thread inits)

To increase the memlock (ulimit -l), add following lines to `/etc/security/limits.d/60-memlock.conf`:

* - memlock 262144
root - memlock 262144

You WILL need to log out and log back in for these settings to take effect on your user (no need to reboot, just relogin in your session).
Recheck after completing these steps to validate:

$ /sbin/sysctl vm.nr_hugepages ; ulimit -l
vm.nr_hugepages = 128
262144

You can also do it Windows-style and simply run-as-root, but this is NOT recommended for security reasons. Also running as root does not properly get around the `ulimit -l` being large enough (and limits `*` does not apply to `root` either, it must be specified explicitly).

## Illegal Instruction

This typically means you are trying to run it on a CPU that does not have [AES](https://en.wikipedia.org/wiki/AES_instruction_set). This only happens on older version of miner, new version gives better error message (but still wont' work since your CPU doesn't support the required instructions).

## Virus Protection Alert

### Virus Protection Alert
Some virus protection software flags the miner binary as *malware*. This is a false positive — the software does not contain any malware (and since it is open source, you can verify that yourself!)
If your antivirus software flags **xmr-stak**, it will likely move it to its quarantine area. You may have to whitelist **xmr-stak** in your antivirus.

## Change Currency to Mine

### Change Currency to Mine
If the miner is compiled for Monero and Aeon than you can change
- the value `currency` in the config *or*
- start the miner with the [command line option](usage.md) `--currency monero` or `--currency aeon7`
- run `xmr-stak --help` to see all supported currencies and algorithms

## How can I mine Monero

### How can I mine Monero
Set the value `currency` in `pools.txt` to `monero`.

## Which currency must be chosen if my fork coin is not listed

### Which currency must be chosen if my fork coin is not listed
If your coin you want to mine is not listed please check the documentation of the coin and try to find out if `cryptonight` or `cryptonight-lite` is the used algorithm.
Select one of these generic coin algorithms.

## Internal compiler error

Seeing `g++: internal compiler error: Killed (program cc1plus)` is probably related to not enough RAM to compile. 1 Gb RAM should be enough (it is on clean Ubuntu 16.04).
Loading