Updated cpuminer opt READMEs, HowTos & FAQs (markdown)

JayDDee
2020-03-01 22:05:18 -05:00
parent 18d67fb3e6
commit 5d76bc078e

@@ -455,7 +455,7 @@ instructions on how to set them.
## Logs # Logs
### Colours ### Colours
@@ -470,21 +470,25 @@ Somes logs and fields are colour coded based on their purpose or to highlight im
The log reports contain a wealth of data that can be used to report actual miner perforance The log reports contain a wealth of data that can be used to report actual miner perforance
and provide estimates. and provide estimates.
### Start up ## Start up
The startup messages are very important to ensure best performmance. In particular The startup messages are very important to ensure best performmance. In particular
the features lists ensure the software is built for the CPU architecture and can the features lists ensure the software is built for the CPU architecture and can
take advantage of all the algo optimizations. take advantage of all the algo optimizations.
`
CPU: AMD Ryzen 7 1700 Eight-Core Processor .
SW built on Feb 8 2020 with GCC 7.4.0.
CPU features: AVX2 AES SHA
SW features: AVX2 AES SHA
Algo features: AVX512 VAES
Starting miner with AVX2 AES... `CPU: AMD Ryzen 7 1700 Eight-Core Processor`
`
`SW built on Feb 8 2020 with GCC 7.4.0`
`CPU features: AVX2 AES SHA`
`SW features: AVX2 AES SHA`
`Algo features: AVX512 VAES`
`Starting miner with AVX2 AES...`
Line 1: CPU brand and model Line 1: CPU brand and model
Line 2: CPU hardware extensions available Line 2: CPU hardware extensions available
Line 3: Hardware extensions supported by the software build. Line 3: Hardware extensions supported by the software build.
@@ -496,7 +500,7 @@ Each provides additional CPU instructions and more complex operations. Only the
each class is displayed although lower ranking features may also exist and be avaiable. Not all features each class is displayed although lower ranking features may also exist and be avaiable. Not all features
have significant improvements and not all combinations are avalable in binary format for Windows. have significant improvements and not all combinations are avalable in binary format for Windows.
* SIMD vector support ### SIMD vector support
SSE2: minimum for 128 bit integer vector support, first available on Intel Core2. SSE2: minimum for 128 bit integer vector support, first available on Intel Core2.
SSSE3: Some additional instructions for 128 bit integer vectors, not very significant. SSSE3: Some additional instructions for 128 bit integer vectors, not very significant.
SSE4.2: More 128 bit vector instructions, also not very significant. SSE4.2: More 128 bit vector instructions, also not very significant.
@@ -505,33 +509,37 @@ have significant improvements and not all combinations are avalable in binary fo
AVX512: a suite of seperate extensions that provide 512 bit integer vector support, first available on AVX512: a suite of seperate extensions that provide 512 bit integer vector support, first available on
Intel Cascade Lake X HEDT CPUs. Intel Cascade Lake X HEDT CPUs.
* AES encryption and decryption, aka AES_NI ### AES encryption and decryption, aka AES_NI
AES: basic hardware AES support performs AES operations with a single instruction, also requires SSE2, AES: basic hardware AES support performs AES operations with a single instruction, also requires SSE2,
first available on Intel Westmere. first available on Intel Westmere.
VAES: Vectored AES, supports 4 parallel AES operations with a single instruction, first available on Intel VAES: Vectored AES, supports 4 parallel AES operations with a single instruction, first available on Intel
Icelake. Also requires AVX512F. Icelake. Also requires AVX512F.
* SHA encryption and decryption, aka SHA_NI ### SHA encryption and decryption, aka SHA_NI
SHA supports basic SHA-256 operations with a single instruction, also requires SSE2. First available SHA supports basic SHA-256 operations with a single instruction, also requires SSE2. First available
on Intel Goldmont but not widely avaiable until AMD Ryzen and Intel Icelake. on Intel Goldmont but not widely avaiable until AMD Ryzen and Intel Icelake.
Some other messages are displayed based on options such as stratum connection, API enabled, CPU affinity etc. Some other messages are displayed based on options such as stratum connection, API enabled, CPU affinity etc.
### New stratum, block, job report ## New stratum, block, job report
This report is issued when a new job is received from the stratum server. This report is issued when a new job is received from the stratum server.
If the report is also for a new block or a changed stratum difficulty the report If the report is also for a new block or a changed stratum difficulty the report
will include new estimates for the new block or stratum difficulty. will include new estimates for the new block or stratum difficulty.
Using external data the coin can be identifed from its block number. Using external data the coin can be identifed from its block number.
`
[2020-02-07 23:38:22] New block 1293839, job 1d9f, ntime 5e5c2e79 `[2020-02-07 23:38:22] New block 1293839, job 1d9f, ntime 5e5c2e79`
lyra2rev3: lyra2v3.mine.zergpool.com:4550
Diff: Net 50648, Stratum 26, Target 0.10156 ` lyra2rev3: lyra2v3.mine.zergpool.com:4550`
TTF @ 2758.00 kh/s: block 2y2d, share 2m38s
Net TTF @ 1040.82 Gh/s: 3m29s ` Diff: Net 50648, Stratum 26, Target 0.10156`
`
` TTF @ 2758.00 kh/s: block 2y2d, share 2m38s`
` Net TTF @ 1040.82 Gh/s: 3m29s
There are 3 forms of this report. New job is a one line report, new block and new stratum diff are up to There are 3 forms of this report. New job is a one line report, new block and new stratum diff are up to
@@ -566,10 +574,11 @@ Line 5, only displayed in single coin pools
### Getwork new block, work report ### Getwork new block, work report
`
[2020-02-28 10:54:02] New block 6273226, diff 118.48, ntime 5e5c2e79 `[2020-02-28 10:54:02] New block 6273226, diff 118.48, ntime 5e5c2e79`
Miner TTF @ 3938.69 kh/s 6m11s, net TTF @ 68.24 Mh/s 2h04m
` ` Miner TTF @ 3938.69 kh/s 6m11s, net TTF @ 68.24 Mh/s 2h04m`
The getwork new block report is similar to the stratum new block log with a few differences. There is no The getwork new block report is similar to the stratum new block log with a few differences. There is no
stratum difficulty and no job id. "New job" is replaced with "New work". All present fields have the same stratum difficulty and no job id. "New job" is replaced with "New work". All present fields have the same
@@ -578,11 +587,11 @@ and is not an estimate. The block TTF is calculated from network hashrate and ne
therefore considered correct. therefore considered correct.
### Share submitted report ## Share submitted report
`[2020-03-01 16:52:18] 168 Submit diff 2.4496e-07, block 440815, job 3f4a`
`
[2020-03-01 16:52:18] 168 Submit diff 2.4496e-07, block 440815, job 3f4a
`
The main purpose of the share submitted report is to timestamp the event to measure latency. It also contains The main purpose of the share submitted report is to timestamp the event to measure latency. It also contains
info to help tracking. info to help tracking.
@@ -599,14 +608,15 @@ A pool misconfiguration or a bug in cpuminer-opt. A bug is more liky wih new cod
* The job id, stratum only, useful to troubleshoot stale shares. * The job id, stratum only, useful to troubleshoot stale shares.
### Share result report ## Share result report
This report is generated when the pool's reply has been received acknowledging the submitted share. This report is generated when the pool's reply has been received acknowledging the submitted share.
`
[2020-02-07 23:59:03] 5 Accepted 5 S0 R0 B0, 400.092 sec (159ms) `[2020-02-07 23:59:03] 5 Accepted 5 S0 R0 B0, 400.092 sec (159ms)`
Diff 0.11393 (0.0853), Block 1044635, Job 1dd6
` ` Diff 0.11393 (0.0853), Block 1044635, Job 1dd6`
Line 1: Line 1:
@@ -651,18 +661,25 @@ Mostly FYI except when solo mining. It is the ratio of share difficulty over net
job was stale. This is obtained from data collected at submit time. job was stale. This is obtained from data collected at submit time.
### Periodic summary report ## Periodic summary report
` [2020-03-01 16:49:10] scrypt: scryptn2.mine.zergpool.com:3435`
` Periodic Report 3m45s 14m58s`
` Share rate 9.84/min 9.68/min`
` Hash rate 27.03h/s 29.17h/s (22.83h/s)`
` Lost hash rate 0h/s .17h/s`
` Submitted 37 145`
` Accepted 37 144`
` Stale 0 1`
`
[2020-03-01 16:49:10] scrypt: scryptn2.mine.zergpool.com:3435
Periodic Report 3m45s 14m58s
Share rate 9.84/min 9.68/min
Hash rate 27.03h/s 29.17h/s (22.83h/s)
Lost hash rate 0h/s .17h/s
Submitted 37 145
Accepted 37 144
Stale 0 1
`
Generated aproximately every 5 minutes. The timing is not precise because it is an opportunistic report. Generated aproximately every 5 minutes. The timing is not precise because it is an opportunistic report.
It is produced when it is convenient in order to miminize the impact on mining. It is produced when it is convenient in order to miminize the impact on mining.
@@ -694,7 +711,7 @@ displayed if not zero. Add this to effective hash rate for performance compariso
* Lines 6+: Optional number of stale or rejected shares or solved blocks, only displayed if not zero. * Lines 6+: Optional number of stale or rejected shares or solved blocks, only displayed if not zero.
### CPU temperature and frequency report ## CPU temperature and frequency report
Another opportunistic report to avoid interrupting mining operation. Temperature reports are dsplayed more Another opportunistic report to avoid interrupting mining operation. Temperature reports are dsplayed more
frequently at higher or rising temperatures and colour coded to draw attention. frequently at higher or rising temperatures and colour coded to draw attention.