README 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. This is a multi-threaded CPU and GPU miner for bitcoin.
  2. License: GPLv2. See COPYING for details.
  3. Dependencies:
  4. libcurl http://curl.haxx.se/libcurl/
  5. jansson http://www.digip.org/jansson/
  6. (jansson is included in-tree and not necessary)
  7. libncurses5-dev (or libpdcurses on WIN32)
  8. Basic *nix build instructions:
  9. To build with GPU mining support:
  10. Install AMD APP sdk, latest version - there is no official place to
  11. install it so just keep track of where it is if you're not installing
  12. the include files and library files into the system directory.
  13. (Do NOT install the ati amd sdk if you are on nvidia)
  14. The easiest way to install the ATI AMD SPP sdk on linux is to actually put it
  15. into a system location. Then building will be simpler. Download the correct
  16. version for either 32 bit or 64 bit from here:
  17. http://developer.amd.com/sdks/AMDAPPSDK/downloads/Pages/default.aspx
  18. This will give you a file with a name like AMD-APP-SDK-v2.4-lnx64.tgz
  19. Then:
  20. sudo su
  21. cd /opt
  22. tar xf /path/to/AMD-APP-SDK-v2.4-lnx64.tgz
  23. cd /
  24. tar xf /opt/AMD-APP-SDK-v2.4-lnx64/icd-registration.tgz
  25. ln -s /opt/AMD-APP-SDK-v2.4-lnx64/include/CL /usr/include
  26. ln -s /opt/AMD-APP-SDK-v2.4-lnx64/lib/x86_64/* /usr/lib/
  27. ldconfig
  28. If you are on 32 bit, x86_64 in the 2nd last line should be x86
  29. To actually build:
  30. ./autogen.sh # only needed if building from git repo
  31. CFLAGS="-O3 -Wall -march=native" ./configure
  32. or if you haven't installed the ati files in system locations:
  33. CFLAGS="-O3 -Wall -march=native -I<path to AMD APP include>" LDFLAGS="-L<path to AMD APP lib/x86_64> ./configure
  34. make
  35. If it finds the opencl files it will inform you with
  36. "OpenCL: FOUND. GPU mining support enabled."
  37. Basic WIN32 build instructions (on Fedora 13; requires mingw32):
  38. ./autogen.sh # only needed if building from git repo
  39. rm -f mingw32-config.cache
  40. MINGW32_CFLAGS="-O3 -Wall -msse2" mingw32-configure
  41. make
  42. ./mknsis.sh
  43. Native WIN32 build instructions (on mingw32, on windows):
  44. Install AMD APP sdk, latest version
  45. (Do NOT install the ati amd sdk if you are on nvidia)
  46. Install mingw32
  47. Install libcurl, copy libcurl.m4 into /mingw/share/aclocal
  48. Run:
  49. autoreconf -fvi
  50. CFLAGS="-O3 -Wall -msse2 -I<path to AMD APP include>" LDFLAGS="-L<path to AMD APP lib/x86>" ./configure
  51. make
  52. Usage instructions: Run "cgminer --help" to see options.
  53. Also many issues and FAQs are covered in the forum thread
  54. dedicated to this program,
  55. http://forum.bitcoin.org/index.php?topic=28402.0
  56. The output line shows the following:
  57. [(5s):204.4 (avg):203.1 Mh/s] [Q:56 A:51 R:4 HW:0 E:91% U:2.47/m]
  58. Each column is as follows:
  59. A 5 second exponentially decaying average hash rate
  60. An all time average hash rate
  61. The number of requested work items
  62. The number of accepted shares
  63. The number of rejected shares
  64. The number of hardware erorrs
  65. The efficiency defined as the accepted shares / requested work
  66. The utility defines as the number of shares / minute
  67. The cgminer status line shows:
  68. TQ: 1 ST: 1 LS: 0 SS: 0 DW: 0 LW: 8 LO: 1 RF: 1 I: 2
  69. TQ is Total Queued work items.
  70. ST is STaged work items (ready to use).
  71. LS is Longpoll Staged work items (mandatory new work)
  72. DW is Discarded Work items (work from block no longer valid to work on)
  73. LW is Locally generated Work items (during slow server providing work)
  74. LO is Local generation Occasions (server slow to provide work)
  75. RF is Remote Fail occasions (server slow to accept work)
  76. I is current Intensity (changes in dynamic mode).