forked from sp-hash/ccminer
-
Notifications
You must be signed in to change notification settings - Fork 312
/
README.txt
245 lines (214 loc) · 11.1 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
ccMiner release 8.25(KlausT-mod) (May 10th, 2019)
---------------------------------------------------------------
***************************************************************
If you find this tool useful and like to support its continued
development, then consider a donation.
KlausT:
Sorry, no donation address. Maybe next year.
tpruvot:
BTC 1AJdfCpLWPNoAMDfHF1wD5y8VgKSSTHxPo
***************************************************************
>>> Introduction <<<
This is a CUDA accelerated mining application where some of the algos have a VERY NOTABLE nVidia advantage
over competing AMD (OpenCL Only) implementations.
We did not take a big effort on improving usability, so please set
your parameters carefuly.
THIS PROGRAMM IS PROVIDED "AS-IS", USE IT AT YOUR OWN RISK!
If you're interessted and read the source-code, please excuse
that the most of our comments are in german.
>>> Command Line Interface <<<
This code is based on the pooler cpuminer 2.3.2 release and inherits
its command line interface and options.
-a, --algo=ALGO specify the hash algorithm to use
bitcoin Bitcoin
blake Blake 256 (SFR/NEOS)
blakecoin Fast Blake 256 (8 rounds)
c11 X11 variant
deep Deepcoin
dmd-gr Diamond-Groestl
fresh Freshcoin (shavite 80)
fugue256 Fuguecoin
groestl Groestlcoin
jackpot Jackpot
keccak Keccak-256 (Maxcoin)
luffa Doomcoin
lyra2v2 Monacoin
lyra2v3 Vertcoin
myr-gr Myriad-Groestl
neoscrypt neoscrypt (FeatherCoin)
nist5 NIST5 (TalkCoin)
penta Pentablake hash (5x Blake 512)
quark Quark
qubit Qubit
sia Siacoin (at pools compatible to siamining.com)
skein Skein SHA2 (Skeincoin)
s3 S3 (1Coin)
spread Spread
x11 X11 (DarkCoin)
x13 X13 (MaruCoin)
x14 X14
x15 X15
x17 X17 (peoplecurrency)
vanilla Blake 256 8 rounds
yescrypt yescrypt
whirl Whirlcoin (old whirlpool)
whirlpoolx Vanillacoin
-d, --devices Comma separated list of CUDA devices to use.
Device IDs start counting from 0! Alternatively takes
string names of your cards like gtx780ti or gt640#2
(matching 2nd gt640 in the PC)
-i --intensity=N GPU intensity 8-31 (default: auto)
Decimals are allowed for fine tuning
-f, --diff-factor Divide difficulty by this factor (default 1.0)
-m, --diff-multiplier Multiply difficulty by this value (default 1.0)
-v, --vote=VOTE block reward vote (for HeavyCoin)
-o, --url=URL URL of mining server
-O, --userpass=U:P username:password pair for mining server
-u, --user=USERNAME username for mining server
-p, --pass=PASSWORD password for mining server
--cert=FILE certificate for mining server using SSL
-x, --proxy=[PROTOCOL://]HOST[:PORT] connect through a proxy
-t, --threads=N number of miner threads (default: number of nVidia GPUs)
-r, --retries=N number of times to retry if a network call fails
(default: retry indefinitely)
-R, --retry-pause=N time to pause between retries, in seconds (default: 30)
-T, --timeout=N network timeout, in seconds (default: 270)
-s, --scantime=N upper bound on time spent scanning current work when
long polling is unavailable, in seconds (default: 5)
-n, --ndevs list cuda devices
-N, --statsavg number of samples used to display hashrate (default: 30)
--no-gbt disable getblocktemplate support (height check in solo)
--no-longpoll disable X-Long-Polling support
--no-stratum disable X-Stratum support
-e disable extranonce
-q, --quiet disable per-thread hashmeter output
--no-color disable colored output
--hwmonitor show data like temperature, fan speed, etc.
-D, --debug enable debug output
-P, --protocol-dump verbose dump of protocol-level activities
--cuda-schedule set CUDA scheduling option:
0: BlockingSync (default)
1: Spin
2: Yield
This is influencing the hashing speed and CPU load
--cpu-affinity set process affinity to cpu core(s), mask 0x3 for cores 0 and 1
--cpu-priority set process priority (default: 0 idle, 2 normal to 5 highest)
-b, --api-bind IP/Port for the miner API (example: 127.0.0.1:4068)
--logfile=filename Create a logfile
-S, --syslog use system log for output messages
--syslog-prefix=... allow to change syslog tool name
-B, --background run the miner in the background
--benchmark run in offline benchmark mode
--no-cpu-verify don't verify the found results
-c, --config=FILE load a JSON-format configuration file
--plimit=N Set the gpu power limit to N Watt (driver version >=352.21)
(needs adminitrator rights under Windows)
-V, --version display version information and exit
-h, --help display this help text and exit\n"
>>> Examples <<<
Example for pool mining on nicehash.com with all your GPUs
ccminer -a lyra2v3 -O 12fsRcScJtcqytZJE3NdSAKBLu52PqDzzR:x -o stratum+tcp://lyra2rev3.eu.nicehash.com:3373
For solo-mining you typically use -o http://127.0.0.1:xxxx where xxxx represents
the rpcport number specified in your wallet's .conf file and you have to pass the same username
and password with -O (or -u -p) as specified in the wallet config.
The wallet must also be started with the -server option and/or with the server=1 flag in the .conf file
>>> API and Monitoring <<<
With the -b parameter you can open your ccminer to your network, use -b 0.0.0.0:4068 if required.
On windows, setting 0.0.0.0 will ask firewall permissions on the first launch. Its normal.
You can test this api on linux with "telnet <miner-ip> 4068" and type "help" to list the commands.
Default api format is delimited text. If required a php json wrapper is present in api/ folder.
>>> Additional Notes <<<
This code should be running on nVidia GPUs ranging from compute capability
3.0 up to compute capability 7.0. Support for Compute 2.0 has been dropped
so we can more efficiently implement new algorithms using the latest hardware
features.
>>> RELEASE HISTORY <<<
2015-02-01 Release 1.0, forked from tpruvot and sp-hash
2015-02-03 v1.01: bug fix for cards with compute capability 3.0 (untested)
2015-02-09 v1.02: various bug fixes and optimizations
2015-03-08 v2.00: added whirlpoolx algo (Vanillacoin), also various optimizations and bug fixes
2015-03-30 v3.00: added skein (for Myriadcoin for example)
2015-05-06 v4.00: added Neoscrypt
2015-05-15 v4.01: fixed crash after ctrl-c (Windows), fixed -g option
2015-07-06 v5.00: -g option removed, some bug fixes and optimizations
2015-07-08 v5.01: lyra2 optimization
2015-08-22 v6.00: remove Lyra2RE, add Lyra2REv2, remove Animecoin, remove yesscrypt
2016-05-03 v6.01: various bug fixes and optimizations
2016-05-12 v6.02: faster x17 and quark
2016-05-16 v7.00: added Vanillacoin, optimized blake and blakecoin,
added stratum methods used by yiimp.ccminer.org
2016-05-16 v7.01: stratum.get_stats bug fix
2016-06-02 v7.02: fix default intensity for Nist5
fix power usage statistics
2016-06-11 v7.03: faster lyra2v2
2016-06-18 v7.04: Neoscrypt optimization
Bug Fixes
2016-08-11 v8.00: added Siacoin
2016-08-12 v8.01: increse default intensity for Sia
fix Linux build
2016-09-29 v8.02: change to CUDA 8.0 on Windows
various small changes
2016-12-08 v8.03: fix memory leak in Neoscrypt
2016-12-13 v8.04: fix illegal memory access in X11-X17
fix duplicate shares in skein
2016-12-17 v8.05: fix Skein bug
2017-03-12 v8.06: Heavy and Mjollnir algos removed
2017-05-18 v8.07: Bitcredit algo removed
fixed bugs in bitcoin and jackpot algo
2017-05-19 v8.08: fix Makefile and configure.ac for Linux
2017-06-07 v8.09: some minor bug fixes
2017-07-17 v8.10: fix Orbitcoin solo mining (Neoscrypt)
2017-07-25 v8.11: change some timeout values
fix Feathercoin solo mining (Neoscrypt)
show chance to find a block while solo mining
2017-08-17 v8.12: fix Myriad-Groestl speed bug
2017-08-26 v8.13: fix retry bug
faster neoscrypt for 1080/1080Ti
2017-11-07 v8.14: faster Neoscrypt for Titan Xp
fix bug that prevented a reconnect after a connection loss
2017-11-21 v8.15: support up to 16 GPUs
fix problem with not exiting when there's an error
2017-12-15 v8.16: add sm_71 (Titan cards) (CUDA 9 and newer versions)
2017-12-21 v8.17: fix possible problem with high intensities
fix bug in -d option
fix Linux build
2018-01-01 v8.18: more speed for Titan V with Lyra2v2 and possibly neoscrypt (untested)
Linux: better default intensity
some small bug fixes
2018-01-23 v8.19: fix x17 for Linux builds without NVML
show default intensity when not using the -i option
add gpu number to the cuda error messages
stratum: show reason of auth failure (when supported by the pool)
API is now disabled by default
Neoscrypt: Titan Xp fix
Windows: fix --background option
fixed: send a second share when we find it
enable stale share detection
send stale shares when the pool supports it
2018-02-03 v8.20: fix crash when using options --ndevs or --help
API: fix possible crash when checking cpu frequency under Linux
fix gpu name bug when using different cards in the same system
add some error messages
2018-03-15 v8.21: add option --cuda-schedule
add option --logfile
make ccminer compilable under OSX
Neoscrypt: detect P104-100 and Tesla P100/V100
Linux: fix Lyra2v2 verification bug
fix for intensities between 8 and 9
2018-07-12 v8.22: add --hwmonitor option
some bug fixes
2018-10-07 v8.23: skein bug fix (lost shares when mining with low difficulty)
fix small memory leak
2019-02-07 v8.24: add lyra2v3 algo
2019-05-10 v8.25: fix invalid share bug
2021-07-08 v8.26: suppoort for more than 8 CPU cores, bugfix for for some coins
>>> AUTHORS <<<
Notable contributors to this application are:
Christian Buchner, Christian H. (Germany): Initial CUDA implementation
djm34, tsiv, sp and KlausT for cuda algos implementation and optimisation
Tanguy Pruvot : 750Ti tuning, blake, colors, general code cleanup/opts
API monitoring, linux Config/Makefile and vstudio stuff...
and also many thanks to anyone else who contributed to the original
cpuminer application (Jeff Garzik, pooler), it's original HVC-fork
and the HVC-fork available at hvc.1gh.com
Source code is included to satisfy GNU GPL V3 requirements.