CPUMiner-Multi

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

!!! THIS IS A HACKED VERSION TO SUPPORT ZCOIN (XZC)'s Lyra2Z algo ! ONLY USE WITH ZCOIN AFTER BLOCK 20500 !!

Use -a lyra2z for XZC mining on pools like on https://xzc.suprnova.cc or solomining.

This contains following optimizations by optiminer:

• Some unnecessary computations and memory accesses removed.
• Code for AVX2 can be enabled by compiling with "-mavx2": $ CFLAGS="-O2 -mavx2" ./configure && make clean && make
• Memory prefetching can be enabled by compiling with "-mavx2": $ CFLAGS="-O2 -DROW_PREFETCH" ./configure && make clean && make

The different flags can also be combined. If you are building for your local CPU, use "-march=native" as well. The hash algorithm is memory bandwith bound, therefore AVX2 / prefetching will not have a big impact on performance.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

This is a multi-threaded CPU miner, fork of pooler's cpuminer (see AUTHORS for list of contributors).

Table of contents

• Algorithms
• Dependencies
• Download
• Build
• Usage instructions
• Donations
• Credits
• License

Algorithms

Currently supported

• ✓ scrypt (Litecoin, Dogecoin, Feathercoin, ...)
• ✓ scrypt:N
• ✓ scrypt-jane:N
• ✓ sha256d (Bitcoin, Freicoin, Peercoin/PPCoin, Terracoin, ...)
• ✓ axiom (Axiom Shabal-256 based MemoHash)
• ✓ bastion (Joincoin [J])
• ✓ blake (Saffron [SFR] Blake-256)
• ✓ blake2s (NevaCoin Blake2-S 256)
• ✓ bmw (Midnight [MDT] BMW-256)
• ✓ cryptonight (Bytecoin [BCN], Monero)
• ✓ cryptonight-light (Aeon)
• ✓ dmd-gr (Diamond-Groestl)
• ✓ fresh (FreshCoin)
• ✓ groestl (Groestlcoin)
• ✓ lbry (LBRY Credits [LBC])
• ✓ lyra2RE (Lyrabar, Cryptocoin)
• ✓ lyra2Z (Zcoin [XZC])
• ✓ myr-gr (Myriad-Groestl)
• ✓ neoscrypt (Feathercoin)
• ✓ nist5 (MistCoin [MIC], TalkCoin [TAC], ...)
• ✓ pentablake (Joincoin)
• ✓ pluck (Supcoin [SUP])
• ✓ quark (Quarkcoin)
• ✓ qubit (MyriadCoin [MYR])
• ✓ skein (Skeincoin, Myriadcoin, Xedoscoin, ...)
• ✓ skein2 (Woodcoin)
• ✓ s3 (OneCoin)
• ✓ vanilla (Blake-256 8-rounds - double sha256 [VNL])
• ✓ x11evo (Revolver [XRE])
• ✓ x11 (Darkcoin [DRK], Hirocoin, Limecoin, ...)
• ✓ x13 (Sherlockcoin, [ACE], [B2B], [GRC], [XHC], ...)
• ✓ x14 (X14, Webcoin [WEB])
• ✓ x15 (RadianceCoin [RCE])
• ✓ yescrypt (GlobalBoostY [BSTY], Unitus [UIS])
• ✓ zr5 (Ziftrcoin [ZRC])

Implemented, but untested

• ? hefty1 (Heavycoin)
• ? keccak (Maxcoin HelixCoin, CryptoMeth, Galleon, 365coin, Slothcoin, BitcointalkCoin)
• ? luffa (Joincoin, Doomcoin)
• ? shavite3 (INKcoin)
• ? sib X11 + gost (SibCoin)

Planned support for

• scrypt-jane (YaCoin, CopperBars, Pennies, Tickets, etc..)

Dependencies

• libcurl http://curl.haxx.se/libcurl/
• jansson http://www.digip.org/jansson/ (jansson source is included in-tree)
• openssl libcrypto https://www.openssl.org/
• pthreads
• zlib (for curl/ssl)

Download

• Windows releases: https://github.com/ocminer/cpuminer-xzc/releases
• Git tree: https://github.com/ocminer/cpuminer-xzc
  • Clone with git clone https://github.com/ocminer/cpuminer-xzc

Build

Basic *nix build instructions:

• just use ./build.sh OR
• ./autogen.sh # only needed if building from git repo
• ./nomacro.pl # only needed if building on Mac OS X or with Clang
• ./configure CFLAGS="-march=native" --with-crypto --with-curl

  • Use -march=native if building for a single machine

• make

Note for Debian/Ubuntu users:

• apt-get install automake autoconf pkg-config libcurl4-openssl-dev libjansson-dev libssl-dev libgmp-dev

Notes for AIX users:

• To build a 64-bit binary, export OBJECT_MODE=64
• GNU-style long options are not supported, but are accessible via configuration file

Basic Windows build with Visual Studio 2013

• All the required .lib files are now included in tree (windows only)
• AVX enabled by default for x64 platform (AVX2 and XOP could also be used)

Basic Windows build instructions, using MinGW64:

• Install MinGW64 and the MSYS Developer Tool Kit (http://www.mingw.org/)
  • Make sure you have mstcpip.h in MinGW\include
• install pthreads-w64
• Install libcurl devel (http://curl.haxx.se/download.html)
  • Make sure you have libcurl.m4 in MinGW\share\aclocal
  • Make sure you have curl-config in MinGW\bin
• Install openssl devel (https://www.openssl.org/related/binaries.html)
• In the MSYS shell, run:
  • for 64bit, you can use ./mingw64.sh else : ./autogen.sh # only needed if building from git repo
  • LIBCURL="-lcurldll" ./configure CFLAGS="-march=native"

    • Use -march=native if building for a single machine

  • make

Architecture-specific notes:

• ARM:
  • No runtime CPU detection. The miner can take advantage of some instructions specific to ARMv5E and later processors, but the decision whether to use them is made at compile time, based on compiler-defined macros.
  • To use NEON instructions, add "-mfpu=neon" to CFLAGS.
• x86:
  • The miner checks for SSE2 instructions support at runtime, and uses them if they are available.
• x86-64:
  • The miner can take advantage of AVX, AVX2 and XOP instructions, but only if both the CPU and the operating system support them.
    • Linux supports AVX starting from kernel version 2.6.30.
    • FreeBSD supports AVX starting with 9.1-RELEASE.
    • Mac OS X added AVX support in the 10.6.8 update.
    • Windows supports AVX starting from Windows 7 SP1 and Windows Server 2008 R2 SP1.
  • The configure script outputs a warning if the assembler doesn't support some instruction sets. In that case, the miner can still be built, but unavailable optimizations are left off.

Usage instructions

Run "cpuminer --help" to see options.

Connecting through a proxy

Use the --proxy option.

To use a SOCKS proxy, add a socks4:// or socks5:// prefix to the proxy host
Protocols socks4a and socks5h, allowing remote name resolving, are also available since libcurl 7.18.0.

If no protocol is specified, the proxy is assumed to be a HTTP proxy.
When the --proxy option is not used, the program honors the http_proxy and all_proxy environment variables.

Donations

Donations for the work done in this fork are accepted :

Tanguy Pruvot :

• BTC: 1FhDPLPpw18X4srecguG3MxJYe4a1JsZnd
• ZRC: ZX6LmrCwphNgitxvDnf8TX6Tsegfxpeozx

Lucas Jones :

• MRO: 472haywQKoxFzf7asaQ4XKBc2foAY4ezk8HiN63ifW4iAbJiLnfmJfhHSR9XmVKw2WYPnszJV9MEHj9Z5WMK9VCNHaGLDmJ
• BTC: 139QWoktddChHsZMWZFxmBva4FM96X2dhE

Credits

CPUMiner-multi was forked from pooler's CPUMiner, and has been started by Lucas Jones.

• tpruvot added all the recent features and newer algorythmns
• Wolf9466 helped with Intel AES-NI support for CryptoNight

License

GPLv2. See COPYING for details.