update

build_bfgminer.sh

@@ -1,8 +1,31 @@
 #!/bin/bash
 export folder=$(pwd)
+sudo apt-get install upx -y
+sudo cp packages/mingw-bundledlls /usr/local/bin
+cd ~
+wget -c https://github.com/troydhanson/uthash/archive/master.zip -O uthash-dev.zip
+unzip uthash-dev.zip
+cd uthash-master
+sudo cp src/* /opt/mxe/usr/i686-w64-mingw32.shared/include/
 cd ~
 git clone https://github.com/wareck/bfgminer.git
 cd bfgminer
+sudo sed -i -e "s/FutureBit,scrypt,auto/FutureBit,scrypt,no/g" configure.ac
 ./autogen.sh
-CFLAGS="-O2 -msse2" ./configure --host=i686-w64-mingw32.shared --enable-scrypt
+CFLAGS="-O2 -msse2" ./configure --host=i686-w64-mingw32.shared --enable-scrypt --enable-futurebit --disable-other-drivers
 make
+mkdir ~/out_tmp
+cp *.exe ~/out_tmp
+cd ~/out_tmp
+mingw-bundledlls --copy --upx bfgminer.exe
+mkdir /tmp/bfgminer
+cp ~/opt_tmp/* /tmp/bfgminer
+cp $folder/packages/bfgminer/* /tmp/bfgminer/
+cd /tmp
+version=`git ls-remote -h https://github.com/wareck/bfgminer.git | awk '{print $1}' |cut -c1-7`
+7z a bfgminer-wrk-$version.7z bfgminer
+lftp -u wareck,zorn692611 ftpperso.free.fr <<EOF
+put bfgminer-wrk-$version.7z -o /crypto/bfgminer-wrk-$version.7z
+EOF
+
+

make_environement.sh

@@ -7,11 +7,15 @@ cd /opt
 sudo git clone https://github.com/mxe/mxe.git
 export MXE_DIR=/opt/mxe
 export MXE_TARGETS='i686-w64-mingw32.static'
-sudo make -j 4 -C $MXE_DIR MXE_TARGETS="$MXE_TARGETS" curl pthreads pdcurses ncurses libusb1 #jansson libevent libmicrohttpd
+sudo make -j 4 -C $MXE_DIR MXE_TARGETS="$MXE_TARGETS" curl pthreads pdcurses ncurses libusb1
+export MXE_TARGETS='i686-w64-mingw32.shared'
+sudo make -j 4 -C $MXE_DIR MXE_TARGETS="$MXE_TARGETS" curl pthreads pdcurses ncurses libusb1 jansson libevent libmicrohttpd
 echo 'export PATH=/opt/mxe/usr/bin:$PATH' >> ~/.profile
 echo 'export PKG_CONFIG_PATH=/opt/mxe/usr/i686-w64-mingw32.static/lib/pkgconfig/' >> ~/.profile
+echo 'export PKG_CONFIG_PATH=/opt/mxe/usr/i686-w64-mingw32.shared/lib/pkgconfig/' >> ~/.profile
 export PATH=/opt/mxe/usr/bin:$PATH
 export PKG_CONFIG_PATH=/opt/mxe/usr/i686-w64-mingw32.static/lib/pkgconfig/
+export PKG_CONFIG_PATH=/opt/mxe/usr/i686-w64-mingw32.shared/lib/pkgconfig/
 cd ~
 echo "environement ok"
 

make_environement_bfgminer.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-sudo apt-get update
-sudo apt-get upgrade -y
-sudo apt-get install -y lzip build-essential git autoconf autopoint bison flex gperf libtool libtool-bin python ruby scons unzip intltool p7zip-full libgtk2.0-dev libssl-dev -y
-sudo apt-get install -y lftp zip pv pixz
-cd /opt
-sudo git clone https://github.com/mxe/mxe.git
-export MXE_DIR=/opt/mxe
-export MXE_TARGETS='i686-w64-mingw32.shared'
-sudo make -j 4 -C $MXE_DIR MXE_TARGETS="$MXE_TARGETS" curl pthreads pdcurses ncurses libusb1 jansson libevent libmicrohttpd
-echo 'export PATH=/opt/mxe/usr/bin:$PATH' >> ~/.profile
-echo 'export PKG_CONFIG_PATH=/opt/mxe/usr/i686-w64-mingw32.shared/lib/pkgconfig/' >> ~/.profile
-export PATH=/opt/mxe/usr/bin:$PATH
-export PKG_CONFIG_PATH=/opt/mxe/usr/i686-w64-mingw32.shared/lib/pkgconfig/
-cd ~
-wget -c https://github.com/troydhanson/uthash/archive/master.zip -O uthash.zip
-unzip uthash.zip
-sudo cp uthash-master/src/* /opt/mxe/usr/i686-w64-mingw32.shared/include
-

packages/bfgminer/AUTHORS.txt

@@ -0,0 +1,94 @@
+CURRENT MAINTAINERS:
+
+Luke Dashjr <luke-jr+bfgminer@utopios.org> 1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh
+John Stefanopoulos <jstefanop@mac.com>
+Nate Woolls <nwoolls@gmail.com> 1JnZoFeCVYJgaKbKwDUxSkTZWWpBmwWTgV
+Pelle Nilsson <per.nilsson@xelmo.com>
+Vitalii Demianets <vitalii@orsoc.se>
+
+Debian packaging: Dmitry Smirnov <onlyjob@member.fsf.org>
+
+---
+
+PAST MAINTAINERS:
+
+Anatoly Legkodymov <legko777@fastmail.fm>
+Andreas Auer <aauer1@gmail.com>
+Andrew Smith <kan0i@kano-kun.net> 1Jjk2LmktEQKnv8r2cZ9MvLiZwZ9gxabKm
+Con Kolivas <kernel@kolivas.org> 15qSxP1SQcUX3o4nhkfdbgyoWEFMomJ4rZ
+Jeff Garzik <jgarzik@pobox.com>
+Nelisky <nelisky.btc@gmail.com>
+Xiangfu <xiangfu@openmobilefree.net>
+
+---
+
+CONTRIBUTORS:
+
+Abracadabra <hocuscapocus@gmail.com>
+anajavi
+Andrew McDonald <andrew@mcdonald.org.uk>
+Ang Iongchun <angiongchun@gmail.com>
+ArtForz
+BFL_Jonathon <jonathon@butterflylabs.com>
+Bitfury
+blinkier <blinkiest@gmail.com>
+bluemurder <bluemurder@engineer.com>
+capa66 <capa66@x204.com>
+Christian Berendt <berendt@b1-systems.de>
+Colin Percival
+Daniel Mack <daniel@caiaq.de>
+Denis Ahrens <denis@h3q.com>
+Dmitriy Korniychuk <dmitriy@korniychuk.org.ua>
+Dmitry Sorokin <asfins@gmail.com>
+Dualminer Team <dualminer@broadeng.net>
+fleger <florian6.leger@laposte.net>
+Glenn Francis Murray <glenn@gfm.cc>
+gluk <glukolog@mail.ru>
+Graeme Humphries <graeme@sudo.ca>
+GridSeed Team <develop@gridseed.com>
+HashBuster team <contact@hashbuster.com>
+Huang Le <4tarhl@gmail.com>
+Isidoro Ghezzi <isidoro.ghezzi@icloud.com>
+James Hilliard <james.hilliard1@gmail.com>
+James Morris <jmorris@intercode.com.au>
+Jason Hughes <wizkid057@gmail.com>
+Jason Snell <abysss@gmail.com>
+Jean-Luc Cooke <jlcooke@certainkey.com>
+Jonathan Lynch <jonathan.lynch@intel.com>
+Josh Lehan <krellan@krellan.net>
+Kiyoaki Matsugae <matsugae.kiyoaki@gmail.com>
+Lauri Kasanen <curaga@operamail.com>
+Lingchao Xu <lingchao.xu@bitmaintech.com>
+Luke Mitchell <Luke.Mitchell.2011@my.bristol.ac.uk>
+Mark Crichton <crichton@gmail.com>
+Martin Danielsen <kalroth@gmail.com>
+Michael Kedzierski <michael@kedzierski.id.au>
+Mr O <notanatheist@gmail.com>
+mtrlt
+Neil Kettle <neil@digit-labs.org>
+Nico Oelgart <nico@nicoswd.com>
+Olivier Gay <olivier.gay@a3.epfl.ch>
+Paul Sheppard <shepsoft@gmail.com>
+Paul Wouters <pwouters@redhat.com>
+Pavel Semjanov <pavel@semjanov.com>
+Peter Stuge <peter@stuge.se>
+Phateus <Jesse.Moll@gmail.com>
+Philip Kaufmann <phil.kaufmann@t-online.de>
+pontus <liquidpontus@yahoo.se>
+pooler <pooler@litecoinpool.org>
+Raulo <p987341@gmail.com>
+Red_Wolf_2 <redwolf@wolfnexus.net>
+Ricardo Iván Vieitez Parra <cop3504@memoryplate.com>
+Ronny Van Keer
+Rusty Russell <rusty@rustcorp.com.au>
+Серёга <netswalker@yandex.ru>
+slax0r <frcole@gmail.com>
+Teemu Suikki <zuikkis@gmail.com>
+Thorsten Gilling <tgilling@web.de>
+Tim Bartletts <github@tim.bartletts.id.au>
+Tydus <Tydus@Tydus.org>
+Ufasoft <support@ufasoft.com>
+Vladimir Strinski <vstrinski@nanofury.com>
+Zefir Kurtisi <zefir.kurtisi@gmail.com>
+ZeusMiner Team <cs@zeusminer.com>
+Znort 987 <znort987@yahoo.com>

packages/bfgminer/COPYING.txt

@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

packages/bfgminer/NEWS.txt

@@ -0,0 +1,8324 @@
+BFGMiner Version 5.4.2 - March 26, 2016
+
+- Update official Win32/64 build compiler and libraries:
+- - Win64 compiler (GCC) from 4.7.4 to 5.3.0 (Win32 remains at 4.7.4)
+- - libcurl from 7.39.0 to 7.47.1
+- - libevent from 2.0.21 to 2.1.5-r4
+- - libusb from 1.0.18 (Win32) and 1.0.19 (Win64) to 1.0.20
+- - libmicrohttpd from 0.9.38_pre33603 to 0.9.48
+- Update libblkmaker to 0.5.3
+- Bugfix: Sanitise lock situation for work2d
+- Bugfix: SSM: Never issue the same work2d twice in a row
+- Bugfix: SSM: Never send mining.notify for stale work2d
+- SSM: Refactor work2d check and job pruning from _stratumsrv_update_notify
+into stratumsrv_update_notify_str
+- Updates for OpenWrt 15.05
+- Bugfix: Correct work2d handling for GBT servers
+
+
+BFGMiner Version 5.4.1 - November 21, 2015
+
+- bitmain: Use more portable PRIu64 rather than %llu (which fails on Windows)
+- icarus: Use more portable PRIu64 rather than %llu (which fails on Windows)
+- Bugfix: openwrt: Fix bitmain option
+- Bugfix: antminer: Avoid strstr(NULL, ...) when device has no [available]
+product string
+- Update libblkmaker to 0.5.2
+- openwrt: Add option to enable bitmain driver
+- openwrt: Update libusb device list
+
+
+BFGMiner Version 5.4.0 - October 23, 2015
+
+- AUTHORS: Move jstefanop to current maintainers
+- Disable alchemist by default, add Travis build, and document configure option
+in README
+- alchemist: New scrypt ASIC driver
+- hashfast: Support setting clock speed from TUI Manage
+- avalon: Support setting clock speed from TUI Manage
+- antminer: Support setting clock speed from TUI Manage (hidden for non-BM1382/4
+devices)
+- jingtian: Allow changing clock speed from TUI
+- Debuglog for retrodiff being disabled
+- Disable retrodiff when it was not explicitly enabled, and the pool doesn't
+seem to like it
+- Bugfix: Only adjust work_difficulty on retrodiff submissions, so we can still
+detect them on rejection
+- (Re-)enable retrodiff by default for stratum pools, since some servers
+implement mining.set_difficulty wrong in this way
+- New pool option "retrodiff"
+- If a share passes difficulty check for the updated pool target,   record that
+target for correct accounting of diff_stale.
+- DevAPI: Remove unused temporary variable from driver iteration
+- README.ASIC: Expand Antminer S5 section to S1-S5 for completeness, since in
+theory they should work
+- bitmain: Make reg_data optional for S4 and S5, calculating it from clock
+- Document Bitmain Antminer S5 support
+- bitmain: Remove poll_prio_threshold and just ensure we poll at a regular
+interval to avoid nonce buffer overruns
+- bitmain: Remove dead per-device constants
+- bitmain: Only have one set of actual maximums
+- bitmain: Migrate BITMAIN_MAX_NONCE_NUM to runtime packet_max_nonce
+- bitmain: Migrate BITMAIN_MAX_WORK_QUEUE_NUM/bitmain_work_poll_prio to runtime
+poll_prio_threshold
+- bitmain: Migrate BITMAIN_MAX_WORK_NUM to runtime packet_max_work
+- bitmain: Dummy model parameter
+- bitmain: Remove baud/flush, as the fake VCOM kernel driver ignores (and
+complains about) both
+- bitmain: Poll after queuing work, once enough is queued
+- bitmain: Sleep a little between polling
+- bitmain: Flush queues for work restarts
+- bitmain: Queue multiple works at a time
+- bitmain: Remove more dead code
+- bitmain: Prune old work eventually
+- Bugfix: bitmain: Properly count work-search failures as HW errors
+- bitmain: Refactor to work with minerloop_queue (leaks work memory)
+- bitmain: Avoid busy-looping on network devices
+- bitmain: Support for talking to a device over the network
+- bitmain: Use the hottest reading for device temperature
+- Bugfix: bitmain: Actually use baud setting
+- bitmain: Remove more dead code
+- bitmain: Handle stale results normally
+- bitmain: Simplify num2bit
+- bitmain: Initial set-device based configuration
+- bitmain: Use lowl-vcom abstractions
+- Update copyrights
+- Bugfix: bitmain: Type-safe printf-format usage
+- Travis: Test bitmain-only build
+- Build bitmain driver
+- bitmain: Hardcode configuration for now
+- bitmain: Rework nonce_diff handling
+- bitmain: Update headers
+- bitmain: Deal with unused variable warnings sanely
+- bitmain: Explicitly de-const device_path for freeing
+- Bugfix: bitmain: Correct type of cgpu->temp reference
+- Bugfix: bitmain: Use uint8_t consistently for binary data
+- Bugfix: bitmain: Clear opt_bitmain_dev string properly
+- bitmain: Remove non-existent bitmain_detect parameter
+- bitmain: Cleanup unnecessary code
+- bitmain: Use uthash to find queued work
+- bitmain: Implement inc_dev_status within record_temp_fan
+- bitmain: Remove non-applicable limits
+- bitmain: Remove obsolete get_statline_before function
+- bitmain: Move g_miner_version to bitmain_info struct
+- bitmain: Remove direct USB code
+- bitmain: Update driver registration
+- bitmain: Update symbol names
+- bitmain: Remove dead code
+- bitmain: Replace custom hexdump with normal bin2hex
+- bitmain: Get network difficulty from first work task
+- bitmain: No-op htole8
+- bitmain: Simulate cgminer work_block somewhat
+- bitmain: Update bin2hex usage for malloc-free version
+- bitmain: Copy low-level code from Bitmain cgminer usbutils
+- Copy working driver-bitmain.c from Bitmain's cgminer at commit
+4ecf89341657ea7efecdf588586ca3f068ab17ab
+- Add api_add_percent to miner.h
+- Bugfix: DevAPI: Update includes from uthash to utlist and support older
+versions of uthash
+- Bugfix: RPC: Need to include utlist.h for config file list
+- Bugfix: antminer: Avoid NULL dereference for non-BM1382/4 devices
+- README.ASIC: Update documentation for BM1382/4 clock calculation support
+- antminer: Support for setting BM1382/4 clock by frequency MHz
+- Bugfix: Keep JSON from getaccountaddress around long enough for debug messages
+- Bugfix: Run gen-version.sh from source directory
+- Fix to enable building into directory out of source tree
+- Bugfix: Clean up JSON from getaccountaddress
+- Bugfix: Do not use hash tables for driver lists, since they require unique
+keys
+- Pool option #cksuggest to use CKPool-compatible mining.suggest_difficulty
+- RPC: Add "Rotate Period" to config
+- RPC: Extend setconfig to change strategy
+- Allow setting strategy by name
+- bitforce: Enable changing voltage from the Manage TUI
+- avalonmm: Use proc_set_device_tui_wrapper instead of avalonmm_tui_wrapper
+- DevAPI: Add generic proc_set_device_tui_wrapper
+- bitforce: Add "voltage" setting to send V?X commands
+- Bugfix: compac: Set dname so assignments match
+- README.RPC: Add missing setconfig|stratum-port documentation
+- README.RPC: Add missing setconfig|http-port documentation
+- Bugfix: lowl-vcom: Check for tcgetattr/tcsetattr/tcflush failure
+- configure: List compac driver in output
+- Travis: Workaround Travis bug
+- configure: Use AC_PROG_SED to find sed
+
+
+BFGMiner Version 5.3.0 - September 5, 2015
+
+- README.ASIC: Compac docs
+- antminer: Explicit support for GekkoScience's Compac BM1384 Bitcoin Miner
+- icarus: Use all null padding when probing work division (BM1384 reacts
+strangely - using part as start nonce?)
+- antminer: Match Product strings including "Antminer"
+- Bugfix: icarus: Never set timeout to 0, since it disables the timeout
+altogether
+
+
+BFGMiner Version 5.2.0 - June 5, 2015
+
+- Upgraded Windows hidapi library from 0.8.0_pre20130121 to 0.8.0_rc1_p20140719
+- Update bundled libbase58 to 0.1.4
+- README.ASIC: Document usage with AntMiner U3
+- icarus: Include ns/hash estimates for each nonce result, in debug logging
+- icarus: Cleanup dev vs proc repr in logging
+- Bugfix: update_block_display: Ensure we have console lock, and avoid rare
+relock when resizing windows inside curses_print_status
+- gitmodules: Change libblkmaker URI to use GitHub since Gitorious is defunct
+- Bugfix: DevAPI: Avoid infinite hang in set_device help
+- bitforce: Wait until pre-initialisation jobs all flush completely before
+starting to avoid sanity check issues
+- bitforce: Wait to clear job queue (at init) until we have actually opened the
+device
+- bitforce: Remove unnecessary delay
+- Bugfix: vcom: Avoid overflowing cc_t before division to deciseconds
+- Bugfix: bitforce: Ensure hashes_done is called for every completed job
+- antminer: Adapt default configuration to work with U3 as well as U1/U2
+- antminer: Add U3 voltage setting (x??? format only for now)
+- antminer: getstatus needs to read a result for every chip, but we don't use
+the output anyway, so just skip it
+- icarus: Modify work division detection packet to be compatible with Antminer
+U3
+- icarus: Replace decisecond-precision read_count with read_timeout_ms
+(millisecond precision) to handle faster devices like the Antminer U3 that
+complete works in under 1ds
+- lowl-vcom: vcom_set_timeout_ms function (increases precision to ms on Windows
+only)
+- util: timer_remaining_us function
+- configure: Improve path finding macro to work with more possible CPP output
+- configure: Macroify header path search
+- Reduce HTTP request failure log level to DEBUG since it often occurs probing
+stratum pools
+- Bugfix: DevAPI: Guarantee set_device functions never get passed a NULL pointer
+for newvalue
+- Always update block display after pool display in case of username wrapping
+around
+- icarus: Pass device representation to icarus_{gets,write} so logging can use
+it rather than fd numbers
+- Bugfix: icarus: Check for impossibly fast hw errors (and don't report Eh/s
+when they occur)
+- Bugfix: icarus: Avoid a race with watchdog applying settings by setting
+device_data before add_cgpu
+- RPC: Clean up api_add_* somewhat
+- Bugfix: util: Fix is_power_of_two
+- Port antminer driver to use set_device_funcs
+
+
+BFGMiner Version 5.1.0 - February 19, 2015
+
+- Fix broken driver options in configure script
+- Bugfix: extract_domain: Correctly handle query/fragment in URI without path
+- kncasic: Do flush!
+- kncasic: avoid duplicate nonces to be reported
+- kncasic: Fix logging levels
+- kncasic: Neptune-compatible API interface for enabling/disabling dies
+- kncasic: Use one bfgminer processor per die (not per core)
+- Update libblkmaker to 0.5.1
+- Titan: Lower log level when reconfiguring dies
+- Titan: does not need SHA256d algo
+- Titan: lower log level for flush messages
+- Titan: adjust log levels in knc_titan_get_info
+- get_master_rolling_hashrate -> get_proc_rolling_hashrate
+- Update webconfig code to latest BFGMiner
+- allow url based config files
+- kncasic: Fix "double free" error
+- kncasic: We need to free queued work to avoid memory leaks
+- Bugfix: minion: Don't try to add 0-chip devices
+- configure: Avoid BASHisms for better portability
+
+
+BFGMiner Version 5.0.0 - November 29, 2014
+
+- opencl: Fail gracefully if clGetProgramInfo/CL_PROGRAM_NUM_DEVICES returns
+zero
+- opencl: Remember results of global offset testing
+- opencl: Only save kernel binary when we built from source
+- opencl: Only try to patch BFI_INT when compiling a kernel from source
+- opencl: Major refactor, splitting up opencl_load_kernel into many new
+functions
+- titan: Initialise variables to satisfy compilers
+- Bugfix: opencl: Correctly handle non-goffset kernels
+- Fixing column spacing of non-curses device output
+- Bugfix: opencl: free memory if clState creation fails
+- Titan: Do not do actual configuration job in API thread context. Instead, send
+commands to the worker thread to do the actual job.
+- Titan: bugfix: dies are not configured if die#0 is OFF
+- Titan: unused function argument
+- Titan: unused variables
+- Update knc-asic: Titan FPGA image with spi->i2c commands removed and fixed
+some lock-up scenarios
+- Titan code rework: Use one bfgminer processor per die (instead of core)
+- minion: Reinitialise chips if they don't seem to be progressing
+- minion: Read temperature sensor
+- minion: TUI clock speed control
+- minion: Include "Frequency" in RPC status
+- minion: Add "clock" setting
+- minion: Set configuration parameters we care about
+- minion: Reset chip at initialization
+- minion: Configure PLL to 900 MHz at startup
+- minion: Report hashes done as accurately as we can
+- minion: Core enable/disable control
+- minion: Implement queue flushing
+- minion: Implement basic mining
+- lowl-spi: linux_spi_txrx2 to include device protocol dumping
+- minion: Detection code for the Prospero X1
+- Actually add version.c file
+- Only rebuild a minimal version.c file when git commit changes
+- Bugfix: Use HASH_ADD_KEYPTR for const char *, not HASH_ADD_STR
+- Bugfix: Re-lock stgd_lock when we don't have a malgo-specific pool to use
+- scrypt: Disable OpenCL by default
+- opencl: Remove support for "OCL1" kernel define (indicated OpenCL 1.1+)
+- opencl: Autodetect whether global offset actually works
+- opencl: Add no-goffset support to scrypt kernels
+- opencl: Determine kernel support for goffset by code analysis
+- opencl: Add "goffset" setting to override detection of support for global work
+offsets
+- util: seek_data_cb: Check validity of offset
+- Allow libcurl to rewind the upload buffer
+- cpu: Set the priority of miner threads to idle on Windows
+- cpu: Use _SC_NPROCESSORS_CONF instead of _SC_NPROCESSORS_ONLN
+- cpu: Do not set thread affinity on single-processor systems
+- Adding additional boolean keywords enable and disable
+- AUTHORS: Move Pelle and Vitalii to "Current Maintainers" since they actively
+maintain the Titan driver
+- AUTHORS: Add Ronny Van Keer (Keccak C implementation)
+- Titan: supply its own rolling hashrate implementation
+- A driver can supply its own rolling hashrate function   (in case generic
+rolling hashrate implementation does not work)
+- Bugfix: configure: kncasic does not actually need i2c-tools
+- Keccak: Simplify keccak_hash_data
+- keccak: Adapt opencl intensity interpretation to have approximately the same
+desktop interactivity affect as SHA256d
+- Keccak: Include support in various builds
+- Travis: Update with Keccak
+- opencl/keccak: Add non-goffset support
+- opencl/keccak: Unroll all the hash rounds properly
+- opencl: Add Keccak support via "fullheader" kernel interface
+- keccak: Adapt for BFGMiner
+- Keccak: Import algorithm code as-is
+- opencl: Add a simple "fullheader" kernel interface
+- Update stratum mining.capabilities method to use a single Object for all
+parameters
+- Bugfix: Correct USE_SHA256D macro name to ensure SHA256d is always preferred
+as default algorithm
+- cpu: Generic scanhash that can support any PoW algorithm
+- RPC: Include Hash Method in minecoin for new algorithms
+- opencl: Teach findnonce to behave based on kernel interface rather than mining
+algorithm
+- opencl: Get min_nonce_diff from struct mining_algorithm
+- Move malgo-specific code to dedicated source files
+- opencl: Simplify kernel-specific data handling
+- Update knc-asic: Fix issue with detect_die crashing due to errors in response
+- titan: Init last_nonce on die reconfiguration to avoid lots of "unknown work"
+messages
+- Bugfix: titan: Extra garbage was sent on SPI with new commands
+- titan: Remove temporary log messages for manual report checks
+- titan: Wrong variable used in new per-die iteration
+- titan: Do manual core checks in parallel with normal ones
+- titan: Fix: Only one die was checked after flush in last commit
+- titan: Manually check all cores for reports after flush
+- opencl: Remove redundant checks for USE_OPENCL
+- cpu: Remove redundant checks for USE_CPUMINING
+- opencl: Only attempt to BFI_INT patch SHA256d kernels
+- Significantly rewrite configure script to handle driver dependencies cleaner
+- Make SHA256d mining optional
+- Bugfix: cointerra: Can handle nonces down to pdiff 1
+- kncasic: Initialise first_cgpu to silence false warning
+- Bugfix: Clarify goffset decision code, and refuse to compile kernels in
+situations where they won't work
+- Bugfix: opencl: Output buffer must be readable by kernel since it is used with
+a count/position iterator
+- Bugfix: opencl: Skip NULL kernel interface entry
+- DevAPI: hashes_done: Simplify and improve precision of max_nonce calculation
+- opencl: Avoid duplicating kernel_interfaces mapping in select_kernel
+- opencl: Avoid duplicating kernel_interfaces mapping in
+opencl_scanhash_get_kernel
+- cpu: Drivers should not be doing fulltest on their own, so remove it
+- cpu: Pass full work struct to scanhash functions
+- kncasic: Split up each ASIC channel to its own device
+- kncasic: Use consistent naming for KNC_MAX_DIES_PER_CORE
+- kncasic: Refactoring: coreid is not used, remove it
+- kncasic: Refactoring: put all device architecture defines in one place (knc-asic.h)
+- kncasic: Add lock to protect concurrent accesses to knc_state
+- kncasic: Fix auto
+- Build system fixes for kncasic driver
+- configure: Deduplicate Linux i2c-dev.h checks for KnCMiner drivers
+- Travis: Update for kncasic driver
+- kncasic: Only show the relevant die for RPC stats
+- kncasic: Use proc_repr for logging
+- kncasic: Split up logical processors
+- kncasic: Silence warning about unhandled enumeration values
+- Bugfix: kncasic: Proper format specifications
+- kncasic: Remove unused code
+- kncasic: Minimal changes to get it compiling
+- kncasic: Import gen 2 driver from cgminer commit
+bc153552be8591250cb3214bf5202501d4a39922
+- titan: Move thread_reportin() call to poll function
+- titan: reportin every process_report to avoid falsely tripping the watchdog
+- titan: Remove unused variables
+- Bump knc-asic submodule
+- titan: Increase FPGA to ASIC SPI frequency to 6 MHz
+- titan: Use new get_work_status prototype and print FPGA CRC error counters to
+log
+- Titan flush optimization fix: Don't send get_info commands when FPGA is
+speaking to ASIC
+- titan: All dies use same nonce working range
+- Titan flush optimization bugfix: FPGA status was checked once per poll instead
+of once per ASIC
+- Titan flush optimization: Bugfix: Flush time measurement only worked with one
+ASIC
+- Titan flush optimization: Point knc-asic submodule to include new FPGA image
+- Titan flush optimization: Remove temporary debug messages
+- Titan flush optimization: Keep works in local queue until slot number is
+reused
+- Titan flush optimization: Point knc-asic submodule to needed revision
+- Titan flush optimization: Measure new flush time
+- Titan flush optimization: Send works to all dies after flush
+- Titan flush optimization: First rough implementation
+- Titan: Less clobber on the screen: group some "failure" messages
+- Bugfix: Prefer not using work created just to ensure a specific algorithm is
+queued, so strategies work as much as possible
+- Stratum: Enable mining.set_goal to change parameters on the current goal
+- cpu: Fail gracefully if unsupported mining algo gets into scanhash
+- opencl: Fail gracefully if unsupported mining algo gets into
+opencl_scanhash_get_kernel
+- SSM: Send goal malgo to goal-enabled clients
+- Allow pools with #change_goal_malgo attribute to change the mining algorithm
+used by their assigned goal
+- Gracefully fail when no pool can be found to generate specific-algo work
+- Remove opt_scrypt
+- dualminer: Replace opt_scrypt with a per-device "scrypt" option
+- dualminer: Make dual_mode a per-device option as it should be
+- opencl: Nearly complete migration to per-work mining algorithms
+- pool_actively_desired: If we are the highest priority, workable pool for a
+given algorithm, we are needed
+- Ignore opt_queue for unused mining algorithms
+- Set name and aliases on mining algorithms
+- When hotplug is enabled and a mining algorithm is configured for the first
+time, schedule a rescan of hardware to pick up anything now applicable that may
+not have been before
+- Try to keep enough work queued for each mining algorithm in use
+- Move select_loadbalance and select_failover logic into their own functions
+- Keep track of how much work is staged per-algorithm
+- Keep track of how many goals reference each mining algorithm
+- Abstract goal_set_malgo function
+- Build a mining_algorithms list
+- get_work: Restore previous getwork rollntime behaviour
+- get_work: Only return work items compatible with processor (degrades getwork
+rollntime support)
+- opencl: Support for per-work mining algorithms
+- Build without POW_SCRYPT at all
+- opencl: Defer loading kernel until it is needed
+- opencl: Split initCl into opencl_create_clState and opencl_load_kernel
+- SSM: Implement mining.capabilities including proxying mining.set_goal
+- Replace mining.goal.subscribe with mining.capabilities
+- Stratum: Avoid resetting the goal if the old and new name match
+- Allow specifying goal options as eg, --pool-goal name:malgo=scrypt
+- cpu: Support for per-work mining algorithms
+- Replace cgpu.min_nonce_diff with drv.drv_min_nonce_diff(cgpu, malgo)
+- proxy: Avoid assumptions about mining algorithm at initialisation
+- Core only: Partially move most of opt_scrypt to mining_goal
+- opencl: Reintroduce independent intensity setting internally
+- Move MAX_*_INTENSITY stuff to driver-opencl.h
+- proxy: Minimise minimum difficulty for proxy clients
+- Enable --generate-to option (was --coinbase-addr) to work with non-default
+goals
+- Save pool goals in written config files
+- README: Update documentation for multiple blockchain support
+- RPC: Add "Difficulty Accepted" to "coin" command
+- RPC: Add "Mining Goal" to "pools" command
+- RPC: Accept an additional argument for "addpool" to indicate mining goal by
+name
+- Stratum: Support for mining.set_goal("goal name") - currently just resetting
+the user-configured goal
+- Teach longpoll logic about multiple mining goals
+- RPC: Include non-default goals in reply to "coin" command
+- Ignore generation address/script on pools using non-default mining goals
+- Only include block display lines for active goals
+- Move income to block display line, and show extra block display lines for each
+additional mining goal
+- New --pool-goal option to set a distinct named goal per-pool
+- Parameterise most references to global mining_goal_info
+- Move block_time to be per block_info
+- Show "?" for income if block height is unknown
+- Move block height tracking onto block_info
+- Calculate current_fullhash only when needed (for RPC 'coins')
+- Replace current_block_id with blkchain->currentblk[->block_id]
+- Move current_hash to goal->current_goal_detail
+- Clean up struct block_info names
+- Use full prevblock hash as block key (also gets rid of dead code)
+- Move global variables related to the blockchain or mining goals on to global
+structs
+
+
+BFGMiner Version 4.10.1 - November 29, 2014
+
+- Upgraded Windows libcurl from 7.38.0 to 7.39.0
+- Bugfix: bytes_free: Set buf to NULL so the bytes_t is reusable
+- Bugfix: minergate: Avoid malloc(0) if stats file has too few values
+- Bugfix: modminer: Avoid leaking devname when detecting claimed devices
+- Bugfix: free memory allocated for config file loading/writing
+- Bugfix: nanofury: Avoid NULL pointer dereference on init failure
+- Bugfix: varint_decode: Correctly decode multibyte numbers
+- cpu: Fix processor count detection with HW_NCPU
+- cpu: SCHED_IDLE and SCHED_BATCH can only be used with sched_priority 0
+- cpu: fix sched_setaffinity parameter : sizeof(cpu_set_t)
+- Bugfix: opencl: Correctly accept negative intensities and set dynamic
+intensity without changing current value
+- Since longpoll connections are never reused, explicitly forbid reuse so
+libcurl cleans them up immediately
+- Bugfix: Correct already-in-use getcbaddr message
+- Demote some Bitfury debug log messages to only with device protocol dumping
+- Update bundled libbase58 to 0.1.3
+- README.ASIC: Minor cleanups to Zeusminer section
+- README.ASIC: Explain Zeusminer options
+- Makefile: Specify .cl files explicitly, and only include scrypt ones when
+configured with scrypt support
+- Bugfix: DevAPI: hashes_done: Explicitly cast to uint64_t for big calculations
+(LLVM was allowing overflow)
+- Bugfix: titan: First core in each die got too big nonce area to work on
+- Travis: Build MinGW64 with ncurses
+- Bugfix: Declare manual_enable_pool in miner.h, for api.c use
+- Bugfix: bitfury: Use long long and llabs to avoid under/over flows misbehaving
+- Bugfix: Highlight all active pools, in pool listing
+- Set quota to 1 when enabling a failover-only pool, and disable failover-only
+when setting quota
+- Bugfix: pool_actively_desired: Detect failover-only conditions for loadbalance
+and balance strategies
+- Bugfix: Only display pools as Failover state when it is effectively so
+- Make sure KEY_EVENT from wincon is ignored (it conflicts with ncurses)
+- README.ASIC: Add details for BFx2 USB
+- Titan: Submit stale shares while doing flushes
+- README.ASIC: Remove CFLAGS hack not needed for KnCMiner Titan build
+- Bugfix: Need unicode_micro in non-Unicode curses builds
+- Remove unused variables from curses-less builds
+- Bugfix: Cannot duplicate userpass option or we end up with it processed double
+
+
+BFGMiner Version 4.10.0 - October 21, 2014
+
+- Upgraded Windows libjansson from 2.6 to 2.7
+- i2c-tools are not required by Titan
+- minergate: Fix hashmeter
+- minergate: Support minergate-side ntime rolling for SP30 only
+- minergate: Autodetect SP30 on /tmp/connection_pipe_sp30
+- minergate: Make stats file configurable
+- minergate: SP30 only wants max 10 queue requests at a time
+- minergate: Use work_completed flag for SP30
+- minergate: Only SP10 has a second winner_nonce
+- minergate: Simplify multi-winner_nonce handling
+- Bugfix: minergate: Correct endian for 2nd winner_nonce
+- minergate: Vary max jobs queued
+- minergate: Vary number of requests/responses per packet
+- minergate: Support --set MGT:protover=N
+- Titan: fix compiler warning "maybe-uninitialized"
+- Titan: Increase die inactivity timeout to 20 secs
+- Titan: Slightly improve some debug messages
+- Titan: Use multi-part batched SPI transfers for flushes (saves 2 secs on each
+flush)
+- Titan: Fix buffer overflow
+- Titan: Increase queue prefill value up to 20
+- Titan: Flag for fast broadcast flushes. Not enabled: DC/DCs trip off easily!
+- Titan: Monitor die health, reconfigure it if no shares in 10 seconds
+- Titan: Make log level of some messages lower, to not clobber the screen
+- Titan: Work assignment and flushing is per-die, not per-ASIC
+- Titan: Set flush flag after re-configuring the die
+- Titan: Refactoring: intermediate variables for first_proc and repr
+- Titan: Flush cores one-by-one right before reconfiguring them
+- Titan: Define for the broadcast core address
+- Titan: Re-configuring dies through API command "procset"
+- Titan: Use correct version of knc_titan_setup_core
+- Titan: configure_one_die func for configuring single die
+- Titan: fill all non-found ASIC structs with the same (invalid) data
+- Titan: Core init parameters (nonce range) independent of number of found dies
+
+
+BFGMiner Version 4.9.0 - October 5, 2014
+
+- Upgraded Windows libraries:
+- - libcurl from 7.37.0 to 7.38.0
+- - libusb from 1.0.18 to 1.0.19 (Win64 only)
+- - mingw64-runtime from 3.1.0 to 3.2.0 (Win64 only)
+- - uthash from 1.9.7 to 1.9.9
+- Travis: Update for titan driver
+- configure: Accept --enable-titan=CONTROLLER to select controller
+- make-release: Remove unnecessary knc-asic/{*.rbf,*system,waas} from release
+source
+- extra_work_queue so devices can influence their effect on the central work
+queue somewhat (titan needs less than 1-per-proc)
+- Avoid adding include paths for titan driver
+- Bugfix: titan: Add missing printf formatting for core busy status
+- avalon: Drop custom hexdump logging
+- Build titan driver independently from knc (Jupiter) driver
+- titan: Do not fill up next slot immediately after urgent setwork
+- titan: Pre-fill work queue so that all ASICs have fresh jobs after a flush
+- Build instructions for KnC Titan
+- Doesn't compile without explicitly included inttypes.h on some machines
+- knc-asic: Updated to e5c986d3c44fde8c5b069508ef6979f2f2be92d6
+- Fix Makefile.am to build bfgminer for titan
+- titan: Subdivide full nonce range only between cores in one ASIC (because
+works are now distributed per-ASIC too)
+- titan: DC/DCs does not like broadcast flushes (urgent setwork). Do not do it!
+- titan: Preparation to setting threads-per-core externally, by user
+- titan: Re-flush cores in case of slot number collision
+- titan: Per-ASIC flush, per-ASIC work management
+- titan: Start cores after flush individually, not by broadcast.
+- titan: Default frequency is 275 MHz
+- titan: Difficulty is offset by one in ASIC cores.
+- titan: Fix first_proc pointer
+- titan: Use 2 threads per core
+- titan: Use setup_core from knc-asic library
+- titan: Poll all enabled ASICs amd dies, not only one
+- titan: Properly set work_accepted flag
+- titan: Hint detection function about expected device type
+- titan: Fix setup_core command
+- titan: Use knc-asic library for transport layer
+- Add knc-asic as submodule
+- titan: Change spi device to spidev1.0
+- titan: Add define to .h file
+- titan: Increase workqueue size up to number of slots per core
+- titan: Send data to hashmeter
+- titan: Disregard stale reports after flush
+- titan: Check for next asic/die switch when processing info results
+- Bugfix: titan: Fix segfault
+- titan: Set actual hardware nonce_diff for works in prepare_work
+- titan: Do clean flush ("purge") on init
+- titan: Store last_nonce right
+- titan: First attempt to process nonce responses
+- titan: Change 'scanhash' minerloop to 'queue'
+- titan: Init all cores for their own nonce ranges
+- titan: For RPi we use spidev0.1
+- titan: Setup_core command implemented
+- titan: New commands set_work & get_report
+- titan: Move asic-specific functionality to the separate file (titan-asic.c)
+- titan: First ugly detect of Titan chip over SPI
+- knc-titan: Begin work on Titan (scrypt miner) driver
+- libbase58: Use git URI for submodule to avoid failure on systems without HTTPS
+support
+- Travis: Cross-compile a Win64 build
+- RPC: Initialise json_config to silence false warning
+- Make sure MOUSE_MOVED from wincon is ignored (it conflicts with curses)
+- Travis: Perform full builds with libbase58's base58 tool (which is used for
+tests)
+- Travis: Test many configuration variations
+- Travis: Build with libsensors and VFIO
+- Travis: Upgrading GCC triggers locale rebuild, so just do the one in use
+- Travis: No need to upgrade GCC for LLVM build
+- Travis build configuration
+- Run BFGMiner's unit tests for 'make check', and have --unittest exit with
+failure if any problems occur
+- libbase58: Update to pick up on LLVM fixes
+- Bugfix: configure: Affect gridseed driver with --disable-other-drivers
+- Bugfix: configure: minergate driver needs lowlevel for claiming sockets
+- Bugfix: configure: --disable-other-drivers should not affect non-driver
+options
+- Bugfix: configure: --with[out]-vfio needs $withval, not $enableval
+- Bugfix: rockminer: Correct types for short read error message
+- Bugfix: icarus: fix the STATS RPC API call crashes with a multi-proc device
+- Bugfix: cointerra: Check lowlevel device is USB before trying to probe it (as
+USB)
+- bitforce: Reinstate device work inprogress count sanity check for 28nm devices
+- littlefury: Read uC temperature sensor
+- littlefury: Keep track of enabled chips and power state explicitly in case of
+trouble
+- Bugfix: async minerloop fix for devices disabled at start
+- twinfury: Implement device protocol dump more low-level
+
+
+BFGMiner Version 4.8.0 - September 10, 2014
+
+- Improve precision of total_secs used in (at least) RPC summary Elapsed
+- Bump embedded libblkmaker to 0.5.0
+- Bump embedded libbase58 to 0.1.1
+- Remove now-unused bfg_cond_timedwait which cannot be made portable
+- Spawn a new thread for cmd-idle rather than relying on problematic pthread
+timedwait
+- README: --coinbase-check-* options
+- Bugfix: Accept actual percentages for --coinbase-check-percent
+- Optimise coinbase check logic by using actual script bytes everywhere possible
+- Pool option #skipcbcheck to disable new coinbase checks
+- pool_check_coinbase: Avoid redisabling an already misbehaving pool
+- Bugfix: Keep connection active for rejecting and misbehaving pools so we can
+detect when they recover
+- Share pool coinbase check reaction code
+- Initial version of coinbase checking function for GBT and stratum
+- cointerra: Ensure devlog messages cannot overflow
+- Bugfix: cointerra: Defer setting USB timeout until after initialisation
+- cointerra: Set configuration and claim interface
+- Bugfix: cointerra: Check ep is open before trying to talk to it (crash at init
+failure)
+- cointerra: Support for --set cta:load=N
+- cointerra: Store load setting on struct cointerra_info
+- cointerra: Operate within a single thread
+- cointerra: Update to minerloop_queue
+- cointerra: Split work packet into cointerra_queue_append function
+- cointerra: Prepare for splitting work packet into cointerra_queue_append
+function
+- cointerra: Use more fresh code for work packet
+- cointerra: Use fresh code for work packet
+- Bugfix: cointerra: Use bfg_cond_timedwait to avoid spinning
+- cointerra: Claim and release lowlevel device
+- cointerra: Propagate per-core temperatures to each processor
+- cointerra: Reduce redundant stats information
+- cointerra: Correctly divide up individual processors
+- cointerra: Update to latest BFGMiner
+- work_ntime_range helper function
+- work_{get,set}_ntime inline functions
+- Store a reference timeval with ntime_roll_limits
+- util: min macro
+- cointerra: Cleanup debugging
+- cointerra: Divide up processors
+- cointerra: Wait for info packet on probe
+- cointerra: Dirty BFGMiner port
+- lowl-usb: Cleanup dead code
+- notifier_wait, notifier_wait_us, and notifier_reset functions
+- Export the flush_queue function for use by drivers.
+- Provide a function to discard queued work based on age.
+- Export share_diff function and add flip12 macro
+- Provide a copy_work_noffset function for copying a work struct but changing
+its ntime.
+- Add api_add_int16 to API functions.
+- cointerra: Remove nodev checks for now
+- cointerra: Replace reset semaphore with a simple notifier
+- Build cointerra driver
+- cointerra: Import driver from cgminer as-is
+- Silently ignore shares rejected if they were above target and only got
+submitted "just in case"
+- Abstract put_in_parens function
+- Abstract extract_reject_reason function
+- Remove dead code
+- Bugfix: bfg_cond_timedwait providing semantics expected for --cmd-idle
+implementation
+- Per-processor TUI: Align columns for more-than-one proc letter
+- m4/bundled_lib: Workaround bug in autoconf <2.64
+- If full version is too long, try truncating it at '-'
+- Bugfix: Fix CPU miner benchmarking within benchmark-intense mode
+- benchmark: Detect duplicate shares within 5 minutes
+- benchmark-intense: benchmark_update_interval constant in code
+- benchmark-intense: Detect stale results
+- benchmark-intense: Update work every second
+- benchmark-intense: Simulate 250 KB generation transaction
+- benchmark-intense: Generate individual work items from 2D work (tests host CPU
+rate of work production)
+- Introduce --benchmark-intense option
+- Import libbase58 for base58 encoding/decoding
+- Cleanup libblkmaker bundling code to mostly live in autoconf macros
+- Always check if we should switch pools when enabling one, and always enable
+pools we want to switch to
+
+
+BFGMiner Version 4.7.1 - September 10, 2014
+
+- Bugfix: Reorder LDADD and such for priority
+- Bugfix: bitforce: Initialise variable to NULL
+- Bugfix: SSM: Use client_next member consistently when working with
+stratumsrv_connlist
+- Bugfix: SSM: Check that a username is provided to mining.authorize
+- Bugfix: SSM: When n2pad<0, release lock before returning
+- Bugfix: SSM: Make buffers long enough to avoid overflows
+- Bugfix: Need signed types for ntime min/max offsets
+- Bugfix: rockminer: Fix processor disabling
+- rockminer: Limit even unsafe frequencies to 640 MHz, since above that
+overflows frequency bits and triggers fan control
+- tq_pop: Remove abstime argument since nothing used it and it wouldn't work
+anyway (uses CLOCK_REALTIME while we use CLOCK_MONOTONIC[_RAW] when possible)
+- Bugfix: Check last solo generation tx against new template rather than most
+recent
+- README: Explicitly mention automatic solo mining configuration, and stress the
+importance of --coinbase-sig
+- Bugfix: Recheck current_pool after calling pool_died
+- Bugfix: Stable pool recovery: Only care if the pool is enabled
+- README.ASIC: Add a section for Gridseed
+- Bugfix: benchmark: Free json_null() after use
+- Bugfix: minergate: Claim socket before we initialise a cgpu for it
+- Bugfix: avalonmm: Claim device before we initialise a cgpu for it
+- Bugfix: switch_pools: Broadcast lp_cond outside of control_lock to avoid
+deadlocking
+- Protect enabled_pools by a mutex in disable_pool function
+- Combine reject_pool into disable_pool function, and don't allow it to override
+a manual disable
+- Call disable_pool() at the begin of remove_pool() and combine them when
+appears together in the code
+- Bugfix: Always call enable_pool and disable_pool to ensure consistent handling
+of the situations
+- Remove dead CPU mining code to silence warnings
+
+
+BFGMiner Version 4.7.0 - August 17, 2014
+
+- openwrt/multibuild: Avoid copying bitforce-firmware-flash, which is no longer
+included
+- AUTHORS: Simpler design, alphabetise lists
+- Remove obsolete SuSE packaging
+- Bugfix: test_hash: Fix Htarg calculation for exact binary divisions of diff 1
+- Fix target calculation from diff < 1.0 in test_hash()
+- avalonmm: Try to autodetect a sane default voltage and clock from MM version
+- avalonmm: Only poll one module at a time, so they don't try to talk over each
+other
+- avalonmm: Set baud rate for detection
+- Stratum: Ignore response from mining.extranonce.subscribe
+- Stratum: Implement mining.set_extranonce, and advertise support for it to
+pools with a #xnsub flag
+- Stratum: Keep nonce1 and n2size in a "staging" state until mining.notify is
+received
+- Stratum: Avoid putting new targets on pool stratum_work until mining.notify is
+received for it
+- minergate: Flush during init
+- minergate: Flush ready-to-queue list
+- minergate: Avoid preparing new jobs to queue while we are pending a flush,
+since the flush would occur after queuing the new jobs
+- minergate: Check for reused job ids
+- minergate: Avoid counting flushed jobs toward hashes done
+- minergate: Report all temperatures individually to RPC
+- minergate: Load temperatures from stats file
+- minergate: Implement hashmeter
+- minergate: Scale nonce difficulty up to pdiff 32
+- minergate: Implement mining
+- minergate: Support for detecting a SP10
+- Bugfix: configure: avalonmm needs work2d
+- Bugfix: bitforce: Remove sanity check triggered by race conditions on 65nm
+devices
+- Bugfix: bitforce: Avoid double-free of voltage data
+
+
+BFGMiner Version 4.6.0 - August 2, 2014
+
+- avalonmm: Even if no fans report speed, display set %
+- Bugfix: avalonmm: Fix fan speed setting
+- Bugfix: avalonmm: Actually read the result needed to get the correct module id
+- README.ASIC: Document AvalonMM driver usage with Avalon 2/3 rigs
+- Bugfix: Makefile.am: Remove reference to non-existent driver-avalonmm.h
+- avalonmm: Safely handle an improper job id that is within the last 2 sent
+- avalonmm: Include asserted fan speed in RPC
+- avalonmm: Include asserted fan speed in ManageTUI
+- avalonmm: Silence warning about detect ack at runtime
+- avalonmm: Make fan speed an option (both RPC and TUI)
+- avalonmm: Allow changing clock speed and voltage from Manage TUI
+- Bugfix: avalonmm: Show proper units for fans & voltage
+- avalonmm: Support for disabling the entire chain
+- Implement broad_udevrules for avalonmm
+- avalonmm: Show extranonce1, module id, temperatures, fans, clock, and voltage
+in Manage TUI
+- avalonmm: Include Module Id and ExtraNonce1 in RPC devdetails
+- avalonmm: Add Temperature0/1 and Fan Percent 0/1 to RPC
+- avalonmm: Add Frequency and Voltage to RPC
+- avalonmm: Add voltage setting (defaults to 0.6625 V)
+- avalonmm: Add clock setting and try to autodetect it if not provided
+- avalonmm: Implement hashmeter
+- avalonmm: Adjust device target up to pdiff 32 when possible
+- avalonmm: Update job when current pool changes
+- Bugfix: avalonmm: MM flips the xnonce2, so we need to do the same
+- avalonmm: Implement mining logic
+- lowl-spi: Move bit order reverse to bitflip8 function in util
+- avalonmm: Treat multiple chained modules as slaves rather than processors
+- avalonmm: Probing for devices using Avalon Miner Manager (Avalon2/3 rigs)
+- littlefury: Move crc16 logic to util
+- Use BUILT_SOURCES to ensure version.h is always built first
+- configure option --with-udevrules-group to allow customising the group name
+used
+- Bugfix: zero_stats: Only call cgpu function if it exists
+- Remove FPGA-only bitforce-firmware-flash tool (now located at
+https://github.com/luke-jr/bitforce-fpga-firmware-flash )
+
+
+BFGMiner Version 4.5.0 - July 26, 2014
+
+- Bugfix: zeusminer: Fix crash in TUI with newly introduced feature
+- Bugfix: gridseed: Fix crash in TUI with newly introduced feature
+- gridseed: Add the ability to set clock speed via the TUI
+- bitforce: Support for Monarch devices on Windows using new "mswin" lowlevel
+interface to scan for KMDF driver
+- Bugfix: gridseed: Implement a proper scanhash routine for GridSeeds
+- zeusminer: Add the ability to set clock speed via the TUI
+- Bugfix: gridseed: Only set PLL frequency once (not once per processor)
+- Bugfix: zeusminer: Retry detection on failure - ZM fails detection 1 / ~30
+times
+- Bugfix: zeusminer: Enabling the ZeusMiner driver should flag needing lowl-vcom
+- aan: Silence false warnings
+- Include broad udev rules when configured with --enable-broad-udevrules option
+- Bugfix: util: Lower the threshold for considering pool Scrypt diff broken
+- Bugfix: gc3355: Do not send work_id (or anything) in the last 4 bytes of work
+- gridseed: Refactor code to clean up and organize
+- gridseed: Document GridSeed specifics with comments and URLs
+- Copyright cleanups and updates
+- Bugfix: zeusminer: using icarus timing can lead to false positive Idle
+detection
+- zeusminer: Return the Chip # via the RPC API call procdetails
+- zeusminer: Display the Chip # in the UI when viewing per-proc details
+- Bugfix: miner: Check work->blk.nonce to see if work should be abandoned
+- rockminer: Allow setting clock 300-2560 as long as prefixed by "unsafe:"
+- util: Work around broken Scrypt pools automatically using realistic pdiff
+assumptions
+- scanhash: Document scanhash related methods with comments
+- Bugfix: gridseed: Report communication errors using dev_error()
+- gc3355: Return bytes read to distinguish 0 bytes from error
+- Bugfix: gridseed: Add delay between Scrypt reset and sending work
+- gridseed: Bugfix: fix the constant used for estimated hash rates
+- klondike: zero_stats support
+- bitforce: zero_stats support (Temperature, Voltage, and Avg Wait)
+- avalon: zero_stats support (temp_max, no_matching_work, match_work_count%d)
+- Add driver interface for zero_stats function
+- Bugfix: bitforce: Short-circuit bitforce_read(0) to avoid lowlif issues
+- Bugfix: bitforce: Ensure data for the current command is always read (and only
+once), with lowl-pci
+- Bugfix: setup-vfio: Add device ids to vfio-pci even if they didn't have a
+driver previously
+- Bugfix: lowl-pci: Use volatile qualifier for PCI mmaps
+- Bugfix: bitforce: Use lowlevel interface device was probed with, for actual
+mining
+- setup-vfio: New shell script to automatically configure VFIO
+- README.ASIC: Monarch: Need to do new_id for every affected device, and only
+after unbinding them
+- README.ASIC: Monarch: Use shell variables for commands
+- gridseed: Bugfix: Revert earlier changes to scanhash based on feedback
+- hashfast: Support for changing clock at runtime
+- hashfast: Store a copy of what we believe to be the chip configuration data
+- hashfast: Store firmware revision
+- util: pk_uNle macro for changing a number inside a packed structure
+- README.ASIC: KnCMiner: Talk about additional i2c-tools dependency
+- README.ASIC: KnCMiner: Remove mention of now-obsolete Bertmod
+- README.ASIC: KnCMiner: Grammatical corrections
+- Bugfix: RPC: Avoid processor-specific details in devdetails
+- gridseed: Bugfix: log invalid detect responses as debug info, not an error
+- zeusminer: Support setting clock via RPC API procset call
+- README: Add Controla and Minera controller software links & info
+- gridseed: Bugfix: Fix hash-rate calculation when no nonces are being found
+- dualminer: Bugfix: assign the proper value for work_division
+- gridseed: Refactor to clarify GridSeed terminology
+- gridseed: Add support for displaying per-chip statistics
+- gridseed: Convert to use newer set_device_funcs interface
+- Bugfix: gridseed: Don't leak cgpu_info when devices are already claimed
+- icarus: Processor detail support
+- DevAPI: Allow using device_proc_by_id with const struct cgpu_info
+- icarus: Ensure fpga_count is finalised before add_cgpu is called
+- icarus: Move work_division autodetection code into new
+icarus_probe_work_division function
+- icarus: Remove ability to change fpga_count at runtime
+- Bugfix: gen-version.sh: Replace bashism ("here string")
+- gridseed: Support devices with more than 255 physical processors
+- Use `git describe` to generate version.h to avoid user confusion over builds
+from git
+- zeusminer: Support devices with more than 255 physical processors
+- hashfast: Include chip/core address in RPC procdetails
+- gridseed: Reduce traffic sending work to GridSeed devices
+- gridseed: Bugfix: previous refactor (unpublished) changed logic
+- gc3355: Refactor to remove SHA2 code specific to the 5-Chip GridSeed Orb
+- lowl-vcom: Bugfix: do not attempt to open the USB devices when enumerating
+
+
+BFGMiner Version 4.4.0 - July 7, 2014
+
+- Update official Windows build compiler from GCC 4.7.3 to 4.7.4
+- lowl-vcom: Added support for auto scanning (-S auto) on Mac OS X
+- rockminer: implement --device-protocol-dump for debugging
+- README: Update for commandline options
+- README: Update configure options
+- Bugfix: bfg_gpio_setpin_output: Clear alt-function bits via INP_GPIO macro
+- jingtian: Explicitly configure SPI device while opening
+- jingtian: Toggle ASIC reset GPIO at startup
+- aan: Set defaults as soon as a proc is initialised
+- aan: Allow specifying clock as xHEXX for a raw PLL register config
+- aan: Include current frequency in RPC status
+- aan: Implement --set jtn:clock=MHz
+- aan: Logic to calculate PLL configurations for a given frequency
+- jingtian: Use SPI enable GPIO to disconnect SPI during chipselect changes
+- aan: Set PLL to 850 MHz
+- aan: Simplify register buffer
+- jingtian: Decode extra temperature bytes in read_reg
+- aan: Add a read_reg hook
+- aan: Enable configuring nonce diff with (eg) --set jtn:diff=32
+- aan: Properly handle nonce_diff
+- aan: Implement mining
+- DevAPI: Some designs set the main thr tv_poll from secondary thrs, so check it
+after the loop
+- aan: aan_spi_parse_rx implies spi_clear_buf
+- jingtian: Do detection asynchronously across all possible chipselects so they
+complete in parallel
+- aan: Refactor aan_spi_cmd a bit
+- jingtian: Implement device protocol dump
+- jingtian: Detection-only code for new driver
+- lowl-spi: GPIO access functions
+- lowl-spi: Move knc_spi_txrx to linux_spi_txrx
+- SGW: Support for proxy-share difficulty preferences
+- SSM: Propagate proxy-share difficulty changes to established connections
+- SSM: Track stratum connections for each proxy user
+- SSM: Track authorised users for each connection
+- SSM: Initialise proxyshare difficulty from --set pxy:diff=N
+- proxy: Accept --set pxy:diff=N to set preferred proxyshare difficulty
+- proxy: Provide a place to store desired proxyshare difficulty on a
+per-username basis, and copy it to SSM connections when authorising them
+- SSM: Track proxy share difficulties
+- Expose target_diff function and add pdiff_to_bdiff macro
+- util: double_find_precision function to identify ideal precision for a fp
+number
+- work2d: Expose WORK2D_MAX_DIVISIONS in header
+- add_local_gbt: Avoid adding servers already configured
+- Bugfix: Avoid writing automatically configured local GBT servers to the config
+file unless they have been manually enabled
+- add_local_gbt: Use rpcconnect when configured
+- rockminer: Bugfix: must specify a baud rate (maximum of 115200) to get a read
+response
+- Bugfix: Use atexit() to ensure a final \n is always printed at exit to work
+cleanly with new logging design
+- Restore compatibility with old versions of libblkmaker
+- Bugfix: probe for ZeusMiner before probing for DualMiner
+- Wait until coinbase-addr is needed again, before updating it following a block
+change (always using getaccountaddress)
+- Don't automatically use #getcbaddr for local bitcoind if the user provided
+their own
+- Bugfix: refresh_bitcoind_address: Check for NULL json (which is not JSON
+"null")
+- Bugfix: add_pool: If no current pool set, initialise it (otherwise pool
+testing may start a longpoll thread which tries to access currentpool
+uninitialised)
+- devpath_to_devid: *nix: Reject anything that doesn't begin with a /
+
+
+BFGMiner Version 4.3.0 - June 30, 2014
+
+- Bugfix: zeusminer: Include config.h
+- openwrt: Disable libusb via --without-libusb
+- Avoid waiting for local bitcoind test if we have other pools defined already
+- lowl-pci: Silence warning on big endian
+- bitfury: Portability fixes, including big endian compatibility
+- Bugfix: bifury: strtoll already implies native endian, no need to flip it
+again
+- bitforce: Additional sanity checks, including ensuring our final queued count
+matches that seen by the device
+- bitforce: Go back to ignoring race-triggered sanity check warnings for ZqX
+- bitforce: Refactor FLB and queue flush sanity checks
+- bitforce: Use binary FLB protocol for Monarch
+- bitforce: Add bitforce_read function to deal with binary responses
+- bitforce: Support for queue id based jobs
+- Make work->device_id unsigned
+- bitforce: Support device explicit "Scan Interval" to override hardcoded sleep
+times
+- bitforce: Allow queued_max to exceed BITFORCE_MAX_QUEUED_MAX iff the firmware
+provides an explicit Queue Depth
+- bitforce: Fix bitforce_chips_to_plan_for to work beyond 32 chips
+- configure: Clean up zeusminer logic
+- icarus: Use estimated hashes for hw errors (more accurate hashrate for devices
+where hw error values vary significantly from hashes performed)
+- zeusminer: Bugfix: calculate work_division based on chips and cores
+- Replace swabn with bswap_32mult (matching swap32yes parameters and
+performance)
+- Bugfix: zeusminer: Correctly encode job header regardless of native endian
+- zeusminer: support added for ZeusMiner scrypt ASICs
+- icarus: refactoring: commenting ICARUS_INFO members
+- icarus: Accept any power of two as a valid work_division
+- icarus: option added for Icarus-based drivers to ignore the golden nonce
+during probe
+- util: is_power_of_two function
+- Bugfix: Display proper statline R and HW error percents for values < 1
+- openwrt: Provide scrypt option
+- Benchmark: Debuglog headers generated
+- Bugfix: cpu: Fix scrypt CPU miner
+- Bugfix: scrypt: Fix scrypt hash postprocessing for big endian
+- Bugfix: scrypt: Correct endian handling in PBKDF2_SHA256_80_128
+- scrypt: Add unit test for scrypt_1024_1_1_256_sp
+- scrypt: Add unit tests for PBKDF2_SHA256_80_128 and salsa20_8
+- Bugfix: Copy ALL the data with swap32to<native>
+- Automatically add pool configured from bitcoin.conf for failover only
+- Add failover_only pool flag, to avoid using it regardless of strategy
+- Accept --default-config option to search and load default configuration files,
+even if user is specifying their own
+- Use appdata_file_call to find BFGMiner config file(s)
+- util: appdata_file_call and appdata_file_find_first functions
+- ccan: Update to latest version (which includes floatval option support)
+- Bugfix: Adapt quit function to new logging design
+- Workaround GCC 4.6 initialisation bugs with BYTES_INIT
+- Bugfix: Use int rather than ssize_t to type-match %d expectation
+- Minor refactor of text-only mode: avoid wasting bottom line of console, and
+save status lines as they are replaced by log items
+- Bugfix: Wake up wait_lpcurrent if its conditions for returning may have
+changed
+- Defer determining --quit-summary default until it is needed, so hotplugged
+devices affect it
+- Bugfix: In benchmark mode, only remove the new pools after putting them in the
+array, since the removal will try to remove it from the array
+- Bugfix: Initialise struct pool in add_pool rather than halfway through startup
+- URI parameter #getcbaddr to request coinbase address from bitcoind or
+compatible servers
+- pool_set_uri function
+- util: bytes_eq and bytes_assimilate
+- Replace struct _cbscript_t with bytes_t for simplicity
+- Bugfix: Parse userpass option with strchr rather than strtok to avoid
+usernameless passwords getting into the username field and being displayed
+- Bugfix: Free old coinbase script before setting a new one
+- util: upper_power_of_two_u32 function
+- Avoid unnecessarily finding drivers in a loop
+- lowl-pci: Never probe via -S *:all
+- configure: Succeed even if the libblkmaker submodule is missing (only
+--with-system-libblkmaker)
+- rockminer: Reset task timeout when queuing work
+- rockminer: When we detect a task failure, check if we ought to grab a new work
+rather than resend
+- rockminer: Add a time limit before resending work even outside of midtask
+state
+- Bugfix: rockminer: Keep count of requested jobs properly
+- make-release: Include ccan LICENSE symlinks as symlinks even in ZIP
+- make-release: Ensure ccan licenses get included in source
+- Bugfix: make-release: Correctly avoid unused parts of ccan
+- make-release: Do builds with the official source release, to test that it
+works
+- Bugfix: DevAPI: Make for_each_logical_proc work correctly
+- Avoid double hashing of shares
+- Create work_hash function to abstractly produce work->hash from work->data
+regardless of algorithm used
+
+
+BFGMiner Version 4.2.0 - June 11, 2014
+
+- Upgraded Windows libmicrohttpd from 0.9.35 to 0.9.38_pre33603
+- SGW: Workaround BE Cube bugs with new libmicrohttpd by forcing HTTP 1.0
+response
+- rockminer: Increase hw error count for problems
+- rockminer: Autodetect with "R-BOX miner" or "RX-BOX miner" product strings
+- rockminer: Support for seeing and setting clock frequency in Manage TUI
+- rockminer: Include clock frequency in RPC processor status
+- rockminer: Support for setting clock frequency
+- rockminer: Workaround lost tasks by resending them
+- rockminer: Support for temperature sensors
+- rockminer: Debug messages
+- Bugfix: rockminer: Initialise rockminer_chip_data
+- Bugfix: rockminer: Ensure work actually exists before testing against it
+- rockminer: Mine at 270 MHz
+- rockminer: Implement mining (at 200 MHz)
+- DevAPI: Move device_proc_by_id out of bifury driver, since it is generically
+useful
+- rockminer: Detection code for new driver
+- bfg_socket wrapper to ensure sockets are close-on-exec
+- set_cloexec_socket: Explicitly cast SOCKET to HANDLE
+
+
+BFGMiner Version 4.1.0 - June 6, 2014
+
+- Bugfix: Ensure variables are declared even without ADL support
+- RPC: Include a list of config files loaded in "config" reply
+- Bugfix: Save a linked list of config files loaded so output makes sense
+(previously only the most recent config file was named, and errors were reported
+inconsistently)
+- README.RPC: Document Coinbase-Sig in config reply
+- Bugfix: Safely handle pool status line when no pools are alive
+- bitforce: Refactor bitforce_vcom_gets slightly to be more sane
+- Bugfix: initiate_stratum: Ensure extranonce2 size is not negative (which could
+lead to exploits later as too little memory gets allocated)
+- Stratum: extract_sockaddr: Truncate overlong addresses rather than stack
+overflow
+- Stratum: tlsca parameter to require CA validation of TLS certificate
+- Bugfix: Avoid setting tv_idle before testing pool (it will be set if the test
+fails)
+- restart_stratum: Make use of return_via
+- return_via helper function family to assign a variable and goto
+- Bugfix: restart_stratum: Release pool_test_lock on failure
+- bfsb: Disable all banks before enabling the one we want, to avoid having two
+enabled at the same time (eg, when switching from bank 3 to bank 2)
+- Interpret present "tls" parameter to require TLS
+- uri_get_param_bool2 returning a tristate
+- Tests for uri_find_param
+- Split uri_find_param out of uri_get_param_bool
+- gridseed: Allow specifying an arbitrary number of chips with --set gsd:chips=X
+- gridseed: added support for the 80-chip (two blades of 40 chips) G-Blade
+Scrypt-only miner
+- Bugfix: gridseed: use a signed integer so that returning -1 has defined
+behavior
+- RPC: Return integer difficulties without decimal places
+- Bugfix: Zero pool "Works"
+- Bugfix: Set any listening sockets to close-on-exec/non-inheritable to avoid
+issues rebinding them on restart
+- RPC: Explicitly shutdown communication on client sockets to avoid them being
+held open by forked processes
+- RPC: Clean up mcast socket with tidyup_socket
+- RPC: Move socket tidyup code to its own function
+- Bugfix: RPC: Use pthread_exit rather than returning from the RPC thread, to
+ensure tidyup gets called
+- Bugfix: bitforce: During initialisation, clear each XLink slave exactly once
+only
+
+
+BFGMiner Version 4.0.0 - May 26, 2014
+
+- Update openwrt Makefile for xz source
+- Update libblkmaker to 0.4.0
+- Workaround Homebrew-induced segfault during device scan
+- Allow hotplug with scrypt
+- Bugfix: test_domain_funcs: printf precisions must be int, not size_t
+- littlefury: Cleanup to make avoiding memory leak easier
+- Bugfix: Avoid using an enum type to hold a bitfield
+- ruby extension is "rb" not "py"
+- README.RPC: Document api-example.rb
+- Add Ruby Api Example
+- hashfast: Check devices with Product matching "GoldenNonce" so we have a
+vendor-neutral way to detect them
+- Reduce set_device-not-implemented message to debug log level, since it can
+occur for init-only settings
+- Use a mutex to block pool_active on a common check per pool at any given time
+- Use cURL return code to check if cURL sockets hit CURLE_AGAIN
+- Abstract pool_recently_got_work into a dedicated function
+- AUTHORS: Dmitry Smirnov contributes BFGMiner packaging to Debian
+- README: Talk about more GUIs and mining OSs
+- icarus: Minor optimisation (swap byte order in 32-bit always-aligned groups,
+and skip pointless memory copy)
+- icarus: Initialise ob_bin to avoid leaking other memory to device
+- Bugfix: bitfury: Set stat_elapsed_secs early, just in case we jump with goto
+- Bugfix: Report actual kernel name in RPC, rather than kernel interface name
+- README.scrypt: Document psw kernel
+- opencl: Another optimised scrypt kernel ("psw")
+- README.scrypt: Document zuikkis kernel
+- opencl: Optimised scrypt kernel ("zuikkis")
+- Bugfix: Silence harmless warnings
+- Bugfix: vcom_set_timeout: Return whether successful
+- bitforce: Set name for ASIC devices
+- Bugfix: Avoid unnecessary rescans due to wrong devtype
+- bitforce: Support 28nm ChannelNN format for ZCX
+- Bugfix: bitforce: Don't confuse channels with X-Link
+- Bugfix: bitforce: Set VCOM timeout to 1 second for ZGX request, since it
+sometimes lacks a newline
+- lowl-vcom: vcom_set_timeout function
+- bitfury: Eventually (after 30 seconds) give up trying to detect chip
+generation and just assume gen1
+- bitfury: Use other nonces for gen1 detection so one bad core can't break it
+- Bugfix: bitfury: Account for necessary nonce fudging during chipgen detection
+- gridseed: Switch from the Queued miner loop to the Scanhash miner loop
+Improves performance on Raspberry Pi Fixes inaccurate hashrate estimates Fixes
+bug overwriting work inadvertently
+- If the current pool lacks its own block change detection, keep the pool used
+for that connected
+- pool_active_lp_pool function to complement select_longpoll_pool
+- Track which pools have active longpoll connections
+- Avoid retrying longpoll requests for removed pools (and possibly change block
+change notification source for existing ones) if longpoll connection gets
+dropped
+- util: Pass full json_rpc_call_state to upload_data_cb
+- Remove now-unused variable
+- nanofury: Update enable/disable/reinit to cleanly handle multichip devices
+- bifury: Default max_queued to chips * 5 + 6 so it is back up to the original
+16 for bi*fury (which seems to need it sometimes)
+- bifury: Default max_queued to chips * 5 for extra breathing room (avoids
+occasional issues with Hex*Fury)
+- README.ASIC: Document workarounds for OSM/Hex*Fury firmware bugs
+- bifury: Measure hashes done by nonces found since we cannot tell what
+generation chip is in use
+- bifury: Default max_queued to chips * 4
+- bifury: chips init setting to workaround buggy hardware which reports wrong
+chip count
+- bifury: free_after_job setting to workaround buggy hardware which ignores
+maxroll
+- bfg_strtobool helper function
+- bifury: Enable runtime modification of max_queued
+- bifury: Migrate to set_device_funcs interface
+- Stratum: Accept a "notls" parameter on pool URIs to disable opportunistic TLS
+- uri_get_param_bool helper function for pool parameters
+- nanofury: Only ramp up osc6_bits on multichip devices
+- Bugfix: nanofury: Move the bitfury pointer back to the last element before
+starting the ramp up loop
+- Bugfix: Use pdiff 1/0x10000 for scrypt benchmarking
+- benchmark: Use sane bits (of a very high difficulty to avoid triggering
+anti-reorg protections)
+- Ignore work difficulty minisculely harder (ie, rounding error) than what
+device supports
+- Benchmark: Add 2D work support
+- SSM: Use a lower share difficulty in scrypt mode
+- Rework test_nonce to share common logic for scrypt and SHA256d
+- work2d: Accept nonce difficulty with submissions
+- configure: Make work2d building abstract from libevent
+- work2d: Standardised way to pad extranonce beyond what work2d manages
+- Abstract code from stratumsrv_mining_submit into new work2d_submit_nonce
+function
+- Avoid handling hex encoding in work2d
+- Move/rename _ssm_gen_dummy_work to work2d_gen_dummy_work
+- SSM: Refactor _ssm_gen_dummy_work to work with struct stratum_work instead of
+struct stratumsrv_job
+- Move "nonce1" session id from struct pool to struct stratum_work
+- Add pool and work_restart_id to struct stratum_work so they can be used
+independently of struct pool
+- Move n2size from struct pool to struct stratum_work
+- autogen.sh: Automate cleaning INSTALL out of libblkmaker so git updates
+properly
+- Update libblkmaker to 0.4.0
+- Replace drv_rolllimit with struct ntime_roll_limits
+- util: Unpack and pack utility functions ([u]pk_u{8,16,32}{le,be})
+- GBT: Do not allow drivers to roll ntime
+- GBT: Use libblkmaker 2D work to service SSM and potentially other 2D work
+drivers
+- Hide blktemplate_t behind bfg_tmpl_ref to abstract reference counter
+- Add pool_has_usable_swork function
+- SSM: Split stratum work division into 2D work manager ("work2d")
+- bitforce: Avoid crashing when broken devices report more jobs flushed than
+they had to flush
+- nanofury: Gradually ramp up osc6_bits for NF6 design
+- util: memrchr is not portable (GNU extension), so implement our own my_memrchr
+- bitfury: Report correct hashrate for gen2 chips
+- bitfury: Detect gen2 chips
+- Stratum: If difficulty calculates out to 0.999 to 1, round it up to 1 to avoid
+something SHA2 hardware cannot handle
+- Stratum: If the pool target has changed since the job a work came from, check
+any shares against the new target too in case it expects retroactive difficulty
+adjustments
+- Stratum: Interpret integer difficulty values as pdiff (or Ldiff, for scrypt)
+to avoid losing shares on non-compliant servers
+- Rework difficulty-to-target functions to error on the safe side, and
+consistently work in pdiff or bdiff
+- Simplify stratum to convert difficulty to target immediately
+- Stratum: Attempt connection with unauthenticated TLS, with failover to raw TCP
+- Stratum: Return to curl_easy_{send,recv}
+- get_registered_domain: Return full IP for raw IP addresses, so they can at
+least redirect to the same IP
+- Reject redirection across different registered domain names (can be disabled
+by appending #redirect to pool URI)
+- util: match_domains function
+- util: Add isCalpha, get_registered_domain, and extract_domain functions
+- README: Update for gridseed 5-chip orb
+- configure: Clean up gridseed logic to only build by default when scrypt is
+enabled
+- gridseed: Fix warnings
+- gridseed: Added support for Scrypt hashing with 5-chip GridSeed devices
+- dualminer: Only one debug message needed for all init options
+- dualminer: Move opt_dual_mode to dualminer file
+- gc3355: move scrypt_only_reset_cmd out of scrypt_only_reset
+- dualminer: No need to reconfigure frequency every work
+- dualminer: refactor gc3355 code for readability, maintainability and use with
+other devices
+- dualminer: Abstract dualminer_init_hashrate out of dualminer_init_firstrun
+- dualminer: Initialise opt_pll_freq along with opt_sha2_units
+- dualminer: Move opt_sha2_units initialisation to new dualminer_set_defaults
+function
+- dualminer: Remove unnecessary opt_sha2_number
+- dualminer: Simplify teardown
+- dualminer: No need to parse strings for SHA2 unit counts
+- gc3355: Support for appending jobs with task id
+- gc3355: increase delays to 20ms
+- gc3355: use NULL for end-of-command terminator
+- dualminer: comment what various things are for and/or do
+- dualminer: Split gc3355_scrypt_prepare_work and gc3355_sha2_prepare_work out
+of dualminer_job_prepare
+- dualminer: Use cgsleep_ms rather than usleep
+- gc3355: Remove unused opt_hubfans variable
+- dualminer: rename various things to be clearer
+- Use a common enum bfg_gpio_value for both lowl-vcom (cts, dtr, rts) and
+mcp2210
+- README.RPC: Document quit/restart reply format change
+- RPC: Provide a full status section for quit/restart commands
+- RPC: Add "Miner" to version response to include software name along with
+version
+- Bugfix: Dereference udev monitor events when done with them
+- opencl: Workaround false warning regarding Mesa version number parsing
+- knc: use_dcdc setting that Nov batch users can use to disable DCDC usage
+- configure: Include <stddef.h> for _Static_assert check
+- opencl: If kernel does not specify an interface in scrypt mode, assume it's
+the scrypt interface
+- opencl: Replace dated versioning with hash of source code
+- opencl: Search all the same kernel paths when setting kernel
+- opencl: Accept arbitrary kernel filenames, provided they specify a kernel
+interface somewhere in the source file
+- Bugfix: Explicitly pass precision and width as int type
+- Make pool stability message use nicer English
+- Failover pool switching back delay is now configurable.
+- Expand extranonce2 size to 64-bit
+- README.ASIC: KnCMiner: Suggest --disable-other-drivers and remove
+no-optimisation CFLAGS
+- configure: libusb is implied by lowl-usb, so no need to list it as an option
+separately
+- Silence warnings when built without various drivers
+- DevAPI: Remove long deprecated serial_detect function family
+- Bugfix: Turn spidevc into lowl-spi to fix building the knc driver without the
+bitfury driver
+- Avoid triggering unnecessary device rescans (such as with pre-lowlevel
+drivers)
+- Replace --no-client-reconnect with --no-pool-redirect which also disables
+X-Stratum header redirects
+- Partial: A new --no-client-reconnect command that disables the
+'client.reconnect' function.
+- ftdi: Rename files to lowl-ftdi.{c,h} to fit with naming convention
+- bfx: New driver for BFx2 Bitfury USB stick miners
+- ftdi: ft232h_mpsse_readwrite_all function to do both reading and writing
+concurrently in MPSSE mode
+- ftdi: ft232h_mpsse_set_axbus function
+- ftdi: Support for ft232h MPSSE mode (currently only works with
+ft232r_write_all)
+- ftdi: Split most of ft232r_open into a ftdi_common_open function
+- ftdi: Support for --device-protocol-dump
+- ftdi: Scan for ft232h-based devices
+- ftdi: Avoid neutering lowlevel_device_info when opening it
+- ftdi: Accept const data in write functions
+- ftdi: Use actual USB packet size for FTDI status removal
+- ftdi: Make ftdi lowlevel code independent of x6500 driver
+- dualminer: Workaround false compiler warning in gc3355_config_cpm
+- Bugfix: --disable-other-drivers should not force libusb to be unused
+- Bugfix: README: Alphabetise and categorise build configuration options (and
+add missing ones)
+- TUI: Use _wlogprint for pool proto to avoid compiler warning
+- Bugfix: TUI: Fall back to RPC URI if sockaddr_url hasn't been extracted (such
+as benchmark mode)
+- Hide work update messages unless explicitly enabled with hidden
+--verbose-work-updates flag
+- TUI: Redesign pool info line to include share difficulties in multipool modes
+and last explicity work update timestamp
+- nanofury: Abstract both power gpios into a nanofury_power_enable function
+- nanofury: Add NANOFURY_GP_PIN_PWR_EN0 (inverted PWR_EN) - support for power
+management (hardware) optimizations
+- Bugfix: nanofury: Set cgpu_data for all processors (eg, to avoid crashing in
+nanofury_set_ledmode for non-first procs)
+- Bugfix: nanofury: Use correct SPI port for baud setting
+- proxy: "Report in" clients when their info is looked up by username
+- opencl: Replace (and deprecate) --no-opencl-binaries option, with --set
+opencl:binary=no
+- opencl: Reenable OpenCL kernel binaries for Mesa OpenCL >= 10.1
+- gc3355: Replace frequency-setting hex blobs with logic
+- README: Update for DualMiner
+- make-release: Switch to xz for source releases
+- Stratum: If a pool explicitly tells us it doesn't support get_transactions, no
+need to wait for a timeout
+- api - buffer size off by 1 for joined commands
+- miner.php - define a default rigport (that can be changed) and don't require a
+port number in the rigs array
+- miner.php allow links for rig buttons in tables and allow using the 4th IP
+octet if no rig name - default disabled for both
+- Remove wrong goto
+- Remove the unqueued work reference when we discard work from get queued as'
+well.
+- Wake the global work scheduler when we remove a work item from the unqueued
+work pointer.
+- Discard work that is stale in the get_queued() function, returning NULL
+instead.
+- Bugfix: dualminer: Declare support for both SHA256d and scrypt algorithms
+- gc3355: Use lowl-vcom set_serial_dtr function
+- lowl-vcom: Implement set_serial_dtr
+- gc3355: Use lowl-vcom cts/rts functions
+- lowl-vcom: Implement set_serial_rts for Windows
+- lowl-vcom: set_serial_rts should return the new rts value, if anything
+- Rename icarus-common.h to driver-icarus.h
+- icarus: probe_timeout setting to control how long we wait before giving up on
+probes
+- icarus: Defer initial open until init
+- Remove debugging garbage that snuck in
+- configure: New --disable-other-drivers options for users who want to build
+just select drivers
+- Simplify _now_gettimeofday on Windows, working around weird WINE crash
+- cpu: Fix and simplify benchmarking on Windows (removes hidden --bench-algo
+option)
+- Remove old bench_block.h, no longer needed
+- Bugfix: cpu: Adapt benchmarking code to new benchmark work generator
+- Report precise share difficulties below 1
+- Bugfix: lowlevel: Pretend drivers not matching the active algorithm don't
+exist
+- Bugfix: dualminer: Set min_nonce_diff before getting work
+- Bugfix: gc3355: Use correct byte counts for hex2bin
+- configure: Fix up dualminer logic
+- dualminer: Support for mining both Scrypt and SHA2 using DualMiner GC3355
+thumb sticks
+- miner: scan for low level devices even if --scrypt is specified by the user
+(to detect Scrypt ASICs)
+- icarus: output protocol information if the user specifies
+--device-protocol-dump
+- icarus: Support for driver-specified job command lengths
+- icarus: Support for custom driver job start function
+- icarus: Support for custom driver initialisation function
+- icarus: Call icarus_job_prepare via driver job_prepare key so it can be
+overridden
+- icarus: generic support for devices that return little-endian nonces
+- icarus: allow custom probes
+- icarus: expose do_icarus_close
+- RPC: Remove separate CPU and GPU counters from devs Msg
+- RPC: Optimise find_index_by_cgpu
+- Bugfix: RPC: Restore PGA index counting
+- Accept decimal values for --shares, and clarify weighed nature of the value
+- benchmark: Remove all real pools, and prevent adding them
+- benchmark: Fake submission of "shares"
+- benchmark: Roll data before nonce only
+- Bugfix: configure: Report bitforce:pci instead of bitforce:uio
+- bitforce: Workaround broken/old compilers by setting device_fd outside of
+initialisation
+- AUTHORS: Update email for Kano
+- RPC: Add "MHS rolling" key to status mirroring "MHS %ds"
+- minorfix: remove extra semicolon
+- Drillbit: Revert needless commit 270c1d01f, thanks @luke-jr
+- Drillbit: Add upper and lower bounds to "Eight boards have a multiple of 8
+ASICs" check
+- Drillbit: Clarify use of device_data pointer to store capabilities/protocol
+version temporarily
+- Drillbit: Keep reading work for as long as the device returns results.
+- Drillbit: Be strict about not accepting any boards with newer protocol
+versions. Protocol version bumps are non-backwards-compatible.
+- Drillbit: Add support for "protocol version 4", non-device-specific
+configuration packet format
+- README.RPC: Add link to Node.js RPC wrapper
+- opencl: Get temperature and fan speed updates with get_stats interface rather
+than abusing statline override interface
+- Bugfix: Remove devtype variable from driver API
+- opencl: Deprecate --auto-{fan,gpu} and --gpu-dyninterval options
+- opencl: Infer autoengine mode when the clock setting receives a range
+- opencl: Infer autofan mode when the fan setting receives a range
+- Bugfix: opencl: Defer initial intensity assignment until init, so opt_scrypt
+has a chance to be set
+- opencl: Strip leading and trailing spaces from names
+- trimmed_strdup helper function
+- icarus: Replace hard-coded "Icarus" mentions
+- opencl: Deprecate all dedicated commandline options for parameters accessible
+via set_device
+- opencl: Make current intensity, xintensity, and oclthreads available via RPC
+- opencl: Redo Manage TUI detail line to use xintensity when more reasonable
+- opencl: Support for setting oclthreads as intensity=xNNN (for NNN xintensity);
+also allow setting d<whatever> for an initial dynamic intensity
+- opencl: Store oclthreads and only convert to/from intensity numbers when
+dealing with external interfaces
+- RPC: Deprecate all cpu* and gpu* commands, and remove CPU/GPU counts from
+'devs' response
+- RPC: pgarestart command to match {cpu,gpu}restart
+- RPC: Unify common code under get_pga_cgpu function
+- README.RPC: Deprecate gpu{intensity,mem,engine,fan,vddc} now that they can be
+accessed via {pga,proc}set
+- RPC: Consider CPU and OpenCL devices as "PGAs" to begin migration to a simpler
+interface
+- RPC: Turn gpu{intensity,mem,engine,fan,vddc} into wrappers around set_device
+- opencl: Support configuration using set_device interface
+- Bugfix: miner_thread: Don't call cgpu_set_defaults if it has already been
+called
+- Common add_set_device_option for automatically generated --set-device options
+- Bugfix: opencl: Safely handle work->device_data across work copies and cleans
+- set_device: Accept underscores for temp_{cutoff,target}
+- opencl: Allow specifying a comma separated list for --gpu-threads
+- opencl: _SET_INT_LIST2 to set variables not necessarily within
+opencl_device_data
+- hashfast: Enable setting device-wide clock at probe time using USB_INIT
+- Bugfix: hashfast: Use signed type for manipulating raw temperature data, in
+case it is below 0 C
+- hashbusteravalon: Add udev rule
+- klondike: Split up work and submissions among logical processors
+- klondike: Make reply_wait_time a settable variable (configured lower for
+hashbusteravalon)
+- klondike: Explicitly enable slaves as well as the master
+- hashbusteravalon: Klondike-based metadriver
+- klondike: Pre-initialise klninfo separately from probe
+- klondike: Allow setting max_work_count and max_work_time via set_device
+- klondike: Variablise max_work_count and old_work_ms
+- Move all OpenCL-specific data behind device_data pointers, and relocate
+OpenCL-specific code out of miner.c
+- opencl: Macro-ise code for list options
+- Reduce failure applying set-device rules to debug loglevel
+- Add --set as alias for --set-device
+- Bugfix: miner.c: Correct ccan include
+- Bugfix: Correct ccan-upstream directory include
+- Load default config before commandline options, so the latter override the
+former (but prioritise defaultconfig pools last)
+- configure: Check for sys/termios.h used by ccan/opt
+- make-release: Only include specific components of ccan
+- Use git submodule for ccan (moving opt_*_floatval into miner.c)
+- Probe erupter before icarus, since they are far more common now
+- Accept --no-config option to inhibit loading default config file, even without
+specifying another config
+- Bugfix: RPC: Ensure isjoin always gets initialised
+- bitforce: Remove two really-unused variables
+- nanofury: Silence false warning from some compilers about uninitialised
+variable use
+- hashfast: Promote problematic write() replies to warning level
+- hashfast: Log errno on write failures
+- Extend maximum processor count to 17,576 (3 letters)
+- DevAPI: Make processor lettering code more extensible
+- Remove shorthand option for undocumented --bench-algo
+- Remove long-deprecated and non-functional --enable-cpu option
+- Deprecate shorthand options for uncommonly-used --algo, --cpu-threads,
+--expiry, --gpu-threads, --intensity, --kernel-path, --kernel, --scan-time,
+--vectors, and --worksize
+- API-README correct new text format documentation
+- API allow multiple commands/replies in one request
+- Due to work restarts causing ~all processors to request work at once, it is
+always ideal to stage at least mining_threads extra works
+- scrypt: raise the maximum GPU intensity for scrypt mining to 31 - benefits
+shown for AMD R9 290 models
+- Bugfix: bitforce: ZNX/ZWX expect size minus 1
+- Bugfix: bitforce: Start building send_queue command at the real end
+- Bugfix: bitforce: Defer opening until after devdata is initialised (since it
+is now used to track open-ness)
+- Document uio/vfio configure options as --without-* since they are enabled by
+default when available
+- Include list of lowlevels built in configure and --help output
+- lowl-pci: Autodetect build-time support for UIO and/or VFIO during configure
+- README.ASIC: Document how to use Monarch in a PCI-Express arrangement on Linux
+- lowl-pci/vfio: Support pread/pwrite access to bars
+- lowl-pci: Support for vfio
+- Abstract UIO-specific code from bitforce driver into lowl-pci
+- bitforce: Initialise lasttag based on response register
+- bitforce: Tie in UIO with lowl-pci
+- lowl-pci: New lowlevel driver for raw PCI devices
+- util: bfg_slurp_file function to quickly read a file
+- bitforce: Support for PCI interface via UIO
+- bitforce: Hide vcom interfaces behind new struct bitforce_lowl_interface
+- bitforce: Let the lowlevel interface deal only with the actual device
+cgpu_info
+- bitforce: Abstract most of VCOM layer away from driver code
+- bitforce: Avoid checking fd by adding is_open flag
+- bitforce: Replace BF{open,close} with more abstract bitforce_vcom_{open,close}
+- bitforce: Abstract fd access mostly down to BFgets/BFwrite
+- bitforce: Support for 28nm WX single-stage bulkqueue command
+- bitforce: Use enum for style (FPGA vs SC)
+- bitforce: Remove never-used and buggy "work queue" mode
+- Round temperature to an integer in thermal cutoff warning
+- Bugfix: icarus: Initialise read_count and other timing-related variables
+- Change default log interval to 20 seconds
+- hashfast: Bump default thermal cutoff temperature to 100 C
+- Bugfix: DevAPI: Ensure temp-cutoff and temp-target are always supported
+settings
+- Bugfix: Initialise cutoff and target temperatures in allocate_cgpu if not
+initialised by the driver
+- Include temperature in thermal cutoff warning
+- Avoid automatic rescans when hotplug is disabled
+- nanofury: New "ledmode" RPC setting, to control LED behaviour
+- nanofury: Support for changing baud rate
+- nanofury: Detect number of chips, so multiple can be used
+- bitfury: When detecting chips, oscillate slower and tolerate clocks outside of
+a predefined range
+- Default --quit-summary to devs if there are more than 24 processors
+- Control printing of quit device summary with --quit-summary option
+- bitfury: Migrate all drivers to set_device_funcs interface
+- drv_set_defaults: Take devpath and serial params so matching by those can work
+- avalon: Replace avalon-options with set_device_funcs
+- klondike: Replace klondike-options with set_device_funcs
+- Replace temp-cutoff and temp-target parameters with set-device options
+- README.FPGA: Update documentation for Icarus driver
+- icarus: Replace icarus-timing with set_device_funcs (including wrapper for
+single icarus-timing case)
+- icarus: Replace icarus-options with set_device_funcs (including wrapper for
+single icarus-options case)
+- drv_set_defaults2 function to work with set_device_funcs
+- icarus: Clarify user_set flags with an enum
+- icarus: Clarify reopen modes with an enum
+- Accept parameter to set_device "help" as a request for help on a specific
+setting
+- set_device_funcs support for returning messages on success
+- RPC: Support for alternate message strings
+- bitfurce: Use new set_device_funcs interface
+- Refactor set_device interface to use option arrays
+- configure: Turn _Static_assert into a noop if the compiler lacks support
+- Store when the last getwork was retrieved and display it in the API summary.
+- bitforce: Consistently use fd -1 when device is not open
+- hashfast: Support for voltage in RPC stats
+- hashfast: Support for voltage displayed in ManageTUI
+- hashfast: Support for temperature
+- Trigger automatic rescans if an expected probe fails (assuming the device just
+needs more time to initialise)
+- Schedule rescan after a 1 second delay, should it be requested twice
+- hotplug: Wait 100ms before rescanning, so plugging in a hub can be handled at
+once and drivers have time to finish initialisation
+- Linux hotplug: Ignore EAGAIN and EINTR from epoll_wait so debugging works
+- Common hotplug_trigger function to use regardless of platform-specific
+implementation
+- Autoscan for new devices on Linux using libudev
+- Autoscan for new devices on Windows when DBT_DEVNODES_CHANGED message is
+broadcast
+- Replace suffix_string with a wrapper around format_unit3
+- Skip lowlevel-based scans in scrypt mode
+- README.GPU: Document new opencl autodetect behaviour
+- opencl: Enable by default in scrypt mode
+
+
+BFGMiner Version 3.10.1 - May 26, 2014
+
+- Upgraded Windows libraries:
+- - libcurl from 7.34.0 to 7.37.0 (and SSL support enabled)
+- - libjansson from 2.4 to 2.6
+- - libmicrohttpd from 0.9.30 to 0.9.35 (now Win64 also)
+- - libusb from libusbx 1.0.17 to 1.0.18
+- DevAPI: for_each_{managed,logical}_proc helper macros
+- Update libblkmaker to 0.3.3
+- make-release: Copy submodules from local system
+- make-release: Automatically determine DLL dependencies to include
+- Bugfix: littlefury: Avoid memory leak for already-claimed devices
+- Bugfix: drillbit: Avoid 9-byte memory leak for already-claimed devices
+- Bugfix: lowl-ftdi: ft232r_close: Free device handle
+- Bugfix: bitfury: Avoid memory leaks when detect fails
+- Bugfix: klondike: Correct case of dname
+- Bugfix: hashfast: Set LIFE_INIT2 so a dead engine doesn't hold up the stats
+line
+- Bugfix: bitforce: Restore device name loading for FPGA Singles
+- Bugfix: Add config.h include to files missing it
+- Bugfix: swap32to?e: Ensure conditionals always have the same type
+- Bugfix: Protect prev_cancelstate variables under console lock
+- opencl: Silence warning about duplicate const qualifier
+- hashbuster: Avoid signed char problems in return status check
+- Bugfix: bfg_claim_any: Use a mutex to avoid races around device claims
+- SSM: Silence JSON parse error message for HTTP POST and TLS attempts
+- bifury: Defer precision loss until after checking osc6_bits value
+- opencl: bfg_clBuildProgram function to share common error handling (logging)
+code
+- opencl: Avoid printing empty build logs
+- Bugfix: opencl: Free allocated memory when done with it
+- Bugfix: Stratum: Use an error buffer on struct pool rather than the stack, so
+it remains valid for the lifetime of the connection
+- Bugfix: Reset tv_idle on pools after test failure
+- Bugfix: Ignore last work time if pool is known to be down
+- pick_unit: Avoid infinite loop when passed inf float
+- Bugfix: bitfury: Correct comment about how much of the nonce range chips
+process
+- Bugfix: Initialise getq (and stgd_lock) earlier so it is ready in case startup
+interactive pool-add tries to stage work
+- bitfury: Wait for two low frequency measurements before acting on a freq drop
+(in case of a single misread)
+- Bugfix: SSM: decref parsed JSON when done with it
+- knc: Replace numeric constants with KNC_CORES_PER_DIE, KNC_DIE_PER_CHIP, and
+KNC_CORES_PER_CHIP defines
+- Bugfix: knc: Actually skip over extra processors rather than infinite loop
+- Bugfix: Use rlim_t type for old_soft_limit so comparison with RLIM_INFINITY is
+correct on all platforms
+- Update alloca logic to work on more platforms
+- start-bfgminer.sh: Shell script to (re)start bfgminer in a background screen
+session
+- Bugfix: Handle disabled CPU support properly in various places
+- Bugfix: README.ASIC: KnCMiner: Use supported Angstrom feeds only
+- Bugfix: pool_active: Skip testing explicitly when we have a recent answer
+- RPC: Use struct timeval for mcast bind timer
+- Bugfix: Restore 2-minutes-past-last-work wait before terminating unused
+stratum connections
+- Partial: Bugfix: Turn spidevc into lowl-spi to fix building the knc driver
+without the bitfury driver
+- SSM: Silence JSON parse error message for HTTP attempts
+- Bugfix: Use UTF-8 for micro prefix internally (and in logging)
+- Consistently allocate space used for formatting numbers
+- util: utf8_len and utf8_strlen functions to quickly measure a character or
+string
+- Bugfix: README: Add missing driver build configuration options
+- Bugfix: renumber_cgpu: No need to copy dev_repr over itself (and trying to is
+undefined)
+- Move OpenCL kernel FAQ to README.GPU and clarify it a bit
+- Bugfix: Log work updates for all active pools in multipool mode
+- test_work_current: Cleanup
+- Bugfix: Differentiate pool_actively_desired from pool_actively_in_use for
+cnx_needed
+- Abstract pool_actively_in_use to handle multipool checking for multiple uses
+- Bugfix: antminer: Fix typo
+- Bugfix: renumber_cgpu: Rebuild repr strings to match new information
+- Bugfix: Skip final pool_active check in balancing modes (where pools switch
+around often)
+- Bugfix: Adjust quota GCD only after completely adding the pool, otherwise it
+will be ignored by the adjustment
+- Bugfix: opencl: Can only BFI_INT patch if using OpenCL binaries
+- SGW: Support for scrypt
+- README: Document VCOM low_latency flag and latency_timer sysfs attribute,
+which can help run more VCOM-based devices on low-end USB hosts
+- Add USB faqs.
+- Bugfix: Stratum: Wait a bit for a response before assuming the pool is hiding
+block contents
+- README: FAQ about Raspberry Pi issues
+- Check for when errno is set on windows as well as the windows variant for
+errors.
+- Partial: Handle interruptions to various select calls in util.c
+- Bugfix: configure: Only fail due to not having libusb, if the user really
+needs or wants libusb
+- Bugfix: Update help display to replace (U)tility with (I)ncome
+- Bugfix: Deduplicate % symbols in help display
+- Bugfix: Correct documentation for --shares option
+- cpu/scrypt: Fix last_nonce to be host endian also
+- Bugfix: cpu: Correct results found by scrypt algorithm
+- Bugfix: lowl-vcom: _get_osfhandle failure returns INVALID_HANDLE_VALUE, not
+NULL
+- Bugfix: lowl-vcom: Invalid fd checks should be for -1, not 0
+- Bugfix: SSM: Actually acquire and release extranonce1s
+- Bugfix: C reserves identifiers beginning with an underscore and uppercase
+letter or another underscore
+- Skip trying to submit shares in benchmark mode
+- Rework benchmark mode
+- Bugfix: configure: Only pull in lowl-usb for lowl-vcom if libusb is available
+- Bugfix: hashfast: Ensure size of hex data passed to applog is of type int
+- README.ASIC: Update "SGW" virtual device identifier to current "PXY"
+- Bugfix: klondike: Reenable hw error reporting on nonces found for unknown work
+- Bugfix: Expand deprecated work->subid field to int width, needed by klondike
+driver for tracking work
+- Bugfix: erupter: Sapphire detected as Emerald and Emerald not detected
+- configure: Remove duplicate sys/file.h check
+- Bugfix: httpsrv: Add missing includes for stdarg, stddef, stdio, and stdlib
+- hashbusterusb: Initialise send packets fully to avoid leaking uninitialised
+data to devices
+- Bugfix: Correct typo in --help ("AlgoritHms")
+- Bugfix: twinfury: Avoid crashing when next_work is not populated here
+- Bugfix: hashbusterusb: Close device after failures
+- Bugfix: hashbuster: Close device after failures
+- README: List --quota in options
+- README.ASIC: Update documentation for Avalon
+- Bugfix: Leave thr->*work alone when disabling non-minerloop_async devices
+- udev rules: Set flag so ModemManager ignores devices
+- bifury: Thermal overheat causes restart losing the clock, so resend it while
+temperature is over 80 C
+- bitforce: Explicitly assign indexes for bitforce_proto enum
+- Bugfix: RPC: MSG_PGASETOK does not have a string param
+- littlefury: Close device if there are any communication problems
+- littlefury: Abstract out littlefury_set_power
+- Bugfix: hashfast: Add missing serial_claim
+- Bugfix: drillbit: Add missing serial_claim
+- Bugfix: bifury: Add missing serial_claim
+- Bugfix: littlefury: Add missing serial_claim
+- Bugfix: Allocate all new devices completely, before trying to activate any
+(since the first processor may control the secondary ones)
+- Since scrypt miners tend to work at actual share difficulty, use that for
+diff1 counting
+- Bugfix: diff1 measurements should be increased by nonce difficulty, not share
+difficulty
+- drillbit: strtol into a long int so negative responses properly get an error
+- Rename *nonces variables to *_diff1 to reflect their nature better
+- Refactor diff1 records to properly weigh non-diff1 work
+- AUTHORS: Add Nico Oelgart
+- Fixed multiple XSS injection vectors
+- drillbit: Expand allowed external clock range to 0-65535
+
+
+BFGMiner Version 3.10.0 - January 15, 2014
+
+- Downgrade official Windows build compiler to GCC 4.7.3.
+- Update official Win64 build mingw64-runtime from 3.0.0 to 3.1.0
+- Bugfix: Stratum: Accept JSON Number type for port number
+- Bugfix: proxy: Set start timer when creating new virtual devices
+- antminer: Add support for the Identify function - flashes LED 10 times
+- drillbit: Expand allowed external clock range to 0-255
+- drillbit: Forbid setting external clock usage if not supported by device
+- Check for DBC_TEMP capability before trying to read temperature
+- Bugfix: drillbit: Reduce work message to correct size
+- README: Update documentation for new udev rules and "video" group
+- Bugfix: opencl/adl: Set iSpeedType for get-fanspeed requests, and ensure we
+don't change do something weird with the fan when initially setting user-defined
+speed flag.
+- Bugfix: drillbit: Initialise rv variable
+- Bugfix: Simplify adding "http://" prefix to avoid strncat overflow (length
+excludes null byte)
+- hashfast: Debuglog work flushing
+- hashfast: Implement OP_NONCE search flag
+- hashfast: Log seq numbers for nonces found
+- hashfast: Count hashes done by nonces found, rather than no-pending-work
+(which could be triggered by flushes)
+- hashfast: Just keep a queue of the 32 most recent work items per core
+- hashfast: Convert to minerloop_queue driver model
+- hashfast: Gracefully complain if we are given an unknown chip or core address
+- udev rule for hashfast devices
+- hashfast: New driver using UMS protocol
+- CRC-8-CCITT implementation
+- AUTHORS: Add Lingchao Xu and move nwoolls up to antminer driver (and mention
+TwinFury driver for Andreas)
+- knc: Workaround false compiler warning about "uninitialised" vars
+- Bugfix: drillbit: Access fd after potentially reopening
+- Remove Christmas colouring
+- drillbit: Add udev rule
+- drillbit: Correct configure logic to check for generic bitfury code (needed to
+decode nonces)
+- drillbit: Implement some basic problem recovery
+- drillbit: Support identify command
+- drillbit: Read/write access to clock and voltage configuration from RPC and
+ManageTUI
+- drillbit: Store board configuration
+- drillbit: Read temperature sensor
+- drillbit: Check nonces against prev work
+- drillbit: Implement mining
+- drillbit: Only detection code
+- antminer: Initial support for the Bitmain AntMiner U1 ASIC Includes support
+for identifying the U1 separately from Icarus and Block Erupter Also includes
+overclocking via --set-device antminer:clock=xHEX
+- Extend horizontal lines to full screen width
+- Log devid for USB string request failures
+- Bugfix: segmentation fault if the terminal window is too narrow for the Help
+and Quit items
+- Accept "address" spelled out in --coinbase-addr option
+- Bugfix: document the need to package zlib1.dll in the Windows build
+instructions
+- Bugfix: Stratum: Re-read pool sock var after suspend+restart
+- Silence false uninitialised var use warning and calculate dev_runtime only
+once
+- Bugfix: HID API not properly detected on Mac OS X
+- Adjust device list size as necessary when accessing options
+- Avoid erasing the screen when statusy is not changing
+- Abstract common set_statusy code out of change_logwinsize and check_winsizes
+- TUI: Support pgup/pgdown for scrolling device list by page
+- Bugfix: icarus: quirk_reopen is an int
+- Bugfix: Do not allocate spi_port on the Stack, even to initialize -
+EXC_BAD_ACCESS on OS X
+- get_statline3: Simplify statistics gathering
+- Bugfix: twinfury: Use serial number formatted over USB, so it works with
+--scan
+- twinfury: Only debuglog temperature debugging data when --device-protocol-dump
+is enabled
+- Bugfix: twinfury: Populate temperature info on both processors
+- Option --weighed-stats to display A and R values weighed by difficulty
+- README.GPU: Document always-disabled-by-default for OpenCL driver
+- AUTHORS: Add Nate Woolls
+- Extend menu to full width of window
+- Abstract out spaces-to-eol to bfg_wspctoeol function
+- Elaborate on spi_port+stack problem in comments
+- Bugfix: Do not allocate spi_port on the Stack - EXC_BAD_ACCESS on OS X
+- Bugfix: don't attempt to probe Bluetooth devices when scanning hardware
+- x6500: Allow overriding the maximum frequency used by the dynclock logic Can
+now use e.g. --set-device x6500:maxclock=210 Prevents spending time on
+frequencies that only produce HW errors
+- HACKING: Clearly document that dname must be lowercase and alphabetic
+- bifury: Tolerate corruption in submit message, remapping shares to the first
+processor if chip id is unrecognised
+- bifury: Tolerate corruption in hwerror message
+- bifury: Tolerate corruption in job message, and only count hashes done when
+completing a known job
+- Use a lowercase driver name to fix --scan pattern matching Otherwise the
+following doesn't work: -S noauto -S twinfury:auto
+
+
+BFGMiner Version 3.9.0 - December 25, 2013
+
+- Update official Win32 build compiler and library:
+- - Upgrade GCC from 4.8.1 to 4.8.2
+- - Upgrade libcurl from 7.28.1 to 7.34.0
+- Update official Win64 build compiler and library:
+- - Upgrade GCC from 4.7.3 to 4.8.2
+- - Upgrade mingw64-runtime from 2.0.8 to 3.0.0
+- Green-on-red title colours for Christmas release
+- write_config: Include http-port and stratum-port options
+- Interpret F1 as a request for Help
+- Bugfix: SSM: Free old _ssm_notify before replacing it
+- Bugfix: SSM: Clean _ssm_cur_job_work as needed to avoid memory leaks
+- Support matching --scan with lowlevel devid
+- cgpu_match: Unit test for USB device path matching
+- Bugfix: cgpu_match: Handle digits in dname (x6500)
+- cgpu_match: More unit tests (dname with digit)
+- cgpu_match: More unit tests (dname and case insensitivity)
+- Display "NO DEVICES FOUND" line in place of device list, when there are none
+- bitfury: Use drv_set_defaults to enable setting baud before probe
+- bitfury: Split out SPI port configuration option ("baud") to its own function
+- drv_set_defaults wrapper function around cgpu_set_defaults for use with
+options that may need to be set during probe
+- bitfury: Set poll interval to start iteration before responses are processed
+- modminer: Check identification begins with "ModMiner" to avoid false detection
+- Bugfix: hashbusterusb: Correct return value of hashbusterusb_vrm_unlock
+- Support for installing a udev rules file for Linux
+- twinfury: Remove unused variable to silence warning
+- cgpu_request_control should be a noop when called from the main thread
+- Bugfix: Handle errors creating a vcom devid more gracefully
+- Bugfix: _wlog: Allocate enough space for complete copy of log line
+- bfsb: Remove unused clock_gettime
+- Bugfix: bfsb: Remove useless slot_on which was never properly initialised
+- Bugfix: When QueryDosDevice fails, skip trying to parse its (undefined)
+results
+- hashbusterusb: Voltage should be in volts (not millivolts) for RPC
+- hashbusterusb: Provide access to VRM stuff from RPC
+- hashbusterusb: Use cgpu_request_control interface to safely access device from
+outside main thread
+- hashbusterusb: Include Voltage in RPC stats
+- Bugfix: hashbusterusb: Ensure unlock code is always allocated, even if null
+- hashbusterusb: Abstract code into hashbusterusb_vrm_lock
+- hashbusterusb: Abstract code into hashbusterusb_vrm_unlock
+- hashbusterusb: Abstract code into hashbusterusb_set_voltage
+- Bugfix: hashbusterusb: Check for voltage change error correctly
+- Abstract mutex_request code from X6500 driver into generic device API
+interface
+- hashbusterusb: Use standard identification behaviour
+- hashbusterusb: Abstract hashbusterusb_set_colour function
+- hashbusterusb: Get voltage with temperature
+- hashbusterusb: Clean up unused variable warnings
+- hashbusterusb: Use bitfury_wlogprint_status for osc6_bits displaying in Manage
+TUI
+- Bugfix: hashbusterusb: Remove ignored prompt for VRM lock
+- hashbusterusb: Use Manage/osc6_bits code from main bitfury driver
+- hashbusterusb: Provide access to VRM and identification in Manage TUI
+- hashbusterusb: Shutdown PSU
+- nanofury: Support identify function by turning off LED for 5 seconds
+- nanofury: nanofury_state structure
+- bitfury: Set poll interval to start iteration before responses are processed
+- Twinfury: moved voltage reading to the thread init function
+- Twinfury supply voltage initial reading: error log improved
+- Twinfury: Reading supply voltage on startup
+- Voltage scaling for twinfury implemented
+
+
+BFGMiner Version 3.8.1 - December 9, 2013
+
+- bfgminer-rpc: Catch error when server host fails to resolve to an IP
+- RPC: Remove unnecessary delay from RPC server startup
+- Call WSAStartup for our own needs independently of libcurl etc
+- hashbusterusb: Give more meaningful errors before serial number is known
+- hashbusterusb: Populate device_path with USB devid
+- Rename hashbuster2 to hashbusterusb (only a-z allowed in driver names)
+- Include libusb in options list, since it is no longer tied to specific drivers
+- Make hashbuster serial number output match formatting on physical board
+- Fix for hashbuster first init after power up
+- Workaround Microsoft's non-standard swprintf
+- vcom: Fabricate vcom devinfo for any existing paths specified to --scan, in
+case enumeration fails
+- Bugfix: hashbuster2: Check for errors setting up libusb handle
+- Bugfix: Draw statuswin in line order to ensure overflow is cutoff properly
+- Fixed one byte stack overflow in mcast recvfrom.
+- Bugfix: Let libc do any translation for %lc before adding wide characters to
+curses
+- Specifically handle mining.get_transactions failures so they get logged at the
+lower debug loglevel
+- Bugfix: lowlevel: Use LL_DELETE2 when cleaning up secondary list
+
+
+BFGMiner Version 3.8.0 - December 1, 2013
+
+- Bugfix: lowl-usb.h: Add missing includes for stdbool/stdint
+- hashbuster2: Retry writing request if no response received in 100ms
+- lowl-usb: usb_ep_set_timeouts_ms function that behaves similar to termios
+VTIME (timeout before begin of read/write)
+- hashbuster2: Use new lowl_usb_endpoint for i/o
+- lowl-usb: Add tools for more reliable read/write using bulk transfers
+- Add bytes_extend_buf, bytes_preappend, bytes_postappend for reading direct to
+a bytes_t
+- New / updated instructions for building bfgminer on Windows
+- configure: Adjust header-path discovery to work sanely with spaces and
+backslashes in paths
+- Bugfix: configure: More fixing BSD sed syntax for curses header search
+- bitfury: Reinitialise chips if their frequency drops over 50%
+- bfg_strerror: Trim C whitespace off the right of FormatMessage output, since
+Windows can add \r\n
+- Demote commonish errors to debug loglevel
+- klondike: Add support for Avalon2-based designs
+- klondike: Remove unnecessary limit of 999 on clock speed displayed in Manage
+Device
+- Bugfix: hashbuster2: Claim USB device internally
+- Bugfix: hashbuster2: Do not try to use lowl-hid.h
+- Bugfix: hashbuster2: Close device and free memory allocated, when no chips are
+found
+- Bugfix: hashbuster2: Remove libusb init and debug level setting
+- Bugfix: hashbuster2: Avoid add_cgpu when no chips found
+- Bugfix: klondike: Claim USB device internally
+- Bugfix: devpath_to_devid: Check stat for error before allocating memory
+- Bugfix: lowlevel: Free hash table data when done with it
+- Bugfix: bifury: Free memory used by version reply
+- bfgtls: Implement destructor to free memory when threads exit
+- hashbuster2: Remove unnecessary libusb_detach_kernel_driver
+- hashbuster2: Read unique serial number from device
+- hashbuster2: Use hashbuster2_io for probe
+- hashbuster2: Clean up warnings about unused variables
+- README: Document --enable-opencl configure option
+- README: Update for HashBuster Micro
+- hashbuster2: Integrate into BFGMiner as a separate driver
+- hashbuster2: Import driver for new protocol
+- Bugfix: nanofury: Check if mcp2210_device exists before trying to power it off
+- Bugfix: lowl-vcom: Check for error getting root hub path
+- openwrt: Update package description
+- configure: Add --without-libusb option to explicitly disable using it
+- Bugfix: Pass newlines as ASCII (fixes lack of them in non-unicode builds)
+
+
+BFGMiner Version 3.7.0 - November 27, 2013
+
+- FTDI scan: Use intptr_t to avoid warning about different size type cast
+- Bugfix: proxy: Add missing unistd.h include
+- Bugfix: bifury: Precision specifications should be int, not size_t
+- Bugfix: klondike: Include config.h first
+- Bugfix: binloader: Include config.h first
+- README.ASIC: Include support URI for bi*fury driver and firmware
+- Added MultiMiner as an example of a GUI application that wraps bfgminer using
+the RPC interface
+- Silence non-issue warnings
+- bifury: Add support for hwerror message
+- inc_hw_errors2: Support reporting hw errors without a known nonce
+- bifury: Initialise cutofftemp to 75 C
+- bifury: Turn chips off and on when disabled and enabled
+- bifury: Split out bifury_send_clock
+- Bugfix: bifury: Avoid double-free and double-close on version parse errors
+during probe
+- bifury: Add support for clock command
+- bifury: Update for "job" protocol change
+- bifury: Update to current git
+- bifury: Workaround bugs in older firmware by flooding device with work until
+it proves it has needwork
+- bifury: Attempt to submit shares even if maxroll limit is ignored
+- Clone cgminer's submit_noffset_nonce interface
+- Bugfix: bifury: Check that there is a line before comparing it to "version "
+- bifury: Prune jobs older than 16 queued, to eventually clean up discarded work
+(from flushes)
+- Replace ucs2tochar* with ucs2_to_utf8* to handle Unicode
+- README.ASIC: Document Bi*Fury firmware upgrade
+- bifury: Free work when we know it's complete
+- bifury: Implement hashrate reporting using "job" messages
+- bifury: Tolerate other data before version reply
+- bifury: Abstract line parsing into bifury_readln function
+- Bugfix: bifury: Use a char array, rather than pointer to char array, for
+bifury_init_cmds
+- bifury: Unify SEND devprotodump logging code
+- fpgautils: Skip SetCommConfig on Windows if baud is not to be set
+- Check for U+2022 and replace it with "*" is unprintable
+- Use replacement character for non-printable Unicode
+- Use UTF-8 for Unicode
+- Implement a utf8_decode function to produce wchar_t needed by curses
+- bifury: New driver
+- Bugfix: twinfury: Handle flash request for both chips, and avoid using proc
+uninitialised
+- Bugfix: twinfury: Fix various technicalities
+- Bugfix: twinfury: Remove incorrect tcflush
+- Twinfury communication protocol changed to be more robust. A preamble is sent
+before the actual command.
+- LED flashing changed: - setting a flag and flash the LED during the poll
+cycle - mutex removed
+- Renamed bf2 driver -> twinfury driver bin2hex utility used to convert the
+serial number
+- BF2 driver comment edited
+- BF2 - Twin Bitfury USB miner driver added
+- Deprecate --ndevs|-n (redundant with -d? and GPU-only)
+- Never abort startup just because we have no devices (there may be cases this
+is pointless, but at least it's consistent)
+- cgpu_match: Accept ranges for letter processor specification
+- cgpu_match: Accept ranges for numeric elements
+- test_cgpu_match: Test with more than one device/processor
+- configure: Condense configuration options summary a bit
+- configure: Put configuration options summary back after everything completes
+- Workaround bug in MinGW-w64: Check for strtok_r to be defined at compile-time,
+and don't override it unless we really want to override
+- Bugfix: configure: Use new need_lowl_vcom instead of need_fpgautils
+- configure: Explicitly check for sleep
+- Bugfix: Set LIBUSB_LIBS for non-pkgconf non-header-subdir libusb installations
+- Move unused winsock2.h includes to the end of config.h
+- Use lround instead of llround, since it has better compatibility with older
+MingW and Cygwin versions
+- lowl-hid: Save and use hid_enumerate results from library test
+- Silence Windows build warnings
+- mcp2210: Remove cruft leftover from HID code (moved out)
+- lowl-vcom: sysfs scan: Simplify maybe_strdup into _sysfs_do_read
+- lowl-vcom: sysfs scan: Don't bother getting product string until we confirm it
+is in fact a tty device
+- input_pool: Accept a null password
+- Bugfix: Move const data into the scope it needs to be in
+- Bugfix: Restore case insensitivity to --scan driver names
+- Accept "@" separator for serial/path in --scan to match --device and
+--set-device better
+- README: Uppercase the sequence letter when talking about multiple pools
+- README: Mention "make install" and clarify saving settings
+- Bugfix: avalon: Don't "probe" with -S <path/serial>
+- bitforce: Add lowl_* to bitforce_queue so it can be specified by name as a
+driver
+- Bugfix: devpath_to_devid: Be strict about COM port specifications on Windows
+- Bugfix: avalon: Don't "probe" with -S all
+- Bugfix: Only count devices in -d?
+- RPC: {dev,proc}details: Add 'Processors', 'Manufacturer', 'Product',
+'Serial', 'Target Temperature', 'Cutoff Temperature'
+- debian: Need to explicitly add opencl support to build.
+- Correctly document klondike as being enabled by default
+- Simplify logic for README.ASIC and README.FPGA install
+- Split fpgautils into lowl-vcom and binloader, and fix internal build
+dependencies
+- Add README.CPU to "make install" distribution when built with CPU mining
+support
+- line 2913 added urlencode
+- Bugfix: RPC: Release apisock on error in tidyup
+- klondike - dont try to flush if not initialised
+- Rename --scan-serial to --scan
+- Bugfix: Handle invalid driver names cleanly
+- Workaround libcurl bug to properly support HTTP proxies for stratum
+- Bugfix: Write klondike options for klondike-options (not icarus options)
+- README.OpenWrt: Change example repository to "latest", and document
+alternatives
+- mcp2210: Add support for --device-protocol-dump
+- Bugfix: Initialise dynamic osc6_bits variables
+- README: Fixed a few typos here and there and improved wording (Thanks
+miningpenguin!)
+- README: Moved CPU sections to README.CPU and elaborated more on it
+- README*: Grammatical cleanups
+- README.ASIC: More KnCMiner
+- README.ASIC: Add section about KnCMiner
+- Bugfix: opencl: Dynamic mode should disable threads for this device, not just
+N after the first
+- Bugfix: Make curses_input return NULL on a blank line, as most callers expect
+- Duplicate (hidden) --userpass option before --pool-priority so it can be used
+in config files
+- Only probe VCOM devices on bare "all" scan-serial request
+- Provide backports of uthash LL_{PREPEND,FOREACH{,_SAFE}}2 (only added in
+1.9.7, not yet in major distros)
+- Upgrade required uthash version to 1.9.4 for LL_CONCAT
+- README: Update documentation for scan-serial
+- README: Bitstreams no longer included with BFGMiner source
+- README: Remove incomplete and unnecessary list of ASIC/FPGA devices
+- write_config: Add scan-serial and set-device
+- write_config: Update to make JSON Array of named parameters
+- Remove support for comma-separated values in --device, and update
+documentation
+- lowlevel: Collapse multiple lowlevel drivers on the same devid to a secondary
+linked list, and only spawn one thread to probe all lowlevels on a given devid
+- Bugfix: vcom_devinfo_scan: Clean up hashtable when done
+- README: Update cgminer driver FAQ with Windows-specific answer, now that we
+have a workaround for *nix
+- cpu/opencl: Always disable by default; removes deprecated -G option entirely
+- vcom_lowl_probe_wrapper: Attempt to reattach detached USB devices
+- Bugfix: erupter: Prioritise Emerald after Sapphire
+- Bugfix: Allow "drv:auto" to override general "noauto"
+- Bugfix: _probe_device_match: Fix inverted logic
+- Bugfix: Don't try to call lowl_probe for drivers that don't support that
+interface
+- lowl-hid: Use usb devids for libusb-based hidapi devices
+- Replace bfg_claim_hid with lowlevel_claim
+- lowlevel: Generic claim interface for lowlevel info
+- cgpu_match: Compare dev_t under paths
+- Rework -d? output to display more useful information now that device ordering
+is non-deterministic
+- cgpu_match: Add support for matching by serial number or path
+- Unit tests for cgpu_match
+- Rework --device option to accept a pattern and JSON Array in config; removes
+support for processor ranges
+- Remove --remove-disabled option, as it conflicts with hotplug, per-processor
+stuff, etc already
+- Bugfix: Reimplement "noauto" flag
+- Bugfix: Restore "-S foo" without driver name functionality
+- Bugfix: scan-serial: Compare dev_t as well
+- littlefury: Convert to lowl_probe
+- hashbuster: Convert to lowl_probe
+- avalon: Convert to lowl_probe
+- cairnsmore/erupter/icarus: Convert to lowl_probe
+- bigpic: Convert to lowl_probe
+- ztex: Convert to lowl_probe
+- x6500: Convert to lowl_probe
+- nanofury: Convert to lowl_probe
+- modminer: Convert to lowl_probe
+- klondike: Convert to lowl_probe
+- bitforce: Convert to lowl_probe
+- fpgautils: Wrapper to easily adapt an old detectone to new lowl_probe
+- lowlevel: Add match variants of detect functions
+- DevAPI: add_cgpu: Use mutex to ensure thread safety
+- Make detectone_meta_info thread-local
+- New threaded device probe framework
+
+
+BFGMiner Version 3.6.0 - November 12, 2013
+
+- RPC: Bump to 2.2 for Works in POOLS
+- Bugfix: klondike: Don't try to free off the stack
+- configure: Update klondike checks for libusb
+- klondike: Autodetect by VID/PID/Manufacturer, rather than too-short "K16"
+Product search
+- Remove accidentally added ASIC-README
+- klondike: Remove noop identify function
+- klondike: Replace deprecated statline with temperature and ManageTUI stuff
+- --shares should be scaled to diff1 not absolute number of shares
+- More README updates.
+- Minor README updates.
+- sha2 allow external access to some macros and the K array
+- klondike: Fixed a math issue when reporting fan speed on the status line.
+- Add a get and queue helper work function.
+- Reset the work_restart bool after the scanwork loop in case the driver flushes
+work synchronously.
+- Get rid of the stage thread since all work can be asynchronously added now via
+hash_push anyway.
+- Fix for opt_worktime on big endian machines.
+- Do get_work in fill_queue without holding other locks.
+- Make hash_pop signal the work scheduler each time it waits on the conditional
+that it should look for more work.
+- Remove discarded work from quota used.
+- Display works completed in summary and API data.
+- Store how many work items are worked on per pool.
+- Add the ability to add uint8 and uint16 entities to api data.
+- klondike - initialise stat_lock
+- klondike - better to unlock locks than to lock them twice :)
+- Remove roundl check and define
+- 'llround' is more suitable here than 'roundl'
+- klondike - change options to clock and temptarget only
+- klondike - fix another uninit dev warning
+- klondike - downgrade 'late update' but add an idle detect - and correct error
+levels
+- klondike - fix isc uninit warning
+- klondike - drop the device for hotplug if it's unresponsive
+- klondike - single 'shutdown' and ensure it happens
+- klondike remove SCNu8 - unsupported on windows
+- klondike - fix uninitialised dev bug
+- Don't attempt to disable curses or print a summary during an app restart to
+prevent deadlocks.
+- klondike - error condition handling
+- Modify Makefile to only include opencl related code when configured in.
+- Convert opencl to need to be explicitly enabled during build with
+--enable-opencl
+- Implement a cglock_destroy function.
+- Implement a rwlock_destroy function.
+- Implement a mutex_destroy function.
+- Simplify queued hashtable by storing unqueued work separately in a single
+pointer.
+- Add cgminer compatibility macro for ms_tdiff
+- klondike rewrite work control
+- allow __work_complete() access
+- miner.h allow devices to tv_stamp work
+- klondike - can only calculate the nonce difference on or after the 2nd nonce
+- klondike - correct/reverse min/max stats
+- klondike: Remove unnecessary devlock
+- klondike - use a link list queue rather than a circular buffer - and add
+timing stats
+- Klondike - increase circular read buffer size
+- Klondike - extra zero value and range checking in temp conversion
+- klondike - display MHz also
+- klondike correct cvtKlnToC() temperature calculation
+- klondike - correct 1st reply debug based on define
+- klondike - debug dump structured replies
+- klondike - avoid division by zero if maxcount is unexpectedly zero
+- klondike store and report errorcount and noise
+- klondike - fix chipstats api stats buffer overrun with 16 chips
+- klondike add new nonecount only once
+- klondike - report mh/s based on nonces found + put old estimate into API stats
+- klondike use a memcpy
+- klondike fix bracket tabs indenting
+- klondike: Update code to current git
+- Klondike update code to current git
+- Add Klondike to README
+- Add Klondike to README.ASIC
+- Klondike to main directory
+- Klondike consistent code spacing
+- Klondike update driver code to current git
+- klondike: update firmware for 16 chips, add dist files
+- klondike: beta final 0.3.0 release
+- klondike: updated firmware, IOC method
+- klondike: prevent nonces when not state W
+- klondike: added driver config option support
+- klondike: fixes for 300 MHz, fix K1 parts list
+- klondike: update driver, docs
+- klondike: update firmware & utils
+- klondike: updated cgminer driver for 3.3.1
+- klondike: update firmware and driver, create new cgminer fork
+- update klondike driver
+- klondike: add cgminer driver file as-is
+
+
+BFGMiner Version 3.5.2 - November 12, 2013
+
+- README.scrypt: Update to reflect current status of code (unmaintained); remove
+Con's litecoin donation address (leaving his bitcoin one) since it is unknown if
+he still accepts donations with litecoin
+- Bugfix: minerloop_async: Check the correct _mt_disable_called flag
+- bitforce: Allow ZCX response to override Manufacturer string
+- Bugfix: RPC: Restore null termination on responses
+- Bugfix: configure: We need DLOPEN_FLAGS for lowlevel hid too
+- Add additional debug information to help track work through BFGMiner
+- README: Update hidapi dependency for HashBuster
+- Bugfix: bigpic: Convert device serial and nonces to host endian
+- Bugfix: modminer: Ensure devices that fail probe are closed properly
+- Bugfix: bitforce: Ensure devices that fail probe are closed properly
+- Bugfix: littlefury: Ensure devices that fail probe are closed properly
+- Bugfix: bigpic: Ensure devices that fail probe are closed properly
+- nanofury: Attempt to be more resilient to problems
+
+
+BFGMiner Version 3.5.1 - November 7, 2013
+
+- Bugfix: make-release: Add README.GPU document
+- Demote USB string fetch failure to LOG_DEBUG since it is rather common
+- Bugfix: RPC: devscan shouldn't be available to read-only access
+- Bugfix: bigpic: Ignore the bitfury chip's counter as best we can
+- Bugfix: bigpic: Accept other delimiters in Bitfury BF1 product string in
+autodetection
+- Bugfix: Fix VCOM/fpgautils build check
+- Bugfix: Only include VCOM code when VCOM/fpgautils support is being built
+- Bugfix: Reimplement scan-serial "all" keyword
+- Bugfix: bitforce detect: Close device after ZGX failure
+- Bugfix: Define lowl_usb even if libusb support is omitted, since VCOM and HID
+drivers check against it for warnings
+
+
+BFGMiner Version 3.5.0 - November 6, 2013
+
+- bigpic: Probe sooner than most drivers, but still after icarus/erupter
+- cpu/opencl: Fix probe priorities to be last
+- Bugfix: RPC: Correct per-device Work Utility to be per-minute instead of
+per-second
+- Bugfix: Fix Windows VCOM enumeration to work with new lowlevel code
+- Bugfix: nanofury: Use maybe_strdup in case strings may be missing
+- Bugfix: bitfury: Fix processor disable/enable for all bitfury-based devices
+- hashbuster: Get temperature when available
+- Bugfix: hashbuster: Use maybe_strdup where there might not be a string
+- hid: Treat null-length strings as missing entirely
+- hashbuster: Enable dynamic osc6_bits
+- hashbuster: New driver
+- Split a hid lowlevel out of mcp2210
+- ztex: Convert to use lowlevel usb enumerator
+- A quick flag to allow drivers to convey the desire to rescan devices (from
+lowlevel up)
+- Lowlevel USB enumerator for libusb
+- dname for lowlevel drivers
+- Bugfix: lowlevel: Avoid null pointer dereference on devices that are missing
+USB strings
+- lowlevel: Add a userpointer to lowl_found_devinfo_func_t and use it for
+serial_autodetect
+- Rework VCOM autodetection to go through lowlevel interface, avoiding repeat
+USB string fetching
+- lowlevel: Keep track of the claimed devid and debuglog every found device
+- ft232r: devinfo_scan: Don't skip claimed USB devices
+- ft232r: Be more tolerant of USB open failure or missing strings
+- RPC: Build most of CONFIG "Device Code" by iterating over registered driver
+list
+- drv_detect_all: Use priority-sorted list of registered drivers
+- Build hash tables to find drivers by dname or name
+- Build a linked list of registered drivers
+- BFG_REGISTER_DRIVER macro to commonly pre-define device_drv structures
+- Move have_libusb checks out of drv_detect_all
+- Replace opt_nogpu with simple function that adds opencl:noauto to scan-serial
+list
+- opencl: Remove ancient gpu_threads variable, not really needed anymore
+- Bugfix: Stop waiting for pool testing as soon as one is active
+- bitfury: Clean up by making private functions static, and naming public ones
+with [lib]bitfury_ prefix
+- bitfury: Remove old (unused) driver code
+- bitfury_gpio: Convert to using current bitfury driver code
+- Bugfix: littlefury: Upgrade to use current bitfury driver (old one didn't work
+with littlefury anymore anyway)
+- Bugfix: test_work_current: Make hexstr buffer large enough for blkhashstr
+later on (issuing old work msg)
+- README: Document --enable-knc configure option
+- README: Document --disable-nanofury configure option
+- Windows autodetect: clear detectone meta info
+- Check for Windows DDK headers, and where they are (and build without them if
+unavailable)
+- Windows SetupAPI-based detection for USB VCOM devices (tested with CP210x and
+CDC)
+- ucs2tochar{,_dup} functions to convert USB string descriptors to char* format
+- bfg_strerror: Support for Windows system errors
+- Introduce applogfail* macros
+- Bugfix: scrypt: Add missing include stdbool.h
+- Bugfix: Explicitly cast uses of be32toh to uint32_t
+- Bugfix: Add missing includes of config.h, stdbool.h, and stdint.h
+- lowlevel: Convey device manufacturer up to nanofury cgpus
+- nanofury: Store device HID path for RPC
+- lowlevel: Promote path to a normal element for devices to simplify things a
+bit
+- nanofury: Claim mcp2210/hid devices
+- mcp2210: Implement claim on HID paths
+- fpgautils: Use string identifiers for internal hardware claims
+- ztex: Keep interface claimed as a lock
+- Bugfix: mcp2210: Check for NULL hid device strings before trying to convert
+them to ASCII
+- FTDI autodetect: Enable populating USB product and serial number
+- Bugfix: FTDI autodetect: Add missing parameter values and remove unused buffer
+- Bugfix: bigpic: Don't active poll event without a poll function
+
+
+BFGMiner Version 3.4.0 - October 26, 2013
+
+- Bugfix: knc: Use separate DEV_RECOVER_DRV deven when doing automatic core
+disable/re-enable, so user-initiated disables are left alone
+- Document existing enum dev_enable usage
+- Bugfix: knc: Only try to re-enable cores after we've actually asserted them as
+disabled, otherwise we won't actually assert the enable either
+- knc: Automatically disable and re-enable problematic cores
+- AUTHORS: Add Dmitry Sorokin
+- bitfury: Disable dynamic osc6_bits when manually setting a specific value
+- bitfury_do_io: Make use of timer_elapsed
+- bitfury: Only use dynamic osc6_bits with boards that support it explicitly
+(BFSB and Metabank for now)
+- bitfury: More debugging info for dynamic osc6_bits
+- Bugfix: bitfury: Fix tv_stat to persist
+- bitfury: Remove useless debugging
+- bitfury: Simplify dynamic osc6_bits logic such that the range is defined in
+one place
+- bitfury: Remove unused skip_stat
+- Bugfix: bitfury: Stick to tracking best_done per-chip, and never call
+zero_stats (which is for users, not drivers)
+- Bugfix: bitfury: Use proc_repr rather than incorrectly calculated chip_id
+- Bugfix: bitfury: struct bitfury_device is already chip-specific
+- bitfury: dynamic osc_6 bits
+- bitfury: Improve frequency calculation - fixes occasional miscalculations as
+well as makes it safer with multiple devices
+- bitfury: Added frequency calculation
+- tm_i2c: Corrected copyright
+- Allow --set-device opt=val without a device specification to attempt setting
+it on every device
+- Bugfix: knc: Maintain queue_full for all cores, so they continue to queue work
+even if the first is disabled
+- bitfury: Allow setting osc6_bits up to 60
+- Bugfix: Set status to LIFE_DEAD2 when killing threads at shut off, to avoid
+calling driver code
+- Skip "testing stability" message at startup
+- Try switching pools if for some reason we end up with only idle pools and have
+ended up current_pool set to an idle one.
+- Check a pool is stable for >5 mins before switching back to it.
+- ManageTUI: Slash key performs processor selection by search
+- nanofury: Populate dev_product and dev_serial
+- mcp2210: Implement mcp2210_close
+- Bugfix: mcp2210: hid_write needs a report id, especially on Windows
+- mcp2210: Workaround some Windows snprintf not handling wide strings correctly
+by simply copying character-per-character (only works for ASCII data)
+- Bugfix: chroot: Check that chdir succeeds
+- AUTHORS: Add pontus
+- knc: Expose Voltage and DCDC Current to TUI Manage device
+- knc: Expose Voltage and DCDC Current to RPC status
+- knc: Store volt/current on knccore
+- knc: Read voltage/current from DCDCs
+- Bugfix: knc: Fix temperature readout of half-celcius
+- Bugfix: Only define have_libusb if building with libusb support
+- littlefury: Remove unused code
+- bitfury: RPC procset: Ignore extra data (like newline) after numbers
+- Add --set-device option to allow setting default procset commands
+- README: Document hidapi dependency for NanoFury sticks
+- AUTHORS: Include Vladimir Strinski for NanoFury code
+- mcp2210: Set GPIO output mode atomically with their output values
+- nanofury: Power off device when shutting down
+- make-release: Include libhidapi-0.dll
+- mcp2210: Port to Windows
+- configure: Find hidapi.h for mcp2210 using pkg-config
+- bitfury: Provide read/write access to osc6_bits from the Manage TUI
+- nanofury: Reduce oscillator bits to 50 to stay within USB specs
+- bitfury: If multiple integers differ after 4 tries, just go with the first so
+we can start mining
+- nanofury: Implement actual mining code
+- nanofury: Turn off device after checkport
+- nanofury: New driver; detect device
+- mcp2210: Implement protocol required for NanoFury USB sticks
+- mcp2210: Skeleton low-level driver for MCP2210 USB to SPI Master bridge
+- ft232r: Use lowlevel interface for ft232r_open
+- Abstract ft232r scan+probe interface into new generic lowlevel driver
+interface
+- configure: Error if knc driver is requested, but linux/i2c-dev.h is missing or
+not from i2c-tools
+- knc: Attempt to express core enable/disable to controller
+- knc: Put knc_device on every processor device_data
+- Refactor device disable/enable logic so that drv.thread_{disable,enable}
+actually get called
+- Bugfix: knc: Check that device actually has work queued, before trying to find
+the most recent one
+- knc: Read temperature sensors
+- DevAPI: minerloop_queue: Run watchdog in device thread
+- knc: Pass queue flush to device when its most recent job produces stale shares
+- knc: Issue flush command at init
+- Bugfix: knc: Perform le32toh on unknown-work nonces
+- knc: Use independent device_id for works to enforce 15-bit size
+- Bugfix: spi_emit_nop: Correct counter logic
+- knc: Implement mining
+- knc: Use FPGA i2c to identify present ASICs
+- knc: Basic detection of boards on expected i2c buses
+- DevAPI: generic_detect: Just use an enum for flags
+- Use list of drivers/algos/options generated by configure in --help info
+- miner.php correct sort gen field names largest to smallest
+- api ... the code related to device elapsed
+- api add device elapsed since hotplug devices Elapsed is less than cgminer Elapsed
+- RPC: Include more info in per-device/processor status
+- API add 'MHS %ds' to 'summary'
+- Icarus remove unneeded opt_debug tests due to applog being a macro
+- We should only yield once in cg_wunlock
+- Provide a function to downgrade a cglock from a write lock to an intermediate
+variant.
+- Reset quotas on load balance for all pools at the same time to avoid running
+out during selection and unintentionally dropping to fallback.
+- Break out of select pool from a common point for appropriate debug messages
+and to avoid further tests.
+- Find the greatest common denominator in quotas and use the smallest number of
+consecutive work items per pool in quota load balance mode to smooth hashrate
+across pools with large quotas. Give excess quota to priority pool 0 instead of
+pool 0.
+- Add subdir-objects to automake options.
+- Use the --failover-only flag to have special meaning in combination with
+load-balance mode to distribute any unused quota back to pool 0 to maintain
+ratios amongst other pools.
+- Display quota and allow it to be modified via the pool menu.
+- More README about quotas.
+- Document quotas and new load-balance strategy.
+- Add API commands and modify output to support pool quota displaying and
+changing.
+- Change message in status when using a balanced pool strategy to notify if
+there's a stratum pool as well.
+- Add quota support to configuration files.
+- Rotate pools on all failures to set a pool in select_pool.
+- Use quotas for load-balance pool strategy.
+- Provide a mechanism for setting a pool quota to be used by load-balance.
+- Change --socks-proxy option to default to SOCKS5
+- Cope with trailing slashes in stratum urls.
+- Make extract_sockaddr set variables passed to it rather than pool struct
+members.
+- miner.php sort the mcast rigs so they are always in the same relative order
+- miner.php allow sending the muticast message multiple times
+- miner.php mcast ignore duplicate replies
+- miner.php coding warning
+- miner.php disable 'gen' by default
+- miner.php allow formula generation of new fields
+- miner.php add doctype
+- miner.php remove incorrect echo
+- miner.php optional error if not enough mcast rigs are found
+- take_queued_work_bymidstate should use a write lock.
+- API mcast add a description option with miner.php
+- Skip dissecting opt->names in parse_config if it doesn't exist.
+- ICA optional limit timing with short=N or long=N
+- logging - applogsiz() for large messages
+- Provide a funcion that looks up queued work by midstate and then removes it
+from the device hash database.
+- Wait until all pools are done testing before giving up, regardless of how long
+they take to fail
+- AUTHORS: Add Ricardo Iván Vieitez Parra and Paul Wouters
+- Bugfix: Check that setgid succeeds
+- When using --chroot, chdir to the new root
+- Bugfix: Add missing drivers to --help list
+- Bugfix: Zero stats: cgpu->diff_stale
+- fpgautils: serial_close: Explicitly release advisory lock before closing, in
+case fd has been inherited by a process forked by system()
+- Use serial_close to pair with every serial_open
+- Workaround bug in Plibc by resetting locale to "C" at startup
+- Bugfix: bitfury: Check for necessity of linux/i2c.h so build succeeds with
+i2c-tools's userspace linux/i2c-dev.h
+- bitforce: Workaround bugs in current firmware for the Chili
+- Bugfix: DevAPI: Reduce race-collision delay to 1ms so thread_shutdown actually
+gets called before threads are killed forcefully
+- Bugfix: configure: Use AC_SYS_LARGEFILE to ensure nonce/share log files can
+safely grow bigger than 2 GB
+- Bugfix: Correct argument type for --submit-threads option
+- littlefury: Workaround Xcode bug initialising fields in anonymous unions
+- Bugfix: write_config: Make intensity list writing more readable, and avoid
+extraneous argument in dynamic intensity case
+- DevAPI: Trigger mt_disable_start after init, if a device is disabled before
+minerloop starts
+- icarus: Skip sending new work if entering DEV_RECOVER* modes
+- icarus: When disabling, close device fd and stop sending new work
+- RPC: Use get_api_extra_device_status for full-device status, for devices with
+only a single processor
+
+
+BFGMiner Version 3.3.0 - October 11, 2013
+
+- openwrt: Optional libevent support
+- RPC: Add missing drivers to Device Code
+- bigpic_process_results: Cleanup
+- RPC: Use procs count for device summaries, rather than iterating over linked
+list (which may span multiple devices)
+- Bugfix: Use bfg_waddstr for cg_[mv]wprintw so special characters get
+interpreted properly
+- Bugfix: bitfury: Clear force_reinit flag after reinit
+- Bugfix: Use base unit for zero, and only if all values are zero
+- RPC: Always build pga* and proc* methods
+- Bugfix: icarus: Check for valid fd before all usage
+- Bugfix: Stratum initiate: Clear json var after freeing it, to avoid a
+potential double-free if retry fails before new JSON is parsed
+- Bugfix: Correct --log-file error message
+- Cleanly fall back to other micro- prefix symbols if locale doesn't support the
+preferred one(s)
+- Bugfix: bfg_waddstr: Missing break after selecting degrees symbol
+- Silence warning about (never really) uninitalised variable use in notifystatus
+- RPC: Complete split between devs/pga* and proc* methods
+- RPC: Internal restructuring to support device-wide view
+- RPC: Remove devdetail method, and rework newer devdetails to use its code
+- configure: Advise running ldconfig when detected and probably necessary
+- configure: Simplify final information summary
+- Bugfix: configure: Disable httpsrv/libevent if not available
+- README: Mention free GPU mining dependencies
+- Write config: Avoid writing default temperature settings
+- bitforce: Set default cutoff temperature to 85C for SC-class devices
+- When shutting down, don't wait for mining threads any longer after the 1
+second sleep
+- bitfury: Silence warning about (never possible) uninitialised variable use
+- bigpic: Handle write failures
+- json_rpc_call_completed: Silence incorrect type cast warning
+- icarus: Silence warning about (never really) uninitalised variable use in
+icarus_scanhash
+- fpgautils: Check for fgets error
+- Silence warning about (never really) uninitalised variable use in
+multi_format_unit
+- ft232r: Silence warning about (never really) uninitalised variable use
+- Silence unused result warnings for notifier_{read,wake}
+- Log a warning if --cmd-* returns a non-zero exit code
+- configure: Update bigpic driver dependency on bitfury code
+- metabank: Initialise --temp-cutoff to 50C
+- README.ASIC: Document special care needed for some bitfury-based miners
+- Bugfix: bitfury: Correct results from RPC pgaset
+- bitfury: Move Slot and fasync RPC info to details instead of status
+- bitfury: Include chip fasync in RPC status
+- bfsb: Split up processors among a separate device per board
+- Bugfix: bitfury: Copy rxbufs to stack in case we need to do SPI communication
+in the meantime
+- bfsb: Merge bfsb_detect_chips into bfsb_autodetect (unchanged)
+- bfsb/metabank: Allow pgaset to change osc6_bits and SPI baud rate
+- bitfury: Fix code indentation
+- bitfury: bitfury_init_oldbuf: Optimise during runtime
+- metabank: Remove unused variables
+- bitfury: Send a work with lots of nonces to help cold-started bitfurys fill a
+static buffer
+- Bugfix: configure: Show --enable-bfsb/metabank in help, since they are
+disabled by default
+- metabank: Reduce i2c banking to only when necessary
+- bfsb: Only build spi_bfsb_select_bank if bfsb driver is being compiled
+- bitfury: Reorganize polling to hit chips sequentially, so SPI traffic can be
+minimised
+- bitfury: spi_emit_data: Return address read data will be located at after txrx
+- bitfury: After 8 bad nonces in a sample period, reinit immediately rather than
+waiting for the remaining up-to-0x38
+- bitfury: Reinitialise chips if their active nonce stops changing
+- bitfury: Recalibrate immediately when we know we need it
+- bitfury: Reset chips if more than 8 hw errors are found in a 0x40 result
+sample period
+- bitfury: If previous nonce mismatch persists, try recalibrating oldbuf
+- bfsb: Shutdown chip when disabling
+- bfsb: Expose Clock Bits and Slot to RPC
+- configure: Simplify dynclock necessity detection
+- configure: Tie libudev usage to fpgautils
+- configure: Simplify fpgautils necessity detection
+- DevAPI: add_cgpu_slave for more elegant multi-device threads
+- Use procs count for device summaries, rather than iterating over linked list
+(which may span multiple devices)
+- metabank: Split up processors among a separate device per board
+- metabank: Merge metabank_detect_chips into metabank_autodetect (unchanged)
+- Removed temperature output from metabank_api_extra_device_status().
+- Modified code to store temperature at cgpu->temp for metabank devices.
+- bitfury: Added get_api_extra_device_status for 'devs' request in metabank
+driver: Slot, Clock Bits, Temperature, Voltage.
+- minerloop_async: Run watchdog code within actual device thread
+- bitfury: Remove unused libbitfury_readHashData
+- Bugfix: DevAPI: Don't call job_process_results when there was no previous job
+- bigpic: Convert to async minerloop
+- bitfury: Port to Windows
+- bigpic: Use bitfury_fudge_nonce
+- Use common bitfury_decnonce for all bitfury-based devices
+- Rename bf1 driver to bigpic, as the same device has other brands too
+- bf1: Clean up log messages
+- bf1: Reduce loglevel of debug messages
+- Bugfix: bf1: Add missing header to Makefile.am, and fix .dname/.name
+- Bugfix: bf1: Fix warnings
+- BF1 driver modified to work under Windows -> packing of structs isn't working
+with Windows
+- Corrected hash rate estimation for BF1. Only 756 out of 1024 nonces are
+scanned.
+- Cleaning up the bf1 driver code
+- BF1 driver working
+- Bitfury BF1 source files added
+- bfsb: modified to use LukeJr:'s new code
+- configure: Reorder output
+- configure: Allow to build *fury drivers only
+- bitfury: Turn commented debug stuff into #ifdef BITFURY_SENDHASHDATA_DEBUG
+- bitfury: Implement queue_full to ensure all processors have a work ready
+before scanwork
+- bfsb: set api speed to 625khz
+- initial support for bitfurystrikesback boards
+- bitfury: LINE_LEN instead of 2048
+- bitfury: 4Mhz SPI by default
+- bitfury: double SPI polling
+- bitfury: +Strange Counter -printf Counter
+- bitfury: tuning of parameters; fixed cycles calculation
+- bitfury: Move clock increase from common code to metabank driver init
+- bitfury: Add driver-bitfury.h for shared function declarations
+- bitfury: Do debug logging of read data before rotation
+- bitfury: Decode nonce array sooner to make debugging easier
+- bitfury: Check that the previous nonce still matches, to detect response
+corruption
+- bitfury: Workaround corruption by looking for matches rather than changes
+- bitfury: Rewrite using async minerloop (currently only setup on metabank
+driver)
+- bitfury: Fix memory issues
+- littlefury: Turn off chips when exiting
+- littlefury: Adapt to 16-bit payload size (protocol change)
+- Bugfix: littlefury: Fix bitfury_do_packet
+- bitfury: Report bad nonces properly
+- bitfury: Unify common nonce fudging code
+- Bugfix: bitfury: Chips only scan 0xbd000000 nonces per work
+- bitfury: Fix logging to use applog
+- bitfury: Split driver into bitfury_gpio (bare GPIO) and metabank (i2c banked
+GPIO)
+- littlefury: Use bitfury driver scanwork
+- bitfury: Eliminate more static variables
+- bitfury: Treat each chip as its own processor
+- bitfury: Resolve devices[chip] only once per chip
+- bitfury: Move second_run logic back to libbitfury
+- bitfury: Loop over chips once during scanwork
+- bitfury: Abstract hashes_done2 which keeps track of time deltas per thr on its
+own
+- littlefury: Need to set tv_morework
+- bitfury: Abstract out payload_to_atrvec
+- littlefury: Log read return value when unexpected
+- bitfury: Eliminate non-const global variables
+- littlefury: Safeguard on job switching
+- Bugfix: littlefury: Keep reading until error, EOF, or buffer filled
+- littlefury: Log devproto of incomplete reads
+- Enable littlefury detection
+- Bugfix: configure: Enable bitfury by default properly
+- bitfury: Require explicit -S bitfury:auto to probe GPIO-based SPI
+- bitfury: Move i2c slot handling to metabank-specific driver code
+- littlefury: Initial driver for BitCentury's USB miner
+- bitfury: Split actual chip detection into simple function
+- Bugfix: bitfury: Fix driver "name" to be correct length
+- bitfury: Abstract SPI interface
+- Bugfix: bitfury: Fix more warnings
+- Bugfix: bitfury: Fix warnings
+- bitfury: Intercept and use applog for perror calls
+- Bugfix: bitfury: Handle SPI init failure cleanly
+- bitfury: major intermediate update
+- bitfury: added chip series detection; multiple chip mining
+- Bitfury ASIC initial support
+- DynClk: Improve commented documentation
+- Replace Utility with (expected) Income calculated by actual shares submitted
+in 100% PPS value
+- format_unit3: BTC formatting with 2 decimal place digits
+- format_unit3: Support for nano- and pico- sizes
+- format_unit3: Use an enum for float-precision parameter
+- format_unit2: Support milli- and micro- unit prefixes
+- opencl: Disable by default if other devices are found; to enable, use -S
+opencl:auto
+- write_config: Save request-diff option
+- Stratum: Clear unused extranonce2 space
+- Don't even show 'Attempting to restart' for devices that don't support it
+- Workaround bug in PDCurses wresize
+- Bugfix: Include config.h in sha2.c first
+- make-release: Include libevent-2-0-5.dll in Windows packages
+- README: Document dependency on libevent
+- README: Document new --chroot-dir and --setuid options
+- Bugfix: Use correct configure define for chroot
+- Remove --disable-chroot build option: always compile --chroot-dir if supported
+- Bugfix: Use correct configure define for pwd.h
+- Improvements on code
+- Update miner.c
+- Added basic chroot support, added option to configure.ac.
+- Updated miner.c
+- Added basic chroot support
+- Replace u-hashrate with nonce-based hashrate adjusted for rejects/stales
+- SSM: Windows port
+- SSM: Allow configuring stratum port via --stratum-port option and RPC
+setconfig
+- SSM: Implement mining.hashes_done extension
+- Proxy: Catch invalid usernames and error
+- SSM: Report hashes done based on share submissions
+- SSM: Include current time in job ids to avoid false hardware errors due to job
+id reuse
+- SSM: If no notify is currently set, try to set it before refusing a subscribe
+- SSM: Prune old jobs after expiry
+- SSM: Use pool data read lock when subdividing notify
+- SSM: Gracefully fail when upstream stratum notify cannot be subdivided
+- SSM: Gracefully fail when upstream pool is not stratum (by closing subscribed
+clients, and refusing to subscribe new ones)
+- SSM: Properly fail cleanly when maximum clients are connected
+- SSM: Clean up stratumsrv_job when pruning it
+- SSM: Avoid responding to notifications, and give an error for unknown methods
+- SSM: Propagate work updates to clients
+- Mostly functional stratum proxy driver
+- Stratum: Split actual work generation away from the current pool data
+- Bugfix: Stratum: Dereference pool swork coinbase buffer inside data lock
+- SGW: Split proxy code out from driver-getwork into driver-proxy
+- Bugfix: miner.php: Check $dototal[$name] is set before comparing its value
+- Bugfix: RPC: Use bad_nonces in Hardware% instead of generic hw_errors
+- Bugfix: RPC: Handle LIFE_DEAD2 case
+- Make failure to open sharelog or noncelog abort startup
+- Nonce logging option --noncelog to simply store every nonce and its info
+- Abstract --sharelog option parsing
+
+
+BFGMiner Version 3.2.1 - September 19, 2013
+
+- Only show long-poll message in pool summary if it's not using stratum.
+- README.ASIC: Clarify syntax of --scan-serial usage for USB Erupters
+- Bugfix: RPC: Defer allocation of apisock until after we check for --api-listen
+- make-release: Only try to include libmicrohttpd if bfgminer.exe depends on it
+- Bugfix: make-release: Include libplibc-1.dll if available
+- SGW: For Windows builds, include winsock2.h instead of POSIX networking
+headers
+- configure: Display getwork proxy server support in summary
+- Bugfix: SGW: Pass actual cgpu_info to prune_worklog_thread instead of silently
+casting one from getwork_client
+- Bugfix: Get total_staged with lock for TS stat, before getting console lock
+- Bugfix: bitforce: Correct fanmode RPC help
+- bitforce: Hide fan control when disabled in firmware
+- Bugfix: bitforce: Correct fanspeed TUI setting
+- Bugfix: logging: Allow up to 4 KB for log lines
+- Bugfix: icarus: Ensure last2_work exists before trying to check nonces fit it
+- README.OpenWrt: Include serialusb drivers
+- README: Include OpenWrt serialusb driver package names
+- Bugfix: Initialise notifier (as invalid) for no-thread devices (SGW)
+- Bugfix: Free temporary kernel path copy when writing config file
+- Bugfix: Put kernel path on the (main) stack after initialisation from
+commandline/config, to avoid appending an argv or jansson string
+- Bugfix: Always allow startup with curses enabled (since the user can use
+Manage devices to add new ones, and display Ctrl-C for text-only quit help
+- Bugfix: Ignore/reject libmicrohttpd before 0.9.5, which introduced symbols we
+need
+- README: Elaborate on format of BW
+- Bugfix: Try to initialise libusb later, so any mutexes applog might need are
+initialised
+- Bugfix: Implicitly initialise timer_set_now when it is first called
+- util: Eliminate unsafe const-removing casts
+- configure: Cleanup CFLAGS/LDFLAGS display
+- Show RT_LIBS in ./configure output.
+
+
+BFGMiner Version 3.2.0 - August 29, 2013
+- cpu: sse2_64: Rename sha256_init to sha256_init_sse2 to avoid conflict with
+new sha2.c
+- httpsrv: Some older versions of libmicrohttpd need stdint.h included first
+- make-release: Include libmicrohttpd-10.dll if it exists
+- Fixes column alignment in decimal fields. Workaround for printf rounding up
+when formatting decimals into limited width.
+- New hidden --unittest option. No longer runs unit tests at startup by default,
+for faster startup. Added unit test for width printing of decimal numbers.
+- Bugfix: configure: More fixing BSD sed syntax for curses header search
+- Bugfix: configure: More fixing BSD sed syntax for libusb header search
+- README: Update solo mining docs
+- erupter: Continue searching a job until the end, even if an earlier result is
+found
+- icarus: Do hwerror-triggered reopen before sending the next job the first
+time, to avoid having to resend it later
+- icarus: Avoid sending a new job if the nonce found was for one before the
+current job anyway
+- icarus: Double-buffer work to solve nonces found before work change takes
+effect
+- icarus: Abstract nonce processing
+- Bugfix: icarus: Avoid trying to submit 0 on comms error
+- icarus: Skip unnecessary nonce memcpy
+- icarus: Make state->last_work a pointer and store it on the heap
+- miner.php fix missing global
+- Bugfix: erupter: After identify, skip starting work if next scanhash is
+already decided to be a "first run" (eg, device errors)
+- Bugfix: erupter: Fix identify following hw error
+- Bugfix: icarus: Don't try to send work if device open failed
+- Debug log when zeroing stats
+- Upgrade libblkmaker to 0.3.2
+- Bugfix: GBT: Advertise coinbasevalue capability
+- Bugfix: Always compile add_serial now that it's somewhat generic
+- icarus: Avoid sending a new job if the nonce found was for one before the
+current job anyway
+- icarus: Double-buffer work to solve nonces found before work change takes
+effect
+- icarus: Abstract nonce processing
+- Bugfix: icarus: Avoid trying to submit 0 on comms error
+- icarus: Skip unnecessary nonce memcpy
+- icarus: Make state->last_work a pointer and store it on the heap
+- README.RPC: Remove usbstats mention
+- README: Add FAQ regarding cgminer messing up drivers
+- README.RPC: Fix miner name
+- README.RPC: Correct to mention other supported devices for pgaidentify
+- api.c fix mcast debug message bug
+- README.RPC: break all lines at most 80 characters
+- Update the API Multicast documentation
+- miner.php implement API Multicast handling to automatically find your local
+net miners
+- Bugfix: RPC: Fix log format types in io_flush
+- Set RT_LIBS correctly from autoconf detection
+- Explicitly check for clock_nanosleep and only use it when available
+- Further integrate cgsleep API into BFGMiner's timer system, so clock_nanosleep
+is only used on platforms with CLOCK_MONOTONIC
+- Convert cgtimer_t to struct timeval
+- Bugfix: Fix BSD sed syntax for curses header search
+- Bugfix: configure: Really fix BSD sed syntax for libusb header search
+- README.RPC: Mention multicast detection
+- README: Include --mcast-* options in usage
+- Use ccan's standard char* set/show functions for --api-mcast-{addr,code}
+- Bugfix: RPC: Use the same mcast code in reply, and log it correctly
+- API mcast only reply to remote IP's that are allowed access
+- Initial API Multicast response v0.1 to find cgminer APIs
+- Check for cnx_needed on each loop through wait_lp_current.
+- Return positive for cnx_needed when no_work is true.
+- Add no_work bool to set when we are in an underrun situation
+- Reorder support names alphabetically.
+- We don't want to continue into the hash_pop function if the getq is frozen.
+- Carve out the unused portions of sha2 implementation.
+- Import Aaron D. Gifford's fast sha256 implementation.
+- Use cloned work when finding avalon results since another thread can discard
+the work item while it's in use.
+- Provide a variant of find_work_bymidstate that returns a clone of the found
+work.
+- Use timespecs on windows as cgtimer_t to capitalise on the higher resolution
+clock changes.
+- Abstract out the conversion of system time to an lldiv_t in decimicroseconds.
+- Use our own gettimeofday implementation on windows for it to be consistent
+across ming builds and higher resolution.
+- Provide cgtimer_sub helper functions.
+- Provide cgtimer_to_ms helper functions.
+- Rename cgsleep_prepare_r as cgtimer_time to get time in cgtimer_t format and
+call cgsleep_prepare_r as a macro for cgtimer_time
+- TimeBeginPeriod and TimeEndPeriod do not add significant overhead when run the
+entire time for cgminer so avoid trying to maintain balanced numbers of them for
+specific time calls to simplify code.
+- Replace all references to the old n*sleep functions with the equivalent
+cgsleep_*s replacements.
+- timeGetTime uses huge resources on windows so revert to using timevals for its
+implementation of cgtimer_t
+- Quotient/remainder error in ms division.
+- Provide cgtimer_to_timeval helper functions.
+- Provide a timeval_to_cgtime helper function to reuse values.
+- Simplify cgsleep code for windows by using a typedef for cgtimer_t that
+resolves to clock resolution, using that internally.
+- On windows use the higher accuracy timegettime function to really get 1ms
+clock and timer accuracy.
+- Fix missed endtimeperiod in overrun timer on windows.
+- Make cgsleep_us_r take an int64_t for us.
+- Make the cgsleep functions build on windows.
+- Set high resolution timing on windows within the cgsleep functions.
+- Provide reentrant versions of cgsleep functions to allow start time to be set
+separately from the beginning of the actual sleep, allowing scheduling delays to
+be counted in the sleep.
+- Make the nmsleep and nusleep functions use the new cgsleep functions internally
+till functions are migrated to the new cgsleep API.
+- Add a ms_to_timespec helper function, and create a cgsleep_ms function that
+uses absolute timers with clock_nanosleep to avoid overruns.
+- Add rt lib linkage to enable use of clock_nanosleep functions with older
+glibc.
+- Add a timeraddspec helper function.
+- Provide a us_to_timespec helper function.
+- Provide a us_to_timeval helper function.
+- Add helper functions to convert timespec to timeval and vice versa.
+- Bugfix: SGW: Discard work from log only by expiry, so post-startup hardware
+errors are truly only hardware errors
+- bitforce: Make voltages available to RPC
+- bitforce: Save voltages as array of longs internally
+- Bugfix: Clear device bad nonces when zeroing stats
+- cpu & opencl: Defer RUNONCE to actual autodetection, so they can be added once
+after startup
+- Bugfix: Avoid crash activating [M]anage devices with no currently defined
+devices
+- TUI: Support for adding new devices using the plus key from [M]anage devices
+- Bugfix: Use add_serial function for scan_serial, so that "all" keyword works
+correctly
+- SGW: Add support for new X-Hashes-Done header to allow devices to more
+accurately report their work
+- SGW: Add X-Mining-Identifier header to inform devices what they are
+represented by in BFGMiner
+- SGW: Use JSON for 401 response; add Server HTTP header
+- AUTHORS: Add contributor Josh Lehan
+- Changed comparison constants to allow for floating-point rounding
+- Install README.ASIC for Block Erupter related drivers as well as Avalon
+- make-release: Windows users don't need README.Debian
+- README.OpenWrt: Import from BFGMiner downloads
+- Silence Windows warning about send data signedness
+- Fix block info
+- API/miner.php add some % fields
+- Don't yield on grabbing the read lock variant of cglocks.
+- util.c expand quit to show file/func/line
+- We should be using a cg_wlock initially in generating stratum work before
+downgrading the lock.
+- Add the ability to downgrade a write variant of the cglocks.
+- Yield after releasing a lock in case we are on a device with limited CPU
+resources.
+- Fix --scrypt being required before scrypt intensities on command line or not
+working at all via config files.
+- Limit intensity range according to whether scrypt is in use or not.
+- Do not allow benchmark mode to be used with scrypt.
+- miner.php format Best Share
+- README.ASIC block erupter USB brief
+- Check for negative wait time in socket_full.
+- Adjust socket wait timeout in recv_line according to how long we've already
+waited to avoid a 60 second wait dropping to 1 second due to a blocked socket.
+- force type checking on curses
+- logging - size check sprintf
+- Only use length-counted variants of format_unit and percentf
+- Implement snprintf-like versions of format_unit and percentf
+- miner - size check all sprintf
+- size check get_datestamp/get_timestamp and remove unused cgpu->init
+- make all statline overflow safe
+- Convert the decay_time function into one that truly creates an exponentially
+decaying average over opt_log_interval.
+- GPU fan rpm display 9999 when it overflows
+- Change mode on python file.
+- Only update hashmeter if we have done hashes or haven't updated longer than
+the log interval, fixing a us/ms error.
+- README.ASIC: Document usage with Block Erupter Blades
+- README: Add mention of libmicrohttpd to dependencies
+- SGW: Include hash1 in work
+- SGW: Include application/json Content-Type header
+- Fix build without libmicrohttpd
+- Allow startup to proceed with no devices, as long as RPC or HTTP are listening
+- SGW: Refuse to issue new work to disabled devices
+- SGW: Respond with stale rejection if share is known to be immediately stale
+- Expose HTTP getwork username in Manage TUI and devdetails RPC
+- Add --cmd-idle notification command for REST/WAIT conditions
+- bfgminer-rpc: Accept unlimited size replies
+- api-example.py: Accept unlimited size replies
+- RPC: Rewrite io_data to cleanly handle unlimited sized responses
+- Configure options to build --without-libmicrohttpd support
+- RPC: setconfig can now change http-port (enabling or disabling the http
+service included)
+- Embedded HTTP server to handle getwork-based mining devices
+- inc_hw_errors2 function can handle a bad nonce without a known work
+- Split up scan_serial function to enable internally adding ad-hoc cgpu
+- Helper functions bfg_json_obj_string and share __json_array_string
+- bytes_t: Add bytes_shift and bytes_nullterminate
+- Fix configure help for --without-sensors
+- README: Document --with-system-libblkmaker
+- Bugfix: Use BSD-friendly sed syntax for libusb header search
+- Bugfix: Handle bitstreams properly
+- Bugfix: Skip search for addwstr since it breaks --with-curses=preference
+- Bugfix: configure: Find correct curses include path without *-config
+- README.FPGA: Further clarify ZTEX setup
+- Display a friendly error directing to README.FPGA when bitstream cannot be
+loaded
+- Remove bitstreams from BFGMiner distribution entirely, and include pointers
+where to find them in README.FPGA
+- ztex: Use load_bitstream_bytes for .bin files
+- fpgautils: load_bitstream_bytes support for Intel HEX format (.ihx) files
+- Add missing 16-bit byteswap macros
+- fpgautils: load_bitstream_bytes function to load a bitstream into a bytes_t
+- bytes_t functions: bytes_init, bytes_append, bytes_reset
+- Look for bitstreams in /usr/share/bitstreams
+- Disable Unicode support by default (use --unicode to enable)
+- make-release: Skip stripping debug info from Windows EXEs, for now
+- Bugfix: Ensure work variable is assigned before checking its thr_id
+- Bugfix: notifier_init (Windows): setsockopt needs an int for SO_REUSEADDR
+- Bugfix: Avoid turning totals red just because a processor is idle
+- Enable notifications for sick/dead with --cmd-sick and --cmd-dead options that
+execute commands when the event occurs
+- RPC: Add cpu enable/disable/restart
+- windows-build: Update to use libpdcursesw.dll
+- Ensure socket error messages are used for socket errors on Windows
+- fpgautils: Attempt to use Linux advisory locks on serial devices
+- Bugfix: README: --temp-cutoff sets the maximum temperature before cutoff, not
+temperature that triggers cutoff
+- Bugfix: Avoid incrementing dev_thermal_cutoff_count when just updating
+timestamp on status
+- Detect curses support for wide characters during configure
+- configure: Check for more variants of curses library names
+- Bugfix: ztex: Avoid trying to format non-libusb error with libusb error name
+- Bugfix: Avoid trying to assign const use_unicode variable with --no-unicode
+option
+- Remove long-unused opt_time variable
+- RPC: Avoid exposing Coinbase-Sig when it isn't supported
+- Bugfix: Fix build with libblkmaker < 0.2
+- Attempt stratum mining.suggest_target before mining.subscribe, if
+--request-diff is used
+- Retry stratum if initiation fails for any reason after we have sent something
+(assuming there is more older variants we can try)
+- Bugfix: Restore delay for authorization on stratum mining.get_transactions
+- Bugfix: Fix TUI-only build
+- bitforce: Extend pgaset _cmd to variable-length commands
+- Bugfix: Use red for total processor count
+- bitforce: Undocumented _cmd1 pgaset for experimenting with firmware
+- Bugfix: curses: use_default_colors() when possible
+- Bugfix: Calculate scrolling range with new cursor lines
+- Bugfix: Ensure use_unicode and have_unicode_degrees constants are defined for
+curses-less builds
+- Bugfix: Replace block_timeval with (time_t) block_time
+- README: Update for --no-unicode option
+
+
+BFGMiner Version 3.1.4 - August 2, 2013
+- Windows: Rebuild pdcurses with UTF-8 and wide character support
+- Bugfix: Avoid using wide curses symbols/macros when USE_UNICODE is not defined
+- Unicode: Use line drawing in TUI Help
+- Use bfg_waddstr even with Unicode disabled, since it's needed for red
+highlight
+- Colour bad conditions in red
+- Unicode: Cross-tee intersecting lines
+- Unicode: Use WACS_VLINE for vertical lines
+- Unicode: If degrees symbol is available, add it to temperatures
+- Unicode: bfg_waddstr wrapper to handle non-ASCII characters, currently used
+only by logging and statlines
+- Unicode: Use WACS_HLINE for horizontal lines
+- Add framework for using Unicode in TUI (can be disabled with --no-unicode)
+- Avoid using potentially locale-dependent ctype functions in locale-independent
+contexts
+- Refactor temperature in TUI statlines to share code nicer
+- Bugfix: avalon: Fix applog formatting
+- Bugfix: Align totals columns in per-processor view
+- Bugfix: Fix curses-less build
+- configure: Workaround buggy autoconf versions
+- Bugfix: erupter: Include headers in order necessary for Windows
+- Bugfix: Reimplement get_intrange using strtol instead of sscanf (which is
+broken on Windows)
+- Bugfix: get_intrange: Check for extra garbage at the end, only after we know
+we have an end-position
+- Bugfix: Fix Enter key in TUI on Windows
+- erupter: Split identify-handling logic into handle_identify function
+- Bugfix: erupter: Ensure identify is handled during no-once or firstrun
+- erupter: After identify, check if a work restart is needed immediately
+- erupter: Implement identify function by pausing hashing for 3 seconds
+- Bugfix: icarus: Remember firstrun state in case it gets changed for the next
+run
+- icarus: Move actual dynclock updates to icarus_job_start
+- icarus: Split out icarus_job_prepare, and rename icarus_job_start
+- Bugfix: ZeroStats: Reset column widths to 1
+- miner.php: Include max temperature in device totals line
+- Bugfix: Stratum Fix debug logging of initial mining.subscribe command
+- Bugfix: Call pool_set_opaque from work_decode, so block content hiding/
+providing messages work for getwork/GBT
+- Split block contents hiding/providing notices out from stratum code
+- Add test suite for get_intrange
+- Bugfix: Check for error conditions in get_intrange to not have weird --device
+behaviour when bad values are provided
+- Bugfix: erupter: Take advantage of detectone_meta_info to handle Emerald
+autodetection
+- TUI Help describing the various status fields (contributed by midnightmagic)
+- Bugfix: ManageTUI: Allow 'I' key to be used by devices not supporting identify
+- Bugfix: Prefer Sapphire over Emerald for -S erupter:*
+- Bugfix: Clear total_bad_nonces when zeroing statistics
+- Bugfix: modminer: Since we are not searching iManuf string for needles, only
+look for "ModMiner"
+- Bugfix: sysfs autodetect: Recurse into tty/ subdirectory (necessary for
+CDC/ACM ttys)
+- sysfs autodetect: Split tty* directory search into new _sysfs_find_tty
+function
+- modminer: Reduce default clock to 190 MHz
+- README: Update driver info to include Erupter driver
+- README: FAQ about scrypt and difficulty
+- Include count of working devices/processors in totals statline
+- Format totals statline the same way as individual device/processor statlines
+- Rearrange TUI a bit, including menu at the top (+1 log line) and hashrate
+total closer to device summaries
+- Bugfix: setup_stratum_curl: Need to release stratum lock on connection failure
+too
+- Bugfix: Avoid unnecessary locks inside curses_print_status, which is called
+with the console lock held
+- Bugfix: setup_stratum_curl: Hold stratum lock until connection completes, to
+avoid potential races
+- Bugfix: stratum_works: If stratum is already active, it works (avoid trying to
+initialise it again)
+- Replace hashrate_to_bufstr/ti_hashrate_bufstr with format_unit/
+multi_format_unit_array
+- New multi_format_unit_array to fill multiple buffers instead of building a
+delimited string
+- multi_format_unit: Skip recounting length of fixed-length strings
+- Shrink status line to fit in 80 columns
+- Add network bandwidth rate to TUI
+- New multi_format_unit variadic macro to handle formatting multiple numbers at
+once
+- format_unit: Option to choose 3-digit integer display vs 5-character floating-
+point display
+- Optimization: format_unit: Handle number first, to avoid having to restore
+suffix later
+- Generalise hashrate_pick_unit/hashrate_to_bufstr into pick_unit/format_unit
+- Extend hashrate_pick_unit/hashrate_to_bufstr to handle sub-kilo units
+- Split total_bytes_xfer to total_bytes_rcvd and total_bytes_sent
+- Bugfix: _decode_udev_enc_dup: Allocate enough space for full string
+- Bugfix: Never use waddstr for logwin, since it would bypass special newline
+handling
+- Bugfix: bitforce: Set kname on chip processors
+- bitforce: Include voltages in Manage device TUI
+- Defer newlines going to curses logwin, to avoid a useless blank line at the
+bottom of the window
+- Ensure printing to logwin always goes through _wlog
+- Remove blank line above log window
+- bitforce: Identify parallel queue protocol distinctly from mere bulk queue
+- ManageTUI: Include kernel name, when available
+- Stratum: Roll ntime as we generate work
+- Stratum: Make swork.ntime native-endian
+- Stratum: Treat ntime as uint32_t (as it should be), still always big endian
+- Debuglog ManageTUI actions/responses
+- ManageTUI: Add generic Identify support
+- Bugfix: Move serial_detect* and open_bitstream to DevAPI code so CPU/OpenCL
+can build properly without fpgautils
+- Short-circuit logging sooner in quiet mode
+- Write to both stderr and console within same console lock "session"
+- Bugfix: Also hold the console lock when writing to stderr
+- Use common console locking function for stdout in logging.c
+- Move console lock and unlock functions (which also handle thread cancelstate)
+to miner.h
+- Bugfix: bitforce: Only try to clear queues of SC devices, since FPGA MR boards
+interpret ZQX/ZOX differently
+- Timer-based gettimeofday substitute for systems with poor time-of-day clocks
+(Windows)
+- Use clock_gettime(CLOCK_MONOTONIC) for timers when available
+- Use QueryPerformanceCounter for timers on Windows
+- Generic refactoring for timer_set_now
+- Replace all remaining uses of gettimeofday for timers, with timer_set_now (aka
+cgtime)
+- Don't mix timers with timestamps (visual only)
+- Always use struct timeval for timers, and don't mix timers with timestamps
+(functional only)
+- get_datestamp: Change timeval parameter to time_t, and implement
+get_now_datestamp for common "current time" use case
+- Use get_datestamp for (non-microsecond) log timestamps
+- Bugfix: ztex: Allocate final processor names on the heap, so they survive when
+the stack for ztex_prepare is gone
+- Bugfix: ztex: Copy serial number to device "name" before cloning it for other
+processors
+- Bugfix: x6500: Use cgpu->temp directly since there is only one sensor per
+processor
+- Bugfix: Actually show the highest temperature, not just calculate it
+- x6500: Allow changing clock speed from TUI Manage device
+- x6500: Port pgaset clock from modminer driver at
+66d2a3ab072fcdbc3c7ed41a97f265afa917bbee
+- modminer: Allow changing clock speed from TUI Manage device
+- bitforce: Flush job and result queues at startup to avoid unnecessary warnings
+- x6500: Reduce default clock to 190 MHz
+- Bugfix: fpgautils: Close libusb handle after copying USB strings
+- use BSD sed syntax to generate iospeed_local.h
+
+
+BFGMiner Version 3.1.3 - July 11, 2013
+- Bugfix: Reset staged_full flag when discarding (stale) popped work, or
+increasing the queue minimum
+- Bugfix: Only trigger staged work underrun if a mining thread was actually
+waiting for it (and do so sooner, before it has the work made)
+- bytes_cpy: avoid malloc and memcpy when size is zero
+- fix infinite loop in bytes_cpy when size is zero
+- Bugfix: Generate iospeeds_local.h based on termios.h defines, and only try to
+use POSIX standard if that fails
+
+
+BFGMiner Version 3.1.2 - July 8, 2013
+- When not compiling with optimizations, initialize unused nonce2 space to avoid
+warnings from memory checking tools
+- TUI Manage devices: Support PgUp/PgDn keys to skip over processors within the
+same device
+- Bugfix: bitforce: Prefer 2nd temperature if higher than 1st
+- When displaying device summary statlines, use the highest temperature reported
+by any processor
+- Stratum: Fix nonce2 sizes greater than 4 and (on big-endian) smaller than 4
+- bitforce: Manage TUI: Display both temperatures (if two), and enable changing
+fan speed
+- opencl: Add fan speed to Manage device TUI now that it's been removed from
+statline
+- DevAPI: Remove old statline APIs entirely, and add new override_statline_temp
+(used by modminer/x6500 for upload %)
+- README: Update statlines
+- TUI: Replace DevAPI statline_before with a predefined temperature column to
+free up statline space
+- Refactor and simplify bin2hex to speed up and avoid unnecessary heap use
+- stratum: Refactor work generation to do hex2bin conversions once, rather than
+every single header generated
+- Implement bytes_t for generic binary data storage (including smart realloc-
+based resize)
+- Bugfix: fpgautils: Only try to change baud rate when requested
+- x6500: Provide manuf/product/serial to cgpu interface
+- ztex: Provide manuf/product/serial to cgpu interface
+- erupter: Use baud 115200 by default
+- List valid baud rates once in iospeeds.h and standardize conversions
+- TUI: Display device manufacturer/product/serial in Manage device screen, when
+available
+- DevAPI: Store manufacturer/product/serial for each device
+- fpgautils: detectone_meta_info to provide metainformation (manufacturer,
+product, serial) on devices to detectone functions
+- Bugfix: fpgautils: Close product string file from sysfs (autodetect)
+- erupter: New icarus-based driver to handle autodetection of Block Erupter
+devices
+- Add --log-file option which redirects stderr to a file, but valid anywhere in
+the commandline or config file
+- Detect staged work underruns and increase queue to avoid them
+- Rewrite hex2bin to perform much faster (reduces minirig CPU usage by more than
+half!)
+- README: Add condensed list of dependencies
+- Enable "maintainer mode" by default
+- Bugfix: opencl: TUI manage: "Change settings" must not be compiled in with
+no-ADL builds
+- Bugfix: Detect whether the linker accepts -zorigin before attempting to use it
+- opencl: ADL: ADL_Adapter_ID_Get fails with newer drivers, so tolerate its
+failure best we can
+- opencl: Don't try to use BFI_INT patching with APP-SDK newer than 1084
+(Catalyst 13.1), since it doesn't work
+- fpgautils: Elaborate that bitstream open failures are probably due to missing
+bitstream package
+- fpgautils: s/firmware/bitstream/
+- Bugfix: Cleanup handling of complete device/driver failure
+- Deprecate -C (enable CPU) and -G (disable GPU) options, now that -S
+drv:[no]auto can be used for the same purposes
+- Bugfix: Since at least one of unix (or __APPLE__) or WIN32 is required by
+util.h, make sure unix is defined if WIN32 is not
+- Bugfix: Set ELF rpath for bundled libblkmaker to use $ORIGIN so it can be run
+from other directories
+- Bugfix: Cleanup needs to happen before printing the final quit message, or it
+gets lost in TUI mode
+- Bugfix: fpgautils: Initialize my_dev_t instances with null bytes, to ensure
+random unused data cannot influence hash keys
+- opencl: ManageTUI: Clear log cleanly for changing settings
+- Remove "GPU management" TUI entirely
+- opencl: Use new "Manage device" interface to do everything "GPU management"
+used to be used for
+- DevAPI: Add interface for drivers to define custom "Manage device" options
+- DevAPI: New function called to display additional processor information for
+"Manage devices"
+- TUI: Add enable/disable commands to device management
+- TUI: Implement beginnings of generic device management interface
+- Bugfix: avalon: Fix LIFE_INIT2 setting
+- Add LIFE_INIT2 status (safe to call functions, but not mining yet) for devices
+that want to report initialization status in their statline
+- Bugfix: modminer: Only program once for --force-dev-init
+- Bugfix: x6500: Only program once for --force-dev-init
+- fpgautils: Workaround and document Xcode clang bug
+- Bugfix: avalon: Correctly claim serial port
+- Bugfix: -S all: Mac OS X needs to probe /dev/cu.*, not just /dev/cu.usb*
+- cpu & opencl: Refuse to detect more than once
+- cpu & opencl: Respect scan-serial auto/noauto instructions
+- ft232r & libztex: Skip probe of claimed devices
+- fpgautils: Check for devices being claimed before calling detectone from autodetectors
+- x6500 & ztex: Claim USB devices
+- fpgautils: Implement bfg_claim_usb for claiming devices by USB bus number and
+address
+- fpgautils: Replace serial_claim with bfg_claim_serial using a more cleanly
+extensible interface and implementation
+- fpgautils: serial_claim: Include a bus enum in hash key
+- Add serial port claiming logic to avalon, bitforce, and modminer drivers
+- RPC: "devscan" command to probe for new devices
+- New (internal) scan_serial function to probe for new devices at runtime
+- Split out per-cgpu temperature configuration code to load_temp_config_cgpu
+- DevAPI: Modify add_cgpu to use temporary devices_new array, so detection can
+be done without touching live variables
+- Move more cgpu initialization to allocate_cgpu
+- Move devtype default assignment to allocate_cgpu
+- Move cgpu startup routine to new start_cgpu function
+- Move cgpu_info allocation to new allocate_cgpu function
+- Move *.drv_detect calls to a new drv_detect_all function
+- DevAPI: add_cgpu: There is no need to hold mutexes while creating devices
+- Bugfix: cpu: Update device "kernel name" with auto-selected algorithm
+- usbtest: Improve portability to at least 2.7 and 3.2
+- usbtest: Avoid messing up the display by escaping weird bytes via repr()
+- usbtest: Skip last 2 optional parameters, since we use the defaults and they
+are not in older versions of pyserial
+- Bugfix: bitforce: ZOX limits results to 16 results per call, so repeat ZOX
+until there are fewer
+- Bugfix: Initialization for bfgtls needs to be done in each thread
+- Bugfix: stratum: Be patient with stratum lines that come in slower than we can
+process them
+- Use bfg_strerror in locations previously just logging raw error numbers
+- Bugfix: stratum: Log WSAGetLastError() for error number on recv failures on
+Windows
+- Use bfg_strerror where it is already needed (for thread-safety)
+- New thread-safe bfg_strerror function to portably stringify error codes
+- Bugfix: bitforce_queue: Initialize buf2 so errors don't cause the work queue
+to flush
+- TUI: Display percentage invalid of found nonces with hw errors
+- Bugfix: modminer & x6500: Increment *->diff1 for all bad nonces
+- percentf2 that takes t as precalculated total
+- Keep track of bad nonces independently from generic hw errors
+- inc_hw_errors: Resolve cgpu outside of mutex
+- Use inc_hw_errors function at every site which increases hw_errors
+
+
+BFGMiner Version 3.1.1 - June 22, 2013
+- stratum: Deliver exact socket-error within the debug error message
+- Don't install docs for (compile-time) disabled functionality
+- Bugfix: Handle make dependencies on subdirectory files properly
+- Bugfix: Use EXTRA_*_DEPENDENCIES for Cygwin workaround, to fix program make
+dependencies
+- Support new overclocking speeds for avalon: 325, 350 and 375
+- Bugfix: logging: Since we are inlining snprintf, stdio.h is needed
+- Bugfix: serial_autodetect_ftdi: Debuglog FTDI COM port mappings returned, fix
+type of FT_HANDLE
+- Bugfix: Allow starting non-libusb devices if libusb_init fails
+- Bugfix: Add missing newline to libusb_init failure message
+- Bugfix: opencl: Remove unnecessary casts from rot() macro, which created type
+issues
+- Bugfix: Remove unused variables
+- Suspend stratum connections when we know they've failed and don't try to recv
+data from them once the socket no longer exists.
+- applog/quit fix GPU errors created
+- logging remove extra added <LF>
+- remove varargs from logging/quit/in general as much as possible
+- compile unix code on Mac OS X fixes not finding the config file in $HOME
+- Create a pool_localgen bool function for testing when a pool can generate work
+locally.
+- Use mining start time for device MH/U calculations
+- Bugfix: Save start time for stats to correct "Elapsed" key on "stats" RPC
+request
+- modminer: tidy up free in device detect function
+- bitforce: RPC pgaset fanmode 9 for auto fan control
+- Bugfix: usbtest: Correct obvious typos
+- Initial import of usbtest.py script
+- Include microseconds in log output with new --log-microseconds option
+- bitforce: Workaround chip ids not necessarily being in order by choosing
+processor count based on expected chip ids rather than parallelization
+- serial_autodetect_ftdi: Debuglog FTDI COM port mappings returned
+- Bugfix: On stratum disconnect, clear stratum_active and stratum_notify
+atomically along with sock
+- Windows: Use backtrace.dll to print usable backtraces to stderr on crash
+- Bugfix: bitforce: parallelized: Properly handle parallelized protocol with
+only 1 chip
+- Bugfix: bitforce: XLINK: Increment boardno when moving on to the next board
+- bitforce: XLINK: Update to use actual length,xlinkid header order
+- Bugfix: bitforce: XLINK: Avoid trying to send 0 bytes after each write
+- Bugfix: opencl: Build fpgautils even if OpenCL is the only driver, now that it
+uses it for kernel-finding
+- Bugfix: Do not try to call get_stats or get_statline* if device is still
+initializing
+- Bugfix: opencl: Add missing include for fpgautils.h (needed for
+open_bitstream)
+
+
+BFGMiner Version 3.1.0 - June 13, 2013
+- Bugfix: openwrt: Expect fixed bitstream path for input
+- Improve Makefile organization and fix "make install"
+- icarus: Upgrade work division autodetection probe to be faster and also detect
+8 core
+- Calculate rejection percentage based on weighed shares, not absolute counts
+- Count weighed discarded (stale) shares per cgpu
+- Bugfix: Cleanly count discarded (stale) shares without overlapping
+devices/sshare locks within clear_stratum_shares
+- configure: Enable Avalon support by default now that it behaves reasonably
+- avalon: Since detection is not really implemented, only probe devices when the
+driver is specified to -S by name (eg, "avalon:/dev/ttyUSB0")
+- Bugfix: bitforce_queue: Never try to reinitialize a slave processor
+- Bugfix: bitforce_queue: Use work_list_del everywhere we remove from work_list
+to ensure work gets freed properly when done
+- Reduce HW error logging to debug level, so it doesn't clutter the TUI log by
+default
+- DevAPI: When a device has more than 26 processors, represent them as aa-zz
+- bitforce: bitforce: Fix TUI display of slave processors on parallelized boards
+- bitforce: Only display temperature in TUI for the first chip on parallelized
+boards
+- Bugfix: bitforce: Set temperature for all processors on the board
+- Bugfix: bitforce_queue: Initialize proc->device_data to board data for
+parallelized chip processors
+- Bugfix: bitforce_queue: Defer nonce count check until after thiswork has been
+identified (or handled as NULL)
+- avalon: avalon_clear_readbuf can simply wait for a single read timeout on
+Windows to avoid select
+- avalon: Simplify avalon_get_result by using avalon_gets
+- avalon: Go back to good old serial timeouts for gets, since select() is for
+sockets (only, on Windows)
+- Updated api.c to return the hashrate with 3 decimal places
+- Change hashrate display to never display 3 fractional digits, because it looks
+a bit ugly
+- bitforce: Credit hashrate to the correct chip on parallelized devices
+- Re-set work thr_id on share submissions, to ensure the result gets credited to
+the correct device in case of shared job queues (as in BitForce long boards)
+- bitforce: Turn parallelization into separate logical processors for more
+details on each, including working with XLink
+- bitforce_queue: Implement job sanity checks using new "ZqX" for devices using
+parallelization
+- bitforce_queue: Minimal support for parallelization
+- Add --device-protocol-dump option to debuglog low-level bitforce protocol
+details
+- When shutting down, set work restart flag (and trigger notifier) to help
+mining threads escape to their main minerloop (and check for shutdown)
+- Document and check for uthash version 1.9.2+
+- Bugfix: Don't report failure for graceful mining thread shutdown
+- Name devices in mining thread failures
+- Warn about killing mining threads
+- Bugfix: Wake up mining threads when asking them to shutdown
+- Disable pthread cancel within curses locking
+- Shorten the avalon statline to fit in the curses interface and show the lowest
+speed fan cooling the asic devices.
+- Change switch_compact function name to switch_logsize to be used for other
+changes.
+- Only adjust cursor positions with curses locked.
+- devs display - fix GPU duplicate bug
+- basic copyright statement in API.java
+- Change the --device parameter parsing and configuration to accept ranges and
+comma separated values.
+- Modify scrypt kernel message.
+- Check for pool_disabled in wait_lp_current
+- Check for pool enabled in cnx_needed.
+- Add README.ASIC to debian packaging and make-release
+- Document avalon options in ASIC-README
+- Create README.ASIC with basic summary of supported ASIC devices.
+- Do avalon driver detection last as it will try to claim any similar device and
+they are not reliably detected.
+- Set the fanspeed to the nominal chosen for GPUs.
+- Clamp initial GPU fanspeed to within user specified range.
+- Avalon fan factor is already multiplied into the info values.
+- Get rid of zeros which corrupt display.
+- Logic fail on minimum fanspeed reporting.
+- Provide a workaround for fan0 sensor not being used on avalon and pad fan RPM
+with zeros.
+- Add ambient temp and lowest fan RPM information to avalon statline.
+- Display max temperature and fanspeed data for avalon.
+- Set devices to disabled after they exit the hashing loops to prevent the
+watchdog thread from trying to act on them.
+- Scanhash functions perform driver shutdown so don't repeat it.
+- Change the opencl shutdown sequence.
+- Send the shutdown message to threads and do the thread shutdown functions
+before more forcefully sending pthread_cancel to threads.
+- Icarus report data direction with comms errors
+- Execute driver shutdown sequence during kill_work.
+- Provide an nusleep equivalent function to nmsleep.
+- Set avalon_info to device data void struct.
+- Make submit_nonce return a bool for whether it's a valid share or not.
+- Do a non-blocking read of anything in the avalon buffer after opening the
+device.
+- Assign the avalon info data to the device_data in cgpu_info.
+- Rename cgpu_data to use new device_data
+- miner.h remove unused device_file and add device_data
+- Must unlock curses as well in logwin_update.
+- icarus report usb write error information
+- Make mining threads report out during work submission.
+- submit_work_async is no longer used directly by driver code.
+- Create a logwin_update function which mandatorily updates the logwin and use
+it when input is expected to prevent display refresh delays.
+- All stratum calls to recv_line are serialised from the one place so there is
+no need to use locking around recv().
+- Only allow the mining thread to be cancelled when it is not within driver
+code, making for cleaner shutdown and allowing us to pthread_join the miner
+threads on kill_work().
+- Implement pthread_testcancel replacement for BIONIC
+- Attribute whatever stats we can get on untracked stratum shares based on
+current pool diff.
+- Downgrade OpenCL headers to 1.0, which work fine for our purposes and are more
+compatible
+- icarus: If work_division autodetect fails, just use the old default of 2
+- avalonhost-raminst script to help with installing to RAM on Avalon-host
+routers
+- Attempt to probe /dev/cu.usb* for fallback "-S all"
+- openwrt: Download uthash dependency
+- Bugfix: openwrt: Always build with libsensors support disabled
+- configure: Check for uthash headers
+- Bugfix: ztex: Only destroy libztex device after the last handle to it has been
+released
+- ztex: Remove libztex slave device interface, simply passing fpgaNum to
+selectFpga
+- Bugfix: cpu: Fix yasm and sse2 detection
+- cpu: Check for SSE2 support independently from yasm
+- Bugfix: cpu: Make sure to link libsse2cpuminer.a before x86_32/libx8632.a
+- Bugfix: cpu: Only build libsse2cpuminer iff yasm is available and targetting
+x86_32
+- Bugfix: Free work only after deleting it from list
+- Remove embedded uthash.h and utlist.h from Makefile
+- windows-build.txt: Update for system uthash
+- Remove embedded uthash (and add dependency on system uthash)
+- Replace elist.h with utlist.h
+- Bugfix: Fix build with CPU mining and *without* yasm
+- cpu: Be explicit about size of sha256_init address
+- cpu: Add --algo fastauto (new default) to detect a usable algorithm without
+taking over a minute
+- cpu: Default to --algo auto
+- cpu: Support all platform-applicable assembly algorithms, even if used CFLAGS
+don't support them
+- Ubuntu: Updated changelog, added scrypt support.
+- cpu: Set fixed symbol names for stuff shared with assembly
+- cpu: Create Mach-O asm binaries on Darwin-based systems
+- Bugfix: cpu: Use COFF yasm binfmt on Cygwin
+- Bugfix: cpu: Get correct nonce from data, where the CPU sub-drivers leave it
+- Remove redundant "Reject ratio" in exit-time summary
+- Apply "R+S(%)" formatting to long-form statistics
+- Group stale shares in with rejects (but still distinctly counted) and make the
+percentage be (reject+stale)/total
+- Include rejected shares as a percentage
+- Move Utility and Best Share to status line
+- Remove LW from status line, since it is basically useless
+- ztex: Clean up a lot of ugly casting
+- Bugfix: Correctly avoid SIGPIPE on Mac
+- Make set_work_target a function to set a specified char as target for use
+elsewhere.
+- Minor typo.
+- Support more shares to be returned for scrypt mining.
+- Set all stratum sockets to nonblocking to avoid trying to use MSG_DONTWAIT on
+windows.
+- Only use MSG_NOSIGNAL for !win32 since it doesn't exist on windows.
+- Use MSG_NOSIGNAL on stratum send()
+- Set TCP_NODELAY for !linux for raw sockets.
+- Use TCP_NODELAY with raw sockets if !opt_delaynet
+- Recheck select succeeds on EWOULDBLOCK for stratum.
+- Don't use TCP_NODELAY if opt_delaynet is enabled with stratum.
+- Fix warnings in avalon driver.
+- correct applog typing
+- Simplify the many lines passed as API data in the avalon driver now that the
+API does not need persistent storage for the name.
+- Duplicate the name string always in api_add_data_full to not need persistent
+storage for names passed to it.
+- Add extra matching work count data in API for Avalon with 4 modules.
+- Clean up summary slightly better on exit.
+- opencl: Disable using binary kernels on Apple by default
+- Use sock_blocks in api.c
+- Fix build and distdir.
+- compile on win32
+- Update README.scrypt with improved hashrates for 7970.
+- Use copy_time helper throughout miner.c
+- Provide wrappers for commonly used timer routines with API stats.
+- Use flip32 function instead of open coding it in gen_stratum_work.
+- Move util.c exports to util.h
+- Replace gettimeofday usage with cgtime
+- Adopt gettimeofday wrapper from cgminer (cgtime) that is always called with tz
+set to NULL and increases the resolution on windows.
+- Add high resolution to nmsleep wrapper on windows.
+- Bugfix: Export stats_lock for deviceapi
+- Set default ocl work size for scrypt to 256.
+- fliter out the wrong result from adjust fan code
+- Set last device valid work on adding device.
+- Make scrypt submission use the submit_nonce code, with nonces matching
+endianness.
+- Increment hardware error count from the one site.
+- compile avalon driver on win32 and win64
+- build out of source dir
+- Rename scrypt regenhash function for consistency.
+- Add Mac FAQ.
+- Further driver FAQs.
+- Check for work restart after disable in the hash queued work loop since it may
+be a long time before we re-enable a device.
+- Unconditionally test for many wrong results on avalon and reset to avoid
+passing a corrupt avalon result to temperature code.
+- Only reset an avalon device with no results when there are no results
+consecutively.
+- More FAQs.
+- Avoid applog in recalloc_sock.
+- Avoid applog under cg_wlock.
+- Put spacing around locking code for clarity.
+- Avoid applog under pool_lock.
+- Avoid more recursive locks.
+- Avoid applog while ch_lock is held.
+- Avoid recursive locks in fill_queue.
+- Variable is already initialised in global scope.
+- More GPU FAQs.
+- More README faqs.
+- Yet more README faqs.
+- Add more FAQs to README.
+- Wrap result wrong tests in avalon scanhash in unlikely() and only consider a
+hash count of zero wrong if a restart wasn't issued.
+- avalon: if result_wrong >= get_work_count jump out the read loop
+- Fix warning on 32bit.
+- fix the fan control on max temp2/3
+- for some reason network down. one simple bfgminer command:   "bfgminer -o
+127.0.0.1:8888 -O fa:ke --avalon-options 115200:32:10:50:256" can idle the
+avalon for safe power and protect chip
+- if hash_count == 0; reinit avalon, fix the 0MHS bug use the max value of temp1
+and temp2 for fan control
+- Reinstate the matching_work_count per subdevice on avalon based on the work
+subid.
+- Rationalise and simplify the share diff and block solve detection to a common
+site.
+- subid field for devices that do not yet support the distinct device/processor
+interface
+- Make the avalon array size a macro.
+- Use replacement of work items in the avalon buffer as needed instead of
+flushing them.
+- Reinstate wrong work count to reset avalon regardless and display number of
+wrong results.
+- select() on serial usb in avalon does not work properly with zero timeout.
+- Use no timeout on further reads in avalon_gets
+- Do sequential reads in avalon_get_reset to cope with partial reads.
+- Show read discrepancy in avalon_get_reset.
+- Reuse avalon_get_work_count variable.
+- Check for AVA_GETS_RESTART when deciding if avalon has messed up.
+- Make the detection of all wrong results on avalon much more conservative to
+avoid false positives on work restarts.
+- Show error codes on select and read fail in avalon.
+- If we get a restart message in avalon_gets still check if there's a receive
+message to parse first without a timeout before returning AVA_GETS_RESTART.
+- avalon_gets is always called from the one call site so inline it.
+- The read_count is unused by the avalon get result code and no longer required
+for avalon reset so simplify code removing it.
+- Use a separate avalon_get_reset function for resetting avalon instead of using
+avalon_get_result.
+- The current hash count returned by avalon scanhash is just an obfuscated
+utility counter so make it explicit.
+- Check for a restart before a timeout in message parsing code in avalon.
+- We should check for a restart message before checking for a timeout in avalon
+scanhash.
+- Store the subid for the work item in avalon.
+- Fix record_temp_fan function in avalon driver.
+- Remove inappropriate memset of struct avalon result which was corrupting fan
+values.
+- Only do_avalon_close once on multiple errors.
+- Reset the result_wrong count on block change in avalon scanhash to prevent
+false positives for all nonces failed.
+- Small timeouts on select() instead of instant timeout increase reliability of
+socket reads and writes.
+- Rotate the avalon work array and free work on AVA_SEND_BUFFER_EMPTY as well.
+- Only get extra work in fill_queue if we don't have any unqueued work in the
+list.
+- Don't get any work if our queue is already full in avalon_fill.
+- Free avalon->works in the event we call avalon_prepare on failure to
+initialise.
+- Fix warnings.
+- Create an array of 4 lots of work for avalon and cycle through them.
+- Remove unused per unit matching work count for avalon.
+- Rename the confusing avalon_info pointer.
+- Simplify avalon scanhash code using the new find_queued_work_bymidstate
+function.
+- Members of cgpu_info for avalon are not meant to be in the union.
+- Use correct struct device_drv for avalon_drv.
+- Check enough work is queued before queueing more in avalon_fill.
+- Actually put the work in the avalon queue.
+- Rename avalon_api to avalon_drv.
+- First draft of port of avalon driver to new cgminer queued infrastructure.
+- Minor README updates.
+- README.GPU: Properly warn about overclocking damage
+- Add example 7970 tuning for scrypt in readme.
+- Update driver recommendations.
+- Add extensive GPU FAQs for the flood of new Scrypt miners.
+- Bugfix: Expect bitstreams and kernels to be in the srcdir, not build dir
+- cpu: Prefer sse4_64 algorithm if supported
+- cpu: sse2_32: Force bare symbols for cross-asm/C symbols
+- Compile CPU mining for win32 and win64
+- configure: Check for pthread in -lwinpthread
+- Use has_pth flag instead of trying to mess with pthread internals
+- configure: Explicitly check for nanosleep
+- configure: Include "no" response in BFG_PTHREAD_FLAG_CHECK
+- miner.h missing extern
+- Update links and recommended SDKs.
+- Bugfix: README.GPU: Fix some typos
+- Update README to match changes to display.
+- Remove increasingly irrelevant discarded work from status lines.
+- Remove increasingly irrelevant GW value from status.
+- README.GPU: Correct terminology
+- Update README about intensity.
+- Bugfix: Restore always autodetecting stratum as non-scrypt
+- icarus: Replace default of 2 work_division/fpga_count with autodetection of 1,
+2, or 4
+- Update scrypt readme with newer information and to match changes in code.
+- Set default GPU threads to 1 for scrypt.
+- Connect backup stratum pools if the primary pool cannot deliver work.
+- Use a new algorithm for choosing a thread concurrency when none or no shader
+value is specified for scrypt.
+- Do not round up the bufsize to the maximum allocable with scrypt.
+- Remove the rounding-up of the scrypt padbuffer which was not effectual and
+counter-productive on devices with lots of ram, limiting thread concurrencies
+and intensities.
+- Make pool adding while running asynchronous, using the pool test thread
+functionality.
+- Only curl easy cleanup a stratum curl if it exists.
+- Add intermediate variants of cglocks that can be up or downgraded to read or
+write locks and use them for stratum work generation.
+- Move the stratum data to be protected under a new cg_lock data_lock.
+- Convert the ch_lock to cg_lock.
+- Convert the control_lock to a cg_lock.
+- Remove unused qd_lock.
+- Implement cg_lock write biased rwlocks.
+- Don't start testing any pools with the watchpool thread if any of the test
+threads are still active.
+- Set sockd to false should curl setup fail on stratum.
+- Reopen the socket whenever we're retrying stratum.
+- Set pool died on failed testing to allow idle flag and time to be set.
+- Remove unused pthread_t typedefs from struct pool.
+- Perform pool_resus on all pools that are found alive with the test pool
+threads.
+- Use pool_unworkable in select_balanced as well.
+- Differentiate pool_unusable from pool_unworkable.
+- Keep a connection open on higher priority stratum pools to fail back to them.
+- Set the wrong bool in pool_active
+- Only bypass unusable pools if they're not the selected ones.
+- Find the first usable pool in preference to the current pool in select_pool
+for work.
+- Add a pool_unusable function which checks if a pool is stratum but not active
+to use within switch_pools.
+- API no longer ignore send() status
+- API make the main socket non-static
+- Start the stratum thread only if we successfully init and authorise it,
+otherwise unset the init flag.
+- Make the initialisation of the stratum thread more robust allowing the
+watchpool thread safe access to it after the stratum thread is started.
+- Shorten the time before keepalive probes are sent out and how frequently
+they're sent with stratum curls.
+- Display select return value on select fail in stratum thread.
+- Clear the socket of anything in the receive buffer if we're going to retry
+connecting.
+- Perform pool resus on pools that were not set as the initial pool at startup.
+- Allow pools to be resuscitated on first startup by the watchpool thread.
+- Check all pools simultaneously at startup switching to the first alive one to
+speed up startup.
+- Close any sockets opened if we fail to initiate stratum but have opened the
+socket.
+- API use control_lock when switching pools
+- Clear last pool work on switching pools if the current pool supports local
+work generation or we are in failover only mode.
+- make rw locks: mining_thr_lock and devices_lock
+- work queues - remove new but unnecessary functions
+- functions for handling work queues
+- find_work() to find work in devices work queue
+- Add a get_queued function for devices to use to retrieve work items from the
+queued hashtable.
+- Add the choice of hash loop to the device driver, defaulting to hash_sole_work
+if none is specified.
+- Add a driver specific flush_work for queued devices that may have work items
+already queued to abort working on them on the device and discard them.
+- Flush queued work on a restart from the hash database and discard the work
+structs.
+- Create a central point for removal of work items completed by queued device
+drivers.
+- Create a fill_queue function that creates hashtables of as many work items as
+is required by the device driver till it flags the queue full.
+- Create the hash queued work variant for use with devices that are fast enough
+to require a queue.
+- Make sure to do full avalon_init if the device_fd is invalid.
+- Document extra zero byte in avalon_reset.
+- Microoptimise likely paths in avalon_gets.
+- Make sure to set timeout to 100ms instead of 1ms in avalon read loop for
+select.
+- Make sure to get time of first response in avalon read loop.
+- Use select for a reliable timeout in avalon read and don't read 1 byte at a
+time, optimising read loop.
+- We should break on the loop on a work restart in avalon, and only consider all
+errors if we actually have gotten some results.
+- Avalon init on comms error as well.
+- Reinit avalon device in case of FPGA controller mess up.
+- Increase reliability of avalon startup by only opening and resetting the
+device once, looking for the id sequence offset by one byte as well, and still
+ignoring if it's wrong, assuming it is an avalon.
+- Nest avalon_decode functions to avoid doing unnecessary lookups once we have
+found the nonce.
+- Use htole32 wrapper for nonce encoding in avalon.
+- Remove unused rev8 function from avalon driver.
+- Remove const qualifier from driver structs
+- rename device_api -> device_drv and all related api -> drv
+- rename get_proc_by_id() to get_devices()
+- Wrap access to devices array under a mutex
+- Provide wrappers for grabbing of thr value under the mining_thr_lock.
+- mutex all access to mining_thr
+- Split thr_info array into control_thr and mining_thr pointers so more mining
+threads can be added later
+- Update the hashmeter at most 5 times per second.
+- Speed up watchdog interval and therefore display updates to 2 seconds.
+- Add README.GPU to EXTRA_DIST.
+- Split out the GPU specific information from the README into a README.GPU file.
+- Update docs and reorder README to show executive summary near top.
+- Add more FAQs about crossfire.
+- Convert error getting device IDs in ocl code to info log level only since
+multiple platforms may be installed and the error is harmless there.
+- Unnecessary extra array in ocl code.
+- Cope with the highest opencl platform not having usable devices.
+- Update kernel file names signifying changes.
+- Use constants from the array of __constants throughout the diablo kernel.
+- Create a __constant array for use within diablo kernel.
+- Use global constant arrays for all other constants used in scrypt kernel.
+- Use global __constants for sha functions in scrypt kernel.
+- Use constants for endian swap macros.
+- Revise scrypt kernel copyright notice.
+- Separate out additions in scrypt kernel.
+- Reuse some Vals[] variables that can be assigned to constants earlier in the
+poclbm kernel, making for fewer ops.
+- Put all constants used in poclbm kernel into __const memory array to speed up
+concurrent reads on the wavefront.
+- opencl: Support for reading temperature from free software radeon drivers via
+libsensors
+
+
+BFGMiner Version 3.0.3 - June 13, 2013
+
+- make-release: Include all submodules, recursively
+- Remove API.java example (no copyright license)
+- Minimally fix "make install" to ignore bitstream sources
+- Add submodule for ZtexBTCMiner (aka ztex_ufm1_*)
+- Add submodule for X6000_ztex_comm4 (aka x6500-overclocker-0402)
+- ztex: Use standard file header/comment formatting, and update license to GPLv3
+- bitforce: Allow a longer timeout (1250ms) for ZCX (Device Information)
+commands
+- Bugfix: pdcurses doesn't like changing logwin size without clearing it also,
+so do that in display options
+- -S all: Start QueryDosDevices probe with 256-byte buffer
+- Use common code to ensure the prefix of -S *:all remains in all
+implementations of it (/dev glob was removing prefixes)
+- bitforce_queue: Ensure comma following nonce count is there, to error cleanly
+- bitforce: Report queue send failures, and count as hw errors
+- Bugfix: bitforce_queue: Don't try to send ready-to-queue work to device, when
+there is no ready-to-queue work
+- Bugfix: bitforce: Clear want_to_send_queue flag when flushing queue, since we
+can't send an empty queue
+- bitforce: Include new total queued count in flush debugging
+- Bugfix: bitforce_queue: Implement a minimum wait time of 10ms
+- README: Document serial device format for Mac OS X
+- Bugfix: cairnsmore1: Enable building with libudev autodetection even if only
+icarus drivers are enabled
+- Bugfix: sysfs autodetect: Continue searching even after finding one tty (fixes
+multiple ttys per device, such as some Cairnsmore1s)
+- Bugfix: ztex: Avoid destroying libztex device in case other processors are
+still in use (fixes crash when 1.15y becomes unavailable)
+- Update windows-build.txt
+- ccan: Add missing copyright comment headers
+- Remove obsolete mknsis.sh
+- Add missing copyright sections to files that may need them
+- Standard copyright format (including year) for adl_functions.h
+- Bugfix: When disabling device, ensure its prev_work (if any) gets freed
+properly
+- Check stratum socket exists and is writable before even considering whether
+the sessionid is the same or not
+- Bugfix: Check that the stratum_share struct for a failed submission is still
+in the submission hashtable before trying to delete it
+- README: Add missing documentation for CPU algorithms cryptopp_asm32, sse2_32,
+and altivec_4way
+- Bugfix: icarus: Check work restart before timeout
+- Bugfix: icarus: Debuglog the correct read timeout (and omit from work restart
+since there's no trivial way to get it)
+- README: Update links
+- Bugfix: cpu: Fix warning on Win64
+- Bugfix: avalon: Strict formatting
+- Bugfix: Cleanup trivial warnings
+- Bugfix: bitforce: Seek to end of nonce counter to find nonces, in case there
+are more than 9
+- Bugfix: Build hexdump.c into the project normally like everything else
+- Bugfix: Really fix device entries in saved config file
+- Update the write config to properly record device entries and remove disabled
+option.
+- avalon: Really fix applog formatting
+- va_copy is meant to be matched by a va_end in log_generic.
+- Further fix distdir for hexdump.c
+- Fulltest is true if value is <= target.
+- Fix warning with no curses built in.
+- Bugfix: configure: Check NEED_FPGAUTILS correctly
+- configure: Better grammar for --enable-cpumining help
+- Bugfix: Check for SSE 4.1 support before building sse4_64 asm CPU miner (uses
+MOVNTDQA instruction)
+- Bugfix: elist: Use uintptr_t for member offset
+- Bugfix: opencl/adl: Fix format string
+- Bugfix: opencl: Correct usage of formatted prints
+- Increase fd limits as much as possible at startup
+- Bugfix: bitforce: bulk queue: Cleanly retry for high temperature recovery
+- Fixed deps for raring, which has newer libudev1.
+- bitforce: debuglog actual result data
+- Bugfix: Missing 'else' can result in null pointer dereference in race
+- Minor grammo in avalon driver.
+- Make avalon temperature reading LOG_INFO level.
+- Fix the problem of seting up termio of ttyUSB0 for icarus. the CSIZE is the
+mask of CS2/4/8
+- bufsize is an unsigned integer, make it so for debug.
+- Bugfix: bitforce: Include get_api_stats in BQUEUE mode
+- Bugfix: Always compile support for commandline --temp-target and
+--temp-cutoff, and write them in the config for all devices
+- Bugfix: Ensure cURL timers get set correctly in submission thread
+- Bugfix: modminer: Remove unused parameter to sprintf
+- Bugfix: modminer: Use correct format for bytes left in bitstream upload
+message
+- Bugfix: Access strategy name string directly instead of accidentally
+- Add printf-format syntax checks to more functions that should use it
+- AUTHORS: Add more contributors
+- Support configure flag --with-system-libblkmaker to allow building without the
+bundled copy
+- Bugfix: Use HTTP/1.1 compatible product token for User-Agent header
+
+
+BFGMiner Version 3.0.2 - April 28, 2013
+
+- Receive failures in recv_line should unconditionally fail.
+- Use sock_blocks function for stratum send and receive.
+- Avoid applog under stratum_lock in __stratum_send.
+- Create an OS specific sock_blocks function.
+- There should be no error response code with return value 0 in recv_line.
+- Check for errors on stratum recv for any recv return value less than 1 and
+only parse the response if it's positive.
+- Avoid applog under stratum_lock in recv_line.
+
+
+BFGMiner Version 3.0.1 - April 24, 2013
+
+- Bugfix: configure: Move actual roundl macro back to miner.h after math.h
+should be included
+- Bugfix: configure: Use dummy pointer to correctly detect roundl when conftest
+main is missing argc parameter
+- Bugfix: configure: Use variable argument to roundl to prevent compilers from
+optimizing it out entirely
+- Remove bitstreams from Windows binary distributions (README directs users to
+download source and copy them)
+- make-release: Remove autom4te.cache from distributed source
+- Bugfix: Omit --no-opencl-binaries option from build if OpenCL is not being
+compiled
+- Bugfix: Check that all pools have URIs set before starting
+- Bugfix: bitforce: Make noncebuf large enough for max qresults +1 (for OK line)
+- opencl: Ability to avoid using binary kernels with new --no-opencl-binaries
+option
+- README: Include jansson PKG_CONFIG_PATH in example for Mac
+- Include trailing \0 with coinbase sigs if there's room
+- Differentiate socket closed from socket error in recv_line.
+- Add new best share info to verbose logging.
+- Add notice for when network diff is changed.
+- convert sleep(const) to nmsleep()
+- Rename longpoll threads according to what pool they're associated with
+- miner.php report 'Last Valid Work' as time before request
+- API V1.25 - add 'Last Valid Work' time for each device
+- add 'count' to customsummarypage 'calc'
+- Bugfix: ztex: Initialize fw_buf pointer to NULL so a free before allocation is
+safe
+- Cleanup when stratum curl fails to initialise.
+- LTC text typo
+- Recreate cURL for new stratum connections, and clear stratum_notify on
+suspending them
+- clear_stratum_shares: Rename diff_stale variable to diff_cleared
+- MMQ it's a bitstream
+- Update a pool's last work time when the work is popped as well as staged.
+- Extend stratum connections another minute (total 2 minutes) after the last
+work item was staged, and maintain last_work_time for non-stratum pools.
+- Fix --benchmark generating valid work for cgminer.
+- Bugfix: Correct pdbuilder result directory
+- Omit add_serial_all code when serial support is not wanted
+- Use configure to detect presence of roundl to avoid redefining an actual
+function (possibly inline)
+- Bugfix: roundl: Add needed parenthesis to perform ?: before +
+- Bugfix: ft232r: Defer allocating structure until after USB endpoint is
+successfully opened, so it won't leak in case of failure
+- Bugfix: ztex: Free bitstream in memory when done with it
+- Bugfix: Safely handle all-space cURL debug messages, should they ever happen
+- Silence warnings about poor format usage for quit()
+- Apply noreturn and printf-format attributes to quit() function definition
+- Bugfix: set_serial_rts get flags to manipulate them correctly
+- Bugfix: Missing return for /dev globbing
+- Bugfix: Free unused work when retrying failed lp request
+- Display processor name with thread disabled/re-enabled messages
+- Move best share to top summary line, and add network difficulty to block line
+- opencl: Default to phatk kernel for Mesa platform
+- opencl: Default to single thread with Mesa OpenCL
+- opencl: Check for Mesa OpenCL and avoid using binary kernels with it
+- bitforce: Never increase bulkqueue poll wait time during queue underruns
+- bitforce: Start off polling bulk queue every 100ms
+- bitforce: Log device queue size after getting bulk results
+- bitforce: Ensure bulkqueue polling occurs at least once a second
+- opencl: Include OpenCL platform in kernel binary filenames
+- bitforce: Use bulk queue mode for all SC devices
+- Bugfix: bitforce: When reinitializing, free all known works to avoid
+decrementing reset queued counter
+- bitforce: Handle timeout during ZOX as cleanly as possible
+- Bugfix: bitforce: Make reinitialization more complete and safe
+- Bugfix: bitforce: Close opened fd if reinit fails
+- Bugfix: bitforce: Retry ZGX until device is NOT busy
+- bitforce: Log when zero queued results are received
+
+
+BFGMiner Version 3.0.0 - April 5, 2013
+
+- Update libblkmaker to 0.3.0
+- debian: Include new api-example.py in docs
+- added example for Python using the RPC API
+- added SPEC file for SUSE distributions
+- Bugfix: bitforce: Free initialization data to avoid trivial one-time memory
+leak
+- Support for local submission of found blocks (GBT only)
+- bitforce: RPC pgaset fanmode 0-5 for manual fan control
+- bitforce: More debugging information
+- Bugfix: modminer: Since RPC always includes the temperature, we don't need to
+add it specially
+- bitforce: Expose dual temperature sensors to RPC
+- bitforce: Support for up to 2 temperature sensors per processor
+- Bugfix: bitforce: BFP_QUEUE: Attempt to recover from extra queue results, or
+the next job finishing early
+- bitforce: Always send a new job ASAP after flushing the queue
+- bitforce: Implement "Queue Job Pack" (ZWX) and use it for XLINK devices to
+avoid USB latency issues
+- bitforce: Ignore INPROCESS added to ZOX response
+- Implement minerloop_queue for devices that process work items too fast to keep
+track of which one they're currently working on
+- bitforce: Split ZOX command into its own function
+- Bugfix: DevAPI: Free work when preparing it fails
+- DevAPI: Abstract get_and_prepare_work for minerloops
+- DevAPI: Move select() logic from minerloop_async to do_notifier_select
+- Clarify stratum mining.set_difficulty debug log message
+- No longer call configure from autogen.sh
+- Bugfix: bitforce: Ensure result_busy_polled gets set for queue mode to avoid
+unnecessary 10ms wait times
+- Bugfix: bitforce: Use common code for end of job_get_results, so queue results
+don't short-circuit timing code
+- Bugfix: bitforce: Ensure "OK" doesn't remain in queued results buffer
+- Bugfix: bitforce: next_line needs to increment beyond the newline character
+- Update README for x970 memdiff values.
+- Do not scan other gpu platforms if one is specified.
+- Update README for sync objects on windows.
+- Add information for setting gpu max alloc and sync parameters for windows with
+scrypt.
+- Whitelist AMD APP SDK 2.8 for diablo kernel.
+- Show pool number in switch message
+- Clear just the socket buffer when we don't care what is left in a stratum
+socket.
+- Clear the stratum socket whenever we are closing it since the buffer is going
+to be reused.
+- Do not continue work from a stratum pool where the connection has been
+interrupted.
+- Close any existing stratum socket if we are attempting to restart stratum so
+the pool knows the connection has gone.
+- Show mechanism of stratum interruption if select times out.
+- Make stratum connection interrupted message higher priority to be visible at
+normal logging levels.
+- API add 'Network Difficulty' to 'coin'
+- avalon: if all result are wrong in one batch read. reinit the avalon
+- avalon: record the last result temperature info
+- delay when close avalon; only record matched result
+- avalon: fix no_matching_work only count when debug
+- avalon: minor change
+- avalon: add idle code
+- avalon: fliter the temp_max >= 100, print the result for debug.
+- avalon: export more data to API stats
+- avalon: add default chip frequency
+- avalon: fix the work_i3 init
+- avalon: add reinit_device
+- avalon: the temp_history_count base on timeout
+- avalon: fix mistake on adjest_fan
+- avalon.c: fix the copyright
+- bfgminer-rpc: add -o option: no format, only the result
+- avalon: update fan pwm
+- avalon: update the FAN_PWM MAX/MIN
+- avalon: minor change
+- avalon: overclock code
+- avalon: fix the display
+- avalon: minor change
+- avalon: fix the fan/temp control
+- avalon: fix the temp_avg
+- avalon: fix temp
+- avalon: add fan/temp control
+- avalon: add FAN speed factor
+- avalon: add TODO on fan/temp control. cleanup detect
+- avalon: add the gate_miner bits
+- avalon: only send one byte on reset
+- avalon: add support on send 2 bulk taskes at begin
+- avalon: fix the hash_count return
+- avalon: fix the LOG_WARNING
+- avalon: add comment on hash_count
+- avalon: WORKAROUND on hashrate
+- avalon: update max miner_num
+- avalon: add more info on api
+- avalon: add nonce_elf and more info on match miner_num
+- avalon: change reset to 300ms
+- avalon: move bulk buffer to it's info structrue
+- avalon: more work on hashrate and read_count
+- avalon: add baud 38400 support
+- avalon: fix nonce_range EB
+- avalon: fix the hashrate wrong
+- more info on avalon API
+- avalon: fix the nonce_range EL
+- avalon: fix the read count
+- avalon: more work on nonce_range
+- avalon: read() times and send delay fixed
+- avalon: add the send delay option
+- avalon: print out fan/temp info
+- avalon: add the result info (fan/temp etc)
+- avalon: more check on hardware error
+- avalon: more work on get_work_count
+- avalon: now we have dynamic get_work_count
+- avalon: more work on parameters
+- avalon: add timeout parameter
+- avalon: baud as parameter now
+- avalon: send work pitch should be : (15*(8+2)*4/19200)s
+- avalon: more work on match work
+- avalon: fix free_work
+- avalon: continue on reset work. wait for buffer empty
+- avalon: add options, if write() error. sleep(1) before reset()
+- avalon: more cleanup
+- avalon: finish read when Buffer empty
+- avalon: fix the nonce EB issue
+- avalon: MORE work
+- avalon: fix the EB/LB issue
+- avalon: some cleanup
+- avalon: fix the first configure task
+- more work on the avalon buffer
+- avalon: fix the BIG_ENDIAN issue
+- avalon: Fix the buffer statu
+- change defines to avalon parameters
+- fix the cts return
+- avalon: change the data to uint8_t, add some test temp code
+- avalon: fix task init
+- avalon: more data format work
+- change to avalon data format
+- debug: add a debug hexdump.c
+- avalon: add some code on match work
+- avalon: try to correct the pool_status and dev_status
+- avalon: more work on multi-works
+- avalon: more work on read
+- avalon: more work on get results
+- more RTS code on avalon.c/h
+- more RTS code
+- avalon: some cleanup
+- avalon: more work on new work queue structrue
+- fpgautils.c: use lancelot as target
+- avalon: since we submit task as bulk data. modify again
+- add scanhash_queue
+- renmae avalon.h to driver-avalon.h
+- fpgautils.c: add get_serial_cts
+- understand the avalon protocol more
+- avalon: new software structrue but target as lancelot
+- add avalon.h
+- avalon: fix warning
+- avalon: add TODO comments
+- more AVALON defines
+- avalon: more work
+- add driver-avalon.c
+- add avalon support to automake
+- Default to work queue mode on BitForce SC devices
+- bitforce: Implement support for non-contiguous XLINK slave addressing
+- gnulib: stdint: fix build with Android's Bionic fox x86
+- gnulib: stdint: Improve support for Android.
+- gnulib: stdint: Add support for Android.
+- Check for ?e##toh macros independently from hto?e##
+- If pthread_cancel is missing/emulated, set asynchronous thread cancel type on
+stage, watchdog, watchpool, and longpoll threads since the emulation cannot
+support deferred cancellation
+- If pthread_cancel is missing (Bionic/Android), emulate it using pthread_kill
+and pthread_exit
+- configure: Intelligently detect what flags/libs get us working pthread, and
+define HAVE_PTHREAD_CANCEL if pthread_cancel is available
+- Bugfix: Initialize mutex_request to invalid so devices that don't use it
+(bitforce) don't try to
+- RPC: pools: Add "Message" to show last client.show_message received over
+stratum
+- Stratum: Support client.show_message method
+- Don't retry without resume support, if the first attempt just timed out
+- Bugfix: minerloop_async: Intelligently handle work updates and device disables
+during transitions
+- Bugfix: minerloop_async: Free old (unused) prepared work when replacing it
+with an upgraded one
+- Bugfix: Free pool sessionid before replacing it
+- Bugfix: Stratum: Address dereference-after-free and memory leak introduced in
+resume support
+- Stratum: If old protocol fails as well, try to resume again next time around
+- Bugfix: Stratum: Only failover to old mining.subscribe protocol if the
+previous attempt was the new one (fixes a flood of retries)
+- Try to extract the sessionid associated with mining.notify on 3rd level array
+and submit it along with the userid to support mining resume, failing gracefully
+and restarting if the pool rejects it.
+- Cope with misread sessionid on stratum for now.
+- Use the sessionid as passed on stratum connect to attempt to resume a
+connection once and then clear it if it fails, to use a new connection.
+- Move to storing the nonce1 in the work struct instead of the sessionid for the
+now defunct first draft mining.resume protocol.
+- Only continue submitting shares with mining.resume support on stratum when the
+session id matches.
+- Provide support for mining.resume with stratum, currently re-authorising after
+successful resumption pending finalising of the protocol process.
+- Provide basic framework for restarting stratum depending on whether resume
+support exists or not.
+- Abstract out the setting up of the stratum curl socket.
+- Remove redundant setting of strings to NULL since the whole work struct is
+zeroed.
+- Only clear stratum shares mandatorily on stratum dropouts when the pool does
+not support resume.
+- Stratum: Keep trying to submit shares, even across reconnects
+- Use new select loop primitives in submission thread
+- Bugfix: Missing pool_no parameter to applog for no-stratum-sessionid debug
+message
+- Do as much outside of mutex locking of sshare_lock as possible.
+- Remove last reference to struct work used outside the sshare_lock in
+submit_work_thread
+- Unlock the sshare_lock in submit_work_thread when all references to work and
+sshare are complete.
+- Bugfix: Copy and free sessionid on work objects
+- Add timestamps to stratum_share structs as they're generated and copy the
+stratum sessionid if it exists to stratum work generated.
+- Store session id for stratum if the pool supports it for future mining.resume
+support.
+- Keep the unique id of each work item across copy_work to prevent multiple work
+items having the same id.
+- x6500: Never consider processors idle if they're enabled
+- x6500: Make mutex management cleaner by blocking device select loop during
+idle get_stats
+- Bugfix: minerloop_async: Always refer to real thread for select loop
+- Bugfix: Initialize work_restart_notifier[1] to INVSOCK instead of -1 to be
+portable
+- ztex: Use restart_wait to react quicker to work updates
+- Handy TIMEVAL_USECS macro
+- Restore blocking restart_wait function with nearly identical semantics as old
+one
+- Bugfix: bitforce: Rework sleep delay adjustment logic to properly deal with
+more accurate timing readings (added in device API update)
+- Hidden --force-rollntime option for getwork pools (use like --pool-priority,
+after each pool definition)
+- Include processor id in get_work logging
+- Support for BIP23 BPE request target extension via new --request-diff option
+- Hidden option to reduce "work update" messages to debug level:
+--quiet-work-updates
+- Change "work restart" to "work update" in messages to reflect reality more
+accurately (no work is lost), and normalize case of "longpoll"
+- HACK: Since get_work still blocks, reportin all processors dependent on this
+thread
+- Move FD_SETSIZE definition to configure so it affects everywhere it needs to
+- Move absolute_uri function to util.c
+- Remove now-unused blocking-wait code (restart_cond, restart_wait, and
+stale_wait)
+- Bugfix: bitforce: Zero hashes complete if we get an invalid response
+- HACK: Since get_work still blocks, reportout all processors dependent on this
+thread
+- bitforce: Support for work queue protocol on BitForce SC devices
+- Use new double-stage format for SC devices
+- modminer+x6500: Expose frequencies to API in terms of MHz to be consistent
+with ztex driver and cgminer
+- bitforce: Replace (bool)cgpu->nonce_range with (enum)bitforce_data->proto
+- bitforce: XLINK support for multiple processors
+- bitforce: Prepare log messages for XLINK by separating into proc and dev
+messages
+- bitforce: Always use fd/mutex pointers on actual device, to prepare for XLINK
+support
+- bitforce: Get fd/mutex pointers only once per function
+- bitforce: Abstract commands to bitforce_cmd1 (single-stage) and bitforce_cmd2
+(double-stage) functions
+- bitforce: Debuglog device information during detection
+- Bugfix: Missing includes needed on Windows
+- Bugfix: Use waddstr instead of wprintw to display completed device summary
+line, so literal %s don't get interpreted as formatting options
+- Bugfix: bitforce: Avoid polling continuously between work restart and job
+completion
+- bitforce: Use poll device API when job_get_results needs to wait
+- bitforce: Use poll device API when job_start needs to wait
+- stale_work_future function to determine in advance if a work/share will be
+stale at some future time
+- bitforce: Minimally refactor to adapt to new minerloop_async
+- minerloop_async: Break out of select on work_restart_notifier
+- Replace UNIX-only work_restart_fd pipe with portable work_restart_notifier
+- Bugfix: Clean out unused variables from minerloop_async
+- Move new device API code to new deviceapi.c source file
+- Make minerloop_async more async, using some callbacks to handle event
+completions
+- Split part of minerloop_async into do_get_results, and a bit other
+reorganization
+- Abstract select_timeout function to convert a realtime timeval to a timeout
+pointer for select()
+- Split part of minerloop_async into do_process_results, and don't allow
+api->job_get_results to return hashes
+- Split part of minerloop_async into do_job_prepare and do_job_start
+- Initialize thr->tv_poll to -1 (disabled)
+- Update the hashmeter one last time before disabling a device
+- minerloop_async: Break out of select for wakeup notifications
+- Replace mining thread queues (which were only used for wakeup pings) with
+notifiers (which can be used with select and co)
+- Unify all mining thread wakeup to mt_enable (simplifying code)
+- Bugfix: get_statline: Correct device summary status, only showing DEAD or OFF
+if it affects all processors
+- Working processor disable/enable with new async minerloop (currently gets
+stuck if all processors disabled)
+- Bugfix: get_statline: Only care about the processor status if
+--show-processors is set
+- Bugfix: watchdog: Use processor thr_info even if it isn't a real thread
+- Only support thread-per-device or N-threads-per-processor; simplify
+work_restart check
+- x6500: Remove mutex, since driver is single-threaded now
+- Bugfix: Update utility every get_statline call, and include every processor
+involved
+- HACKING: New text file to document the internal workings of (currently) the
+device API
+- Bugfix: mining_threads is now a total of thr_info objects, not necessarily
+actual running threads
+- x6500: Working (but incomplete) asynchronous/single-threaded driver
+- Incomplete (but workable) asynchronous minerloop
+- Core support for managing multiple processors from a single thread
+- Allow device drivers to implement their own minerloop
+- Move cgpu_info and thr_info initialization to main, and ensure all get
+initialized before starting any threads
+- Refactor and simplify miner_thread (no major behavioural changes)
+- Move difficulties to end of share result message, so they can be made to line
+up nicely
+- Bugfix: Consolidate share result message code (including fixing displayed
+hash portion for stratum)
+- miner.php: Include ProcID in Device column as a letter
+- Show summaries per-device unless --show-processors is used (also available on
+Display TUI menu)
+- Order next_proc linked list in processor id order
+- Consolidate processor summary line generation for TUI and text-only modes
+- RPC: Update to include ProcID so multiprocessor devices can be understood
+correctly
+- RPC: Common function for adding device-identifying fields
+- modminer: Make single-processor statline look like other temperature-only
+statlines
+- modminer: Split each FPGA into its own logical processor (in the same device
+still)
+- modminer: Get mutex pointer only once per function
+- ztex: Combine master+slave devices into a single multiprocessor device
+- Preformat dev_repr (device representation) and proc_repr (processor
+representation) once for use everywhere
+- x6500: Split each FPGA into its own logical processor (in the same device
+still)
+- x6500: Get mutex pointer only once per function
+- Minimal support for defining devices with multiple logical processors
+- Rename all README files to standard README.* style
+
+
+BFGMiner Version 2.10.6 - April 5, 2013
+
+- Bugfix: Restore missing variable
+- Bugfix: openwrt: Never include _ in platform name
+- Bugfix: Fixed typo in bfgminer-rpc usage
+- pool_active: Ensure temporary curl is always cleaned up
+- Try to find jansson via pkg-config first, and fall back to checking system
+defaults if that fails
+- Attempt to find libjansson via pkg-config if AC_CHECK_LIB fails
+- Update scrypt readme re drivers and sdk.
+- Bugfix: README: Move --device out of GPU only options
+- Update .gitignore
+- Added bfgminer-rpc binary to .gitignore
+- Bugfix: Actually change to the newly selected pool when statum is inactive and
+it decides to change
+- Bugfix: modminer: Properly fail on dynclock error
+- Bugfix: opencl: Clean pc_data->work before freeing pc_data
+- Bugfix: Correct order of libblkmaker libraries so static builds work
+- Bugfix: Need to ensure __BIG_ENDIAN__ is defined before including uthash.h
+- Bugfix: Stratum: When destroying cURL easy handle, be sure to clear pool
+stratum_curl pointer
+- Bugfix: bitforce: Fix warning
+- Bugfix: Stratum: Properly handle non-integer "id" for client.get_version
+requests
+- json_dumps_ANY utility function to portably implement json_dumps(..., ... |
+JSON_ENCODE_ANY)
+- Bugfix: bitforce: Free old name when updating it on reinitialization
+- Stratum: Include pool number in send/recv protocol logging
+- Include pool number in stratum thread name
+- API always report failed send() replies
+- API.java allow partial reads
+- Bugfix: Stratum: Use curl_easy_cleanup to close connection, so cURL
+understands what is going on
+- Bugfix: hash_pop: If a work should be rolled, use a clone of it rather than
+consume a rollable work
+- openwrt: Move Makefile into a bfgminer subdirectory to avoid symlinking issues
+- openwrt: Use --with-curses=ncurses to avoid ncursesw dependency
+- configure: Support --with-curses=FOO to look for curses implementation in
+libFOO
+- Set pool socket to INVSOCK after closing connection, just in case
+- Clean up compiler warnings
+- Bugfix: Check that pool is active one last time before selecting it
+- Bugfix: Trim whitespace (like newlines) off the end of debug info from
+libcurl
+- Bugfix: submit_nonce: Backup the original work->blk.nonce since the miner
+code uses it to track work consumption
+- Bugfix: Scheduler needs to unpause disabled devices, even if it isn't waking
+them up
+- Bugfix: Use SOCKETTYPE for notifiers, to avoid potential overflow on Win64
+- Bugfix: Some versions of MingW define localtime_r, but don't handle the
+timeval.tv_sec case that we use; so undef any preexisting one and use our own
+- Bugfix: reinit_gpu: Remember the selected device to correctly change
+properties of
+- Bugfix: cpu: reinit_device hasn't worked since 93b284d, so just remove it
+entirely instead of letting it screw with thread 0
+- Document necessity to run ldconfig and possibly configure ld.so
+- Bugfix: Complete startup after just one pool is found active, no need to wait
+for the rest
+- Bugfix: Update links
+- miner.php: Replace PGA dev number with concatenated device ID
+- Bugfix: miner.php: Display devices with aligned columns instead of assuming
+they come out of the RPC aligned
+- Bugfix: miner.php: Silence PHP "local timezone" warning
+- Bugfix: api-example: Try to use BSD sockets on any non-Windows platform
+- Bugfix: stratum: Delay mining.get_transactions request until after auth has
+succeeded, so its failure doesn't abort the connection (also avoids any delay
+from a large result)
+- --no-getwork option to disable getwork protocol support
+- Clarify dependencies with Debian/Ubuntu package names
+
+
+BFGMiner Version 2.10.5 - February 8, 2013
+
+- Bugfix: Actually increment template_nonce when we use it
+- Change file modes.
+- Fix logic fail on partial writes with stratum send that was leading to corrupt
+message submissions.
+
+
+BFGMiner Version 2.10.4 - February 7, 2013
+
+- New platform ports: OpenWrt and Win64
+- Update official Windows build compiler and libraries:
+- - Upgrade GCC from 4.6.3 to 4.7.2
+- - Upgrade libusbx from 1.0.10 to 1.0.14
+- - Upgrade jansson from 2.3.1 to 2.4
+- - Upgrade libcurl from 7.26.0 to 7.28.1
+- - Upgrade pthreads-win32 from 2.8.0 to 2.9.1
+- Bugfix: Release libudev handle when ID_MODEL doesn't match what we're looking
+for
+- openwrt: Script to build for multiple platforms easily
+- openwrt: Bitstreams should be "all" arch
+- Working OpenWrt Buildroot Makefile
+- Do not enable the pool disable on reject feature unless explicitly enabled
+with --disable-rejecting.
+- Check for calloc failure for completeness in gen_stratum_work.
+- Cache the coinbase length to speed up stratum work generation.
+- Cache the header length when generating stratum work to avoid calculating it
+on every work generation, and to only need one alloc+sprintf, speeding up work
+generation.
+- Use heap ram for coinbase in gen_stratum_work, zeroing it before use.
+- Provide a wrapper for aligning lengths of size_t to 4 byte boundaries.
+- Bugfix: ztex: While 1.15y can finish highspeed FPGA config immediately, at
+least 1.15x needs some delay
+- Use CURLOPT_OPENSOCKETFUNCTION to intercept the socket being created for
+stratum, in order to workaround CURLINFO_LASTSOCKET breakage on Win64
+- make-release: Update for Win64 and bfgminer-rpc.exe
+- Use localtime_r instead of localtime, including a Windows implementation that
+handles Win64's broken struct timeval.tv_sec
+- Use standard execv arg type on Win64
+- Bugfix: Correct various size mismatches
+- Ensure winsock2.h is always included before windows.h
+- Bugfix: Add necessary Winsock library to bfgminer-rpc linking
+- Bugfix: Remove dependencies of compat.h on miner.h for Windows (moves
+timersub/timeradd to compat.h where it belongs)
+- modminer: Raise default/maximum clocks to 210 and 250 respectively
+- modminer: Use better-performing X6500 overclocker bitstream
+- Disable libusb linkage/usage when neither X6500 nor ZTEX support is desired
+- Add support for "--scan-serial all" via simply globbing /dev
+- fpgautils: serial_autodetect implementation using sysfs
+- fpgautils: Unified serial_autodetect function to find a serial device
+regardless of the underlying method
+- fpgautils: Look for bitstreams in ../share/bfgminer/ too
+- Bugfix: Ensure curses library is always linked in NCURSES_LIBS, to avoid
+unnecessary dependencies for (non-curses) tools
+- Bugfix: GBT: work->data is always little-endian, but libblkmaker wants the
+nonce in native-endian
+- Bugfix: cpu: Corrections necessary to get 'c' and 'cryptopp' algorithms
+working on big endian
+- Bugfix: Sanity check for bits exponent in real_block_target
+- Bugfix: cpu: Increment nonce after checking (rather than before), to avoid
+skipping the first nonce of each scanhash call
+- cpu: via: Only swap back the nonce, rather than all data
+- cpu: Minor optimization by checking H==0 before calling fulltest
+- Bugfix: Skip yasm check when building for non-x86 platforms
+- Allow --scantime alias to --scan-time
+- Build bfgminer-rpc program from api-example.c
+- Bugfix: Remove miner.h include from api-example.c since it isn't needed and
+pulls in libblkmaker
+- Make wrapping consistent at 79-80 characters per line
+- Bugfix: Correct numerous misspellings, typos, etc
+- Bugfix: Prefer using a non-frozen mining thread for watchdog
+- Bugfix: x6500: Expose x6500_fpga_data even if JTAG reset/detect fail, since
+it is still used to store temperature info if the other FPGA initializes
+- Adding ZTEX Windows guide from Jason Snell
+
+
+BFGMiner Version 2.10.3 - January 22, 2013
+
+- Revert "x6500: Whenever we get a hardware error, purge buffers just in case
+of read/write desync"
+- Bugfix: libblkmaker: Check that zero-padding on base58check input matches
+output (needed to properly reject addresses with too many or too few prefix/pad
+'1's)
+- Bugfix: Free bin2hex output in __update_block_title
+- Bugfix: Allocate space for the terminating null byte on new current_hash
+- Display tail end of prevblock hash rather than start+32bits
+- Try to extract block height from coinbase scriptSig, when mining stratum
+- Display next block height when using GBT
+- Use suffixes for target-difficulty also, in share accept/reject loglines
+- Bugfix: Implement common target_diff function, fixing scrypt-specific bugs in
+and simplifying common code shared by set_blockdiff, calc_diff, and share_diff
+- Set DISPLAY to :0 by default (on non-Windows)
+- Bugfix: Reset pool bytes received when zeroing stats
+- miner.php trim trailing zeros on some of the STATS numbers
+- Semi-Cherrypick: API stats - include pool network bytes + in miner.php
+- Best Share readme
+- API zero - zero statistics - all or bestshare - with optional on screen
+summary
+- api.c pgaenable not re-enabling the device - plus related debug
+- diffexactone pool diff1 used for share value calculation is ffffffff... not
+100000000... :P
+- miner.php user/pass fix 'usr' is readonly
+- miner.php optional user/pass login restrictions
+- zero (most) API stats
+- Remember best share per pool and return in API pools
+- ztex: precheck the secondary solutions to avoid hw errors the ztex bitstreams
+gives back the latest checked nonce and its hash7 value and two possible
+solutions.
+- Bugfix: configure: if blocks require at least one command, so fill with true
+- Bugfix: Only log stratum resume if it was actually "idle" before
+- Zero the best share string memory when zeroing stats.
+- Change the pool stratum socket buffer to new cgminer implementation, to
+allocate it in a grow-only fashon and reduce virtual memory fragmentation at
+the expense of CPU time.
+- Differentiate socket full from sock full.
+- Allow stratum to startup without notify but check it is valid before creating
+stratum work.
+- Do not try to generate stratum work unless the notify command has succeeded.
+- Document Mac OS X configure usage with Homebrew pkg-config path
+- Clean up post-configure display of compile environment
+- Bugfix: If native ncurses detection fails, print "none?" result before moving
+on to try AC_SEARCH_LIBS scan
+- Fix more printf-format non-compatibilities
+- Update windows-build.txt
+
+
+BFGMiner Version 2.10.2 - December 27, 2012
+
+- Update documentation to include block difficulty
+- Reset all stats when requested
+- Reset total diff1 shares when zeroing stats as well to show correct work
+utility.
+- Update documentation.
+- Parse anything in the stratum socket if it's full without waiting. Empty the
+socket even if a connection is not needed in case there are share returns.
+- Provide a mechanism to zero all the statistics from the menu.
+- Display the current pool diff in the status line.
+- Display block diff in status line.
+- Generalise the code for solving a block to enable block solve detection with
+scrypt mining.
+- Generate the output hash for scrypt as well and use the one function to set
+share_diff.
+- Use one size for scratchbuf as a macro in scrypt.c
+- Remove the unused sha224 functions.
+- Check staged_rollable under staged lock, when cloning available work.
+- scrypt_diff uses a uint64_t as well.
+- Correct target for stratum support with scrypt mining.
+- Bugfix: Ensure nonces are put in data as little-endian in test_nonce*
+- Add low-level debugging info for data_buffer (some only enabled with
+-DDEBUG_DATABUF)
+- Make all_data_cb fwrite-compliant by returning nmembs, and check for unlikely
+overflows
+- Bugfix: Need to do extract_sockaddr before trying to initiate stratum
+(erroneous http URI usage, except at startup)
+- Bugfix: Update last GBT work in pool_active before staging it, since otherwise
+it could possibly be consumed before we copy it
+- Bugfix: Address Windows-specific formatting issues (including lack of support
+for %ll*)
+- Bugfix: ztex: Correct formatting for reset failure error
+- ztex: Fix formatting in a debug message
+- cairnsmore: Don't bother timing dynclock detection, since there's no standard
+way to log it accurately
+- Correct formatting in FPGA drivers
+- opencl/adl: Fix formatting to fit strict rules
+- Explicitly cast all_data.buf to char* for debug printing
+- Follow strict time_t handling rules
+- Use GNU format-checking attribute when available for applog
+
+
+BFGMiner Version 2.10.1 - December 21, 2012
+
+- libztex: fixed a typo
+- libztex: check returnvalue of libusb_claim_interface() and release the
+interface in case of early exit
+- Bugfix: submissions: Skip FD_ISSET when fd==-1 (let the next select setup deal
+with cleaning them out)
+- Bugfix: Remove sws from write_sws list when discarding it due to pre-send
+stratum disconnection
+- Bugfix: Shutdown stratum socket when initiate fails, so it doesn't linger
+- Bugfix: Clear stratum receive buffer when initializing, in case there was
+extra unprocessed data in it from a previous connection
+- Stop all work from the current pool if it's a stratum pool once it is
+disconnected since it will be invalid upon reconnecting.
+- Discard all staged work from stratum pools as well as the shares upon
+disconnection since all the work becomes invalid.
+- Use correct cbreak after 15 second delay when no pool is found alive.
+- modminer: Set default clock frequency to user request so it sticks better
+- modminer: Make valid frequency range consistent: 2-230
+- Allow stratum to work with scrypt.
+- MMQ add api pgaset for clock
+- API V1.23 - new pgaset command, to be used soon
+- Protect the best_share/best_diff values under control lock.
+- Bugfix: modminer: Return failure to change frequency when device reports it
+- opencl: Look in the right place for OpenCL library on Mac OS X
+- Bugfix: AC_C_BIGENDIAN is reported to have problems, and invasive even if
+buried in a conditional, so don't use it
+- Bugfix: Check for bswap_* first, to avoid redefinition based on other variants
+- Bugfix: autoheader isn't smart enough to figure out variable defines, so use
+AH_TEMPLATE for each possible header
+- Check a stratum pool hasn't gone dead while being a backup pool and missed
+having its idle flag cleared.
+- Fix null pointer issue when one chip on an X6500 is not initialized yet when
+reading temperature.
+- Hot-patch broken libcurl pkgconfig CFLAGS found in libcurl's Windows binaries
+- Update OpenCL 1.2 headers from http://www.khronos.org/registry/cl/api/1.2/
+- Reorganize detection of platform byteswap macros and endian to be more robust
+using autoconf
+- Move new bandwidth-based Efficiency to status line
+- Replace work-based efficiency with new bandwidth-based efficiency
+- Bugfix: Pull out GBT request collapsing since it is no longer needed with new
+get_work main loop
+- Bugfix: Free unused work when waiting on external GBT request
+- README: Explicitly mention automake dependency
+- README: Update AMD APP SDK URIs
+- Bugfix: Free shares discarded before beginning submission
+- Bugfix: Discard stratum shares waiting for a writable socket, if the pool
+disconnects in the meantime
+- Bugfix: Always let watchpool thread handle dead pool recovery (including for
+stratum-only pools)
+- Bugfix: Avoid lingering stratum_auth when connection is lost
+- API-README explain custom page extensions in miner.php
+- miner.php add a sample group pool report
+- miner.php allow where,group,having on cumstom pages
+- Bugfix: Hook CURLOPT_DEBUGFUNCTION to count actual bytes sent/received by
+libcurl
+- Bugfix: Reset pool transparency_time when connecting to stratum
+- Bugfix: Immediately discard shares found on disconnected stratum pools, since
+there is no way to submit them
+- Bugfix: Decrement total_submitting when stale shares are discarded before any
+submission attempts
+- Bugfix: Only try to compare stratum job_id for work that has a job_id (ie,
+ones that came from stratum)
+- Bugfix: Recheck has_stratum even if the pool hasn't changed, in case pool has
+switched to another protocol in the process; also only delay 5 seconds before
+retry if pool is the same
+- Bugfix: Try GBT if no pool protocol is known (can occur in the process of
+stratum failover to GBT)
+- Bugfix: Correctly track discarded stratum shares, and log them as "disconnect"
+in sharelog
+- Check for EWOULDBLOCK when supported in send and recv as well.
+- Use the raw send() command instead of curl_easy_send since curl raw socket
+usage introduces random bugs on windows.
+- Use raw recv() command in place of curl_easy_recv since the curl
+implementation introduces random bugs on windows builds when the recv fails.
+- miner.php when displaying a single rig, add prev/next rig buttons if they
+exist, next to refresh
+- miner.php allow custom page joins for STATS
+- miner.php - include windows easyphp link
+- driver-ztex: use the correct size for the swap array
+- API stats - display pool byte transfer stats
+- Pool store data transfer stats
+- Benchmark incorrect work size
+- ChangeLog refer to NEWS
+- driver-ztex: search the complete noncerange based on the actual speed
+- API-README update
+- api use a dynamic io buffer, truncated before it reaches the current ~64k
+limit
+
+
+BFGMiner Version 2.10.0 - December 11, 2012
+
+- Bugfix: Free work before replacing it with clone
+- Bugfix: Since we are using pipes for select notifier on *nix, we need to use
+read/write there
+- Bugfix: Winsock needs send/recv for sockets, not write/read
+- Bugfix: opencl: Initialize pc_data to avoid clean_work checking uninitialized
+pointers
+- Bugfix: Correct parenthesis in bind() call in Windows notifier_init
+- Include Windows error messages in notifier_init errors
+- Include prctl header for thread renaming to work.
+- Set tv_idle time if a pool is not active when input from the menu.
+- minor unlikely zero pointer test
+- BeaverCreek doesn't like BFI INT patching.
+- Only stratum pools that are idle need to be kicked via cnx_needed.
+- Do not do any setup if opt_api_listen is disabled in api.c.
+- libztex: in case the selectFpga() failed set the selected fpga to unknown
+- Only set the lagging flag for select_pool() on failed getwork if we're not in
+opt_fail_only mode.
+- driver-ztex: support for broken fpga on a multifpga board
+- libztex: use a function for the twice called firmware reset code
+- libztex: removed an unused struct member (ztex->valid)
+- Set the pool lagging flag on startup to avoid it being shown initially, and
+only unset it once the maximum number of staged work items has been reached.
+- libztex: Include compat.h for substitute libusb_error_name (on older libusb
+versions missing it)
+- Suppress warning about "succeeded" not being used in finish_req_in_progress
+for now
+- Bugfix: Always give the get_work thread a curl, regardless of other
+outstanding curls in use
+- Bugfix: Failover after even a single job-request failure (or else it takes
+too long on timeouts)
+- Bugfix: Need to remove and re-add curl easy handles from multi to start a new
+request
+- Access total_submitting under mutex lock to avoid any potential races, and
+increment it as soon as we queue the submission up
+- Just leave the submit_work thread running persistently
+- Bugfix: Restore work->pool after prepare_rpc_req since clean_work now clears
+it
+- Bugfix: Now that stage_work is trying to manipulate staged_work in the same
+thread, clone_available needs to stage it outside of its own lock
+- Make main() the getwork scheduler once everything is set up, so that all app
+exits use the kill_work and quit paths.
+- Set successful connect to true on auth stratum to allow summary on exit from
+single stratum pool.
+- Hash_pop should signal further waiters on its own pthread conditional in case
+there are multiple waiters.
+- Check the job_id has not changed on stratum work when deciding if the work is
+stale as might occur across disconnections.
+- Perform pool_resus on getwork pool that generates work in getwork_thread.
+- Set pool lagging message for getwork pool that falls to zero staged in getwork
+thread.
+- Stage extra work when the primary pool is a getwork pool without rolltime.
+- Do not try to clean up twice if kill message is given.
+- Only recalculate total_staged in getwork thread if required.
+- Include the correct config header in libztex and include it before other
+includes.
+- Implement a completely new getwork scheduler. Stage all work from the one
+thread, making it possible to serialise all requests minimising the number of
+getworks requested or local work generated. Use a pthread conditional to wake up
+the thread whenever work is removed to generate enough work to stay above the
+watermark set by opt_queue. Remove all remnants of the old queueing mechanism,
+deleting the now defunct queued count.
+- Bugfix: Clean up share hashing and target checks, fixing share difficulty
+calculation for above-target would-be-shares
+- Use templates from pool_active and longpolls without fetching more
+unnecessarily
+- Try to avoid requesting GBT jobs when there is already a request in progress
+that will likely provide sufficient work
+- Reuse most recent GBT job if in get_work_thread if it isn't stale
+- libztex: fixed some warnings and removed some whitespaces
+- Remove all references to the now unused workio_cmd structure.
+- Remove the old workio command queue thread, replacing it with a kill
+conditional to exit the program.
+- Remove getwork command from workio_cmd queues and do them directly from
+queue_request.
+- Begin tearing down the old workio command queues by removing submit commands
+from there and submit them asynchronously via their own threads.
+- driver-ztex: changed two pairs of malloc()/memset() to calloc()
+- libztex: Read bitstream file in 2kb blocks with simpler and faster code
+- Added the binary versions of ztex_ufm1_15d4.ihx and ztex_ufm1_15y1.ihx
+- libztex: Add firmware download support for ZTEX 1.15d and 1.15x
+- libztex: Factor out local version of libusb_get_string_descriptor_ascii()
+- libztex: Don't return error when a bitstream was already configured
+- libztex: Read bitstream file in 64kb blocks with simpler and faster code
+- libztex: Verify that the mining firmware is not a dummy firmware
+- libztex: Match mining firmware ZTEX descriptor against the dummy firmware
+- libztex: Start download sequence only after reading in the new firmware
+- libztex: Download mining firmware to all devices with dummy firmware
+- Update windows build instructions.
+- Set pool probed to true on successful authorisation with stratum to avoid it
+being pinged later.
+- Style changes.
+- Allow pool active to be called on stratum or disabled pools in the watchpool
+thread if the pool has not been probed.
+- lock (most of) the threaded statistics updates
+- README stats don't add up
+- Rearrange summary lines and include count of active submissions in progress
+- Defer submissions instead of blocking in pop_curl_entry
+- Run a single share submission thread asynchronously submitting all shares in
+parallel
+- Handle share submissions asynchronously, one at a time (still threaded)
+- Split up json_rpc_call so it can be used asynchronously in libcurl-multi
+- Split submit_upstream_work into _request and _completed stages, pulling out
+json_rpc_call
+- Bugfix: Adjust USB_* variables to new LIBUSB_* names
+- Bugfix: Avoid double-free due to realloc_strcat moving memory around
+- Bugfix: Stratum connections might be needed for share submissions up to a
+minute after the last time they are used to generate work
+- Bugfix: Clean work before trying to generate new stratum work on top of it
+- Bugfix: modminer: Get rid of useless usbutils include
+- Make need connection return true if a pool is idle.
+- New --skip-security-checks option to allow miners to skip checks when it
+saves bandwidth
+- Skip stratum transaction download when there are no transactions
+- API add Best Share to summary
+- API lock access to some summary statistics (and copy them)
+- Enable backup stratum connections for getwork when the primary pool doesn't
+have longpoll aka solo mining.
+- Check for correct absence of opt_fail_only in cnx_needed.
+- Remove unused variable.
+- The specification for stratum has been elaborated to say that a changed diff
+applies only to new work so do not retarget when submitting shares.
+- Suspend stratum connections to backup pools when there is no requirement to
+potentially grab work from them.
+- Rename rename_thr to RenameThread to match cgminer
+- modminer: Adopt symbolic command names from kanoi
+- Make gen_stratum_work more robust by using a dynamically allocated array for
+the header in case bogus data is sent by the pool to avoid overflowing a static
+array.
+- scrypt_diff now returns a uint64_t
+- Support monitoring and reporting much higher diffs for scrypt mining,
+truncating irrelevant zeroes from displayed hash.
+- Pass ostate values around in scrypt to be able to extract full hashes if
+needed later on.
+- Revert "Handle crash exceptions by trying to restart cgminer unless the
+--no-restart option is used."
+- Provide helper function realloc_strcat to extend arbitrary length arrays
+based on string length.
+- Use base_work for comparison just for cleanness in __copy_work
+- Remove all static work structs, using the make and free functions.
+- Add pool no. to stale share detected message.
+- Add info about which pool share became stale while resubmitting.
+- Reduce extra slots in the max backlog for ztex to minimise memory waste.
+- Get rid of unused last_work in opencl thread data.
+- Do away with the flaky free_work api in the driver code which would often lose
+the work data in opencl and simply flush it before exiting the opencl scanhash.
+- Minor work handling restructure, including moving some stratum data from
+fixed-size buffers to their own heap allocations.
+- opencl: Use new dev_error function for REASON_DEV_NOSTART
+- Provide rudimentary support for the balancing failover strategies with stratum
+and GBT by switching pools silently on getwork requests.
+- Convert remaining modminer and bfl uses of usleep to nmsleep.
+- Convert libztex to nmsleep where possible.
+- Convert unreliable usleep calls to nmsleep calls in ztex driver.
+- Tidy up device error counts
+- Only increase gpu engine speed by a larger step if the temperature is below
+hysteresis instead of increasing it to max speed.
+- Convert pool not responding and pool alive message on backup pools to verbose
+level only since they mean a single failed getwork.
+- Use stratum block change from backup pools as an alternative to longpoll for
+pools that don't support LP.
+- Round some more static string arrays to 4 byte boundaries.
+- There is no need for the static arrays to be larger than required, so long as
+they're 4 byte aligned to appease ARM.
+- Hash1 is only used by the CPU mining code and never changes so remove it from
+the work struct and bypass needing to process the value for all other mining.
+
+
+BFGMiner Version 2.9.5 - December 11, 2012
+
+- Bugfix: Copy share hash to work->hash before doing 4-byte flip required by
+fulltest
+- driver-ztex: libztex_setFreq() must be called before ztex_releaseFpga()
+- libztex: Make log messages say bitstream when refering to bitstreams
+- Increase FD_SETSIZE to 4096 on Windows
+- Bugfix: Use AC_PROG_CPP in libusb include subdirectory detection for improved
+portability
+- Bugfix: Free input memory after prioritising pools in TUI
+- Bugfix: Free filename entry for writing config file when done with it
+- Bugfix: Free stratum nonce1 before replacing it with new value on reconnect
+
+
+BFGMiner Version 2.9.4 - December 4, 2012
+
+- Update libblkmaker to 0.2.1
+- Count template number, and append it to the coinbase of templates without any
+cbtxn
+- Bugfix: bitforce: Always increment global hw error counter when incrementing
+device hwe
+- Bugfix: Correct order of printf-style arguments in cbappend fail
+- Bugfix: Capitalize "MHz" correctly
+- ztex: Correctly release mutex and reset FPGA if configuration fails
+- ztex: Harmonize low-speed FPGA configuration code with high-speed code
+- libztex: Silence warning: comparison between signed and unsigned
+- Count longpoll decodes as queued work since the count otherwise remains
+static.
+- Bugfix: Assign header-based rolltime before decoding work, so GBT expires
+overrides it properly
+- Look for libusb_init in -lusb, since FreeBSD has it there
+- Bugfix: Use pkgconfig for libusb when available, and try to guess the include
+path if not
+- Bugfix: FPGA-README: Correct idVendor in example MMQ udev rule
+- fixes target calc for mips openwrt
+- Bugfix: clear_work: Whether the template is in fact being freed or not, the
+work reference to it needs to be
+- libztex: Work around ZTEX USB firmware bug exposed by the FreeBSD libusb
+- README: Document solo mining usage
+- README: Update dependencies
+- Bugfix: We should never roll stale work
+- Ubuntu: Removing erroneous libssl dep again. GITHUB#94
+- Bugfix: Clear out stratum share work before freeing it
+- Provide rudimentary support for literal ipv6 addresses when parsing stratum
+URLs.
+- Do not attempt to remove the stratum share hash after unsuccessful submission
+since it may already be removed by clear_stratum_shares.
+
+
+BFGMiner Version 2.9.3 - November 16, 2012
+
+- Bugfix: Properly process new stratum jobs through test_work_current, even if
+old shares are still accepted, and copy submit_old flag correctly
+- Ensure pdiff 1 is always caught regardless of bdiff precision, and ceil all
+other cases to ensure we never lose valid shares
+- Check against a double for current pool diff.
+- Support for fractional diffs and the classic just-below-1 share all FFs diff
+target.
+- Check share target diff for best_share to be calculated when solo mining.
+- Store the full stratum url information in rpc_url for correct configuration
+file saving.
+- Put in a hack to prevent dud work from sneaking into test_work_current being
+seen as a new block.
+- Reset the work->longpoll flag where it will affect stratum work items as
+well.
+- Bugfix: Stratum does not guarantee notify messages every minute, so extend
+timeout to 2 full minutes
+- Bugfix: Always honour libblkmaker time limits
+- Always (debug)log when stratum template is updated by the pool
+- Bugfix: When a stratum connection is interrupted, ensure all work/shares for
+it are considered stale
+- Bugfix: clear_sock should return on socket errors
+- Bugfix: Force calculation of work_difficulty since set_work_target fails to
+consider the pdiff<bdiff difference
+- Bugfix: Minimal support for handling real difficulties from stratum server
+- Bugfix: Never consider shares to be accepted if the submission response is an
+error
+- Bugfix: Always fail scrypt detection if Stratum is chosen
+
+
+BFGMiner Version 2.9.2 - November 7, 2012
+
+- Add endian swap defines for where missing.
+- Only retarget stratum shares to new pool diff if diff has dropped.
+- Bugfix: x6500: Use json_object_set_new to correctly count references to
+per-FPGA RPC data
+- Bugfix: modminer: Use json_object_set_new to correctly count references to
+per-FPGA RPC data
+- Bugfix: Only append newline when printing protocol data
+- Bugfix: Use memchr to look for newlines in socket line data, since the buffer
+isn't null terminated
+- Bugfix: Ensure GETWORK_MODE_GBT isn't replaced with GETWORK_MODE_POOL
+- Count lost stratum share submits and increase message priority to warning.
+- Show which pool untracked share messages have come from.
+- Sleep 5 seconds before retrying submit.
+- Changes to build prototypes to support building on FreeBSD 9.1-RC2 amd64
+- Count lost shares with stratum as submit stale lost.
+- Discard record of stratum shares sent and report lost shares on disconnection
+since they will never be reported back.
+- Check that count of transactions received via stratum is reasonable
+- Use realloc'd data_buffer to support stratum lines longer than 8 KB, and
+parse stratum responses during auth
+- Use mining.get_transactions to check for stratum pool transparency (actual
+response ignored for now)
+- ztex: Silence false "unexpected" hardware errors, and don't count them as hw
+errors
+- README: Update build instructions to reflect current reality
+- x6500: Expose per-FPGA details to RPC API
+- x6500: Implement support for --temp-target
+- x6500: Increase default clock frequency to 200 Mhz, now that new bitstream
+seems to run well around that
+- x6500: Flush nonces in FPGA buffer at initialization to avoid false hw errors
+on restart
+- x6500: Release device lock sooner during initialization, before logging
+initial frequency info
+- x6500: Read temperature sensors after sending work, when enabled
+- Bugfix: jtag: Fix optimized register reading code (it was reading an extra
+bit before the last, corrupting outside the buffer)
+- Implement new --force-dev-init option to force bitstream upload to modminer
+and x6500 devices
+- Bugfix: x6500: Include --scan-serial option even for x6500-only builds
+- Bugfix: ztex: Include --scan-serial option even for ztex-only builds, so it
+can be used to disable autodetect if needed
+- FPGA-README: Discuss X6500 --scan-serial usage of cases where it may be
+needed
+- ft232r: If we are searching for a specific serial, pay no attention to the
+product id
+- x6500: Try a more flexible approach to applying dynclock logic
+- Bugfix: dynclock: Use standard C struct initializer to handle initialization,
+instead of memsetting memory to nulls
+- x6500: Whenever we get a hardware error, purge buffers just in case of
+read/write desync
+- Bugfix: x6500: When purging ft232r buffers (during bitstream upload), also
+clear JTAG delayed read counter to avoid any potential desync
+- Bugfix: ft232r: Always flush writes before purging buffers, and empty local
+read buffer when flushing ftdi read buffer
+- There is no need for addrinfo any more.
+- Fix filename for x6500 bitstream to match previous commit's rename
+- Rename x6500 bitstream to match existing licensing naming setup
+- x6500 dual temp sensor support
+- x6500 is far more stable with its own bitstream
+
+
+BFGMiner Version 2.9.1 - October 30, 2012
+
+- When we find a block, always progress to it for mining
+- Bugfix: Enforce --expiry, but split --expiry-lp for a longer expiry on
+longpoll setups
+- Bugfix: regeneratehash needs to compare hash segments in Little Endian, not
+Big Endian
+- Bugfix: Always fail scrypt detection if Stratum is working
+- Bugfix: Scan for ft232r devices later, after console lock and other mutexes
+are initialized properly
+- ft232r: Debuglog non-FTDI device IDs found
+- Bugfix: Wait to release JSON result in case of JSON-RPC error until we've
+logged the error
+- Bugfix: RPC: Defer release of JSON until after cmd is used
+- Bugfix: Release JSON result in case of JSON-RPC error
+- Bugfix: Release job JSON result as soon as we are done using it
+- Bugfix: Release JSON received from RPC socket after we're done using it
+- Bugfix: Use clear_work and workdup everywhere work is copied around
+- Bugfix: Clear work before replacing it with new, to free any pointers
+- server and client sockaddr_in are no longer used in struct pool.
+- Set sshare id and swork_id within the sshare mutex to avoid multiple share
+submits with the same id.
+- Bugfix: Really use freeaddrinfo to clean up in extract_sockaddr
+- Update documentation for X6500
+- Bugfix: Free unused JSON returned when switching to Stratum
+- Bugfix: Free unused work when switching to Stratum instead
+- Bugfix: Use freeaddrinfo to clean up in extract_sockaddr
+- RPC: Include PGA support for X6500-only builds
+- RPC: Abstract code to handle any new device drivers as PGAs without special
+support
+- Bugfix: Release GBT submission JSON objects after dumping them
+- Bugfix: Free old stratum_work data before replacing it
+- Bugfix: Release memory allocated by prior stratum sockaddr extractions
+- Bugfix: Clear work template when preparing a new request
+- Bugfix: Initialize temporary stratum work
+- Bugfix: x6500: jtag_read buffer needs to be initialized since reading JTAG
+implies writing too
+- Replace now-redundant accepted_weighed with equivalent diff_accepted
+- Fail on select() failing in stratum thread without needing to attempt
+recv_line.
+- Add share to stratum database before sending it again in case we get a
+response from the pool before it's added.
+- Bugfix: modminer: Check that we have a valid fd before trying to start work
+- Shorten the initiate stratum connect timeout to 30 seconds.
+- Shorten the stratum timeout on read to 90 seconds to detect unresponsive pool.
+- Display best share difficulty on exit.
+- Make stratum socket fail more robust on windows by disabling the send buffer.
+- Reuse the same curl handle forcing a new connection instead of risking
+derefencing.
+- Add information about submission failure to stratum send.
+
+
+BFGMiner Version 2.9.0 - October 28, 2012
+
+- modminer: Remove dead code
+- Bugfix: Include headers in order needed for Mingw build
+- Bugfix: Save pool pointer to avoid dereferencing work after it might
+potentially be freed
+- Bugfix: Cleanup some harmless warnings
+- Bugfix: TUI: Avoid clearing the whole screen when we just want to clear the
+log window
+- Wishlist #130 implemented by "blinkier":
+- - Add all-at-once pool priority reassignment to curses TUI interface
+- - Save/restore pool priorities in config file
+- - Allow setting initial pool priorities via command line
+- Bugfix: Replace reportin hack with a reset back to LIFE_INIT for bitstream
+upload
+- Bugfix: SI kilo prefix is a lowercase "k"
+- Bugfix: If userpass is missing a password, treat it as a null password
+(regression fix)
+- Upgrade libblkmaker to 0.2.0
+- Bugfix: Build correct pay-to-scripthash script
+- Implement --coinbase-addr for solo mining
+- x6500: Since we program in about a minute now, only report status verbosely
+every 25%
+- x6500: Poll nonce less often since USB latency slows us down anyway
+- jtag: Avoid writing an extra readback byte when we are ignoring tdo anyway
+- ft232r: Set output buffer size to 4096 bytes
+- x6500: Adjust dynclock so it works more reasonably
+- x6500: Dynclock support
+- Provide a simple/dummy libusb_error_name when it is missing (libusb < 1.0.9)
+- x6500: Stop abusing pointer type to store bitstream upload progress
+- Bugfix: ft232r: Avoid reuse of USB device count variable
+- x6500: Implement basic hashrate prediction and efficient job completion
+- jtag: Optimized implementation of JTAG reads to workaround ft232r slowness
+- x6500: Try nonce with previous work if it is wrong for current
+- x6500: Ensure ft232r buffer is flushed to change registers
+- x6500: Start clock speed off at 180, and extra debugging for
+x6500_set_register
+- x6500: When programming, poll each FPGA status individually since they might
+not be ready at the same time
+- x6500: Various tweaks and hacks to get mining working
+- Bugfix: x6500: Remove erroneous bitendianflip
+- Bugfix: jtag: Handle ftdi-common environmental stuff properly
+- jtag: Defer ignored reads a bit to avoid USB latency
+- Bugfix: ft232r: First 2 bytes of every 0x40 are FTDI status or something
+- x6500: Implement mining protocols (doesn't work yet)
+- x6500: Cleanup dead code and implement bailout2
+- x6500: Clean up and finish FPGA initialization
+- x6500: Comment bitstream upload function better
+- fpgautils: Abstract open_xilinx_bitstream out from modminer and x6500 drivers
+- x6500: Get bitstream upload working
+- Bugfix: jtag: Use the correct bit for reading/writing data streams
+- ft232r: Buffer writes to improve performance
+- x6500: Get FPGA probe working
+- jtag: JTAG implementation for X6500 (over ft232r)
+- ft232r: ft232r_read_all function to simplify exact-length reads
+- ft232r: Implement read buffer so ft232r_read always works like read(2)
+- ft232r: Complete necessary interfaces for X6500
+- x6500: Bare minimum detection-only X6500 support via libusb
+- Minor debian packaging fixes.
+- Only add stratum share to database if we succeeded in submitting it, with a
+debug output saying it succeeded.
+- Use keepalive with stratum sockets to improve its ability to detect broken
+connections.
+- Show only the URL in the status bar to avoid long prefixes making for extra
+long lines.
+- Display compact status in menu and update README to reflect current menu
+entries.
+- Add a compact display mode that does not list per device statistics in the
+status window.
+- Add blank spaces after best share displayed.
+- Round a few static string arrays up to 4 byte boundaries for ARM.
+- Display best share diff for scrypt as well.
+- Show the best diff share as "best share" and add info to the README.
+- Display the best diff share submitted so far.
+- Redundant check.
+- The work struct pointer in struct pc_data in findnonce is never freed yet
+there is no need to allocate it separately so make struct work a static part of
+the struct pc_data. s
+- No longer should hide --no-restart option if OpenCL support is missing
+- Handle crash exceptions by trying to restart cgminer unless the --no-restart
+option is used.
+- Switch queued count when choosing a different pool from a failed stratum pool
+in getwork thread.
+- Put a mandatory 5s wait between reattempting a getwork on failure to avoid
+hammering requests.
+- Make sure to check pool stratum curl exists under lock before attempting any
+recv to not risk dereferencing upon attempting to reinitiate stratum.
+- Avoid redefining macros and align to 4 byte boundaries.
+- API - add Stratum information to pools
+- update FPGA-README for MMQ
+- Time for dynamic is in microseconds, not ms.
+- x86_64 builds of mingw32 are not supported directly and should just configure
+as generic mingw32 builds since they're NOT 64 bit.
+- Use 3 significant digits when suffix string is used and values are >1000.
+- Get rid of unused warning for !scrypt.
+- Use select on stratum send to make sure the socket is writeable.
+- Cope with dval being zero in suffix_string and display a single decimal place
+when significant digits is not specified but the value is greater than 1000.
+- Pad out the suffix string function with zeroes on the right.
+- Failure to calloc in bin2hex is a fatal failure always so just check for that
+failure within the function and abort, simplifying the rest of the code.
+- Provide locking around the change of the stratum curl structures to avoid
+possible races.
+- Bump opencl kernel version numbers.
+- Remove atomic ops from opencl kernels given rarity of more than once nonce on
+the same wavefront and the potential increased ramspeed requirements to use the
+atomics.
+- Clear the pool idle flag in stratum when it comes back to life.
+- Display correct share hash and share difficulty with scrypt mining.
+- Show work target diff for scrypt mining.
+- Watch for buffer overflows on receiving data into the socket buffer.
+- Dramatically simplify the dynamic intensity calculation by oversampling many
+runs through the opencl kernel till we're likely well within the timer
+resolution on windows.
+- Align static arrays to 4 byte boundaries to appease ARM builds for stratum.
+- Update documentation.
+- Left align values that are suffix_string generated.
+- Share_diff should not be converting the work data to hex.
+- Update readme describing difficulty displayed on log lines.
+- Off by one error.
+- Prevent overflows of the port char array in extract_sockaddr.
+- Disable stratum detection with scrypt.
+- Display the actual share diff next to the pool required diff, using a suffix
+creation function to prevent values of >1000 being shown in their entirety.
+- Fix 4 * 0 being 0 that would break dynamic intensity mode.
+- Supplement other 64-bit endian swap macros
+- Bugfix: Fix htobe64 on big endian platforms that don't define it
+- Fix lack of htobe64 on mingw32.
+- Reinstate the history on dynamic intensity mode to damp fluctuations in
+intensity but use an upper limit on how much the value can increase at any time
+to cope with rare overflows.
+- Update to cgminer's newer dynamic intensity algorithm
+- Support for the stratum mining protocol.
+- Simplify target generation code.
+- Add support for client.get_version for stratum.
+- Use a 64 bit unsigned integer on the diff target to generate the hex target.
+- Update reconnect message to show whole address including port.
+- Look for null values and parse correct separate array entries for url and port
+with client reconnect commands for stratum.
+- The command for stratum is client.reconnect, not mining.reconnect.
+- Only copy the stratum url to the rpc url if an rpc url does not exist.
+- Implement rudimentary mining.reconnect support for stratum.
+- Ignore the value of stratum_active on calling initiate_stratum and assume
+we're always trying to reinitiate it, and set the active flag to false in that
+function.
+- stratum auth can be unset if we fail to authorise on subsequent calls to
+auth_stratum which undoes the requirement of setting it in one place so set it
+in pool_active.
+- Format Stratum submission-start debug the same way as other submissions
+- Bugfix: Set work_restart_id in gen_stratum_work for when work is reused to
+avoid thinking it's all stale.
+- Only auto-switch to Stratum internally, but save HTTP URI in case pool stops
+using Stratum; also always shows original pool URI on RPC
+- SHUT_RDWR is now always defined for us, so no need to check ifdef on LP hang
+- Implement --no-stratum option to disable autodetection
+- Show Stratum pools as "Strtm" protocol in "Pool management" TUI
+- Bugfix: BFGMiner doesn't use rpc_proxytype
+- Remove free that could segfault.
+- Use the stratum url as the rpc url advertised if we switch to it.
+- Count an invalid nonce count as a hardware error on opencl.
+- Count each stratum work item as local work.
+- Cope with one stratum pool being the only active pool when it dies by sleeping
+for 5 seconds before retrying to get work from it instead of getting work
+indefinitely.
+- Detect stratum outage based on either select timing out or receiving an empty
+buffer and properly re-establish connection by disabling the stratum_active
+flag, coping with empty buffers in parse_stratum.
+- Fix various modminer warnings on mingw.
+- Fix sign warning on windows build for bitforce.
+- Cast socketfail to integer since SOCKET is an unsigned int on windows.
+- Use the stratum thread to detect when a stratum pool has died based on no
+message for 2 minutes.
+- Only set the stratum auth flag once and once the stratum thread is started,
+use that to set/unset the stratum active flag.
+- Only hand off to stratum from getwork if we succeed in initiating the
+protocol.
+- Target should only be 32 bytes copied.
+- Use a static array for work submission data instead of stack memory.
+- Clear the buffer data before sprinting to it.
+- Clear work stratum strings before setting them and add them to debug output.
+- Drop stratum connect failed message to verbose level only since it's a regular
+probing message.
+- TCP Keepalive in curl is only in very recent versions and not required with
+regular messages on stratum anyway.
+- Move stratum sockets to curl infrastructure with locking around send+recv to
+begin support for proxies and ssl.
+- Make detect stratum fail if a proxy has been set up.
+- Stratum does not currently have any proxy support so do not try to switch to
+stratum if a proxy has been specified.
+- Windows doesn't work with MSG_PEEK on recv so move to a continuously updating
+buffer for incoming messages.
+- Alloca is unreliable on windows so use static arrays in util.c stratum code.
+- Begin support for mingw stratum build.
+- Add space to reject reason.
+- Parse the reject reason where possible from stratum share submission.
+- Pass json error value to share result function to be able to parse reject
+reason in stratum.
+- Don't try to parse unneeded parameters in response to mining.subscribe.
+- Remove the sshare hash entry if we failed to send it.
+- Change notify message to info level to avoid spamming repeatedly when a pool
+is down.
+- Check the stratum pool difference has not changed compared to the work diff
+when testing whether a share meets the target or not and retarget if necessary.
+- Bit error in target calculation for stratum.
+- Offset the current block detection to the prev block hash.
+- We should be testing for id_val, not id in parse stratum response.
+- Make target on stratum scale to any size by clearing sequential bits according
+to diff.
+- Correct target calculation in gen_stratum_work.
+- If a share result has an error code but still has an id, it is likely a
+reject, not an error.
+- Initiate stratum the first time in pool_active only, allowing us to switch to
+it on getting a failed getwork and detecting the presence of stratum on the url
+at that time.
+- Use 5 second timeout on sock full for now as a temporary workaround.
+- If no stratum url is set by the end of the detect stratum routine, copy the
+sockaddr url.
+- Make all buffers slightly larger to prevent overflow.
+- Make the stratum recv buffer larger than the recvsize.
+- Userpass needs to be copied to user and pass earlier to allow stratum
+authorisation to work with it.
+- Store a sockaddr url of the stripped url used in determining sockaddr to not
+confuse it with the stratum url and fix build warnings.
+- Decrease the queued count with stratum work once it's staged as well.
+- Allow the stratum retry to initiate and auth stratum in pool_alive to make
+sure the stratum thread is started.
+- Avoid duplicating pool->rpc_url and setting pool->stratum_url twice to itself.
+- Detect if a getwork based pool has the X-Stratum header on startup, and if so,
+switch to the stratum based pool.
+- Comment update.
+- Minor message change.
+- Create a work item from a "clean" request from stratum allowing the new block
+to be detected and the appropriate block change message to be given.
+- Use statically allocated stratum strings in struct work to cope with the
+inability to safely deallocate dynamically allocated ram.
+- Use the current pool when deciding whether to reuse work from a stratum source
+rather than the work's previous pool.
+- Copy the stratum url to the rpc url to avoid none being set.
+- Provide locking around stratum send operations to avoid races.
+- Submit shares from stratum through the abstracted submit share function
+detecting what message they belong to and showing the data from the associated
+work, and then deleting it from the hash.
+- Use a more robust mechanism to obtain a \n terminated string over a socket.
+- Abstract out share submit as a function to be useable by stratum.
+- Rename parse_stratum to parse_method as it is only for stratum messages that
+contain methods.
+- Display stratum as mechanism in status line when current pool is running it.
+- Count each stratum notify as a getwork equivalent.
+- Correct nonce submitted with share.
+- Extranonce2 should be added before coinbase2.
+- We should be hashing the binary coinbase, not the hex one.
+- Fix endianness of nonce submitted for stratum.
+- Check that stratum is already active in initiate_stratum to avoid
+de-authorising ourselves by subscribing again.
+- Begin implementing a hash database of submissions and attempt sending results.
+- Copy parameters from stratum work required for share submission.
+- Set lagging flag on first adding a pool to prevent pool slow warning at
+startup.
+- Fix work->target being a 32 byte binary in gen_stratum_work.
+- Store and display stripped url in its own variable.
+- Create machinery to divert work requests to stratum.
+- Generate the work target in gen_stratum_work, setting default diff to 1 in
+case it is not yet set.
+- Generate work data, midstate and hash1 in gen_stratum_work.
+- Generate header created from stratum structures in gen_stratum_work.
+- Generate merkle root hash in gen_stratum_work.
+- Generate the coinbase for generation of stratum based work.
+- The number of transactions is variable so make merkle a variable length
+dynamically allocated array and track how many there are for stratum.
+- Rename nonce2 to n2size reflecting that it's a size variable and not the
+actual nonce.
+- Provide rudimentary support for stratum clean work command in the stratum
+thread.
+- Cope with pools being removed in the stratum thread.
+- Use the pool sock value directly in the stratum thread in case it changes
+after reconnecting.
+- Create a stratum thread per pool that has stratum that monitors the socket and
+serves received data.
+- Check return value of stratum_parse.
+- Complete authorisation in stratum.
+- Implement stratum parsing of notify parameters and storing them in the pool
+stratum work structure.
+- Create helper functions for duplicating json strings to avoid keeping json
+references in use.
+- Append \n in the sock_send function instead of adding it when constructing
+json in stratum.
+- Don't keep any json references around with stratum structures.
+- Create parse_stratum function that hands off stratum parameters to other
+functions to manage pool stratum work struct variables. Implement mining
+difficulty setting.
+- Create helper functions for checking when a socket is ready to read on and
+receive a single line at a time. Begin stratum authorisation process.
+- Provide a helper function for reading a single \n terminated string from a
+socket.
+- Create a stratum work structure to store current work variables.
+- Test specifically for stratum being active in pool_active.
+- Detect stratum in common place when adding urls, and use a bool to tell us
+when it's active.
+- Remove unused add_pool_details5
+- Fix warnings.
+- Extract and store various parameters on stratum init confirming successful
+mining notify.
+- Use existing socket macros and close the socket on failure in init stratum.
+- Initiate stratum and grab first json result.
+- Get detailed addressinfo from the parsed URL for future raw socket usage when
+possible. IPV4 only for now.
+- Prepare for getaddrinfo call.
+- Add data structures to pool struct for socket communications.
+- Put all socket definitions in util.h to allow reusing by added socket
+functions to be used in util.c.
+
+
+BFGMiner Version 2.8.3 - October 18, 2012
+
+- Update to libblkmaker 0.1.3
+- Use explicit host to BE functions in scrypt code instead of hard coding
+byteswap everywhere.
+- Ease the checking on allocation of padbuffer8 in the hope it works partially
+anyway on an apparently failed call.
+- Round target difficulties down to be in keeping with the rounding of detected
+share difficulties.
+- String alignment to 4 byte boundaries and optimisations for bin<->hex
+conversions.
+- Fix GPU memory allocation size for scrypt
+- Fix access violation with scrypt mining
+- Bugfix: Only free rpc_req after using it, not before
+- Bugfix: Increment work->pool->staged inside of mutex to avoid work being
+freed (and staged decremented) before we dereference it
+- Revert "No need for extra variable in hash_push.": The extra variable is
+needed to avoid a rare dereference-after-free error.
+- In opencl_free_work, make sure to still flush results in dynamic mode.
+- Workaround: Debug log only after dec_queued, to make a free/use race more
+rare
+- Bugfix: Remove redundant \n in debug messages
+- Bugfix: Free rpc_req in pool_active and longpolls
+- README: Explicitly provide Ubuntu package name for libjansson-dev
+- Bugfix: Include flash_led bool in cgpu_info for Icarus-but-not-BitForce
+builds, since Cairnsmore uses it
+- Only check work block id against pool's if the pool has a known block id
+- Avoid clearing pool->block_id unless we really are changing pools
+
+
+BFGMiner Version 2.8.2 - October 8, 2012
+
+- Update to libblkmaker 0.1.2
+- Bugfix: --temp-target no longer has a simple default (fixes build without
+OpenCL support)
+- Bugfix: icarus: Silence false epoll error
+- Bugfix: icarus: Set firstrun for errors starting next job, so the current
+one finishes properly
+- Bugfix: icarus: Restore generic failure management for write errors
+- Use strtod not strtol for bitforce temp backup.
+- Cope with broken drivers returning nonsense values for bitforce temperatures.
+- Minor warning fixes.
+- Fix unused warnings on ming build.
+- Fix sign warning in ocl.c
+- fds need to be zeroed before set in modminer.
+- Put scrypt warning on separate line to avoid 0 being shown on windows as
+bufsize.
+- Prevent corrupt values returned from the opencl code from trying to read
+beyond the end of the buffer by masking the value to a max of 15.
+- Icarus USB write failure is also a comms error
+- api.c DEBUG message has no paramter
+- Icarus catch more USB errors and close/reopen the port
+- API-README update cgminer verison number
+- hashmeter fix stats kh/s on 32bit windows
+- cairnsmore: Increase maximum clock frequency to 210 Mhz
+- icarus: Hashrate estimates really don't need the attention of a warning,
+demote them to debug
+- cairnsmore: Automatically "downgrade" default FPGA-per-device to 1 for
+dynclock devices
+- Bugfix: cairnsmore: Get autodetection of dynclock to work consistently
+- cairnsmore: Adjust dynclock usage to react in proper time
+- dynclock: Document function usage
+- cairnsmore: Fix race on dynclock detection
+- icarus: Detect attempts to send commands via work and neuter them
+- cairnsmore: Glasswalker has a minimum multiplier of 20 :(
+- cairnsmore: Detect frequency changing support despite hashing of commands
+- modminer: Allow clocks down to 2 Mhz just in case
+- Allow device drivers and users to properly change target temperatures for
+non-GPUs
+- Check that ncurses*-config installs actually work before deciding to use
+them
+- Bugfix: Fix multiple bugs in autogen.sh
+- - Don't use readlink -f unneccesarily (it's not portable)
+- - Always run autoreconf within the real source directory
+- - Run configure from PWD, *not* the real source directory
+- Bugfix: Include nonce in data buffer for debugging
+- Bugfix: swap32* wants count of 32-bit blocks, not bytes
+- Initial Cygwin port
+- Revert "Remove needless roundl define.", since it is needed for Cygwin and
+OpenWRT
+- Bugfix: Deal with various compiler warnings
+- modminer: Implement --temp-hysteresis logic
+- Support for maximum frequency being below the default, eg when the maximum
+is temporarily reduced to deal with temperature
+- Bugfix: modminer: Reduce dynclock max frequency as needed to keep
+temperature below cutoff
+- Bugfix: Restore disabled label, needed to skip over hashrate calculations
+(which mess up otherwise)
+- Bugfix: bitforce: Count actual throttling as hardware errors
+- icarus: Allow failure in case of reopen failure, now that the miner core
+will retry on its own
+- If a device dies, attempt to reinitialize it occasionally
+- Bugfix: The REST flag is now preferred over WAIT, since the former might
+trigger the latter
+- Bugfix: modminer: Update temperature readings when disabled (fixes thermal
+cutoff recovery)
+- Bugfix: Move thermal cutoff to general watchdog code (fixes bitforce
+recovery)
+- Rename enable_device to register_device, since it only works for setting it
+up at startup
+- Move targettemp from ADL to cgpu_info, so all devices can readily use it
+- Bugfix: "REST" flag had too much padding
+- Bugfix: adl: Only warn and disable GPU due to thermal cutoff, if it's
+actually enabled
+- Bugfix: bitforce: Only warn and disable bitforce due to thermal cutoff, if
+it's actually enabled
+
+
+BFGMiner Version 2.8.1 - September 27, 2012
+
+- Avoid strndup for Windows compatibility
+- Bugfix: cairnsmore: Add missing compat.h include (for sleep)
+- cairnsmore: Implement "identify" for supported firmware
+- Adjust identify_device API to return a bool whether supported or not, for
+runtime capability detection
+- Bugfix: cairnsmore: Fix invalid share detection on LE
+- Bugfix: icarus: Fix logging message to not assume "Icarus" always, and use
+device driver name
+- Bugfix: cairnsmore: Correct frequency scaling detection logic
+- cairnsmore: When changing frequency, adjust Hs expectations accordingly
+- cairnsmore: Detect availability of frequency scaling, and only enable it
+when supported
+- cairnsmore: Implement dynamic clocking support for Glasswalker's bitstream
+- Update libblkmaker to 0.1.1
+- Advertise BFGMiner in blocks found by default (without --coinbase-sig)
+- RPC: Add "Coinbase-Sig" to config/setconfig
+- New --coinbase-sig option to add arbitrary data to blocks you generate (GBT
+only)
+- opencl: Defer nonce validity checking to submit_nonce
+- scrypt: Implement test_nonce2 and submit_nonce hw error check
+- Bugfix: modminer: Convert nonce to native endian
+- Interpret any attempts to submit a H-not-zero nonce as a hardware error
+- make-release: Strip DLLs and EXE in Windows binary
+- dynclock: Use consistent messages for frequency changes
+- modminer: Port to dynclock
+- dynclock: Split dynamic clocking algorithm out of Ztex driver
+- Bugfix: When changing GPU memclock, adjust internal variable so it is
+correctly saved to config file
+- Bugfix: Re-probe longpoll header for each pool alive check, including
+retries when a preferred protocol fails
+- Bugfix: modminer: Bitstream binary filenames are *.bit
+- modminer: Start frequency off at 200 Mhz
+- Reorder libztex header include order to fix missing struct definition.
+- Display share difficulty on log with a shortened hash display on submission.
+- API stats add some pool getwork difficulty stats
+- Ignore any pings pushed to the worker threads if the thread is still paused to
+prevent it being enabled and disabled repeatedly.
+- Test for sequential getwork failures on a pool that might actually be up but
+failing to deliver work as we may end up hammering it repeatedly by mistake.
+- reduce windows compile warnings
+- util.c - bug - proxy - no data end condition
+- API don't change 'Diff1 Shares' - backward compatability FTW
+- miner.php highlighting correctly handling difficulty
+- API - Add last share difficulty for devices and pool
+- Store and report Accepted,Rejected,Stale difficulty in the summary and API
+- WorkTime - display prevblock for scrypt
+- api.c remove compile warnings
+- Calculate work difficulty for each getwork and display with WorkTime debug
+- FPGA - allow long or short device names in detect code + style police
+- WorkTime - multiple nonce per work and identify the work source
+- Optional WorkTime details with each Accepted/Rejected work item
+- Icarus - ignore hardware errors in timing mode
+- miner.php oops - mistype
+- API pgaidentify - unsupported message should be a warning
+- API/BFL identify a device - currently only BFL to flash the led
+- BFL add throttle count to internal stats + API
+- BFL: missing device id in log message
+- Bugfix: ztex: Clear device_ztex before freeing it
+- Bugfix: ztex: statline existence depends on whether the libztex structure
+exists, not whether the cgpu is enabled
+- Bugfix: README: Make usermod commands consistent, including important -a
+option
+- Bugfix: Address a couple of rare TQ leaks, and improve logging a bit
+- Bugfix: Properly quote configure options
+
+
+BFGMiner Version 2.8.0 - September 15, 2012
+
+- Be specific about jansson version requirement
+- Replace "Alive" in pool status with protocol in use (GBT or GWork)
+- Remove copy of old jansson from source repository
+- Honour block template expiry (BIP 23 Basic Pool Extensions "expires")
+- Add --no-gbt option so getblocktemplate can be disabled if it causes
+problems
+- BIP 22 long polling
+- Properly detect pool protocol
+- Bugfix: Sort out work template refcounting by properly using work_free and
+new workcpy
+- Support for rolling extranonce in templates
+- Initial libblkmaker integration, using a git submodule
+- cairnsmore: There's no set hashrate like Icarus, so always use short timing
+mode by default
+- Bugfix: Include unistd.h needed for ssize_t type
+- fpgautils: Don't try to scan serial at all anymore, if a device is claimed
+- fpgautils: serial_claim function to politely ask other drivers not to try to
+use device
+- RPC: Update to work with Cairnsmore
+- cairnsmore: Windows autodetect using FTDI library
+- cairnsmore: Beginnings of new driver, with automatic upgrade from Icarus
+detection
+- icarus: Support disabling reopen quirk via --icarus-options
+- proxy: Replace mess of encoding proxy into pool URI with a --pool-proxy
+option, and use cURL's builtin proxy URI support
+- save individual pool proxy settings to config
+- API-README update for pools proxy info
+- CURL support for individual proxy per pool and all proxy types
+- Bugfix: Update current_block_id for fixed set_curblock
+- miner.php by default don't display IP/Port numbers in error messages
+- api.c all STATUS messages automatically escaped
+- API add display of and setting queue,scantime,expiry
+- README - FPGA device FAQ
+- API add device diff1 work
+- count device diff1 shares
+- API-README update
+- api.c Correct diff1 field name
+- Bugfix: Sanitize block hash handling (including fixing on big endian)
+- Bugfix: Print the (full) correct block hash when warning about work issued
+against old blocks
+- Bugfix: When comparing current block, only pay attention to the prevblock
+header
+- Allow mixing user+pass and userpass, so long as user+pass are balanced
+before userpass options
+- ztex: Include device serial number and FPGA number in cgpu name field
+- ztex: Abstract common cgpu_info creation code
+- ztex: Do thread initialization in thread_init rather than thread_prepare
+- Bugfix: Tolerate working on old blocks when there is only one pool enabled
+- Bugfix: ztex: Detect through fpgautils so -S noauto correctly inhibits
+autodetection
+- ztex: Workaround duplicate share submissions by doubling "backlog" size
+- ztex: Use consistent device ids for logging
+- Bugfix: ztex: Increment global hw_errors too
+- Bugfix: free adhoc string elist element when removing it from list
+- Bugfix: icarus: Initialize lret variable after work restart reentry
+- Bugfix: ztex: Free lastnonce heap memory if backlog allocation fails
+- icarus: Initialize epoll event structure in a way Valgrind is happier with
+- Bugfix: Use strtok_r for parse_config since some options use strtok
+themselves
+- Import strtok_r from gnulib for Windows portability
+- Bugfix: ztex: Don't try to destroy a mutex that was never created (single
+FPGA Ztex devices)
+- ztex: Clean up redundant dereferencing in ztex_shutdown
+- API-README more debug parameter information
+- API allow full debug settings control
+- Sort the blocks database in reverse order, allowing us to remove the first
+block without iterating over them. Output the block number to debug.
+- Adjust opencl intensity when adjusting thread count to prevent it getting
+pegged at a value below the minimum threads possible.
+- miner.h max_hashes -> int64_t
+- Keep the local block number in the blocks structs stored and sort them by
+number to guarantee we delete the oldest when ageing the block struct entries.
+- Use correct sdk version detection for SDK 2.7
+- Bugfix: Align Ztex statline properly by removing redundant frequency
+- make-release: Convert text files to DOS format for Windows ZIP
+
+
+BFGMiner Version 2.7.5 - August 27, 2012
+
+- Revert "Do a complete cgminer restart if the ATI Display Library fails, as
+it does on windows after running for some time, when fanspeed reporting
+fails."
+- Stop special-casing worksize default to 256 for Cypress, since it incurs a 5
+MH/s hit with stock config
+- New "--scan-serial all" feature to probe all enumerated serial ports
+- modminer: Revamp dynamic clocking algorithm per request from cablepair
+- Test for lagging once more in queue_request to enable work to leak to backup
+pools.
+- There is no need to try to switch pools in select_pool since the current pool
+is actually not affected by the choice of pool to get work from.
+- Only clear the pool lagging flag if we're staging work faster than we're using
+it.
+- needed flag is currently always false in queue_request. Remove it for now.
+- thr is always NULL going into queue_request now.
+- Fix for non-ADL OpenCL device formatting issue
+
+
+BFGMiner Version 2.7.4 - August 23, 2012
+
+- Perform select_pool even when not lagging to allow it to switch back if needed
+to the primary.
+- Simplify macros in output kernels avoiding apparent loops and local variables.
+- Carry the needed bool over the work command queue.
+- Move the decision to queue further work upstream before threads are spawned
+based on fine grained per-pool stats and increment the queued count immediately.
+- Track queued and staged per pool once again for future use.
+- OpenCL 1.0 does not have native atomic_add and extremely slow support with
+atom_add so detect opencl1.0 and use a non-atomic workaround.
+- Pools: add RollTime info to API 'stats' and 'Stats' button in miner.php
+
+
+BFGMiner Version 2.7.3 - August 23, 2012
+
+- Minimise the number of getwork threads we generate.
+- Pick worksize 256 with Cypress if none is specified.
+- Give warning with sdk2.7 and phatk as well.
+- Whitelist sdk2.7 for diablo kernel as well.
+- Only keep the last 6 blocks in the uthash database to keep memory usage
+constant. Storing more is unhelpful anyway.
+- Increase kernel versions signifying changed APIs.
+- BFL flash - more FPGA-README
+- Check we haven't staged work while waiting for a curl entry before proceeding.
+- Use atomic ops to never miss a nonce on opencl kernels, including nonce==0,
+also allowing us to make the output buffer smaller.
+- Remove compile errors/warnings and document compile/usage in FPGA-README
+- Ignore the submit_fail flag when deciding whether to recruit more curls or not
+since we have upper bounds on how many curls can be recruited, this test is
+redundant and can lead to problems.
+- API-README update cgminer version number
+- API-README fix groups P: example mistake
+- API-README add COIN and other edits
+- miner.php allow 'coin' is custom pages
+
+
+BFGMiner Version 2.7.1 - August 22, 2012
+
+- Update windows build instructions courtesy of sharky.
+- Increase max curls to number of mining threads + queue * 2, accounting for up
+and downstream comms.
+- Queue enough requests to get started.
+- There is no point trying to clone_work in get_work() any more since we clone
+on every get_work_thread where possible.
+- There is no point subtracting 1 from maxq in get_work_thread.
+- miner.php allow page title to be defined in myminer.php
+- Only set lagging flag once there are no staged work items.
+- select_pool does not switch back to the primary once lagging is disabled.
+- Increment total work counter under mutex lock.
+- Increment the queued count after the curl is popped in case there's a delay
+waiting on curls and we think we've queued work when in fact we're waiting on
+curls.
+- Do the dynamic timing in opencl code over a single pass through scanhash to
+make sure we're only getting opencl times contributing to the measured
+intervals.
+- Increase curl reaping time to 5 minutes since comms between  curl requests can
+be 2 mins apart with lots of rolltime.
+- No need for extra variable in hash_push.
+- Remove short options -r and -R to allow them to be reused and remove readme
+entries for deprecated options.
+- Deprecate the opt_fail_pause parameter, leaving a null placeholder for
+existing configurations.
+- Free work before retrying in get_work_thread.
+- Don't pause after failed getwork, set lagging flag and reassess.
+- We should not be pausing in trying to resubmit shares.
+- Get rid of the extending fail pause on failed connects since we discard work
+after a period.
+- get_work always returns true so turn it into a void function.
+- get_work never returns false so get rid of fail pause loop.
+- Get rid of pause and retry from get_upstream_work so we only do it from one
+place.
+- Remove all cases where --retries aborts BFGMiner, making it for submission
+retries only, where it makes sense.
+
+
+BFGMiner Version 2.7.0 - August 21, 2012
+
+- Implement a new pool strategy, BALANCE, which monitors work performed per pool
+as a rolling average every 10 minutes to try and distribute work evenly over all
+the pools. Do this by monitoring diff1 solutions to allow different difficulty
+target pools to be treated equally, along with solo mining. Update the
+documentation to describe this strategy and more accurately describe the
+load-balance one.
+- fpga serial I/O extra debug (disabled by default)
+- Getwork fail was not being detected. Remove a vast amount of unused variables
+and functions used in the old queue request mechanism and redefine the getfail
+testing.
+- Consider us lagging only once our queue is almost full and no staged work.
+- Simplify the enough work algorithm dramatically.
+- Only queue from backup pools once we have nothing staged.
+- Don't keep queueing work indefinitely if we're in opt failover mode.
+- Make sure we don't opt out of queueing more work if all the queued work is
+from one pool.
+- Set lagging flag if we're on the last of our staged items.
+- Reinstate clone on grabbing work.
+- Grab clones from hashlist wherever possible first.
+- Cull all the early queue requests since we request every time work is popped
+now.
+- Keep track of staged rollable work item counts to speed up clone_available.
+- Make expiry on should_roll to 2/3 time instead of share duration since some
+hardware will have very fast share times.
+- Check that we'll get 1 shares' worth of work time by rolling before saying we
+should roll the work.
+- Simplify all those total_secs usages by initialising it to 1 second.
+- Overlap queued decrementing with staged incrementing.
+- Artificially set the pool lagging flag on pool switch in failover only mode as
+well.
+- Artificially set the pool lagging flag on work restart to avoid messages about
+slow pools after every longpoll.
+- Factor in opt_queue value into enough work queued or staged.
+- Roll work whenever we can on getwork.
+- Queue requests for getwork regardless and test whether we should send for a
+getwork from the getwork thread itself.
+- Get rid of age_work().
+- Don't try to get bitforce temperature if we're polling for a result to
+minimise the chance of interleaved responses.
+- Fix harmless unused warnings in scrypt.h.
+- Check we are not lagging as well as there is enough work in getwork.
+
+
+BFGMiner Version 2.6.5 - August 20, 2012
+
+- API new command 'coin' with mining information
+- Add message to share if it's a resubmit.
+- Add virtual adl mapping for when none is specified on the command line to
+not crash without a map specified.
+- Fix ADL gpu-map not working when there are more ADL devices than openCL.
+Patch supplied and tested by Nite69.
+- bitforce: Initial import of Linux-only bitforce-firmware-flash utility
+- Revert stale-on-arrival failsafe, since it ends up needing exceptions for
+everything
+- Bugfix: opencl: Declare opencl_dynamic_cleanup in header
+- Even if we want to submit stale shares, give up if we have more submissions
+waiting on threads (even before failing)
+- Even if we want to submit stale shares, give up if they've failed and we
+have more submissions waiting on threads
+- opencl: Use timeBeginPeriod on Windows to ensure gettimeofday has sufficient
+precision for dynamic intensity
+- Bugfix: opencl: Move ADL fanspeed warning messages to a new thread to get
+around summary-update deadlocking
+- README: Note that user groups don't get updated until re-login
+- Initialise cnt in libztex.c
+- Don't try to start devices that don't support scrypt when scrypt mining.
+- Repeating on timeout in ztex could make the code never return.
+- Offset libusb reads/writes by length written as well in ztex.
+- Cope with timeouts and partial reads in ztex code.
+- If there are more devices than nDevs, don't iterate over them as they may
+overwrite devices mapped below that with the mapping option.
+- Fix README faq on bfl auto-detect.
+- Set memory clock based on memdiff if present from with engine changes,
+allowing it to parallel manual changes from the menu as well.
+- api.c typo
+- API allow display/change failover-only setting
+- API-README corrections
+- miner.php documentation (in API-README) v0.1
+- Bugfix: opencl: Show blank device-info statline area if GPU doesn't have
+ADL, to fix column alignment
+- README: Document usage of 0 to indicate "leave at default" for comma-
+delimited GPU options
+- Correct API-README versions to match when BFGMiner included them
+- API-README update changelog
+- Minimise locking and unlocking when getting counts by reusing shared mutex
+lock functions.
+- Avoid getting more work if by the time the getwork thread is spawned we find
+ourselves with enough work.
+- The bitforce buffer is cleared and hw error count incremented on return from a
+failed send_work already so no need to do it within the send_work function.
+- Don't make mandatory work and its clones last forever.
+- modminer: Log debug info for nonces found
+
+
+BFGMiner Version 2.6.4 - August 11, 2012
+
+- Bugfix: Define my_cancellable_getch in miner.h
+- Escape " and \ when writing json config file
+- miner.php allow a custom page section to select all fields with '*' - e.g. to
+create a STATS section on a custom page
+- miner.php optional single rig totals (on by default)
+- Bugfix: Initialize submitting mutex
+- Bugfix: bitforce: Allocate enough space for FTDI description pointers
+- Queue one request for each staged request removed, keeping the staged
+request count optimal at all times.
+- Bugfix: Avoid cancelling threads while locks are held
+- Set recognizable names on threads for debugging
+- Bugfix: Don't keep making new get_work threads if all pools are dead
+- Enable configuring submission thread limit with --submit-threads option
+- Bugfix: Limit active submission threads to 0x40 so we don't overflow
+- Bugfix: Properly handle switching to pools that aren't on the latest block,
+and warn if a pool actively switches to an old block
+- Log more details of reasons in stale_work debug messages
+- Failsafe against stale-on-arrival work: disable the pool
+- Bugfix: Debug message should show "Work stale due to work restart" when it's
+not a share
+- windows-build: Remove APP SDK section since it is no longer needed
+- modminer: HACK: Let last_work handle the end of the work, and start the next
+one immediately
+- Bugfix: modminer: Remove erroneous "else" statement, to fix hashrate
+reporting
+- README: Document user group required for FPGAs on Gentoo and Ubuntu
+- BFGMiner-specific README adjustments
+- Bugfix: opencl: Ignore error getting device ids from platforms unless they
+are explicitly chosen
+- New --debuglog option to include debug info in stderr logfile even if not in
+the console
+- Bumped down debhelper compatibility reqs so that this will build on Lucid.
+- Updated to match packaging changes.
+- Switched to native packages so we don't have to muck around creating fake
+upstream tarballs, and can easily generate minor versions for upload to
+Launchpad.
+- Removed accidentally included debugging line.
+- Minor version bump again because of launchpad. Will sort this out for next
+release.
+- Updated to patch bitforce module issue on Debian/Ubuntu.
+- Added local quilt config dir to ignore.
+- modminer: Check nonce against previous work, in case of race
+- Bugfix: Enable --kernel-path option if ModMiner or Ztex is enabled (even if
+no OpenCL)
+- Bugfix: Escape backslashes and double-quotes in strings that rightfully may
+have them, when writing JSON config file
+- Clean object (.o) and dependency (.d) files out of source tree
+- Bugfix: bitforce: Don't count hashes that never happened due to throttling
+- Bugfix: Deal with serial_open timeout maximum (25.5s)
+- - fpgautils: Linux only supports uint8_t decisecond values for timeouts, so
+use uint8_t for timeout value; this gets smart compilers to throw warnings
+when overflowed in some cases
+- - bitforce: Reduce serial timeout to 25 seconds (was 30) and increase job
+long timeout to 25 seconds (was 15) to handle throttling gracefully
+- modminer: Add debug info to API extra device stats
+- modminer: Raise clock speed when there's only good nonces for a while
+- modminer: Only print clock speed adjustments when they actually change
+- modminer: Increase tolerance for bad nonces to 2%
+- modminer: Reset bad-nonce ratio measurement when the clock speed changes
+- Bugfix: bitforce: Include the correct device id in "garbled response" warning
+- ADL: Add attribution and disclaimer to interfaces
+- Cleaned out refs to AMD SDKs.
+- Updated README about debian packaging, changelog with minor version bump to
+work around Launchpad reqs.
+- Updated changelog with Ubuntu release specific version, needed to build for
+multiple releases. Also stripped out ADL SDK stuff in the build rules.
+- Initial work to adjust debian packaging from cgminer. Should build correctly
+now with pbuilder/pdebuild, and include docs.
+- Adapt miner code to free ADL structures
+- Import free ADL interfaces
+- Include scrypt.h in Makefile.
+- Fix windows bitforce build.
+- Convert the serial autodetect functions to use int instead of char to
+enumerate devices.
+- Uglify windows autodetect code for BFL.
+- There is no point zeroing temperature in BFL if we fail to get a response, and
+we should register it as a HW error, suggesting throttling.
+- Update SCRYPT README with information about HW errors.
+- Use the scrypt CPU code to confirm results from OCL code, and mark failures as
+HW errors, making it easier to tune scrypt parameters.
+- We may as well leave one curl still available per pool instead of reaping the
+last one.
+- Display reaped debug message outside mutex lock to avoid recursive locking.
+- api.c update API start message and include port number
+- miner.php ignore arg when readonly
+- miner.php allow pool inputs: delete, addpool, poolpriority
+- bitforce: Reopen on communication error
+- Bugfix: Calculate hw err percent for the affected FPGA only
+- make-release: Adapt to new autogen by using NOCONFIGURE var
+
+
+BFGMiner Version 2.6.3 - August 6, 2012
+
+- modminer: Relax no-nonces downclocking condition to be more reasonable
+- README: Update scrypt configure option
+- README: Update configure options
+- Bugfix: Display --disable-modminer in configure --help now that it is
+enabled by default
+- Add specific information when ADL detects error -10 saying the device is not
+enabled.
+- modminer: Shorten upload warning message to fit better
+- modminer: Sending a "ping" first, to workaround bug in new firmware betas
+- modminer: Include Hardware Errors and Valid Nonces in extra device status
+- Bugfix: modminer: Calculate bad-nonce percentage based only on the same
+FPGA's hardware errors, accurately
+- modminer: Show bitstream upload progress in statline, and only report to log
+every 10%
+- modminer: Be more verbose about why the clock is getting reduced
+- Document how Icarus golden nonce is handled by other FPGAs
+- Rewrite should_run for sched, to properly handle one-shot schedules spanning
+midnight
+- Bugfix: Check list_empty in pop_curl_entry after condition wait
+- Bugfix: Only add new pools to array after completing basic structure
+initialization
+- If __BFGMINER_SEGFAULT_ERRQUIT is set in the environment, segfault on
+non-zero quit()s
+- Check against NULL pointers getting into curlring
+- modminer: Finish a process results run with a nonce poll, rather than sleep
+- modminer: Workaround Windows driver failures
+- Count likely throttling episodes on bitforce devices as hardware errors.
+- Bugfix: bitforce: Increase serial read timeout to 30 seconds during actual
+mining, to tolerate more throttling
+- Style cleanups.
+- Make pool_disabled the first in the enums == 0, fixing the pool enabled count
+which compares if value is not enabled before enabling it.
+- Correct writing of scrypt parameters to config file based on command line
+parameters only.
+- Add scrypt support while writing conf
+- Use different variables for command line specified lookup gap and thread
+concurrency to differentiate user defined versus auto chosen values.
+- Queue a request on pool switch in case we have no work from the new pool yet.
+- API remove unused warning in non-GPU compile
+- api.c in linux allow to open a closed socket in TIME_WAIT
+- Display failover only mode in pool menu and allow it to be toggled live.
+- Reinstate check for system queueing lag when the current pool's queue is maxed
+out, there is no staged work, and the work is needed now.
+- Fix harmless warnings.
+- Check the current staged and global queued as well before queueing requests.
+Discard stales before ageing work in the watchdog thread. Queue requests after
+discarding and ageing work in watchdog thread. Display accurate global queued in
+curses output. Reuse variable in age_work().
+- The queueing mechanism has become a complex state machine that is no longer
+predictable. Rewrite it from scratch watching only current queues in flight and
+staged work available on a pool by pool basis.
+- Update debian package configs to v2.6.2
+- Queue an extra request whenever staged work drops below mining thread count in
+hash_pop.
+- Bugfix: Initialize logwin to 1 line high temporarily, to avert PDCurses crash
+- Enable FPGA support by default, as long as their dependencies are met
+- Bugfix: modminer: Search for *ModMiner* in udev ID_MODEL
+- make-release: build with --enable-scrypt
+- miner.php support custom report section joins
+- ICA default fpga_count to work_division if specified
+- FPGA-README document new hidden --icarus-options
+- ICA support 57600 baud rate, up to 8 FPGA and partial working FPGA boards
+- Scrypt mining does not support block testing yet so don't try to print it.
+- Clear the bitforce buffer whenever we get an unexpected result as it has
+likely throttled and we are getting cached responses out of order, and use the
+temperature monitoring as a kind of watchdog to flush unexpected results.
+- It is not critical getting the temperature response in bitforce so don't
+mandatorily wait on the mutex lock.
+- Check there is a cutoff temp actually set in bitforce before using it as a cut
+off value otherwise it may think it's set to zero degrees.
+- We dropped the temporary stopping of curl recruiting on submit_fail by
+mistake, reinstate it.
+- Make threads report in either side of the scanhash function in case we miss
+reporting in when restarting work.
+- Add debugging output when work is found stale as to why.
+- Print the 3 parameters that are passed to applog for a debug line in
+bitforce.c
+- Clear bitforce buffer on init as previously.
+- Add some headroom to the number of curls available per pool to allow for
+longpoll and sendwork curls.
+- Show the correct base units on GPU summary.
+- Bugfix: bitforce: 1 decisecond timeout is unreasonably short, give it a
+second
+- Bugfix: Don't try to log abandon time, since we aren't keeping track
+reasonably
+- Import uthash 1.9.6
+- Bugfix: bitforce: Pause after send_work failures
+- Fix comm error handling to not consider work restarts an error condition
+- comm error bug fix
+- Bugfix: No endian.h on Windows
+- Remove unused mkinstalldirs
+- Display scrypt as being built in as well.
+- Fix build warning about KL_SCRYPT when built without scrypt support.
+- News update.
+- More scrypt intensity information.
+- Minor readme updates.
+- Update README with more build instructions.
+- Remove the low hash count determinant of hardware being sick. A low hash rate
+can be for poor network connectivity or scrypt mining, neither of which are due
+to sick hardware.
+- Style
+- API-README poolpriority changes
+- api.c verify poolpriority parameters before changing pools
+- api.c poolpriority changes
+- Implement shared swap32(yes|tole|tobe) function to handle endian flipping
+32-bit chunks in blocks
+- Use correct macros for endian handling code
+
+
+BFGMiner Version 2.6.1 - July 29, 2012
+
+- Autoselect --scrypt iff all pools send scrypt work
+- Adapt SCRYPT-README to BFGMiner (directing Bitcoin donations the correct
+direction to reach Con)
+- Remove mentions of Litecoin specifically
+- Bugfix: Fix build without OpenCL but with scrypt
+- make-release: Add SCRYPT-README
+- Bump version 2.6.0, adding SCRYPT README to makefile.
+- Smarter autogen.sh script.
+- Sleeping on intensity decrease is broken, remove it.
+- Sleep only the extra amount of time we overran the dynamic interval in dynamic
+mode.
+- Add scrypt documentation in the form of a separate readme.
+- Fix build error without scrypt enabled.
+- Limit thread concurrency for scrypt to 5xshaders if shaders is specified.
+- Simplify repeated use of gpus[gpu]. in ocl.c
+- Find the nearest power of 2 maximum alloc size for the scrypt buffer that can
+successfully be allocated and is large enough to accomodate the thread
+concurrency chosen, thus mapping it to an intensity.
+- Don't make opt_scrypt mandatory blocking with opencl code.
+- Update kernel versions reflecting changes in the API.
+- Make the thread concurrency and lookup gap options hidden on the command line
+and autotune parameters with a newly parsed --shaders option.
+- Fix target testing with scrypt kernel as it would have been missing shares
+below target.
+- Always create the largest possible padbuffer for scrypt kernels even if not
+needed for thread_concurrency, giving us some headroom for intensity levels.
+- Use the detected maximum allocable memory on a GPU to determine the optimal
+scrypt settings when lookup_gap and thread_concurrency parameters are not given.
+- Check the maximum allocable memory size per opencl device.
+- Add debugging output if buffer allocation fails for scrypt and round up
+bufsize to a multiple of 256.
+- Nonce testing for btc got screwed up, leading to no accepted shares. Fix it.
+- Display size of scrypt buffer used in debug.
+- Allow intensities up to 20 if scrypt is compiled in.
+- Add name to scrypt kernel copyright.
+- Allow lookup gap and thread concurrency to be passed per device and store
+details in kernel binary filename.
+- Ignore negative intensities for scrypt.
+- Change the scale of intensity for scrypt kernel and fix a build warning.
+- Correct target value passed to scrypt kernel.
+- Use 256 output slots for kernels to allow 1 for each worksize.
+- Test the target in the actual scrypt kernel itself saving further
+calculations.
+- Reinstate GPU only opencl device detection.
+- Decrease lookup gap to 1. Does not seem to help in any way being 2.
+- Fix build.
+- Make pad0 and pad1 local variable in scrypt kernel.
+- Constify input variable in scrypt kernel.
+- Send correct values to scrypt kernel to get it finally working.
+- Create command queue before compiling program in opencl.
+- Fix external scrypt algo missing.
+- Limit scrypt to 1 vector.
+- Handle KL_SCRYPT in config write.
+- Get rid of stuff.
+- Don't enqueuewrite buffer at all for pad8 and pass work details around for
+scrypt in dev_blk.
+- Set the correct data for cldata and prepare for pad8 fixes.
+- Get rid of spaces in arrays in scrypt kernel.
+- Start with smaller amount of hashes in cpu mining to enable scrypt to return
+today sometime.
+- Free the scratchbuf memory allocated in scrypt and don't check if CPUs are
+sick since they can't be. Prepare for khash hash rates in display.
+- Add cpumining capability for scrypt.
+- Set scrypt settings and buffer size in ocl.c code to be future modifiable.
+- Cope with when we cannot set intensity low enough to meet dynamic interval by
+inducing a forced sleep.
+- Make dynamic and scrypt opencl calls blocking.
+- Fix nonce submission code for scrypt.
+- Make sure goffset is set for scrypt and drop padbuffer8 to something
+manageable for now.
+- Set up buffer8 for scrypt.
+- Build fix for opt scrypt.
+- Don't check postcalc nonce with sha256 in scrypt.
+- Don't test nonce with sha and various fixes for scrypt.
+- Make scrypt buffers and midstate compatible.
+- Use specific output array entries in scrypt kernel.
+- Provide initial support for the scrypt kernel to compile with and mine scrypt
+with the --scrypt option.
+- Enable completely compiling scrypt out.
+- Begin import of scrypt opencl kernel from reaper.
+
+
+BFGMiner Version 2.5.3 - July 29, 2012
+
+- Bugfix: Add zlib1.dll to Win32 release archive
+- Bugfix: SICK low-hashrate is now determined by being under 1/3 the runtime
+average hashrate
+- Bugfix: cpu_set_t is never #defined, so use CPU_ZERO which is a macro
+
+
+BFGMiner Version 2.5.2 - July 29, 2012
+
+- Limit total number of curls recruited per pool to the number of mining threads
+to prevent blasting the network when we only have one pool to talk to.
+- Bugfix: Skip writing configuration of range-limited int options with negative
+values
+- Bugfix: Correctly attempt to load ~/.bfgminer/bfgminer.conf or
+~/.cgminer/cgminer.conf as defaults
+- Send X-Minimum-Wait header on longpolls, to explicitly inform pools we will
+handle a response with no delay
+- bitforce: Abandon (only) stale searches for work restarts
+- Keep a counter of enabled pools and use that instead of iterating over the
+pool list. Use that value to ensure we don't set the last remaining active pool
+to the rejecting state.
+- bitforce: Skip out of sending work if work restart requested
+- RPC: Writeup on poolpriority command usage
+- Bugfix: API: Report errors from poolpriority command
+- RPC: New "poolpriority" command to set the order of pool priorities
+- strtok_ts: Thread-safe strtok that work on POSIX or Windows
+- Bugfix: Supress "caught up" event when first switching to a pool
+- Announce and restart work immediately when current pool has caught up to the
+current block
+- Bugfix: Don't consider work stale due to other pools' longpolls, if
+--failover-only is active
+- Refactor stale_work function to only flag actual stale shares
+- stale_work: Don't factor getwork delay into expiry for shares (only for work
+itself)
+- Bugfix: Use pool number rather than numeric pointer to strict pool, in block
+found notice
+- Accept JSON Numbers in config file parameters
+- Improve readability of OPT_HASARG in parse_config
+- Allow JSON false as a valid value for strictly boolean options
+- Include scan-serial in example configuration file
+- fpgautils: add support for 57.6 kBd serial
+- miner.php add a socket RCV timeout for if cgminer is hung and the API thread
+is still running
+- BFL force all code to timeout to avoid hanging
+- Initialise mdplatform.
+- Find the gpu platform with the most devices and use that if no platform option
+is passed.
+- Bugfix: It is not a hardware error if nonces returned from modminer don't
+meet the pool target
+- bitforce & icarus: Log detection failures at debug log level, so we don't
+confuse users who have different devices (which is why these drivers are
+failing detection!)
+- Show "WAIT" (LIFE_WAIT status) if a cgpu is idle waiting for work (pool
+slow/dead)
+- Instead of quitting on failing N retries, just discard the share
+- Bugfix: Don't discard stale shares after submission failure, if user or pool
+wants stales submitted
+- Bugfix: Record discard-during-retry shares in the sharelog
+- Bugfix: Only show Algorithm in RPC summary if CPU mining is actually active
+- OpenCL: Remove intensity from statline, since it overflowed
+- Move "Q" (requested getworks) to second status line as "GW" to balance out
+better
+- Bugfix: Use a mutex to control non-curses output
+- Simplify code to a single vprintf path for curses-less printing
+- Move opt_quiet check to my_log_curses, so it works for curses-less builds
+- Use log_generic for vapplog to cut down on code duplication
+- Bugfix: Copy argv[0] given to dirname()
+- Find the gpu platform with the most devices and use that if no platform
+option is passed.
+- Allow more platforms to be probed if first does not return GPUs.
+- Detach pthread from within the api thread in case it is terminated due to not
+being instantiated before pthread_cancel is called from main, leading to a
+segfault.
+- Debug output per thread hashrate is out by a factor of 1000.
+- Don't check if CPUs are sick since they can't be.
+- Calculate midstate in separate function and remove likely/unlikely macros
+since they're dependent on pools, not code design.
+- Display in debug mode when we're making the midstate locally.
+- Bugfix: Document --no-adl and --gpu-platform
+- Bugfix: Remove redundant documentation of --auto-fan and --auto-gpu (they
+are in GPU-specific options)
+- CPU mining may not be included in binaries, but it's not deprecated for
+BFGMiner either
+- Bugfix: Restore case-insensitivity to input
+- Scroll the device list with up/down arrow keys, if it is overflowed
+- Use select statement to handle input
+- Bugfix: Actually check that the device fits in the individual summary window
+before trying to print it
+- Bugfix: Fix build without curses but with OpenCL
+- Bugfix: Don't show a Temperature key if it isn't known
+- BFGMiner-specific NEWS fix
+
+
+BFGMiner Version 2.5.1 - July 13, 2012
+
+- Replace CPU Algo in header with runtime
+- Bugfix: Calculate diff-1 utility to fix utility-hashrate on pools with
+diff!=1
+- Add utility hashrate to curses display
+- Show units in kh, Gh, Th, etc as needed to use at most 3 integer digits
+- Use FTD2XX.DLL on Windows to autodetect BitFORCE SHA256 devices
+- bitforce_get_result returns -1 on error now.
+- Check return value of read in BFgets
+- Bugfix: modminer: Count hashes done before work restart
+- Bugfix: modminer: Adapt "get nonce" error condition to new scanhash=>-1
+error API
+- Bugfix: Make our Windows nanosleep/sleep replacements standards-compliant
+(which fixes nmsleep) and include compat.h for bitforce (for sleep)
+- miner.php fix rig # when miners fail
+- Fix whitespace mangling.
+- bitforce: Use "full work" vs "nonce range" for kernel name
+- Abbrv. correction
+- Remove superfluous ave_wait
+- Put kname change for broken nonce-range back in
+- Add average wait time to api stats
+- Revert "Merge branch 'ave_time' of https://github.com/pshep/cgminer.git"
+- Add average return time to api stats
+- Missed one nonce-range disabling.
+- Change timeouts to time-vals for accuracy.
+- More BFL tweaks. Add delay between closing and reopening port. Remove buffer
+clear in re-init Add kernel type (mini-rig or single)
+- Revert "Change BFL driver thread initialising to a constant 100ms delay
+between devices instead of a random arrangement."
+- Only try to shut down work cleanly if we've successfully connected and started
+mining.
+- Fix spelling.
+- modminer: Firmware returns 0xffffff00 immediately if we set clockspeed too
+high
+- Bugfix: modminer: Actually count good shares
+- Bugfix: Adapt OpenCL scanhash errors to driver API change (errors are now -1,
+not 0)
+- Remove bitforce_thread_init The delay thing does nothing useful... when long
+poll comes around, all threads restart at the same time anyway.
+- fix API support for big endian machines
+- Bugfix: Use const struct device_api* for mt_disable
+- modminer: Show progress of bitstream upload
+- Bugfix: Don't declare devices SICK if they're just busy initializing
+- Bugfix: Calculate nsec in nmsleep correctly
+- miner.php allow rig names in number buttons
+- Change BFL driver thread initialising to a constant 100ms delay between
+devices instead of a random arrangement.
+- Spelling typo.
+- Time opencl work from start of queueing a kernel till it's flushed when
+calculating dynamic intensity.
+- Modify te scanhash API to use an int64_t and return -1 on error, allowing zero
+to be a valid return value.
+- Check for work restart after the hashmeter is invoked for we lose the hashes
+otherwise contributed in the count.
+- Remove disabled: label from mining thread function, using a separate
+mt_disable function.
+- Style changes.
+- Cope with signals interrupting the nanosleep of nmsleep.
+- Use standard cfsetispeed/cfsetospeed to set baud rate on *nix
+- miner.php split() flagged deprecated in PHP 5.3.0
+- Bugfix: Use nmsleep instead of restart_wait, so we always wait the full time
+- Make long timeout 10seconds on bitforce for when usleep or nanosleep just
+can't be accurate...
+
+
+BFGMiner Version 2.5.0 - July 7, 2012
+
+- Fix BitFORCE driver to not silenty discard valid shares (bug introduced by
+CGMiner merges)
+- Fix --benchmark not working since the dynamic addition of pools and pool
+stats.
+- Make disabling BFL nonce range support a warning since it has to be explicitly
+enabled on the command line now.
+- miner.php allow renaming table headers
+- Make bitforce nonce range support a command line option --bfl-range since
+enabling it decrease hashrate by 1%.
+- Add sanity checking to make sure we don't make sleep_ms less than 0 in
+bitforce.
+- The fastest minirig devices need a significantly smaller starting sleep time.
+- Use a much shorter initial sleep time to account for faster devices and nonce
+range working, and increase it if nonce range fails to work.
+- Use nmsleep instead of usleep in bitforce.
+- Provide a ms based sleep function that uses nanosleep to avoid the inaccuracy
+of usleep on SMP systems.
+- delay_time_ms is always set so need not be initialised in bitforce.
+- Increase bitforce timeout to 10 seconds.
+- Add more hysteresis and poll ~5 times to allow for timer delays in bitforce
+devices.
+- miner.php allow alternating line colours (off by default)
+- Display the actual duration of wait when it is greater than the cutoff.
+- Set nonce to maximum once we determine nonce range support is broken.
+- Initial wait time is always known so no need to zero it beforehand in
+bitforce.
+- No point counting wait time until the work is actually sent to bitforce
+devices.
+- Use string comparison functions instead of explicit comparisons.
+- Account for wait_ms time when nonce_range is in use on BFL.
+- Split nonces up into 1/5 chunks when nonce range is supported.
+- limit clear buffer iterations.
+- Ad fd check to clear buffer.
+- miner.php remove incorrect 'DATE' error message
+- miner.php allow summary header in custom pages
+- Disable nonce range support in BFL when broken support is detected.
+- Restart_wait is only called with a ms value so incorporate that into the
+function.
+- Only try to adjust dev width when curses is built in.
+- miner.php define custom sum fields as a simple array
+- Fix off-by-one error in nonce increment in bfl.
+- Use BE when setting nonce in bitforce nonce range work.
+- Enable nonce range in the normal init sequence for bfl.
+- Queue extra work at 2/3 differently depending on whether we're using nonce
+range or not.
+- Initially enable support for nonce range support on bfl, splitting nonces up
+into 3/4 size and only disable it if it fails on work submit.
+- Attempt to detect nonce range support in BFL by sending work requring its
+support.
+- Limit retrying on busy for up to BITFORCE_TIMEOUT_MS
+- Attempt to initialise while bitforce device returns BUSY.
+- Extend length of string that can be passed to BFL devices.
+- Fix signedness warning.
+- Adjust device width column to be consistent.
+- Use cgpu-> not gpus[] in watchdog thread.
+- Add api stats (sleep time)
+- Timing tweaks Added long and short timeouts, short for detecting throttling,
+long to give up totally. Reset sleep time when device re-initialised Still check
+results after timeout Back up a larger time if result on first poll.
+- Add API Notify counter 'Comms Error'
+- Style police on api.c
+- Do all logging outside of the bitforce mutex locking to avoid deadlocks.
+- Remove applog call from bfwrite to prevent grabbing nested mutexes.
+- Bitforce style changes.
+- Minor style changes.
+- Remove needless roundl define.
+- Made JSON error message verbose.
+- Fine-tune timing adjustment. Also remove old work_restart timing.
+- Check for gpu return times of >= 0, not just 0, to fix intensity dropping to
+-10.
+- Restart is zeroed in the mining thread so no need to do it inside the bitforce
+code.
+- More improvements to comms. BFL return nothing when throttling, so should not
+be considered an error. Instead repeat with a longer delay.
+- Polling every 10ms there's not much point checking the pthread_cond_timedwait
+as it just adds overhead. Simply check the value of work_restart in the bfl main
+polling loop.
+- Use a pthread conditional that is broadcast whenever work restarts are
+required. Create a generic wait function waiting a specified time on that
+conditional that returns if the condition is met or a specified time passed to
+it has elapsed. Use this to do smarter polling in bitforce to abort work, queue
+more work, and check for results to minimise time spent working needlessly.
+- Add busy time to wait time.
+- api.c put version up to 1.14
+- Add tiny delay after writing to BFL Change BFL errors to something more human
+readable Send work busy re-tries after 10ms delay
+- Fix race condition in thread creation that could under some conditions crash
+BFGMiner at startup
+
+
+BFGMiner Version 2.4.4 - July 1, 2012
+
+- Fix builds on non gnu platforms.
+- api.c ensure old mode is always available when not using --api-groups + quit()
+on param errors
+- Implement rudimentary X-Mining-Hashrate support.
+- Detect large swings in temperature when below the target temperature range and
+change fan by amounts dependant on the value of tdiff.
+- Adjust the fanspeed by the magnitude of the temperature difference when in the
+optimal range.
+- Revert "Restarting cgminer from within after ADL has been corrupted only leads
+to a crash. Display a warning only and disable fanspeed monitoring."
+- api.c fix json already closed
+- implement and document API option --api-groups
+- Put upper bounds to under 2 hours that work can be rolled into the future for
+bitcoind will deem it invalid beyond that.
+- define API option --api-groups
+- api.c allow unwell devices to be enabled so they can be cured
+- miner.php - fix/enable autorefresh for custom pages
+- miner.php allow custom summary pages - new 'Mobile' summary
+- Work around pools that advertise very low expire= time inappropriately as this
+leads to many false positives for stale shares detected.
+- Only show ztex board count if any exist.
+- There is no need for work to be a union in struct workio_cmd
+- fpgautils.c include a debug message for all unknown open errors
+- Don't keep rolling work right up to the expire= cut off. Use 2/3 of the time
+between the scantime and the expiry as cutoff for reusing work.
+- Log a specific error when serial opens fail due to lack of user permissions
+- Increase GPU timing resolution to microsecond and add sanity check to ensure
+times are positive.
+- Opencl code may start executing before the clfinish order is given to it so
+get the start timing used for dynamic intensity from before the kernel is
+queued.
+- fpgautils.c - set BAUD rate according to termio spec
+- fpgautils.c - linux ordering back to the correct way
+- miner.php remove unneeded '.'s
+- miner.php add auto refresh options
+- miner.php add 'restart' next to 'quit'
+- miner.php make fontname/size configurable with myminer.php
+- Make the pools array a dynamically allocated array to allow unlimited pools to
+be added.
+- Make the devices array a dynamically allocated array of pointers to allow
+unlimited devices.
+- Dynamic intensity for GPUs should be calculated on a per device basis. Clean
+up the code to only calculate it if required as well.
+- Bugfix: Provide alternative to JSON_ENCODE_ANY for Jansson 1.x
+- Use a queueing bool set under control_lock to prevent multiple calls to
+queue_request racing.
+- Use the work clone flag to determine if we should subtract it from the total
+queued variable and provide a subtract queued function to prevent looping over
+locked code.
+- Don't decrement staged extras count from longpoll work.
+- Count longpoll's contribution to the queue.
+- Increase queued count before pushing message.
+- Test we have enough work queued for pools with and without rolltime
+capability.
+- As work is sorted by age, we can discard the oldest work at regular intervals
+to keep only 1 of the newest work items per mining thread.
+- Roll work again after duplicating it to prevent duplicates on return to the
+clone function.
+- Abstract out work cloning and clone $mining_threads copies whenever a rollable
+work item is found and return a clone instead.
+- api.c display Pool Av in json
+- Take into account average getwork delay as a marker of pool communications
+when considering work stale.
+- Work out a rolling average getwork delay stored in pool_stats.
+- Getwork delay in stats should include retries for each getwork call.
+- Walk through the thread list instead of searching for them when disabling
+threads for dynamic mode.
+- Extend nrolltime to support the expiry= parameter. Do this by turning the
+rolltime bool into an integer set to the expiry time. If the pool supports
+rolltime but not expiry= then set the expiry time to the standard scantime.
+- When disabling fanspeed monitoring on adl failure, remove any twin GPU
+association. This could have been leading to hangs on machines with dual GPU
+cards when ADL failed.
+- modminer: Don't delay 2nd+ FPGAs during work restart
+- Disable OpenCL code when not available.
+- Fix openwrt crashing on regeneratehash() by making check_solve a noop.
+- Fix sign warning.
+- Bugfix: icarus: properly store/restore info and work end times across longpoll
+restarts
+- Enable modminer for release builds
+
+
+BFGMiner Version 2.4.3 - June 14, 2012
+
+- Change device API "name" to reflect driver name abbreviation instead of device type name
+- miner.php allow a separate user settings file
+- modminer: Implement extended device stats to expose each Board to the RPC API
+- Bugfix: Use new cgpu->thr for longpoll waking
+- bitforce: Remove 4.5s delay before polling starts, since MiniRig finishes sooner
+- FPGA - allow device detect override without an open failure
+- Bugfix: Missing printf value in merge from cgminer
+- Ensure C compiler is in C99 mode
+- Add CPU core count detection for BSD/Mac
+- Set CPU mining idle priority on Windows
+- can_roll and should_roll should have no bearing on the cycle period within the
+miner_thread so remove it.
+- Check for strategy being changed to load balance when enabling LPs.
+- Check that all threads on the device that called get_work are waiting on
+getwork before considering the pool lagging.
+- Iterate over each thread belonging to each device in the hashmeter instead of
+searching for them now that they're a list.
+- When using rotate pool strategy, ensure we only select from alive enabled
+pools.
+- Start longpoll from every pool when load balance strategy is in use.
+- Add mandatory and block fields to the work struct. Flag any shares that are
+detected as blocks as mandatory to submit, along with longpoll work from a
+previously rejecting pool.
+- Consider the fan optimal if fanspeed is dropping but within the optimal speed
+window.
+- Fix typo in some API messages (succeess/success)
+- api.c MMQ stat bugs
+- Bugfix: Fix warnings when built without libudev support
+- Bugfix: slay a variety of warnings
+- Bugfix: modminer: Fix unsigned/signed comparison and similar warnings
+- API add ModMinerQuad support
+- Bugfix: Honour forceauto parameter in serial_detect functions
+- modminer: Temperature sensor improvements
+- modminer: Make log messages more consistent in format
+- Only adjust GPU speed up if the fanspeed is within the normal fanrange and
+hasn't been turned to maximum speed under overheat conditions.
+- ModMiner use valid .name
+- New driver: BTCFPGA ModMiner
+- Abstract generally useful FPGA code into fpgautils.c
+- API add stats for pool getworks
+- miner.php option to hide specific fields from the display
+- miner.php add version numbers to the summary page
+- Update debian configs to v2.4.2
+- Add API and FPGA READMEs into Makefile to be included in source distribution.
+- Icarus - fix unit64_t printf warnings
+
+
+BFGMiner Version 2.4.2 - June 2, 2012
+
+- Use epoll to immediately interrupt Icarus with new work on longpolls (Linux)
+- API.class compiled with Java SE 6.0_03 - works with Win7x64
+- miner.php highlight devs too slow finding shares (possibly failing)
+- API update version to V1.11 and document changes
+- API save default config file if none specified
+- api.c save success incorrectly returns error
+- api.c replace BUFSIZ (linux/windows have different values)
+- Move RPC API content out of README to API-README
+- Open a longpoll connection if a pool is in the REJECTING state as it's the
+only way to re-enable it automatically.
+- Use only one longpoll as much as possible by using a pthread conditional
+broadcast that each longpoll thread waits on and checks if it's the current pool
+before
+- If shares are known stale, don't use them to decide to disable a pool for
+sequential rejects.
+- Restarting cgminer from within after ADL has been corrupted only leads to a
+crash. Display a warning only and disable fanspeed monitoring.
+- Icarus: fix abort calculation/allow user specified abort
+- Icarus: make --icarus-timing hidden and document it in FPGA-README
+- Icarus: high accuracy timing and other bitstream speed support
+- add-MIPSEB-to-icarus-for-BIG_ENDIAN
+- work_decode only needs swab32 on midstate under BIG ENDIAN
+- add compile command to api-example.c
+- save config bugfix: writing an extra ',' when no gpus
+- Add dpkg-source commits
+
+
+BFGMiner Version 2.4.1 - May 6, 2012
+
+- Icarus: Calibrate hashrate yet even more accurately
+- In the unlikely event of finding a block, display the block solved count with
+the pool it came from for auditing.
+- Display the device summary on exit even if a device has been disabled.
+- Use correct pool enabled enums in api.c.
+- Import Debian packaging configs
+- Ensure we test for a pool recovering from idle so long as it's not set to
+disabled.
+- Fix pool number display.
+- Give BFGMiner -T message only if curses is in use.
+- Reinit_adl is no longer used.
+- API 'stats' allow devices to add their own stats also for testing/debug
+- API add getwork stats to BFGMiner - accesable from API 'stats'
+- Don't initialise variables to zero when in global scope since they're already
+initialised.
+- Get rid of unitialised variable warning when it's false.
+- Move a pool to POOL_REJECTING to be disabled only after 3 minutes of
+continuous rejected shares.
+- Some tweaks to reporting and logging.
+- API support new pool status
+- Add a temporarily disabled state for enabled pools called POOL_REJECTING and
+use the work from each longpoll to help determine when a rejecting pool has
+started working again. Switch pools based on the multipool strategy once a pool
+is re-enabled.
+- Removing extra debug
+- Fix the benchmark feature by bypassing the new networking code.
+- Reset sequential reject counter after a pool is disabled for when it is
+re-enabled.
+- ztex updateFreq was always reporting on fpga 0
+- Trying harder to get 1.15y working
+- Specifying threads on multi fpga boards extra cgpu
+- Missing the add cgpu per extra fpga on 1.15y boards
+- API add last share time to each pool
+- Don't try to reap curls if benchmarking is enabled.
+
+
+BFGMiner Version 2.4.0 - May 3, 2012
+
+- Only show longpoll warning once when it has failed.
+- Convert hashes to an unsigned long long as well.
+- Detect pools that have issues represented by endless rejected shares and
+disable them, with a parameter to optionally disable this feature.
+- Bugfix: Use a 64-bit type for hashes_done (miner_thread) since it can overflow
+32-bit on some FPGAs
+- Implement an older header fix for a label existing before the pthread_cleanup
+macro.
+- Limit the number of curls we recruit on communication failures and with
+delaynet enabled to 5 by maintaining a per-pool curl count, and using a pthread
+conditional that wakes up when one is returned to the ring buffer.
+- Generalise add_pool() functions since they're repeated in add_pool_details.
+- Bugfix: Return failure, rather than quit, if BFwrite fails
+- Disable failing devices such that the user can attempt to re-enable them
+- Bugfix: thread_shutdown shouldn't try to free the device, since it's needed
+afterward
+- API bool's and 1TBS fixes
+- Icarus - minimise code delays and name timer variables
+- api.c V1.9 add 'restart' + redesign 'quit' so thread exits cleanly
+- api.c bug - remove extra ']'s in notify command
+- Increase pool watch interval to 30 seconds.
+- Reap curls that are unused for over a minute. This allows connections to be
+closed, thereby allowing the number of curl handles to always be the minimum
+necessary to not delay networking.
+- Use the ringbuffer of curls from the same pool for submit as well as getwork
+threads. Since the curl handles were already connected to the same pool and are
+immediately available, share submission will not be delayed by getworks.
+- Implement a scaleable networking framework designed to cope with any sized
+network requirements, yet minimise the number of connections being reopened. Do
+this by create a ring buffer linked list of curl handles to be used by getwork,
+recruiting extra handles when none is immediately available.
+- There is no need for the submit and getwork curls to be tied to the pool
+struct.
+- Do not recruit extra connection threads if there have been connection errors
+to the pool in question.
+- We should not retry submitting shares indefinitely or we may end up with a
+huge backlog during network outages, so discard stale shares if we failed to
+submit them and they've become stale in the interim.
+
+
+BFGMiner Version 2.3.6 - April 29, 2012
+
+- Shorten stale share messages slightly.
+- Protect the freeing of current_hash under mutex_lock to prevent racing on it
+when set_curblock is hit concurrently.
+- Change default behaviour to submitting stale, removing the --submit-stale
+option and adding a --no-submit-stale option.
+- Make sure to start the getwork and submit threads when a pool is added on the
+fly. This fixes a crash when a pool is added to running BFGMiner and then
+switched to.
+- Faster hardware can easily outstrip the speed we can get work and submit
+shares when using only one connection per pool.
+- Test the queued list to see if any get/submits are already queued and if they
+are, start recruiting extra connections by generating new threads.
+- This allows us to reuse network connections at low loads but recuit new open
+connections as they're needed, so that BFGMiner can scale to hardware of any
+size.
+
+
+BFGMiner Version 2.3.5 - April 28, 2012
+
+- Restarting BFGMiner leads to a socket that can't be bound for 60 seconds, so
+increase the interval that API binding waits to 30 seconds to minimise the
+number of times it will retry, spamming the logs.
+- Give a longpoll message for any longpoll that detects a block change, primary
+or backup, and also display which pool it was.
+- Decrease utility display to one decimal place.
+- Small cosmetic output alignment.
+- Add pool number to stale share message.
+- Add space to log output now that there is more screen real estate available.
+- Indentation clean up.
+- Remove thread id display from rejected shares as well.
+- Merge pull request #185 from Diapolo/diakgcn
+- add goffset support for diakgcn with -v 1 and update kernel version
+- Set have_longpoll to true when there is at least one pool with longpoll.
+- Don't display the thread ID since it adds no useful information over the
+device number.
+- Don't display the first 8 bytes of a share since they will always be zero at
+>= 1 difficulty.
+- work->longpoll is reset across test_work_current so we need to recheck what
+pool it belongs to.
+- Use longpolls from backup pools with failover-only enabled just to check for
+block changes, but don't use them as work.
+- Start longpoll only after we have tried to extract the longpoll URL.
+- Check for submitold flag on resubmit of shares, and give different message for
+stale shares on retry.
+- Check for submitold before submitstale.
+- Don't force fresh curl connections on anything but longpoll threads.
+- Create one longpoll thread per pool, using backup pools for those pools that
+don't have longpoll.
+- Use the work created from the longpoll return only if we don't have
+failover-enabled, and only flag the work as a longpoll if it is the current
+pool.
+- This will work around the problem of trying to restart the single longpoll
+thread on pool changes that was leading to race conditions.
+- It will also have less work restarts from the multiple longpolls received from
+different pools.
+- Remove the invalid entries from the example configuration file.
+- Add support for latest ATI SDK on windows.
+- Export missing function from libztex.
+- miner.php change socktimeoutsec = 10 (it only waits once)
+- Bugfix: Make initial_args a const char** to satisfy exec argument type warning
+(on Windows only)
+- miner.php add a timeout so you don't sit and wait ... forever
+- Create discrete persistent submit and get work threads per pool, thus allowing
+all submitworks belonging to the same pool to reuse the same curl handle, and
+all getworks to reuse their own handle.
+- Use separate handles for submission to not make getwork potentially delay
+share submission which is time critical.
+- This will allow much more reusing of persistent connections instead of opening
+new ones which can flood routers.
+- This mandated a rework of the extra longpoll support (for when pools are
+switched) and this is managed by restarting longpoll cleanly and waiting for a
+thread join.
+- miner.php only show the current date header once
+- miner.php also add current time like single rig page
+- miner.php display rig 'when' table at top of the multi-rig summary page
+- README - add some Ztex details
+- api.c include zTex in the FPGA support list
+- api.c ensure 'devs' shows PGA's when only PGA code is compiled
+- miner.c sharelog code consistency and compile warning fix
+- README correct API version number
+- README spelling error
+- api.c combine all pairs of sprintfs()
+- api.c uncomment and use BLANK (and COMMA)
+- Code style cleanup
+- Annotating frequency changes with the changed from value
+- README clarification of 'notify' command
+- README update for API RPC 'devdetails'
+- api.c 'devdetails' list static details of devices
+- Using less heap space as my TP-Link seems to not handle this much
+
+
+BFGMiner Version 2.3.4 - April 26, 2012
+
+- New maintainership of code with modular FPGA/GPU focus, under BFGMiner name
+- Complete working support for cross-compiling Windows builds on Linux.
+- Fix usage of low --scan-time settings so it doesn't busy-loop
+- JSON API: Add new 'devdetail' command to get fixed device information
+- JSON API: Implement driver abstraction for extra device status
+- Icarus: Use epoll to wait for serial port input properly, when available
+- Icarus: Workaround buggy USB-UART that causes Icarus to stop mining rarely
+- Icarus: Estimate mining hashrate correctly, calibrated from real-world data
+- Icarus: Parallelize work setup with Icarus hash search improving performance
+- Icarus: More reliable detection and runtime
+- OpenCL: Move GPU-specific data fetching from JSON API to OpenCL driver
+- OpenCL: Dynamically load OpenCL library, to be more vendor-independent and
+allow use without actually having OpenCL (i.e. FPGA-only rigs).
+
+
+CGMiner Version 2.3.4 - April 25, 2012
+
+- Extensively document the cause of GPU device issues and the use of --gpu-map.
+- Support for share logging
+- Detect poorly performing combination of SDK and phatk kernel and add verbose
+warning at startup.
+- Icarus update to new add_cgpu()
+- Icarus driver working with Linux and Windows
+- api.c fix unused variable compile warning
+- Display all OpenCL devices when -n is called as well to allow debugging of
+differential mapping of OpenCL to ADL.
+- Add a --gpu-map option which will allow arbitrarily mapping ADL devices to
+OpenCL devices for instances where association by enumeration alone fails.
+- Increase upper limit on number of extra items to queue as some FPGA code can't
+yet reliably keep many devices busy.
+- Display configuration file information when -c option is passed and only when
+file exists on loading default config file.
+- Display configuration file loaded, if any, and debug output if configuration
+file parsing failed.
+- Add missing ztex header to Makefile for distribution.
+- Document long-form COM port device names on Windows, required to specify
+serial ports above 9
+- Include ztex bitstreams firmware in distribution and install if configured in.
+- Style police on driver-ztex.c
+- work_restart should only be changed by cgminer.c now
+- Shut down the api cleanly when the api thread is cancelled. This should allow
+the api socket to be closed successfully to next be reopened with app_restart.
+- Make a union for cgpu device handles, and rename "device" to "device_ztex"
+since it's Ztex-specific
+- Initialise name variable.
+- Remove unnecessary check for variable that always has memory allocated.
+- Bugfix: Missing "break" no-op in default case
+- Make the status window and log window as large as can fit on startup,
+rechecking to see if it can be enlarged after the fact. This allows any number
+of devices to be displayed provided the window is made long enough without
+corrupting the output.
+- Style police on libztex.c.
+- API add removepool like the screen interface
+- api.c escape required characters in return strings + pools returns the
+username
+- Set lp_path to NULL after free for consistency.
+- Removing dmalloc import left behind by mistake
+- Fixing leak in resp_hdr_cb
+- miner.php warning highlight GPU stats if they are zero (e.g. ADL not enabled)
+- miner.php highlight any device that isn't 'Enabled'
+- miner.php highlight any Status that isn't 'Alive'
+- miner.php optionally support multiple rigs
+- Initial Ztex support 1.15x board.
+
+
+CGMiner Version 2.3.3 - April 15, 2012
+
+- Don't even display that cpumining is disabled on ./configure to discourage
+people from enabling it.
+- Do a complete cgminer restart if the ATI Display Library fails, as it does on
+windows after running for some time, when fanspeed reporting fails.
+- Cache the initial arguments passed to cgminer and implement an attempted
+restart option from the settings menu.
+- Disable per-device status lines when there are more than 8 devices since
+screen output will be corrupted, enumerating them to the log output instead at
+startup.
+- Reuse Vals[] array more than W[] till they're re-initialised on the second
+sha256 cycle in poclbm kernel.
+- Minor variable alignment in poclbm kernel.
+- Make sure to disable devices with any status not being DEV_ENABLED to ensure
+that thermal cutoff code works as it was setting the status to DEV_RECOVER.
+- Re-initialising ADL simply made the driver fail since it is corruption over
+time within the windows driver that's responsible. Revert "Attempt to
+re-initialise ADL should a device that previously reported fanspeed stops
+reporting it."
+- Microoptimise poclbm kernel by ordering Val variables according to usage
+frequency.
+
+
+CGMiner Version 2.3.2 - March 31, 2012
+
+- Damping small changes in hashrate so dramatically has the tendency to always
+make the hashrate underread so go back to gentle damping instead.
+- Revert the crossover of variables from Vals to W in poclbm kernel now that
+Vals are the first declared variables so they're used more frequently.
+- Vals variables appearing first in the array in poclbm is faster.
+- Change the preferred vector width to 1 for Tahiti only, not all poclbm
+kernels.
+- Use a time constant 0.63 for when large changes in hashrate are detected to
+damp change in case the large change is an aliasing artefact instead of a real
+chang
+- Only increment stale counter if the detected stales are discarded.
+- Attempt to re-initialise ADL should a device that previously reported fanspeed
+stops reporting it.
+- Move the ADL setup and clearing to separate functions and provide a reinit_adl
+function to be used when adl fails while running.
+- Use slightly more damping on the decay time function in the never-ending quest
+to smooth off the hashmeter.
+- Set the starting fanspeed to a safe and fairly neutral 50% when autofan is
+enabled.
+- Provide locking around updates of cgpu hashrates as well to prevent multiple
+threads accessing data fields on the same device.
+- Display the beginning of the new block in verbose mode in the logs.
+- Reinstate old diablo kernel variable ordering from 120222, adding only goffset
+and vector size hint. The massive variable ordering change only helped one SDK
+on
+- Change the version number on the correct kernels.
+- api.c devicecode/osinfo incorrectly swapped for json
+- Add extensive instructions on how to make a native windows build.
+- Update version numbers of poclbm and diablo kernels as their APIs have also
+changed.
+- Use global offset parameter to diablo and poclbm kernel ONLY for 1 vector
+kernels.
+- Use poclbm preferentially on Tahiti now regardless of SDK.
+- Remove unused constant passed to poclbm.
+- Clean up use of macros in poclbm and use bitselect everywhere possible.
+- Add vector type hint to diablo kernel.
+- Add worksize and vector attribute hints to the poclbm kernel.
+- Spaces for non-aligned variables in poclbm.
+- Swap Vals and W variables where they can overlap in poclbm.
+- More tidying of poclbm.
+- Tidy up first half of poclbm.
+- Clean up use of any() by diablo and poclbm kernels.
+- Minor variable symmetry changes in poclbm.
+- Put additions on separate lines for consistency in poclbm.
+- Consolidate last use of W11 into Vals4 in poclbm.
+- Change email due to SPAM
+- api.c miner.php add a '*' to the front of all notify counters - simplifies
+future support of new counters
+- miner.php add display 'notify' command
+- Small change to help arch's without processor affinity
+- Fix bitforce compile error
+- api.c notify should report disabled devices also - of course
+- API returns the simple device history with the 'notify' command
+- code changes for supporting a simple device history
+- api.c Report an OS string in config to help with device issues
+- api.c fix Log Interval - integer in JSON
+- api.c config 'Device Code' to show list of compiled devices + README
+- api.c increase buffer size close to current code allowable limit
+- removed 8-component vector support from kernel, as this is not supported in
+CGMINER anyway
+- forgot to update kernel modification date, fixed ;)
+- reordered an addition in the kernel, which results in less instructions used
+in the GPU ISA code for GCN
+- miner.php: option for readonly or check privileged access
+- Ignore reduntant-with-build options --disable-gpu, --no-adl, and --no-restart
+- miner.php: ereg_replace is DEPRECATED so use preg_replace instead
+- Make curses TUI support optional at compile-time.
+- Bugfix: AC_ARG_WITH provides withval instead of enableval
+- miner.php split devs output for different devices
+- api.c: correct error messages
+- icarus.c modify (regular) timeout warning to only be debug
+- icarus.c set the windows TODO timeout
+- Allow specifying a specific driver for --scan-serial
+- optimized nonce-check and output code for -v 2 and -v 4
+- Bugfix: Check for libudev header (not just library) in configure, and document
+optional dependency
+- Add API support for Icarus and Bitforce
+- Next API version is 1.4 (1.3 is current)
+- README/api.c add "When" the request was processed to STATUS
+- Bugfix: ZLX to read BitFORCE temp, not ZKX -.-
+- Use libudev to autodetect BitFORCE GPUs, if available
+- Use the return value of fan_autotune to set fan_optimal instead of passing it
+as a pointer.
+- Pass the lasttemp from the device we're using to adjust fanspeed in twin
+devices.
+- fix the name to 3 chars, fix the multi-icarus support
+- Bugfix: "-S auto" is the default if no -S is specified, and there is no such
+delay in using it
+- README add information missing from --scan-serial
+- Update README RPC API Version comment
+- Bugfix: Allow enabling CPU even without OpenCL support
+- Change failed-to-mine number of requested shares messge to avoid segfault on
+recursive calling of quit().
+- Get rid of extra char which is just truncated in poclbm kernel.
+- only small code formating changes
+- removed vec_step() as this could lead to errors on older SDKs
+- unified code for generating nonce in kernel and moved addition of base to the
+end -> faster
+
+CGMiner Version 2.3.1 - February 24, 2012
+
+- Revert input and output code on diakgcn and phatk kernels to old style which
+worked better for older hardware and SDKs.
+- Add a vector*worksize parameter passed to those kernels to avoid one op.
+- Increase the speed of hashrate adaptation.
+- Only send out extra longpoll requests if we want longpolls.
+- API implement addpool command
+- API return the untouched Total MH also (API now version 1.3)
+- Add enable/disablepool to miner.php example and reduce font size 1pt
+
+
+CGMiner Version 2.3.0 - February 23, 2012
+
+- Consider extra longpoll work items as staged_extra so as to make sure we queue
+more work if queueing regular work items as longpolls.
+- Use diablo kernel on all future SDKs for Tahiti and set preferred vector width
+to 1 on poclbm kernel only.
+- Explicitly type the constants in diakgcn kernel as uint, to be in line with
+poclbm kernel.
+- Reset all hash counters at the same time as resetting start times to get
+accurate hashrates on exiting which is mandatory for benchmarking.
+- Report thread out before it starts to avoid being flagged as sick when waiting
+for the first work item.
+- Don't disable and re-enable devices as they may recover and in the meantime
+have their status set to OFF.
+- API new commands enablepool and disablepool (version already incremented)
+- Tolerate new-format temperature readings for bitforce
+- Modify cgminer.c pool control to allow API to call it
+- Bugfix: Fix BitFORCE driver memory leak in debug logging
+- Extra byte was being unused in poclbm leading to failure on some platforms.
+- Explicitly type the constants in poclbm kernel as uint.
+- Don't save 'include' when saving the configuration
+- Allow configuration file to include another recursively
+- Use the SDK and hardware information to choose good performing default
+kernels.
+- Move phatk kernel to offset vector based nonce bases as well.
+- Add a --benchmark feature which works on a fake item indefinitely to compare
+device performance without any server or networking influence.
+- Allow writing of multiple worksizes to the configuration file.
+- Allow writing of multiple vector sizes to the configuration file.
+- Allow writing of multiple kernels to the configuration file.
+- Allow multiple different kernels to be chosen per device.
+- Allow the worksize to be set per-device.
+- Allow different vectors to be set per device.
+- If we're well below the target temperature, increase gpu engine speed back to
+maximum in case we have gotten lost between profiles during an idle period.
+- We should be setting the value of fan_optimal, not its address.
+- As all kernels will be new versions it's an opportunity to change the .bin
+format and make it simpler. Specifying bitalign is redundant and long can be l.
+- Use any() in kernel output code.
+- Put the nonce for each vector offset in advance, avoiding one extra addition
+in the kernel.
+- Reset times after all mining threads are started to make estimating hashrates
+easier at startup.
+- Bugfix: allow no-exec (NX) stack
+- Fix minor warning.
+- fix the bitforce.c code style follow 1TBS
+- fix icarus.c compile warning
+- small changes to speedup no vec for AMD 898.1 OCL runtime
+- Update licensing to GPL V3.
+- Reset the longpoll flag after it's been used once to prevent it restarting
+work again.
+- Begin import of DiabloMiner kernel.
+- Modify API debug messages to say API instead of DBG
+- When API shuts down cgminer don't kill itself
+- Don't make rolled work from the longpoll be seen as other longpoll work items.
+- API add 'privileged' command so can verify access level
+- Set the lp_sent variable under lock since there will almost always be a race
+on setting this variable, potentially leading to multiple LPs being sent out.
+- API restrict access to all non display commands by default
+- Update API version to 1.2 for new 'Log Interval'
+- API add --log Interval to 'config' reply
+- --api-allow special case 0/0 means all
+
+
+CGMiner Version 2.2.7 - February 20, 2012
+
+- Send out extra longpolls when we have switched pools and the longpoll thread
+is still bound to the old one. This is particularly useful with p2pool where
+longpolls do not correlate with main bitcoin block change and would have led to
+high reject rates on failover.
+- Store whether a work item is the result of a longpoll or not in struct work
+and use it to help determine block changes directly from the work longpoll bool.
+- Keep track of when a longpoll has been sent for a pool and if the current pool
+is requesting work but has not sent a longpoll request, convert one of the work
+items to a longpoll.
+- Store the longpoll url in the pool struct and update it from the pool_active
+test in case it changes. This is to allow further changes to longpoll management
+on switching pools.
+- Re-check for a longpoll supporting pool every 30 seconds if none is found
+initially.
+- Report threads as busy waiting on getwork on startup to avoid them being
+flagged sick on startup during slow networking.
+- Allow devices that are disabled due to overheating to be flagged as recovering
+instead of disabling them and re-enable them if they're below ideal temperatures
+- Tahiti prefers worksize 64 with poclbm.
+- No need to expressly retain the opencl program now that the zero binary issue
+is fixed. This actually fixes cgminer to work with the latest SDK included with
+the ATI catalyst driver 12.2.
+- Show error code on any opencl failure status.
+- Add detection for version 898.1 SDK as well but only give SDK 2.6 warning once
+on startup instead of with each device initialisation.
+- Always use a fresh connection for longpoll as prolonged persistent connections
+can fail for many reasons.
+- Keep track of intended engine clock speed and only adjust up if it's higher
+than the last intended speed. This avoids setting the clock speed to one
+relative to a lower profile one by mistake.
+- Use gpu-memdiff on startup if an engine clockspeed is set and a memdiff value
+is set.
+- Revert "Adjust engine speed up according to performance level engine setting,
+not the current engine speed." - ineffectual.
+- Freeze the queues on all threads that are sent the pause message to prevent
+them trying to start up again with saved pings in their queues.
+- Updates to diakgcn kernel/
+- Consolidate all screen updates to the watchdog thread and touch both windows
+before refresh.
+- Curses will be disabled in clean_up so don't do it early in kill_work, and
+disable_adl so that GPU settings may be restored to normal in case shutting down
+curses leads to instability on windows.
+- Stop the mining threads before trying to kill them.
+- Plain refresh() does not give reliably screen updates so get rid of all uses
+of it.
+- First release with working diakgcn kernel.
+
+CGMiner Version 2.2.6 - February 16, 2012
+
+- Provide warning on each startup about sdk 2.6
+- Fix unused warnings on win32.
+- bitforce: Simplify BFopen WIN32 ifdef/else
+- Fix initialization warning with jansson 1.3
+- bitforce: Cleanup extraneous TODO that isn't needed
+- Move tcsetattr (and new tcflush) into *nix BFopen to simplify things a bit
+- Add message explaining 2nd thread disabling for dynamic mode and how to tune
+it.
+- Move logwindow down once number of devices is known.
+- Automatically choose phatk kernel for bitalign non-gcn ATI cards, and then
+only select poclbm if SDK2.6 is detected.
+- Allow the refresh interval to be adjusted in dynamic intensity with a
+--gpu-dyninterval parameter.
+- Make curses display visible right from the beginning and fix the window sizes
+so the initial messages don't get lost once the status window is drawn.
+- The amount of work scanned can fluctuate when intensity changes and since we
+do this one cycle behind, we increment the work more than enough to prevent
+repeati
+- bitforce: Set a 30 second timeout for serial port on Windows, since the
+default is undefined
+- Use PreVal4addT1 instead of PreVal4 in poclbm kernel.
+- Import PreVal4 and PreVal0 into poclbm kernel.
+- Import more prepared constants into poclbm kernel.
+- Keep variables in one array but use Vals[] name for consistency with other
+kernel designs.
+- Replace constants that are mandatorily added in poclbm kernel with one value.
+- Remove addition of final constant before testing for result in poclbm kernel.
+- Hand optimise variable addition order.
+- Hand optimise first variable declaration order in poclbm kernel.
+- Radical reordering machine based first pass to change variables as late as
+possible, bringing their usage close together.
+- fix strcpy NULL pointer if env HOME unset.
+- bitforce: Disable automatic scanning when at least one device is specified
+manually
+- Unroll all poclbm additions to enable further optimisations.
+
+
+CGMiner Version 2.2.5 - February 13, 2012
+
+- Make output buffer write only as per Diapolo's suggestion.
+- Constify nonce in poclbm.
+- Use local and group id on poclbm kernel as well.
+- Microoptimise phatk kernel on return code.
+- Adjust engine speed up according to performance level engine setting, not the
+current engine speed.
+- Try to load a binary if we've defaulted to the poclbm kernel on SDK2.6
+- Use the poclbm kernel on SDK2.6 with bitalign devices only if there is no
+binary available.
+- Further generic microoptimisations to poclbm kernel.
+- The longstanding generation of a zero sized binary appears to be due to the
+OpenCL library putting the binary in a RANDOM SLOT amongst 4 possible binary
+locations. Iterate over each of them after building from source till the real
+binary is found and use that.
+- Fix harmless warnings with -Wsign-compare to allow cgminer to build with -W.
+- Fix missing field initialisers warnings.
+- Put win32 equivalents of nanosleep and sleep into compat.h fixing sleep() for
+adl.c.
+- Restore compatibility with Jansson 1.3 and 2.0 (api.c required 2.1)
+- Modularized logging, support for priority based logging
+- Move CPU chipset specific optimization into device-cpu
+
+
+CGMiner Version 2.2.4 - February 11, 2012
+
+- Fix double definition of A0 B0 to zeroA zeroB.
+- Retain cl program after successfully loading a binary image. May decrease
+failures to build kernels at startup.
+- Variable unused after this so remove setting it.
+- BFI INT patching is not necessarily true on binary loading of files and not
+true on ATI SDK2.6+. Report bitalign instead.
+- Various string fixes for reject reason.
+- Generalize --temp-cutoff and implement support for reading temperature from
+BitFORCE FPGAs
+- Change message from recovered to alive since it is used on startup as well as
+when a pool has recovered.
+- Start mining as soon as any pool is found active and rely on the watchpool
+thread to bring up other pools.
+- Delayed responses from testing pools that are down can hold up the watchdog
+thread from getting to its device testing code, leading to false detection of
+the GPU not checking in, and can substantially delay auto gpu/auto fan
+management leading to overheating. Move pool watching to its own thread.
+- Bugfix: BitFORCE index needs to be static to count correctly
+- Space out retrieval of extra work according to the number of mining threads.
+- Make shutdown more robust. Enable the input thread only after the other
+threads exist. Don't kill off the workio thread and use it to exit main() only
+if there is an unexpected problem. Use kill_work() for all anticipated shutdowns
+where possible. Remove unused thread entry.
+- Change poclbm version number.
+- One array is faster than 2 separate arrays so change to that in poclbm kernel.
+- Microoptimisations to poclbm kernel which increase throughput slightly.
+- Import diablominer kernel. Currently disabled as not working.
+- Import diapolo kernel. Currently disabled as not working.
+- Conflicting entries of cl_kernel may have been causing problems, and
+automatically chosen kernel type was not being passed on. Rename the enum to
+cl_kernels and store the chosen kernel in each clState.
+- Set cl_amd_media_ops with the BITALIGN flag and allow non-bitselect devices to
+build.
+- ALlow much longer filenames for kernels to load properly.
+- Allow different kernels to be used by different devices and fix the logic fail
+of overcorrecting on last commit with !strstr.
+- Fix kernel selection process and build error.
+- queue_phatk_kernel now uses CL_SET_VARG() for base-nonce(s), too
+- added OpenCL >= 1.1 detection code, in preparation of OpenCL 1.1 global offset
+parameter support
+- Use K array explicitly to make it clear what is being added.
+- Work items have a tendency to expire at exactly the same time and we don't
+queue extra items when there are plenty in the queue, regardless of age. Allow
+extra work items to be queued if adequate time has passed since we last
+requested work even if over the limit.
+- Discard work when failover-only is enabled and the work has come from a
+different pool.
+- Missing include to build on newer mingw32.
+- Move from the thread safe localtime_r to regular localtime which is the only
+one supported on newer pthread libraries on mingw32 to make it compile with the
+newer ming. Thread safety is of no importance where localtime is used in this
+code.
+- Define in_addr_t in windows if required
+- sys/wait.h not required in windows
+- Allow API to restrict access by IP address
+- Add pool switching to example miner.php
+- Display X-Reject-Reason, when provided
+- Remove the test for whether the device is on the highest profil level before
+raising the GPU speed as it is ineffectual and may prevent raising the GPU
+speed.
+- Remove unnecessary check for opt_debug one every invocation of applog at
+LOG_DEBUG level and place the check in applog().
+
+
+CGMiner Version 2.2.3 - February 6, 2012
+
+- Revert "Rewrite the convoluted get_work() function to be much simpler and roll
+work as much as possible with each new work item." This seems to cause a race on
+work in free_work(). Presumably other threads are still accessing the structure.
+
+
+CGMiner Version 2.2.2 - February 6, 2012
+
+- Provide support for the submitold extension on a per-pool basis based on the
+value being detected in a longpoll.
+- Don't send a ping to a dynamic device if it's not enabled as that will just
+enable it for one pass and then disable it again.
+- Rewrite the convoluted get_work() function to be much simpler and roll work as
+much as possible with each new work item.
+- Roll as much work as possible from the work returned from a longpoll.
+- Rolling work on each loop through the mining thread serves no purpose.
+- Allow to stage more than necessary work items if we're just rolling work.
+- Replace divide_work with reuse_work function used twice.
+- Give rolled work a new ID to make sure there is no confusion in the hashtable
+lookups.
+- Remove now-defunct hash_div variables.
+- Remove unused get_dondata function.
+- Silence ADL warnings.
+- Silence unused parameter warnings.
+- Stagger the restart of every next thread per device to keep devices busy ahead
+of accessory threads per device.
+- Deprecate the --donation feature. Needlessly complex, questionable usefulness,
+depends on author's server and a central pool of some kind, and was not heavily
+adopted.
+- It's devices that report back now, not threads, update message.
+- Continue auto-management of fan and engine speeds even if a device is disabled
+for safety reasons.
+- No need to check we're highest performance level when throttling GPU engine
+speed.
+- Abstract out tests for whether work has come from a block that has been seen
+before and whether a string is from a previously seen block.
+- Probe but don't set the timeout to 15 seconds as some networks take a long
+time to timeout.
+- Remove most compiler warnings from api.c
+- Add last share's pool info in cgpu_info
+- Allow the OpenCL platform ID to be chosen with --gpu-platform.
+- Iterate over all platforms displaying their information and number of devices
+when --ndevs is called.
+- Deprecate main.c
+- Some networks can take a long time to resolve so go back to 60 second timeouts
+instead of 15.
+- Only enable curses on failure if curses is desired.
+- Fix warnings in bitforce.c
+- Bugfix: Need to open BitForce tty for read-write
+- Fix various build issues.
+- Modularize code: main.c -> device-cpu + device-gpu
+- Fix phatk kernel not working on non-bitalign capable devices (Nvidia, older
+ATI).
+- Update poclbm kernel for better performance on GCN and new SDKs with bitalign
+support when not BFI INT patching. Update phatk kernel to work properly for non
+BFI INT patched kernels, providing support for phatk to run on GCN and non-ATI
+cards.
+- Return last accepted share pool/time for devices
+- Display accepted share pool/time for CPUs
+- Bug intensity always shows GPU 0
+- Update example web miner.php to use new API commands
+
+
+CGMiner Version 2.2.1 - January 30, 2012
+
+NOTE - The GPU Device reordering in 2.2.0 by default was considered a bad idea
+so the original GPU ordering is used by default again unless reordering is
+explicitly requested.
+
+- Fix bitforce failing to build into cgminer.
+- Add missing options to write config function.
+- Add a --gpu-reorder option to only reorder devices according to PCI Bus ID
+when requested.
+- Fix for midstate support being broken on pools that supported no-midstate
+work by ensuring numbers are 32 bits in sha2.c
+- Set virtual GPUs to work when ADL is disabled or all mining will occur on GPU
+0.
+- Add information about paused threads in the menu status.
+- Disable all but the first thread on GPUs in dynamic mode for better
+interactivity.
+- Set the latest network access time on share submission for --net-delay even if
+we're not delaying that submission for further network access.
+- Clear adl on exiting after probing values since it may attempt to overclock.
+- As share submission is usually staggered, and delays can be costly, submit
+shares without delay even when --net-delay is enabled.
+- Display GPU number and device name when ADL is successfully enabled on it.
+- Display GPU ordering remapping in verbose mode.
+- Don't fail in the case the number of ADL and OpenCL devices do not match, and
+do not attempt to reorder devices unless they match. Instead give a warning
+about
+- Display error codes should ADL not return ADL_OK in the more critical function
+calls.
+- Fix unused warning.
+- Fix compile warnings in api.c
+- Add extensive ADL based device info in debug mode.
+- Make --ndevs display verbose opencl information as well to make debugging
+version information easier.
+- Display information about the opencl platform with verbose enabled.
+- Explicitly check for nvidia in opencl platform strings as well.
+
+
+CGMiner Version 2.2.0 - January 29, 2012
+
+NOTE: GPU Device order will change with this release with ATI GPUs as cgminer
+now can enumerate them according to their Bus ID which means the values should
+now correlate with their physical position on the motherboard.
+
+- Default to poclbm kernel on Tahiti (7970) since phatk does not work, even
+though performance is sub-standard so that at least it will mine successfully by
+defau
+- Retain cl program after every possible place we might build the program.
+- Update ADL SDK URL.
+- Fix potential overflow.
+- Map GPU devices to virtual devices in their true physical order based on
+BusNumber.
+- Change the warning that comes with failure to init cl on a device to be more
+generic and accurate.
+- Advertise longpoll support in X-Mining-Extensions
+- Detect dual GPU cards by iterating through all GPUs, finding ones without
+fanspeed and matching twins with fanspeed one bus ID apart.
+- Do not attempt to build the program that becomes the kernel twice. This could
+have been leading to failures on initialising cl.
+- Some opencl compilers have issues with no spaces after -D in the compiler
+options.
+- Allow intensity up to 14.
+- Use calloced stack memory for CompilerOptions to ensure sprintf writes to the
+beginning of the char.
+- Whitelist 79x0 cards to prefer no vectors as they perform better without.
+- Adjust fan speed gently while in the optimal range when temperature is
+drifting to minimise overshoot in either direction.
+- Detect dual GPU cards via the indirect information of - 1st card has a fan
+controller. 2nd card does not have a fan controller, cards share the same device
+name
+- Instead of using the BFI_INT patching hack on any device reporting
+cl_amd_media_ops, create a whitelist of devices that need it. This should enable
+GCN architec
+- Fixed API compiling issue on OS X
+- Add more explanation of JSON format and the 'save' command
+- Return an error if using ADL API commands when it's not available
+- Read off lpThermalControllerInfo from each ADL device.
+- Add ADL_Overdrive5_ThermalDevices_Enum interface.
+- Add API commands: config, switchpool, gpu settings, save
+- Implement socks4 proxy support.
+- Fix send() for JSON strings
+- Introduce a --net-delay option which guarantees at least 250ms between any
+networking requests to not overload slow routers.
+- Generalise locking init code.
+- Allow invalid values to be in the configuration file, just skipping over them
+provided the rest of the file is valid JSON. This will allow older configurat
+- Allow CPU mining explicitly enable only if other mining support is built in.
+- BitForce FPGA support
+- Configure out building and support of all CPU mining code unless
+--enable-cpumining is enabled.
+- Allow parsed values to be zero which will allow 0 values in the config file to
+work.
+- Advertise that we can make our own midstate, so the pool can skip generating
+it for us
+- Refactor the CPU scanhash_* functions to use a common API. Fixes bugs.
+- Don't consider a pool lagging if a request has only just been filed. This
+should decrease the false positives for "pool not providing work fast enough".
+- Invalidating work after longpoll made hash_pop return no work giving a false
+positive for dead pool. Rework hash_pop to retry while finds no staged work u
+- Remove TCP_NODELAY from curl options as many small packets may be contributing
+to network overload, when --net-delay is enabled.
+- Refactor miner_thread to be common code for any kind of device
+- Simplify submit_nonce loop and avoid potentially missing FOUND - 1 entry.
+Reported by Luke-Jr.
+- Micro-optimisation in sha256_sse2 code courtesy of Guido Ascioti
+guido.ascioti@gmail.com
+- Refactor to abstract device-specific code
+
+
+CGMiner Version 2.1.2 - January 6, 2012
+
+- If api-description is specified, save it when writing the config file
+- Adjust utility width to be constant maximum as well.
+- Add percent signs to reject ratio outputs
+- Should the donation pool fail, don't make the fallover pool behave as though
+the primary pool is lagging.
+- Use an alternative pool should the donation getwork fail.
+
+
+CGMiner Version 2.1.1 - January 1, 2012
+
+- Include API examples in distribution tarball.
+- Don't attempt to pthread_join when cancelling threads as they're already
+detached and doing so can lead to a segfault.
+- Give more generic message if slow pool at startup is the donation pool.
+- Continue to attempt restarting GPU threads if they're flagged dead at 1 min.
+intervals.
+- Don't attempt to restart sick flagged GPUs while they're still registering
+activity.
+- Make curl use fresh connections whenever there is any communication issue
+in case there are dead persistent connections preventing further comms from
+working.
+- Display pool in summary if only 1 pool.
+- Adjust column width of A/R/HW to be the maximum of any device and align them.
+
+
+CGMiner Version 2.1.0 - December 27, 2011
+
+- Major infrastructure upgrade with RPC interface for controlling via sockets
+encoded with/without JSON courtesy of Andrew Smith. Added documentation for
+use of the API and sample code to use with it.
+- Updated linux-usb-cgminer document.
+- Rewrite of longpoll mechanism to choose the current pool wherever possible to
+use for the longpoll, or any pool that supports longpoll if the current one
+does not.
+- Display information about longpoll when the chosen server has changed.
+- Fix the bug where longpoll generated work may have been sent back to the
+wrong pool, causing rejects.
+- Fix a few race conditions on closing cgminer which caused some of the crashes
+on exit.
+- Only adjust gpu engine speed in autotune mode if the gpu is currently at the
+performance level of that being adjusted.
+- Various fixes for parsing/writing of configuration files.
+- Do not add blank lines for threads of unused CPUs.
+- Show which pool is unresponsive on startup.
+- Only show GPU management menu item if GPUs are in use.
+- Align most device columns in the curses display.
+
+
+CGMiner Version 2.0.8 - November 11, 2011
+
+- Make longpoll do a mandatory flushing of all work even if the block hasn't
+changed, thus supporting longpoll initiated work change of any sort and merged
+mining.
+- Byteswap computed hash in hashtest so it can be correctly checked. This fixes
+the very rare possibility that a block solve on solo mining was missed.
+- Add x86_64 w64 mingw32 target
+- Allow a fixed speed difference between memory and GPU clock speed with
+--gpu-memdiff that will change memory speed when GPU speed is changed in
+autotune mode.
+- Don't load the default config if a config file is specified on the command
+line.
+- Don't build VIA on apple since -a auto bombs instead of gracefully ignoring
+VIA failing.
+- Build fix for dlopen/dlclose errors in glibc.
+
+
+CGMiner Version 2.0.7 - October 17, 2011
+
+- Support work without midstate or hash1, which are deprecated in bitcoind 0.5+
+- Go to kernel build should we fail to clCreateProgramWithBinary instead of
+failing on that device. This should fix the windows problems with devices not
+initialising.
+- Support new configuration file format courtesy of Chris Savery which can write
+the config file from the menu and will load it on startup.
+- Write unix configuration to .cgminer/cgminer.conf by default and prompt to
+overwrite if given a filename from the menu that exists.
+
+
+CGMiner Version 2.0.6 - October 9, 2011
+
+- Must initialise the donorpool mutex or it fails on windows.
+- Don't make donation work interfere with block change detection allowing
+donation to work regardless of the block chain we're mining on.
+- Expire shares as stale with a separate timeout from the scantime, defaulting
+to 120 seconds.
+- Retry pools after a delay of 15 seconds if none can be contacted on startup
+unless a key is pressed.
+- Don't try to build adl features without having adl.
+- Properly check shares against target difficulty - This will no longer show
+shares when solo mining at all unless they're considered to be a block solve.
+- Add altivec 4 way (cpu mining) support courtesy of Gilles Risch.
+- Try to use SSL if the server supports it.
+- Display the total solved blocks on exit (LOL if you're lucky).
+- Use ADL activity report to tell us if a sick GPU is still busy suggesting it
+is hard hung and do not attempt to restart it.
+
+
+CGMiner Version 2.0.5 - September 27, 2011
+
+- Intensity can now be set to dynamic or static values per-device.
+- New donation feature --donation sends a proportion of shares to author's
+account of choice, but is disabled by default!
+- The hash being displayed and block detection has been fixed.
+- Devices not being mined on will not attempt to be ADL managed.
+- Intensity is now displayed per GPU device.
+- Make longpoll attempt to restart as often as opt_retries specifies.
+- We weren't rolling work as often as we could.
+- Correct some memory management issues.
+- Build fixes.
+- Don't mess with GPUs if we don't have them.
+
+
+CGMiner Version 2.0.4 - September 23, 2011
+
+- Confused Longpoll messages should be finally fixed with cgminer knowing for
+sure who found the new block and possibly avoiding a rare crash.
+- Display now shows the actual hash and will say BLOCK! if a block is deemed
+solved.
+- Extra spaces, which would double space lines on small terminals, have been
+removed.
+- Fan speed change is now damped if it is already heading in the correct
+direction to minimise overshoot.
+- Building without opencl libraries is fixed.
+- GPUs are autoselected if there is only one when in the GPU management menu.
+- GPU menu is refreshed instead of returning to status after a GPU change.
+
+
+CGMiner Version 2.0.3 - September 17, 2011
+
+- Various modes of failure to set fanspeeds and adl values have been addressed
+and auto-fan should work now on most hardware, and possibly other values
+which previously would not have worked.
+- Fixed a crash that can occur on switching pools due to longpoll thread races.
+- Use ATISTREAMSDKROOT if available at build time.
+- Fanspeed management is returned to the driver default on exit instead of
+whatever it was when cgminer was started.
+- Logging of events deemed WARNING or ERR now will display even during
+periods where menu input is being awaited on.
+
+
+CGMiner Version 2.0.2 - September 11, 2011
+
+- Exit cleanly if we abort before various threads are set up or if they no
+longer exist.
+- Fix a rare crash in HASH_DEL due to using different mutexes to protect the
+data.
+- Flag devices that have never started and don't allow enabling of devices
+without restarting them.
+- Only force the adapter speed to high if we've flagged this device as being
+managed.
+- Flag any devices with autofan or autogpu as being managed.
+- Use a re-entrant value to store what fanspeed we're trying to set in case the
+card doesn't support small changes.     Force it to a multiple of 10% if it
+fails on trying to speed up the fan.
+- Do not bother resetting values to old ones if changes to GPU parameters report
+failure, instead returning a failure code only if the return value from get()
+differs.
+- Remove redundant check.
+- Only display supported values from fanspeed on change settings.
+- Missing bracket from output.
+- Display fan percentage on devices that only support reporting percent and not
+RPM.
+- Properly substitute DLOPEN flags to build with ADL support when -ldl is needed
+and not when opencl is not found.
+
+
+CGMiner Version 2.0.1 - September 9, 2011
+
+- Fix building on 32bit glibc with dlopen with -lpthread and -ldl
+- ByteReverse is not used and the bswap opcode breaks big endian builds. Remove
+it.
+- Ignore whether the display is active or not since only display enabled devices
+work this way, and we skip over repeat entries anwyay.
+- Only reset values on exiting if we've ever modified them.
+- Flag adl as active if any card is successfully activated.
+- Add a thermal cutoff option as well and set it to 95 degrees by default.
+- Change the fan speed by only 5% if it's over the target temperature but less
+than the hysteresis value to minimise overshoot down in temperature.
+- Add a --no-adl option to disable ADL monitoring and GPU settings.
+- Only show longpoll received delayed message at verbose level.
+- Allow temperatures greater than 100 degrees.
+- We should be passing a float for the remainder of the vddc values.
+- Implement accepting a range of engine speeds as well to allow a lower limit to
+be specified on the command line.
+- Allow per-device fan ranges to be set and use them in auto-fan mode.
+- Display which GPU has overheated in warning message.
+- Allow temperature targets to be set on a per-card basis on the command line.
+- Display fan range in autofan status.
+- Setting the hysteresis is unlikely to be useful on the fly and doesn't belong
+in the per-gpu submenu.
+- With many cards, the GPU summaries can be quite long so use a terse output
+line when showing them all.
+- Use a terser device status line to show fan RPM as well when available.
+- Define max gpudevices in one macro.
+- Allow adapterid 0 cards to enumerate as a device as they will be non-AMD
+cards, and enable ADL on any AMD card.
+- Do away with the increasingly confusing and irrelevant total queued and
+efficiency measures per device.
+- Only display values in the log if they're supported and standardise device log
+line printing.
+
+
+CGMiner Version 2.0.0 - September 6, 2011
+
+Major feature upgrade - GPU monitoring, (over)clocking and fan control for ATI
+GPUs.
+
+New command line switches:
+--auto-fan-     Automatically adjust all GPU fan speeds to maintain a target
+temperature
+--auto-gpu-     Automatically adjust all GPU engine clock speeds to maintain
+a target temperature
+--gpu-engine <arg>  Set the GPU engine (over)clock in Mhz - one value for all or
+separate by commas for per card.
+--gpu-fan <arg>     Set the GPU fan percentage - one value for all or separate
+by commas for per card.
+--gpu-memclock <arg> Set the GPU memory (over)clock in Mhz - one value for all
+or separate by commas for per card.
+--gpu-powertune <arg> Set the GPU powertune percentage - one value for all or
+separate by commas for per card.
+--gpu-vddc <arg>    Set the GPU voltage in Volts - one value for all or separate
+by commas for per card.
+--temp-hysteresis <arg> Set how much the temperature can fluctuate outside
+limits when automanaging speeds (default: 3)
+--temp-overheat <arg> Set the overheat temperature when automatically managing
+fan and GPU speeds (default: 85)
+--temp-target <arg> Set the target temperature when automatically managing fan
+and GPU speeds (default: 75)
+
+- Implement ATI ADL support for GPU parameter monitoring now and setting later
+(temp, fan, clocks etc.).
+- Check for the presence of the ADL header files in ADL_SDK.
+- Import adl_functions.h from amd overdrive ctrl.
+- Implement a setup function that tries to detect GPUs that support the ADL and
+link in the parameters into the gpus struct.
+- Put a summary of monitoring information from the GPU menu.
+- Implement changing memory speed and voltage on the fly.
+- Implement fan speed setting.
+- Minor corrections to set fan speed by percentage.
+- Make sure to read off the value in RPM only.
+- Implement auto fanspeed adjustment to maintain a target temperature and
+fanspeed below 85%, with an overheat check that will speed the fan up to 100%.
+- Add an --auto-fan command line option to allow all GPUs to have autofan
+enabled from startup.
+- Add a gpu autotune option which adjusts GPU speed to maintain a target
+temperature within the bounds of the default GPU speed and any overclocking set.
+- Avoid a dereference if the longpoll thread doesn't exist.
+- Clean up by setting performance profiles and fan settings to startup levels on
+exit.
+- Add a small amount of hysteresis before lowering clock speed.
+- Allow target, overheat and hysteresis temperatures to be set from command
+line.
+- Combine all stats collating into one function to avoid repeating function
+calls on each variable.
+- Add gpu statistics to debugging output via the watchdog thread.
+- Implement menus to change temperature limits.
+- Implement setting the GPU engine clock speed of all devices or each device as
+a comma separated value.
+- Implement setting the GPU memory clock speed of all devices or each device as
+a comma separated value.
+- Implement setting the GPU voltage of all devices or each device as a comma
+separated value.
+- Implement setting the GPU fan speed of all devices or each device as a comma
+separated value.
+- Add support for monitoring powertune setting.
+- Implement changing of powertune value from the GPU change settings menu.
+- Get the value of powertune in get_stats.
+- Implement setting the GPU powertune value of all devices or each device as a
+comma separated value.
+- Remove the safety checks in speed setting since confirmation is done first in
+the menu, then show the new current values after a short pause.
+- Force the speed to high on startup and restore it to whatever the setting was
+on exit.
+- Add temperature to standard output where possible and use more compact output.
+- Move and print at the same time in curses to avoid random trampling display
+errors.
+- Update the status window only from the watchdog thread, do not rewrite the top
+status messages and only refresh once all the status window is complete,
+clearing the window each time to avoid corruption.
+- Set a safe starting fan speed if we're automanaging the speeds.
+- Provide locking around all adl calls to prevent races.
+- Lower profile settings cannot be higher than higher profile ones so link any
+drops in settings.
+- Add new needed text files to distribution.
+- Queue requests ignoring the number of staged clones since they get discarded
+very easily leading to false positives for pool not providing work fast enough.
+- Include libgen.h in opt.c to fix win32 compilation warnings.
+- Fix compilation warning on win32.
+- Add the directory name from the arguments cgminer was called from as well to
+allow it running from a relative pathname.
+- Add a --disable-adl option to configure and only enable it if opencl support
+exists.
+- Retry before returning a failure to get upstream work as a failure to avoid
+false positives for pool dead.
+- Retry also if the decoding of work fails.
+- Use the presence of X-Roll-Ntime in the header as a bool for exists unless N
+is found in the response.
+
+
+CGMiner Version 1.6.2 - September 2, 2011
+
+- Add --failover-only option to not leak work to backup pools when the primary
+pool is lagging.
+- Change recommendation to intensity 9 for dedicated miners.
+- Fix the bouncing short term value by allowing it to change dynamically when
+the latest value is very different from the rolling value, but damp the change
+when it gets close.
+- Use the curses_lock to protect the curses_active variable and test it under
+lock.
+- Go back to requesting work 2/3 of the way through the current scantime with
+CPU mining as reports of mining threads running out of work have occurred with
+only 5 seconds to retrieve work.
+- Add start and stop time scheduling for regular time of day running or once off
+start/stop options.
+- Print summary on quit modes.
+- Put some sanity checks on the times that can be input.
+- Give a verbose message when no active pools are found and pause before
+exiting.
+- Add verbose message when a GPU fails to initialise, and disable the correct
+GPU.
+- Cryptopp asm32 was not correctly updated to the incremental nonce code so the
+hash counter was bogus.
+- Get rid of poorly executed curl check.
+- If curl does not have sockopts, do not try to compile the
+json_rpc_call_sockopt_cb function, making it possible to build against older
+curl libraries.
+- Most people expect /usr/local when an unspecified prefix is used so change to
+that.
+- Rename localgen occasions to getwork fail occasions since localgen is
+unrelated now.
+
+
+CGMiner Version 1.6.1 - August 29, 2011
+
+- Copy cgminer path, not cat it.
+- Switching between redrawing windows does not fix the crash with old
+libncurses, so redraw both windows, but only when the window size hasn't
+changed.
+- Reinstate minimum 1 extra in queue to make it extremely unlikely to ever have
+0 staged work items and any idle time.
+- Return -1 if no input is detected from the menu to prevent it being
+interpreted as a 0.
+- Make pthread, libcurl and libcurses library checks mandatory or fail.
+- Add a --disable-opencl configure option to make it possible to override
+detection of opencl and build without GPU mining support.
+- Confusion over the variable name for number of devices was passing a bogus
+value which likely was causing the zero sized binary issue.
+- cgminer no longer supports default url user and pass so remove them.
+- Don't show value of intensity since it's dynamic by default.
+- Add options to explicitly enable CPU mining or disable GPU mining.
+- Convert the opt queue into a minimum number of work items to have queued
+instead of an extra number to decrease risk of getting idle devices without
+increasing risk of higher rejects.
+- Statify tv_sort.
+- Check for SSE2 before trying to build 32 bit SSE2 assembly version. Prevents
+build failure when yasm is installed but -msse2 is not specified.
+- Add some defines to configure.ac to enable exporting of values and packaging,
+and clean up output.
+- Give convenient summary at end of ./configure.
+- Display version information and add --version command line option, and make
+sure we flush stdout.
+- Enable curses after the mining threads are set up so that failure messages
+won't be lost in the curses interface.
+- Disable curses after inputting a pool if we requested no curses interface.
+- Add an option to break out after successfully mining a number of accepted
+shares.
+- Exit with a failed return code if we did not reach opt_shares.
+- The cpu mining work data can get modified before we copy it if we submit it
+async, and the sync submission is not truly sync anyway, so just submit it sync.
+
+
+CGMiner Version 1.6.0 - August 26, 2011
+
+- Make restarting of GPUs optional for systems that hang on any attempt to
+restart them.     Fix DEAD status by comparing it to last live time rather than
+last attempted restart time since that happens every minute.
+- Move staged threads to hashes so we can sort them by time.
+- Create a hash list of all the blocks created and search them to detect when a
+new block has definitely appeared, using that information to detect stale work
+and discard it.
+- Update configure.ac for newer autoconf tools.
+- Use the new hashes directly for counts instead of the fragile counters
+currently in use.
+- Update to latest sse2 code from cpuminer-ng.
+- Allow LP to reset block detect and block detect lp flags to know who really
+came first.
+- Get start times just before mining begins to not have very slow rise in
+average.
+- Add message about needing one server.
+- We can queue all the necessary work without hitting frequent stales now with
+the time and string stale protection active all the time.     This prevents a
+pool being falsely labelled as not providing work fast enough.
+- Include uthash.h in distro.
+- Implement SSE2 32 bit assembly algorithm as well.
+- Fail gracefully if unable to open the opencl files.
+- Make cgminer look in the install directory for the .cl files making make
+install work correctly.
+- Allow a custom kernel path to be entered on the command line.
+- Bump threshhold for lag up to maximum queued but no staged work.
+- Remove fragile source patching for bitalign, vectors et. al and simply pass it
+with the compiler options.
+- Actually check the value returned for the x-roll-ntime extension to make sure
+it isn't saying N.
+- Prevent segfault on exit for when accessory threads don't exist.
+- Disable curl debugging with opt protocol since it spews to stderr.
+
+
+CGMiner Version 1.5.8 - August 23, 2011
+
+- Minimise how much more work can be given in cpu mining threads each interval.
+- Make the fail-pause progressively longer each time it fails until the network
+recovers.
+- Only display the lagging message if we've requested the work earlier.
+- Clean up the pool switching to not be dependent on whether the work can roll
+or not by setting a lagging flag and then the idle flag.
+- Only use one thread to determine if a GPU is sick or well, and make sure to
+reset the sick restart attempt time.
+- The worksize was unintentionally changed back to 4k by mistake, this caused a
+slowdown.
+
+
+CGMiner Version 1.5.7 - August 22, 2011
+
+- Fix a crash with --algo auto
+- Test at appropriate target difficulty now.
+- Add per-device statics log output with --per-device-stats
+- Fix breakage that occurs when 1 or 4 vectors are chosen on new phatk.
+- Make rolltime report debug level only now since we check it every work
+item.
+- Add the ability to enable/disable per-device stats on the fly and match
+logging on/off.
+- Explicitly tell the compiler to retain the program to minimise the chance of
+the zero sized binary errors.
+- Add one more instruction to avoid one branch point in the common path in the
+cl return code. Although this adds more ALUs overall and more branch points, the
+common path code has the same number of ALUs and one less jmp, jmps being more
+expensive.
+- Explicitly link in ws2_32 on the windows build and update README file on how
+to compile successfully on windows.
+- Release cl resources should the gpu mining thread abort.
+- Attempt to restart a GPU once every minute while it's sick.
+- Don't kill off the reinit thread if it fails to init a GPU but returns safely.
+- Only declare a GPU dead if there's been no sign of activity from the reinit
+thread for 10 mins.
+- Never automatically disable any pools but just specify them as idle if they're
+unresponsive at startup.
+- Use any longpoll available, and don't disable it if switching to a server that
+doesn't have it. This allows you to mine solo, yet use the longpoll from a pool
+even if the pool is the backup server.
+- Display which longpoll failed and don't free the ram for lp_url since it
+belongs to the pool hdr path.
+- Make the tcp setsockopts unique to linux in the hope it allows freebsd et. al
+to compile.
+
+
+CGMiner Version 1.5.6 - August 17, 2011
+
+- New phatk and poclbm kernels. Updated phatk to be in sync with latest 2.2
+courtesy of phateus. Custom modified to work best with cgminer.
+- Updated output buffer code to use a smaller buffer with the kernels.
+- Clean up the longpoll management to ensure the right paths go to the right
+pool and display whether we're connected to LP or not in the status line.
+
+
+CGMiner Version 1.5.5 - August 16, 2011
+
+- Rework entirely the GPU restart code. Strike a balance between code that
+re-initialises the GPU entirely so that soft hangs in the code are properly
+managed, but if a GPU is completely hung, the thread restart code fails
+gracefully, so that it does not take out any other code or devices. This will
+allow cgminer to keep restarting GPUs that can be restarted, but continue
+mining even if one or more GPUs hangs which would normally require a reboot.
+- Add --submit-stale option which submits all shares, regardless of whether they
+would normally be considered stale.
+- Keep options in alphabetical order.
+- Probe for slightly longer for when network conditions are lagging.
+- Only display the CPU algo when we're CPU mining.
+- As we have keepalives now, blaming network flakiness on timeouts appears to
+have been wrong.     Set a timeout for longpoll to 1 hour, and most other
+network connectivity to 1 minute.
+- Simplify output code and remove HW errors from CPU stats.
+- Simplify code and tidy output.
+- Only show cpu algo in summary if cpu mining.
+- Log summary at the end as per any other output.
+- Flush output.
+- Add a linux-usb-cgminer guide courtesy of Kano.
+
+
+CGMiner Version 1.5.4 - August 14, 2011
+
+- Add new option: --monitor <cmd> Option lets user specify a command <cmd> that
+will get forked by cgminer on startup. cgminer's stderr output subsequently gets
+piped directly to this command.
+- Allocate work from one function to be able to initialise variables added
+later.
+- Add missing fflush(stdout) for --ndevs and conclusion summary.
+- Preinitialise the devices only once on startup.
+- Move the non cl_ variables into the cgpu info struct to allow creating a new
+cl state on reinit, preserving known GPU variables.
+- Create a new context from scratch in initCQ in case something was corrupted to
+maximise our chance of succesfully creating a new worker thread. Hopefully this
+makes thread restart on GPU failure more reliable, without hanging everything
+in the case of a completely wedged GPU.
+- Display last initialised time in gpu management info, to know if a GPU has
+been re-initialised.
+- When pinging a sick cpu, flush finish and then ping it in a separate thread in
+the hope it recovers without needing a restart, but without blocking code
+elsewhere.
+- Only consider a pool lagging if we actually need the work and we have none
+staged despite queue requests stacking up. This decreases significantly the
+amount of work that leaks to the backup pools.
+- The can_roll function fails inappropriately in stale_work.
+- Only put the message that a pool is down if not pinging it every minute. This
+prevents cgminer from saying pool down at 1 minute intervals unless in debug
+mode.
+- Free all work in one place allowing us to perform actions on it in the future.
+- Remove the extra shift in the output code which was of dubious benefit. In
+fact in cgminer's implementation, removing this caused a miniscule speedup.
+- Test each work item to see if it can be rolled instead of per-pool and roll
+whenever possible, adhering to the 60 second timeout. This makes the period
+after a longpoll have smaller dips in throughput, as well as requiring less
+getworks overall thus increasing efficiency.
+- Stick to rolling only work from the current pool unless we're in load balance
+mode or lagging to avoid aggressive rolling imitating load balancing.
+- If a work item has had any mining done on it, don't consider it discarded
+work.
+
+
+CGMiner Version 1.5.3 - July 30, 2011
+
+- Significant work went into attempting to make the thread restart code robust
+to identify sick threads, tag them SICK after 1 minute, then DEAD after 5
+minutes of inactivity and try to restart them. Instead of re-initialising the
+GPU completely, only a new cl context is created to avoid hanging the rest of
+the GPUs should the dead GPU be hung irrevocably.
+- Use correct application name in syslog.
+- Get rid of extra line feeds.
+- Use pkg-config to check for libcurl version
+- Implement per-thread getwork count with proper accounting to not over-account
+queued items when local work replaces it.
+- Create a command queue from the program created from source which allows us
+to flush the command queue in the hope it will not generate a zero sized binary
+any more.
+- Be more willing to get work from the backup pools if the work is simply being
+queued faster than it is being retrieved.
+
+
+CGMiner Version 1.5.2 - July 28, 2011
+
+- Restarting a hung GPU can hang the rest of the GPUs so just declare it dead
+and provide the information in the status.
+- The work length in the miner thread gets smaller but doesn't get bigger if
+it's under 1 second.     This could end up leading to CPU under-utilisation and
+lower and lower hash rates.     Fix it by increasing work length if it drops
+under 1 second.
+- Make the "quiet" mode still update the status and display errors, and add a
+new --real-quiet option which disables all output and can be set once while
+running.
+- Update utility and efficiency figures when displaying them.
+- Some Intel HD graphics support the opencl commands but return errors since
+they don't support opencl. Don't fail with them, just provide a warning and
+disable GPU mining.
+- Add http:// if it's not explicitly set for URL entries.
+- Log to the output file at any time with warnings and errors, instead of just
+when verbose mode is on.
+- Display the correct current hash as per blockexplorer, truncated to 16
+characters, with just the time.
+
+
+CGMiner Version 1.5.1 - July 27, 2011
+
+- Two redraws in a row cause a crash in old libncurses so just do one redraw
+using the main window.
+- Don't adjust hash_div only up for GPUs. Disable hash_div adjustment for GPUs.
+- Only free the thread structures if the thread still exists.
+- Update both windows separately, but not at the same time to prevent the double
+refresh crash that old libncurses has.     Do the window resize check only when
+about to redraw the log window to minimise ncurses cpu usage.
+- Abstract out the decay time function and use it to make hash_div a rolling
+average so it doesn't change too abruptly and divide work in chunks large enough
+to guarantee they won't overlap.
+- Sanity check to prove locking.
+- Don't take more than one lock at a time.
+- Make threads report out when they're queueing a request and report if they've
+failed.
+- Make cpu mining work submission asynchronous as well.
+- Properly detect stale work based on time from staging and discard instead of
+handing on, but be more lax about how long work can be divided for up to the
+scantime.
+- Do away with queueing work separately at the start and let each thread grab
+its own work as soon as it's ready.
+- Don't put an extra work item in the queue as each new device thread will do so
+itself.
+- Make sure to decrease queued count if we discard the work.
+- Attribute split work as local work generation.
+- If work has been cloned it is already at the head of the list and when being
+reinserted into the queue it should be placed back at the head of the list.
+- Dividing work is like the work is never removed at all so treat it as such.
+However the queued bool needs to be reset to ensure we *can* request more work
+even if we didn't initially.
+- Make the display options clearer.
+- Add debugging output to tq_push calls.
+- Add debugging output to all tq_pop calls.
+
+
+CGMiner Version 1.5.0 - July 26, 2011
+
+- Increase efficiency of slow mining threads such as CPU miners dramatically. Do
+this by detecting which threads cannot complete searching a work item within the
+scantime and then divide up a work item into multiple smaller work items.
+Detect the age of the work items and if they've been cloned before to prevent
+doing the same work over. If the work is too old to be divided, then see if it
+can be time rolled and do that to generate work. This dramatically decreases the
+number of queued work items from a pool leading to higher overall efficiency
+(but the same hashrate and share submission rate).
+- Don't request work too early for CPUs as CPUs will scan for the full
+opt_scantime anyway.
+- Simplify gpu management enable/disable/restart code.
+- Implement much more accurate rolling statistics per thread and per gpu and
+improve accuracy of rolling displayed values.
+- Make the rolling log-second average more accurate.
+- Add a menu to manage GPUs on the fly allowing you to enable/disable GPUs or
+try restarting them.
+- Keep track of which GPUs are alive versus enabled.
+- Start threads for devices that are even disabled, but don't allow them to
+start working.
+- The last pool is when we are low in total_pools, not active_pools.
+- Make the thread restart do a pthread_join after disabling the device, only
+re-enabling it if we succeed in restarting the thread. Do this from a separate
+thread so as to not block any other code.This will allow cgminer to continue
+even if one GPU hangs.
+- Try to do every curses manipulation under the curses lock.
+- Only use the sockoptfunction if the version of curl is recent enough.
+
+
+CGMiner Version 1.4.1 - July 24, 2011
+
+- Do away with GET for dealing with longpoll forever. POST is the one that works
+everywhere, not the other way around.
+- Detect when the primary pool is lagging and start queueing requests on backup
+pools if possible before needing to roll work.
+- Load balancing puts more into the current pool if there are disabled pools.
+Fix.
+- Disable a GPU device should the thread fail to init.
+- Out of order command queue may fail on osx. Try without if it fails.
+- Fix possible dereference on blank inputs during input_pool.
+- Defines missing would segfault on --help when no sse mining is built in.
+- Revert "Free up resources/stale compilers." - didn't help.
+- Only try to print the status of active devices or it would crash.
+- Some hardware might benefit from the less OPS so there's no harm in leaving
+kernel changes that do that apart from readability of the code.
+
+CGMiner Version 1.4.0 - July 23, 2011
+
+- Feature upgrade: Add keyboard input during runtime to allow modification of
+and viewing of numerous settings such as adding/removing pools, changing
+multipool management strategy, switching pools, changing intensiy, verbosity,
+etc. with a simple keypress menu system.
+- Free up resources/stale compilers.
+- Kernels are safely flushed in a way that allows out of order execution to
+work.
+- Sometimes the cl compiler generates zero sized binaries and only a reboot
+seems to fix it.
+- Don't try to stop/cancel threads that don't exist.
+- Only set option to show devices and exit if built with opencl support.
+- Enable curses earlier and exit with message in main for messages to not be
+lost in curses windows.
+- Make it possible to enter server credentials with curses input if none are
+specified on the command line.
+- Abstract out a curses input function and separate input pool function to allow
+for live adding of pools later.
+- Remove the nil arguments check to allow starting without parameters.
+- Disable/enable echo & cbreak modes.
+- Add a thread that takes keyboard input and allow for quit, silent, debug,
+verbose, normal, rpc protocol debugging and clear screen options.
+- Add pool option to input and display current pool status, pending code to
+allow live changes.
+- Add a bool for explicit enabling/disabling of pools.
+- Make input pool capable of bringing up pools while running.
+- Do one last check of the work before submitting it.
+- Implement the ability to live add, enable, disable, and switch to pools.
+- Only internally test for block changes when the work matches the current pool
+to prevent interleaved block change timing on multipools.
+- Display current pool management strategy to enable changing it on the fly.
+- The longpoll blanking of the current_block data may not be happening before
+the work is converted and appears to be a detected block change.     Blank the
+current block be
+- Make --no-longpoll work again.
+- Abstract out active pools count.
+- Allow the pool strategy to be modified on the fly.
+- Display pool information on the fly as well.
+- Add a menu and separate out display options.
+- Clean up the messy way the staging thread communicates with the longpoll
+thread to determine who found the block first.
+- Make the input windows update immediately instead of needing a refresh.
+- Allow log interval to be set in the menu.
+- Allow scan settings to be modified at runtime.
+- Abstract out the longpoll start and explicitly restart it on pool change.
+- Make it possible to enable/disable longpoll.
+- Set priority correctly on multipools.     Display priority and alive/dead
+information in display_pools.
+- Implement pool removal.
+- Limit rolltime work generation to 10 iterations only.
+- Decrease testing log to info level.
+- Extra refresh not required.
+- With huge variation in GPU performance, allow intensity to go from -10 to +10.
+- Tell getwork how much of a work item we're likely to complete for future
+splitting up of work.
+- Remove the mandatory work requirement at startup by testing for invalid work
+being passed which allows for work to be queued immediately.     This also
+removes the requirem
+- Make sure intensity is carried over to thread count and is at least the
+minimum necessary to work.
+- Unlocking error on retry. Locking unnecessary anyway so remove it.
+- Clear log window from consistent place. No need for locking since logging is
+disabled during input.
+- Cannot print the status of threads that don't exist so just queue enough work
+for the number of mining threads to prevent crash with -Q N.
+- Update phatk kernel to one with new parameters for slightly less overhead
+again.     Make the queue kernel parameters call a function pointer to select
+phatk or poclbm.
+- Make it possible to select the choice of kernel on the command line.
+- Simplify the output part of the kernel. There's no demonstrable advantage from
+more complexity.
+- Merge pull request #18 from ycros/cgminer
+- No need to make leaveok changes win32 only.
+- Build support in for all SSE if possible and only set the default according to
+machine capabilities.
+- Win32 threading and longpoll keepalive fixes.
+- Win32: Fix for mangled output on the terminal on exit.
+
+
+CGMiner Version 1.3.1 - July 20, 2011
+
+- Feature upgrade; Multiple strategies for failover. Choose from default which
+now falls back to a priority order from 1st to last, round robin which only
+changes pools when one is idle, rotate which changes pools at user-defined
+intervals, and load-balance which spreads the work evenly amongst all pools.
+- Implement pool rotation strategy.
+- Implement load balancing algorithm by rotating requests to each pool.
+- Timeout on failed discarding of staged requests.
+- Implement proper flagging of idle pools, test them with the watchdog thread,
+and failover correctly.
+- Move pool active test to own function.
+- Allow multiple strategies to be set for multipool management.
+- Track pool number.
+- Don't waste the work items queued on testing the pools at startup.
+- Reinstate the mining thread watchdog restart.
+- Add a getpoll bool into the thread information and don't restart threads stuck
+waiting on work.
+- Rename the idlenet bool for the pool for later use.
+- Allow the user/pass userpass urls to be input in any order.
+- When json rpc errors occur they occur in spits and starts, so trying to limit
+them with the comms error bool doesn't stop a flood of them appearing.
+- Reset the queued count to allow more work to be queued for the new pool on
+pool switch.
+
+CGMiner Version 1.3.0 - July 19, 2011
+
+- Massive infrastructure update to support pool failover.
+- Accept multiple parameters for url, user and pass and set up structures of
+pool data accordingly.
+- Probe each pool for what it supports.
+- Implement per pool feature support according to rolltime support as
+advertised by server.
+- Do switching automatically based on a 300 second timeout of locally generated
+work or 60 seconds of no response from a server that doesn't support rolltime.
+- Implement longpoll server switching.
+- Keep per-pool data and display accordingly.
+- Make sure cgminer knows how long the pool has actually been out for before
+deeming it a prolonged outage.
+- Fix bug with ever increasing staged work in 1.2.8 that eventually caused
+infinite rejects.
+- Make warning about empty http requests not show by default since many
+servers do this regularly.
+
+
+CGMiner Version 1.2.8 - July 18, 2011
+
+- More OSX build fixes.
+- Add an sse4 algorithm to CPU mining.
+- Fix CPU mining with other algorithms not working.
+- Rename the poclbm file to ensure a new binary is built since.
+- We now are guaranteed to have one fresh work item after a block change and we
+should only discard staged requests.
+- Don't waste the work we retrieve from a longpoll.
+- Provide a control lock around global bools to avoid racing on them.
+- Iterating over 1026 nonces when confirming data from the GPU is old code
+and unnecessary and can lead to repeats/stales.
+- The poclbm kernel needs to be updated to work with the change to 4k sized
+output buffers.
+- longpoll seems to work either way with post or get but some servers prefer
+get so change to httpget.
+
+
+CGMiner Version 1.2.7 - July 16, 2011
+
+- Show last 8 characters of share submitted in log.
+- Display URL connected to and user logged in as in status.
+- Display current block and when it was started in the status line.
+- Only pthread_join the mining threads if they exist as determined by
+pthread_cancel and don't fail on pthread_cancel.
+- Create a unique work queue for all getworks instead of binding it to thread 0
+to avoid any conflict over thread 0's queue.
+- Clean up the code to make it clear it's watchdog thread being messaged to
+restart the threads.
+- Check the current block description hasn't been blanked pending the real
+new current block data.
+- Re-enable signal handlers once the signal has been received to make it
+possible to kill cgminer if it fails to shut down.
+- Disable restarting of CPU mining threads pending further investigation.
+- Update longpoll messages.
+- Add new block data to status line.
+- Fix opencl tests for osx.
+- Only do local generation of work if the work item is not stale itself.
+- Check for stale work within the mining threads and grab new work if
+positive.
+- Test for idle network conditions and prevent threads from being restarted
+by the watchdog thread under those circumstances.
+- Make sure that local work generation does not continue indefinitely by
+stopping it after 10 minutes.
+- Tweak the kernel to have a shorter path using a 4k buffer and a mask on the
+nonce value instead of a compare and loop for a shorter code path.
+- Allow queue of zero and make that default again now that we can track how
+work is being queued versus staged. This can decrease reject rates.
+- Queue precisely the number of mining threads as longpoll_staged after a
+new block to not generate local work.
+
+
+CGMiner Version 1.2.6 - July 15, 2011
+
+- Put a current system status line beneath the total work status line
+- Fix a counting error that would prevent cgminer from correctly detecting
+situations where getwork was failing - this would cause stalls sometimes
+unrecoverably.
+- Limit the maximum number of requests that can be put into the queue which
+otherwise could get arbitrarily long during a network outage.
+- Only count getworks that are real queue requests.
+
+
+CGMiner Version 1.2.5 - July 15, 2011
+
+- Conflicting -n options corrected
+- Setting an intensity with -I disables dynamic intensity setting
+- Removed option to manually disable dynamic intensity
+- Improve display output
+- Implement signal handler and attempt to clean up properly on exit
+- Only restart threads that are not stuck waiting on mandatory getworks
+- Compatibility changes courtesy of Ycros to build on mingw32 and osx
+- Explicitly grab first work item to prevent false positive hardware errors
+due to working on uninitialised work structs
+- Add option for non curses --text-only output
+- Ensure we connect at least once successfully before continuing to retry to
+connect in case url/login parameters were wrong
+- Print an executive summary when cgminer is terminated
+- Make sure to refresh the status window
+
+CGMiner Versions -> 1.2.4
+
+- Con Kolivas - July 2011. New maintainership of code under cgminer name.
+- Massive rewrite to incorporate GPU mining.
+- Incorporate original oclminer c code.
+- Rewrite gpu mining code to efficient work loops.
+- Implement per-card detection and settings.
+- Implement vector code.
+- Implement bfi int patching.
+- Import poclbm and phatk ocl kernels and use according to hardware type.
+- Implement customised optimised versions of opencl kernels.
+- Implement binary kernel generation and loading.
+- Implement preemptive asynchronous threaded work gathering and pushing.
+- Implement variable length extra work queues.
+- Optimise workloads to be efficient miners instead of getting lots of extra
+  work.
+- Implement total hash throughput counters, per-card accepted, rejected and
+  hw error count.
+- Staging and watchdog threads to prevent fallover.
+- Stale and reject share guarding.
+- Autodetection of new blocks without longpoll.
+- Dynamic setting of intensity to maintain desktop interactivity.
+- Curses interface with generous statistics and information.
+- Local generation of work (xroll ntime) when detecting poor network
+connectivity.
+
+cpuminer Version 1.0.2
+
+- Linux x86_64 optimisations - Con Kolivas
+- Optimise for x86_64 by default by using sse2_64 algo
+- Detects CPUs and sets number of threads accordingly
+- Uses CPU affinity for each thread where appropriate
+- Sets scheduling policy to lowest possible
+- Minor performance tweaks
+
+cpuminer Version 1.0.1 - May 14, 2011
+
+- OSX support
+
+cpuminer Version 1.0 - May 9, 2011
+
+- jansson 2.0 compatibility
+- correct off-by-one in date (month) display output
+- fix platform detection
+- improve yasm configure bits
+- support full URL, in X-Long-Polling header
+
+cpuminer Version 0.8.1 - March 22, 2011
+
+- Make --user, --pass actually work
+
+- Add User-Agent HTTP header to requests, so that server operators may
+  more easily identify the miner client.
+
+- Fix minor bug in example JSON config file
+
+cpuminer Version 0.8 - March 21, 2011
+
+- Support long polling: http://deepbit.net/longpolling.php
+
+- Adjust max workload based on scantime (default 5 seconds,
+  or 60 seconds for longpoll)
+
+- Standardize program output, and support syslog on Unix platforms
+
+- Suport --user/--pass options (and "user" and "pass" in config file),
+  as an alternative to the current --userpass
+
+cpuminer Version 0.7.2 - March 14, 2011
+
+- Add port of ufasoft's sse2 assembly implementation (Linux only)
+  This is a substantial speed improvement on Intel CPUs.
+
+- Move all JSON-RPC I/O to separate thread.  This reduces the
+  number of HTTP connections from one-per-thread to one, reducing resource
+  usage on upstream bitcoind / pool server.
+
+cpuminer Version 0.7.1 - March 2, 2011
+
+- Add support for JSON-format configuration file.  See example
+  file example-cfg.json.  Any long argument on the command line
+  may be stored in the config file.
+- Timestamp each solution found
+- Improve sha256_4way performance.  NOTE: This optimization makes
+  the 'hash' debug-print output for sha256_way incorrect.
+- Use __builtin_expect() intrinsic as compiler micro-optimization
+- Build on Intel compiler
+- HTTP library now follows HTTP redirects
+
+cpuminer Version 0.7 - February 12, 2011
+
+- Re-use CURL object, thereby reuseing DNS cache and HTTP connections
+- Use bswap_32, if compiler intrinsic is not available
+- Disable full target validation (as opposed to simply H==0) for now
+
+cpuminer Version 0.6.1 - February 4, 2011
+
+- Fully validate "hash < target", rather than simply stopping our scan
+  if the high 32 bits are 00000000.
+- Add --retry-pause, to set length of pause time between failure retries
+- Display proof-of-work hash and target, if -D (debug mode) enabled
+- Fix max-nonce auto-adjustment to actually work.  This means if your
+  scan takes longer than 5 seconds (--scantime), the miner will slowly
+  reduce the number of hashes you work on, before fetching a new work unit.
+
+cpuminer Version 0.6 - January 29, 2011
+
+- Fetch new work unit, if scanhash takes longer than 5 seconds (--scantime)
+- BeeCee1's sha256 4way optimizations
+- lfm's byte swap optimization (improves via, cryptopp)
+- Fix non-working short options -q, -r
+
+cpuminer Version 0.5 - December 28, 2010
+
+- Exit program, when all threads have exited
+- Improve JSON-RPC failure diagnostics and resilience
+- Add --quiet option, to disable hashmeter output.
+
+cpuminer Version 0.3.3 - December 27, 2010
+
+- Critical fix for sha256_cryptopp 'cryptopp_asm' algo
+
+cpuminer Version 0.3.2 - December 23, 2010
+
+- Critical fix for sha256_via
+
+cpuminer Version 0.3.1 - December 19, 2010
+
+- Critical fix for sha256_via
+- Retry JSON-RPC failures (see --retry, under "minerd --help" output)
+
+cpuminer Version 0.3 - December 18, 2010
+
+- Add crypto++ 32bit assembly implementation
+- show version upon 'minerd --help'
+- work around gcc 4.5.x bug that killed 4way performance
+
+cpuminer Version 0.2.2 - December 6, 2010
+
+- VIA padlock implementation works now
+- Minor build and runtime fixes
+
+cpuminer Version 0.2.1 - November 29, 2010
+
+- avoid buffer overflow when submitting solutions
+- add Crypto++ sha256 implementation (C only, ASM elided for now)
+- minor internal optimizations and cleanups
+
+cpuminer Version 0.2 - November 27, 2010
+
+- Add script for building a Windows installer
+- improve hash performance (hashmeter) statistics
+- add tcatm 4way sha256 implementation
+- Add experimental VIA Padlock sha256 implementation
+
+cpuminer Version 0.1.2 - November 26, 2010
+
+- many small cleanups and micro-optimizations
+- build win32 exe using mingw
+- RPC URL, username/password become command line arguments
+- remove unused OpenSSL dependency
+
+cpuminer Version 0.1.1 - November 24, 2010
+
+- Do not build sha256_generic module separately from cpuminer.
+
+cpuminer Version 0.1 - November 24, 2010
+
+- Initial release.
+

packages/bfgminer/README.ASIC.txt

@@ -0,0 +1,470 @@
+SUPPORTED DEVICES
+
+Currently supported ASIC devices include Avalon, Bitfountain's Block Erupter
+series (both USB and blades), a large variety of Bitfury-based miners,
+Bitmain's Antminer S5 and U1-3, Butterfly Labs' SC range of devices, HashBuster
+boards, GekkoScience's Compac USB stick, Klondike modules, and KnCMiner's
+Mercury, Jupiter and Saturn.
+
+
+ANTMINER S1-S5
+--------------
+
+BFGMiner must be compiled for and run on the embedded controller. When
+configuring, use the --enable-bitmain option to build the 'bitmain' driver used
+to interface with this hardware. None of the device attributes are autodetected
+at this time, so you must also tell BFGMiner this at runtime with a series of
+--set options. For example:
+
+-S bitmain:auto --set btm:model=S5 --set btm:layout=32:8 --set btm:timeout=3
+--set btm:clock=350 --set btm:reg_data=0d82 --set btm:voltage=x0725
+
+Note that reg_data is optional for S4 and S5 and will be calculated from clock
+if not provided.
+
+The meaning of each of these options are not documented individually at this
+time, but can be determined from the stock cgminer's options. You want to look
+at the "bitmain-options" from the command line, and the "bitmain-freq" and
+"bitmain-voltage" in the /config/cgminer.conf file.
+In this case, they were:
+
+NOTE: These are NOT valid BFGMiner options!
+    --bitmain-options 115200:32:8:7:200:0782:0725
+                             |    | |   |    ^^^^ voltage
+                             |    | |   ^^^^ reg_data
+                             |    | ^^^ clock
+                             |    ^ timeout
+                             ^^^^ layout
+    "bitmain-freq" : "3:350:0d82",
+                      | |   ^^^^ reg_data
+                      | ^^^ clock
+                      ^ timeout
+    "bitmain-voltage" : "0725"
+                         ^^^^ voltage
+
+Notice how there are duplicate settings for timeout, clock, reg_data, and
+voltage. You can probably use either one, but the 350 MHz clock performs
+better than the 200 MHz clock. You shouldn't mix and match the
+timeout/clock/reg_data combinations, however!
+
+Additionally, since the controllers are underpowered for these devices, you may
+need to experiment with a good queue setting to control how much work BFGMiner
+tries to pre-prepare for it. A reasonable starting place is:
+
+--queue 8192
+
+
+ALCHEMIST
+---------
+This driver requires the latest FPGA firmware flashed on the blades (stock
+firmware has major bug and won't run properly with this driver). For
+instructions, please visit: https://litecointalk.org/?topic=27370
+The driver has been designed to run each of the 8 blades inside an AlcheMist
+256 as a separate miner. To detect all the blades you need to manually probe it
+with the following serial ports:
+
+-S ALC:all -S ALC:/dev/ttyO1 -S ALC:/dev/ttyO2 -S ALC:/dev/ttyO3
+-S ALC:/dev/ttyO4
+
+(the four ttyUSB ports are auto detected by all)
+
+The driver supports custom frequency settings in the range of 200-400 MHz in 16
+MHz increments (driver will default to 352 MHz if these conditions are not met).
+Frequency is set with the following --set option:
+
+--set ALC:clock=336
+
+You can also set the frequency per board by specifying the tty port:
+
+--set ALC@/dev/ttyO3:clock=352
+
+Driver also supports running single blades off a Raspberry Pi. Make sure you
+have configured GPIO pin 25 correctly (see below) and scan via
+-S ALC:/dev/ttyAMA0
+
+echo 25 > /sys/class/gpio/export
+echo out > /sys/class/gpio/gpio25/direction
+
+
+ANTMINER U3
+-----------
+
+The U3 does not support autodetection, so you will want to use --scan-serial to
+manually probe it. For example, to scan all devices, you can use:
+
+-S antminer:all --set antminer:chip=BM1382
+
+Additionally, for optimal performance you will need to set voltage, clock, and
+timing. Voltage format for the U3 is not documented by the manufacturer, thus
+must be provided as hexadecimal configuration codes. Timing is provided in the
+number of nanoseconds each hash takes at the given configuration. A
+known-working configuration is:
+
+--set antminer:voltage=x800 --set antminer:clock=237.5
+--set antminer:timing=0.022421
+
+
+AVALON 1
+--------
+
+Currently, Avalon boards are best supported by connecting them directly (or via
+a hub) to a regular PC running BFGMiner. It is also possible to install the
+OpenWrt packages of BFGMiner to the Avalon's embedded controller, but this is
+not a simple task due to its lack of available flash space.
+
+To use the Avalon from a regular PC, you will need to specify two options:
+First, add the -S option specifying the avalon driver specifically. For example,
+
+-S avalon:\\.\COM9
+
+Next, use the --set-device option to provide the device configuration.
+If you are translating options from --avalon-options (cgminer and older versions
+of BFGMiner), note the values are baud:miner_count:asic_count:timeout:clock.
+
+    baud=N         The device is essentially hard coded to emulate 115200 baud,
+                   so you shouldn't change this.
+    miner_count=N  Most Avalons are 3 module devices, which come to 24 miners.
+                   4 module devices would use 32 here.
+    asic_count=N   Virtually all have 10, so don't change this.
+    timeout=N      This defines how long the device will work on a work item
+                   before accepting new work to replace it. It should be changed
+                   according to the frequency (last setting). It is possible to
+                   set this a little lower if you are trying to tune for short
+                   block mining (eg p2pool) but much lower and the device will
+                   start creating duplicate shares.
+    clock=N        This is the clock speed of the devices. Only specific values
+                   work: 256, 270, 282 (default), 300, 325, 350 and 375.
+
+Sample settings for valid different frequencies (last 2 values):
+34:375
+36:350
+39:325
+43:300
+45:282
+47:270
+50:256
+
+
+AVALON 2/3
+----------
+
+Avalon 2/3 units communicate with a UART, usually attached to your host via a
+generic USB UART adapter. Therefore, you will need to manually probe the correct
+UART device with the -S option:
+
+-S avalonmm:\\.\COM22
+
+Next, use the --set option to configure at least your desired clock frequency
+and voltage.
+
+Avalon 2: --set avalonmm:clock=1500 --set avalonmm:voltage=1
+Avalon 3: --set avalonmm:clock=450 --set avalonmm:voltage=0.6625
+
+You may also want to set the fan speed, which is specified as a percentage:
+
+--set avalonmm:fan=95
+
+
+BFSB, MEGABIGPOWER, AND METABANK BITFURY BOARDS
+-----------------------------------------------
+
+Both BFSB and MegaBigPower (V2 only at this time) boards are supported with the
+"bfsb" driver. Metabank boards are supported with the "metabank" driver. These
+drivers are not enabled by default, since they must be run on a Raspberry Pi in
+a specific hardware configuration with the boards. To enable them, you must
+build with --enable-bfsb or --enable-metabank. Do not try to use these drivers
+without the manufacturer-supported hardware configuration! Also note that these
+drivers do not properly support thermal shutdown at this time, and without
+sufficient cooling you may destroy your board or chips!
+
+To start BFGMiner, ensure your Raspberry Pi's SPI is enabled (you can run the
+raspi-config utility for this). For Metabank boards, you must also load the I2C
+drivers (do not try to modprobe both with a single command; it won't work):
+    modprobe i2c-bcm2708
+    modprobe i2c-dev
+Then you must run BFGMiner as root, with the proper driver selected.
+For example:
+    sudo bfgminer -S bfsb:auto
+
+
+BFx2
+----
+
+You will need to install the WinUSB driver instead of the default FTDI serial
+driver. The easiest way to do this is using Zadig: http://zadig.akeo.ie/
+
+Note that since it's impossible to tell the BFx2 apart from various other
+devices (including BFL/Cairnsmore1 miners and even many non-mining devices!),
+you must run with the -S bfx:all option (or 'bfx:all' at the M+ menu).
+
+I do not know what this will do with other devices; it may start fires,
+launch nuclear missiles (please don't run BFGMiner on computers with
+missile controls), etc.
+
+
+BI*FURY
+-------
+
+Bi*Fury should just work; you may need to use -S bifury:<path>
+
+On Windows, you will need to install the standard USB CDC driver for it.
+    http://store.bitcoin.org.pl/support
+
+If you want to upgrade the firmware, unplug your device. You will need to
+temporarily short a circuit. With the USB connector pointing forward, and the
+heatsink down, look to the forward-right; you will see two tiny lights, a set of
+2 terminals, and a set of 3 terminals. The ones you need to short are the set of
+2. With them shorted, plug the device back into your computer. It will then
+pretend to be a mass storage disk drive. If you use Windows, you can play along
+and just overwrite the firmware.bin file. If you use Linux, you must use mcopy:
+    mcopy -i /dev/disk/by-id/usb-NXP_LPC1XXX_IFLASH_ISP-0:0 firmware.bin \
+        ::/firmware.bin
+After this is complete, unplug the device again and un-short the 2 terminals.
+This completes the upgrade and you can now plug it back in and start mining.
+
+
+BIG PICTURE MINING BITFURY USB
+------------------------------
+
+These miners are sensitive to unexpected data. Usually you can re-plug them to
+reset to a known-good initialisation state. To ensure they are properly detected
+and used with BFGMiner, you must specify -S bigpic:all (or equivalent) options
+prior to any other -S options (which might probe the device and confuse it).
+
+
+BLOCK ERUPTER BLADE
+-------------------
+
+Blades communicate over Ethernet using the old but simple getwork mining
+protocol. If you build BFGMiner with libmicrohttpd, you can have it work with
+one or more blades. First, start BFGMiner with the --http-port option. For
+example:
+    bfgminer --http-port 8330
+Then configure your blade to connect to your BFGMiner instance on the same port,
+with a unique username per blade. It will then show up as a PXY device and
+should work more or less like any other miner.
+
+
+BLOCK ERUPTER USB
+-----------------
+
+These will autodetect if supported by the device; otherwise, you need to use
+the '--scan-serial erupter:<device>' option to tell BFGMiner what device to
+probe; if you know you have no other serial devices, or only ones that can
+tolerate garbage, you can use '--scan-serial erupter:all' to probe all serial
+ports. They communicate with the Icarus protocol, which has some additional
+options in README.FPGA
+
+
+COMPAC
+------
+
+These USB sticks are based on Bitmain's BM1384 chip, and use the antminer
+driver. You can set the clock frequency with
+
+--set compac:clock=200
+
+
+HEX*FURY
+--------
+
+Hex*Fury uses the bifury driver. Miners using earlier boards may need to
+workaround bugs in the firmware:
+    bfgminer --set bifury:chips=6 --set bifury:free_after_job=no
+This may cause poor behaviour or performance from other bifury-based devices.
+If you encounter this, you can set the workarounds per-device by using their
+serial number (which can be seen in the TUI device manager; in this example,
+141407160211cdf):
+    bfgminer --set bifury@141407160211cdf:chips=15 ...
+
+
+KLONDIKE
+--------
+
+--klondike-options <arg> Set klondike options clock:temptarget
+
+
+KNCMINER (Jupiter)
+--------
+
+KnCMiner rigs use a BeagleBone Black (BBB) as the host; this is pluged into a
+"cape" with a FPGA and connections for 4-6 ASIC modules (depending on the cape
+version). Note that in addition to the usual dependencies, this driver also
+requires i2c-tools (aka libi2c-dev on some systems). The BBB comes with the
+Ångström Distribution by default. The following is a step by step install for
+BFGMiner on this system;
+
+-----------------Start------------
+cat >/etc/opkg/feeds.conf <<\EOF
+src/gz noarch http://feeds.angstrom-distribution.org/feeds/v2013.06/ipk/eglibc/all/
+src/gz base http://feeds.angstrom-distribution.org/feeds/v2013.06/ipk/eglibc/armv7ahf-vfp-neon/base/
+src/gz beaglebone http://feeds.angstrom-distribution.org/feeds/v2013.06/ipk/eglibc/armv7ahf-vfp-neon/machine/beaglebone/
+EOF
+
+opkg update
+opkg install angstrom-feed-configs
+rm /etc/opkg/feeds.conf
+opkg update
+
+opkg install update-alternatives
+opkg install automake autoconf make gcc cpp binutils git less pkgconfig-dev ncurses-dev libtool nano bash i2c-tools-dev
+while ! opkg install libcurl-dev; do true; done
+
+curl http://www.digip.org/jansson/releases/jansson-2.0.1.tar.bz2 | tar -xjvp
+cd jansson-2.0.1
+./configure --prefix=/usr CC=arm-angstrom-linux-gnueabi-gcc --disable-static NM=arm-angstrom-linux-gnueabi-nm
+make install && ldconfig
+cd ..
+
+git clone git://github.com/luke-jr/bfgminer
+cd bfgminer
+./autogen.sh
+git clone git://github.com/troydhanson/uthash
+./configure --host=arm-angstrom-linux-gnueabi --enable-knc --disable-other-drivers CFLAGS="-I$PWD/uthash/src"
+make AR=arm-angstrom-linux-gnueabi-ar
+
+/etc/init.d/cgminer.sh stop
+./bfgminer -S knc:auto -c /config/cgminer.conf
+
+---------------END-------------
+
+KNCMINER (Titan)
+--------
+
+Titan uses RaspberryPi as a controller.
+
+Build instructions:
+-----------------Start------------
+
+git clone git@github.com:KnCMiner/bfgminer.git
+cd bfgminer
+./autogen.sh
+./configure --enable-scrypt --disable-sha256d --enable-titan --disable-other-drivers
+make
+sudo /etc/init.d/bfgminer.sh restart
+screen -r
+
+---------------END-------------
+
+MONARCH
+-------
+
+The Butterfly Labs Monarch devices can be used as either USB devices, or in a
+PCI-Express slot. As USB devices, they are essentially plug-and-play. If you
+wish to use them via PCI-Express, however, you must first load the proper
+driver. BFGMiner can work with either Linux uio (2.6.23+, requires root access)
+or Linux vfio (3.6+, requires IOMMU support).
+
+To enable uio on your cards, you may need to do:
+    sudo modprobe uio_pci_generic
+    echo 1cf9 0001 | sudo tee /sys/bus/pci/drivers/uio_pci_generic/new_id
+
+Enabling vfio is similar, but allows you to run BFGMiner without root
+privileges. Since setting this up is more complicated, BFGMiner includes a
+setup-vfio script (which must be run with root permissions). Simply run:
+    sudo setup-vfio --unsafe --user $(whoami) 1cf9 0001
+You will be asked about each Monarch found, and must answer 'yes' to each one.
+
+If you wish to manually setup VFIO, follow these steps:
+First, load the kernel module:
+    sudo modprobe vfio-pci
+Next, identify what the device ids are for your card(s):
+    lspci -D | grep 1cf9  # the first number of each line is the device id
+From that, you can identify its IOMMU group, and list all devices sharing that
+group:
+    readlink "/sys/bus/pci/devices/$DEVICE_ID/iommu_group"
+    ls "/sys/kernel/iommu_groups/$IOMMU_GROUP_ID/devices/"
+All of the devices listed (other than the Monarch), if any, will need to be
+disabled and unbound! To do that, use:
+    echo "$DEVICE_ID" | sudo tee "/sys/bus/pci/devices/$DEVICE_ID/driver/unbind"
+    echo "$DEVICE_CODE" | sudo tee /sys/bus/pci/drivers/vfio-pci/new_id
+Note that $DEVICE_ID should be something like "0000:01:00.0" and $DEVICE_CODE is
+something like "1cf9 0001" (this example is the Monarch itself).
+If you want to run BFGMiner as a normal user:
+    chown "$USERNAME" "/dev/vfio/$IOMMU_GROUP_ID"
+Depending on your system, you may also need to do:
+    echo 1 | sudo tee /sys/module/vfio_iommu_type1/parameters/allow_unsafe_interrupts
+
+
+ONESTRINGMINER
+--------------
+
+OneStringMiner boards use the bifury driver. Miners using earlier boards may
+need to workaround bugs in the firmware:
+    bfgminer --set bifury:chips=15 --set bifury:free_after_job=no
+If you have different devices using the bifury driver, see the section on
+Hex*Fury for applying workarounds per-device.
+
+
+GRIDSEED
+--------
+
+Gridseed units, at the present time, come in two versions: Blade - a 40 chip
+unit and Orb - a 5 chip unit. Orb units can be used to mine both SHA256d and
+scrypt based coins whereas the Blade is scrypt only, although BFGMiner only
+supports scrypt mode at this time.
+
+BFGMiner allows a miner to connect both types of units to a single miner
+instance and provides for granular control of the clock frequencies for each
+device and each chip on each device. The basic use of this feature is to use the
+--set option on from the command line:
+
+bfgminer --scrypt -S gridseed:all --set gridseed@<serial_number>:clock=825
+
+for multiple devices, add multiple --set arguments.
+
+Additionally, these can be added to the bfgminer.conf file for persistence like
+this:
+
+"set" : [
+        "gridseed@<serial_number>:clock=825",
+        "gridseed@<serial_number>:clock=850",
+        "gridseed@<serial_number>:clock=875"
+]
+
+To find the device serial number, start bfgminer and press <M> to manage
+devices, then <Page Down> or <down arrow> through the list of devices and take
+note of the device serial number in the device information shown.
+
+...
+Select processor to manage using up/down arrow keys
+ GSD 0a:       |  74.4/ 72.9/ 10.2kh/s | A:  1 R:0+0(none) HW:0/none
+  STM32 Virtual COM Port from STMicroelectronics
+Serial: 6D85278F5650
+Clock speed: 875
+...
+
+So for example, an entry would look like this:
+        gridseed@6D85278F5650:clock=875
+
+
+ZEUSMINER
+---------
+
+Zeusminers do not support autodetection, so you will need to use --scan to probe
+for them:
+
+-S zeusminer:\\.\COM3
+
+You should also configure the driver for your specific device:
+
+    --set zeusminer:clock=N        Clock frequency (default: 328)
+    --set zeusminer:chips=N        Number of chips per device
+        Blizzard    :  6          Cyclone     :  96
+        Hurricane X2: 48 (2*24)   Hurricane X3:  64 (2*32)
+        Thunder   X2: 96 (4*24)   Thunder   X3: 128 (4*32)
+Note: if you set this option incorrectly, the device may underperform and/or
+      misreport hashrate.
+
+For example:
+
+bfgminer --scrypt -o stratum+tcp://pool:port -u user -p pass -S zeusminer:\\.\COM3 --set zeusminer:clock=328 --set zeusminer:chips=128
+
+---
+
+This code is provided entirely free of charge by the programmer in his spare
+time so donations would be greatly appreciated. Please consider donating to the
+address below.
+
+Luke-Jr <luke-jr+bfgminer@utopios.org>
+1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh

packages/bfgminer/README.FPGA.txt

@@ -0,0 +1,288 @@
+
+This README contains extended details about FPGA mining with BFGMiner
+
+
+ModMiner (MMQ)
+--------------
+
+ModMiner does not have any persistent storage for bitstreams, so BFGMiner must
+upload it after power on. For this to work, you must first download the
+necessary bitstream file to BFGMiner's "bitstreams" directory, and give it the
+name "fpgaminer_x6500-overclocker-0402.bit". You can download this bitstream
+from FPGA Mining LLC's website:
+    http://www.fpgamining.com/documentation/firmware
+
+-
+
+If the MMQ doesn't respond to BFGMiner at all, or the red LED isn't flashing
+then you will need to reset the MMQ.
+
+The red LED should always be flashing when it is mining or ready to mine.
+
+To reset the MMQ, you are best to press the left "RESET" button on the
+backplane, then unplug and replug the USB cable.
+
+If your MMQ doesn't have a button on the "RESET" pad, you need to join the two
+left pads of the "RESET" pad with conductive wire to reset it. Cutting a small
+(metal) paper-clip in half works well for this.
+
+Then unplug the USB cable, wait for 5 seconds, then plug it back in.
+
+After you press reset, the red LED near the USB port should blink continuously.
+
+If it still wont work, power off, wait for 5 seconds, then power on the MMQ
+This of course means it will upload the bitstream again when you start BFGMiner.
+
+-
+
+Device 0 is on the power end of the board.
+
+-
+
+You must make sure you have an appropriate firmware in your MMQ
+Read here for official details of changing the firmware:
+ http://wiki.btcfpga.com/index.php?title=Firmware
+
+The basics of changing the firmware are:
+ You need two short pieces of conductive wire if your MMQ doesn't have buttons
+ on the "RESET" and "ISP" pads on the backplane board.
+ Cutting a small (metal) paper-clip in half works well for this.
+
+ Join the 2 left pads of the "RESET" pad with wire and the led will dim.
+ Without disconnecting the "RESET", join the 2 left pads of the "ISP" pad with
+ a wire and it will stay dim.
+ Release "RESET" then release "ISP" and is should still be dim.
+ Unplug the USB and when you plug it back in it will show up as a mass storage
+ device.
+  Linux: (as one single line):
+   mcopy -i /dev/disk/by-id/usb-NXP_LPC134X_IFLASH_ISP000000000-0:0
+      modminer091012.bin ::/firmware.bin
+  Windows: delete the MSD device file firmware.bin and copy in the new one
+   rename the new file and put it under the same name 'firmware.bin'
+ Disconnect the USB correctly (so writes are flushed first)
+ Join and then disconnect "RESET" and then plug the USB back in and it's done.
+
+Best to update to one of the latest 2 listed below if you don't already
+have one of them in your MMQ.
+
+The current latest different firmware are:
+
+ Latest for support of normal or TLM bitstream:
+  http://btcfpga.com/files/firmware/modminer092612-TLM.bin
+
+ Latest with only normal bitstream support (Temps/HW Fix):
+  http://btcfpga.com/files/firmware/modminer091012.bin
+
+The code is currently tested on the modminer091012.bin firmware.
+This comment will be updated when others have been tested.
+
+-
+
+On many Linux distributions there is an app called modem-manager that may cause
+problems when it is enabled, due to opening the MMQ device and writing to it.
+
+The problem will typically present itself by the flashing led on the backplane
+going out (no longer flashing) and it takes a power cycle to re-enable the MMQ
+firmware - which then can lead to the problem reoccurring.
+
+You can either disable/uninstall modem-manager if you don't need it or:
+a (hack) solution to this is to blacklist the MMQ USB device in
+/lib/udev/rules.d/77-mm-usb-device-blacklist.rules
+
+Adding 2 lines like this (just above APC) should help.
+# MMQ
+ATTRS{idVendor}=="1fc9", ATTRS{idProduct}=="0003", ENV{ID_MM_DEVICE_IGNORE}="1"
+
+The change will be lost and need to be re-done, next time you update the
+modem-manager software.
+
+
+BitForce (BFL)
+--------------
+
+--bfl-range         Use nonce range on BitForce devices if supported
+
+This option is only for BitForce devices. Earlier devices such as the single
+did not have any way of doing small amounts of work which meant that a lot of
+work could be lost across block changes. Some of the Mini Rigs have support
+for doing this, so less work is lost across a longpoll. However, it comes at
+a cost of 1% in overall hashrate so this feature is disabled by default. It
+is only recommended you enable this if you are mining with a Mini Rig on
+P2Pool.
+
+BitFORCE FPGA Single units can have their bitstream modified using the
+bitforce-firmware-flash utility on Linux, which can be obtained from:
+    https://github.com/luke-jr/bitforce-fpga-firmware-flash
+It is untested with other devices. Use at your own risk! Windows users may use
+Butterfly Labs EasyMiner to change firmware.
+
+To compile:
+ make bitforce-firmware-flash
+To flash your BFL, specify the BFL port and the flash file e.g.:
+ sudo ./bitforce-firmware-flash /dev/ttyUSB0 alphaminer_832.bfl
+It takes a bit under 3 minutes to flash a BFL and shows a progress % counter
+Once it completes, you may also need to wait about 15 seconds, then power the
+BFL off and on again.
+
+If you get an error at the end of the BFL flash process stating:
+ "Error reading response from ZBX"
+it may have worked successfully anyway.
+Test mining on it to be sure if it worked or not.
+
+You need to give BFGMiner about 10 minutes mining with the BFL to be sure of
+the Mh/s value reported with the changed firmware - and the Mh/s reported will
+be less than the firmware speed since you lose work on every block change.
+
+
+Icarus (ICA)
+------------
+
+There are a number of options for Icarus-compatible devices which can be used
+with --set-devices (or the RPC pgaset method):
+
+    baud=N           The serial baud rate (default 115200)
+    work_division=N  The fraction of work divided up for each processor: 1, 2,
+                     4, or 8. e.g. 2 means each does half the nonce range
+                     (default 2)
+    fpga_count=N     The actual number of processors working; this would
+                     normally be the same as work_division. Range is from 1 up
+                     to <work_division>. It defaults to the value of
+                     work_division, or 2 if you don't specify work_division.
+    reopen=MODE      Controls how often the driver reopens the device to
+                     workaround issues. Choices are 'never', on 'timeout' only
+                     (default), or every 'cycle'.
+    timing=MODE      Set how the timing is calculated:
+                         default[=N]   Use the default hash time
+                         short[=N]     Calculate the hash time and stop
+                                       adjusting it at ~315 difficulty 1 shares
+                                       (~1hr)
+                         long=[N]      Re-calculate the hash time continuously
+                         value[=N]     Specify the hash time in nanoseconds
+                                       (e.g. 2.6316) and abort time (e.g.
+                                       2.6316=80).
+
+An example would be: --set-device ECM:baud=57600 --set-device
+ECM:work_division=2 --set-device DCM:fpga_count=1 --set-device ECM:reopen=never
+This would mean: use 57600 baud, the FPGA board divides the work in half however
+only 1 FPGA actually runs on the board, and don't reopen the device (e.g. like
+an early CM1 Icarus copy bitstream).
+
+Icarus timing is used to determine the number of hashes that have been checked
+when it aborts a nonce range (including on a longpoll).
+It is also used to determine the elapsed time when it should abort a nonce
+range to avoid letting the Icarus go idle, but also to safely maximise that
+time.
+
+'short' or 'long' mode should only be used on a computer that has enough CPU
+available to run BFGMiner without any CPU delays.
+Any CPU delays while calculating the hash time will affect the result
+'short' mode only requires the computer to be stable until it has completed
+~315 difficulty 1 shares, 'long' mode requires it to always be stable to ensure
+accuracy, however, over time it continually corrects itself.
+The optional additional =N for 'short' or 'long' specifies the limit to set the
+timeout to in deciseconds; thus if the timing code calculation is higher while
+running, it will instead use the limit.
+This can be set to the appropriate value to ensure the device never goes idle
+even if the calculation is negatively affected by system performance.
+
+When in 'short' or 'long' mode, it will report the hash time value each time it
+is re-calculated.
+In 'short' or 'long' mode, the scan abort time starts at 5 seconds and uses the
+default 2.6316ns scan hash time, for the first 5 nonces or one minute
+(whichever is longer).
+
+In 'default' or 'value' mode the 'constants' are calculated once at the start,
+based on the default value or the value specified.
+The optional additional =N specifies to set the default abort at N 1/10ths of a
+second, not the calculated value, which is 112 for 2.6316ns
+
+To determine the hash time value for a non Icarus Rev3 device or an Icarus Rev3
+with a different bitstream to the default one, use 'long' mode and give it at
+least a few hundred shares, or use 'short' mode and take note of the final hash
+time value (Hs) calculated.
+You can also use the RPC API 'stats' command to see the current hash time (Hs)
+at any time.
+
+The Icarus code currently only works with devices that support the same commands
+as Icarus Rev3 requires and also is less than ~840Mh/s and greater than 2Mh/s.
+If your device does hash faster than ~840Mh/s it should work correctly if you
+supply the correct hash time nanoseconds value.
+
+The timing code itself will affect the Icarus performance since it increases
+the delay after work is completed or aborted until it starts again.
+The increase is, however, extremely small and the actual increase is reported
+with the RPC API 'stats' command (a very slow CPU will make it more noticeable).
+Using the 'short' mode will remove this delay after 'short' mode completes.
+The delay doesn't affect the calculation of the correct hash time.
+
+
+X6500
+-----
+
+Since X6500 FPGAs do not use serial ports for communication, the --scan-serial
+option instead works with product serial numbers. By default, any devices with
+the X6500 USB product id will be used, but some X6500s may have shipped without
+this product id being configured. If you have any of these, you will need to
+specify their serial numbers explicitly, and also add -S x6500:auto if you
+still want to use the autodetection for other properly-configured FPGAs.
+The serial number of X6500s is usually found on a label applied to the ATX
+power connector slot. If yours is missing, devices seen by the system can be
+displayed by starting bfgminer in debug mode. To get a simple list of devices,
+with the debug output shown, you can use: bfgminer -D -d? -T
+
+X6500 does not have any persistent storage for bitstreams, so BFGMiner must
+upload it after power on. For this to work, you must first download the
+necessary bitstream file to BFGMiner's "bitstreams" directory, and give it the
+name "fpgaminer_x6500-overclocker-0402.bit". You can download this bitstream
+from FPGA Mining LLC's website:
+    http://www.fpgamining.com/documentation/firmware
+
+
+ZTEX FPGA Boards
+----------------
+
+http://www.ztex.de sells two boards suitable for mining: the 1.15x with 1 FPGA
+and the 1.15y with 4 FPGAs. ZTEX distributes their own mining software and
+drivers. BFGMiner has full support for these boards, as long as they have at
+least the "dummy" mining bitstreams installed on them.
+
+If your boards do not have a mining bitstream yet, you must first, install
+ZTEX's BTCMiner (requires Java JDK version 6 or later) and install one.
+
+=== WINDOWS NOTE ===
+Upon first powering up and connecting the board via USB, windows will attempt
+and fail to find the appropriate drivers.  To load the initial firmware on the
+board, you'll need the EZ-USB FX2 SDK from here:
+    http://www.ztex.de/downloads/#firmware_kit
+Extract the firmware kit and use the driver within libusb-win32/ztex.inf.
+Windows should now recognize the board and you're ready to program it.
+=== END OF WINDOWS ===
+
+Grab the latest miner jar from http://www.ztex.de/btcminer/#download and program
+the appropriate dummy firmware for your board.  The command should look
+something like (for a single FPGA board):
+    java -cp ZtexBTCMiner-120417.jar BTCMiner -m p -f **FILENAME** -s 01-02-01
+For ZTEX 1.15x boards, the dummy bitstream filename is ztex_ufm1_15d.ihx
+For ZTEX 1.15y boards, the dummy bitstream filename is ztex_ufm1_15y.ihx
+
+=== WINDOWS NOTE ===
+To mine using BFGMiner, you'll have to swap the USB drivers. The BFGMiner-
+compatible WinUSB drivers for the board can be generated with this tool:
+    http://sourceforge.net/projects/libwdi/files/zadig/
+Basic usage instructions for Zadig can be found here:
+    https://github.com/pbatard/libwdi/wiki/Zadig
+Once Zadig generates and installs a WinUSB driver, ensure everything is working
+by running:
+    bfgminer -D -d? -T
+You should see something like this in the output:
+    [2013-01-22 20:19:11] Found 1 ztex board
+    [2013-01-22 20:19:11] ZTX 0: Found Ztex (ZTEX 0001-02-01-1)
+=== END OF WINDOWS ===
+
+If you have installed a dummy bitstream, you will now need to copy the main
+mining bitstream where BFGMiner can find it. This are usually the same as the
+dummy bitstream filename, but with a number added to the end. Extract the
+ZtexBTCMiner-120417.jar file using any unzip utility, and look for the proper
+*.ihx and *.bit files (the latter will be inside the 'fpga' directory of the
+jar). Copy them to BFGMiner's "bitstreams" directory, and you're ready to start
+mining.

packages/bfgminer/README.GPU.txt

@@ -0,0 +1,489 @@
+EXECUTIVE SUMMARY ON GPU USAGE (SEE ALSO README.scrypt FOR SCRYPT MINING):
+
+By default, BFGMiner will NOT mine on any GPUs unless in scrypt mode. If you
+wish to use your GPU to mine SHA256d (generally not a good idea), you can
+explicitly enable it with the -S opencl:auto option.
+
+Single pool, regular desktop:
+
+bfgminer -S opencl:auto -o http://pool:port -u username -p password
+
+If you have configured your system properly, BFGMiner will mine on all GPUs in
+"dynamic" mode which is designed to keep your system usable and sacrifice some
+mining performance.
+
+Single pool, dedicated miner:
+
+bfgminer -S opencl:auto -o http://pool:port -u username -p password --set-device intensity=9
+
+Single pool, first card regular desktop, 3 other dedicated cards:
+
+bfgminer -S opencl:auto -o http://pool:port -u username -p password --set-device intensity=9 --set-device OCL0:intensity=d
+
+Multiple pool, dedicated miner:
+
+bfgminer -S opencl:auto -o http://pool1:port -u pool1username -p pool1password -o http://pool2:port -u pool2usernmae -p pool2password --set-device intensity=9
+
+Add overclocking settings, GPU and fan control for all cards:
+
+bfgminer -S opencl:auto -o http://pool:port -u username -p password --set-device intensity=9 --auto-fan --auto-gpu --set-device OCL:clock=750-950 --set-device OCL:memclock=300
+
+Add overclocking settings, GPU and fan control with different engine settings for 4 cards:
+
+bfgminer -S opencl:auto -o http://pool:port -u username -p password --set-device intensity=9 --auto-fan --auto-gpu --set-device OCL0:clock=750-950 --set-device OCL1:clock=945 --set-device OCL2:clock=700-930 --set-device OCL3:clock=960 --set-device OCL:memclock=300
+
+READ WARNINGS AND DOCUMENTATION BELOW ABOUT OVERCLOCKING
+
+To configure multiple displays on linux you need to configure your Xorg cleanly
+to use them all:
+
+sudo aticonfig --adapter=all -f --initial
+
+On Linux you virtually always need to export your display settings before
+starting to get all the cards recognised and/or temperature+clocking working:
+
+export DISPLAY=:0
+
+---
+SETUP FOR GPU SUPPORT:
+
+To setup GPU mining support:
+
+Install the AMD APP sdk, ideal version (see FAQ!) - put it into a system
+location.
+Download the correct version for either 32 bit or 64 bit from here:
+	http://developer.amd.com/tools/heterogeneous-computing/amd-accelerated-parallel-processing-app-sdk/downloads/
+
+The best version for Radeon 5xxx and 6xxx is v2.5, while 7xxx cards need v2.6 or
+later, 2.7 seems the best.
+
+For versions 2.4 or earlier you will need to manually install them:
+This will give you a file with a name like:
+ AMD-APP-SDK-v2.4-lnx64.tgz (64-bit)
+or
+ AMD-APP-SDK-v2.4-lnx32.tgz (32-bit)
+
+Then:
+
+sudo -i
+cd /opt
+tar xf /path/to/AMD-APP-SDK-v2.4-lnx##.tgz
+cd /
+tar xf /opt/AMD-APP-SDK-v2.4-lnx##/icd-registration.tgz
+ln -s /opt/AMD-APP-SDK-v2.4-lnx##/include/CL /usr/include
+ln -s /opt/AMD-APP-SDK-v2.4-lnx##/lib/x86_64/* /usr/lib/
+ldconfig
+
+Where ## is 32 or 64, depending on the bitness of the SDK you downloaded.
+If you are on 32 bit, x86_64 in the 2nd last line should be x86
+
+
+---
+INTENSITY INFORMATION:
+
+Intensity correlates with the size of work being submitted at any one time to
+a GPU. The higher the number the larger the size of work. Generally speaking
+finding an optimal value rather than the highest value is the correct approach
+as hash rate rises up to a point with higher intensities but above that, the
+device may be very slow to return responses, or produce errors.
+
+NOTE: Running intensities above 9 with current hardware is likely to only
+diminish return performance even if the hash rate might appear better. A good
+starting baseline intensity to try on dedicated miners is 9. 11 is the upper
+limit for intensity while Bitcoin mining, if the GPU_USE_SYNC_OBJECTS variable
+is set (see FAQ). The upper limit for SHA256d mining is 14 and 20 for scrypt.
+
+
+---
+OVERCLOCKING WARNING AND INFORMATION
+
+AS WITH ALL OVERCLOCKING TOOLS YOU ARE ENTIRELY RESPONSIBLE FOR ANY HARM YOU
+MAY CAUSE TO YOUR HARDWARE. OVERCLOCKING CAN INVALIDATE WARRANTIES, DAMAGE
+HARDWARE AND EVEN CAUSE FIRES. THE AUTHOR ASSUMES NO RESPONSIBILITY FOR ANY
+DAMAGE YOU MAY CAUSE OR UNPLANNED CHILDREN THAT MAY OCCUR AS A RESULT.
+
+The GPU monitoring, clocking and fanspeed control incorporated into BFGMiner
+comes through use of the ATI Display Library. As such, it only supports ATI
+GPUs. Even if ADL support is successfully built into BFGMiner, unless the card
+and driver supports it, no GPU monitoring/settings will be available.
+
+BFGMiner supports initial setting of GPU engine clock speed, memory clock
+speed, voltage, fanspeed, and the undocumented powertune feature of 69x0+ GPUs.
+The setting passed to BFGMiner is used by all GPUs unless separate values are
+specified. All settings can all be changed within the menu on the fly on a
+per-GPU basis.
+
+For example:
+--set-device OCL:clock=950 --set-device OCL:memclock=825
+
+will try to set all GPU engine clocks to 950 and all memory clocks to 825,
+while:
+--set-device OCL0:clock=950 --set-device OCL1:clock=945 --set-device OCL2:clock=930 --set-device OCL3:clock=960 --set-device OCL:memclock=300
+
+will try to set the engine clock of card 0 to 950, 1 to 945, 2 to 930, 3 to
+960 and all memory clocks to 300.
+
+AUTO MODES:
+There are two "auto" modes in BFGMiner, --auto-fan and --auto-gpu. These can be
+used independently of each other and are complementary. Both auto modes are
+designed to safely change settings while trying to maintain a target
+temperature. By default this is set to 75 degrees C but can be changed with the
+--set-device option. For example:
+
+--set-device OCL:temp-target=80
+Sets all cards' target temperature to 80 degrees.
+
+--set-device OCL0:temp-target=75 --set-device OCL1:temp-target=85
+Sets card 0 target temperature to 75, and card 1 to 85 degrees.
+
+AUTO FAN:
+e.g.
+--auto-fan (implies 85% upper limit)
+--set-device OCL0:fan=25-85 --set-device OCL1:fan=65 --auto-fan
+
+Fan control in auto fan works off the theory that the minimum possible fan
+required to maintain an optimal temperature will use less power, make less
+noise, and prolong the life of the fan. In auto-fan mode, the fan speed is
+limited to 85% if the temperature is below "overheat" intentionally, as higher
+fanspeeds on GPUs do not produce signficantly more cooling, yet significantly
+shorten the lifespan of the fans. If temperature reaches the overheat value,
+fanspeed will still be increased to 100%. The overheat value is set to 85
+degrees by default and can be changed with the temp_overheat setting:
+
+e.g.
+--set-device OCL0:temp_overheat=75 --set-device OCL1:temp_overheat=85
+Sets card 0 overheat threshold to 75 degrees and card 1 to 85.
+
+AUTO GPU:
+e.g.
+--auto-gpu --set-device OCL:clock=750-950
+--auto-gpu --set-device OCL0:clock=750-950 --set-device OCL1:clock=945 --set-device OCL2:clock=700-930 --set-device OCL3:clock=960
+
+GPU control in auto gpu tries to maintain as high a clock speed as possible
+while not reaching overheat temperatures. As a lower clock speed limit, the
+auto-gpu mode checks the GPU card's "normal" clock speed and will not go below
+this unless you have manually set a lower speed in the range. Also, unless a
+higher clock speed was specified at startup, it will not raise the clockspeed.
+If the temperature climbs, fanspeed is adjusted and optimised before GPU engine
+clockspeed is adjusted. If fan speed control is not available or already
+optimal, then GPU clock speed is only decreased if it goes over the target
+temperature by the hysteresis amount, which is set to 3 by default and can be
+changed with:
+--temp-hysteresis
+If the temperature drops below the target temperature, and engine clock speed
+is not at the highest level set at startup, BFGMiner will raise the clock speed.
+If at any time you manually set an even higher clock speed successfully in
+BFGMiner, it will record this value and use it as its new upper limit (and the
+same for low clock speeds and lower limits). If the temperature goes over the
+cutoff limit (95 degrees by default), BFGMiner will completely disable the GPU
+from mining and it will not be re-enabled unless manually done so. The cutoff
+temperature can be changed with:
+
+--set-device OCL0:temp-cutoff=95 --set-device OCL1:temp-cutoff=105
+Sets card 0 cutoff temperature to 95 and card 1 to 105.
+
+--set-device OCL:memdiff=-125
+This setting will modify the memory speed whenever the GPU clock speed is
+modified by --auto-gpu. In this example, it will set the memory speed to be 125
+MHz lower than the GPU speed. This is useful for some cards like the 6970 which
+normally don't allow a bigger clock speed difference. The 6970 is known to only
+allow -125, while the 7970 only allows -150.
+
+
+CHANGING SETTINGS:
+When setting values, it is important to realise that even though the driver
+may report the value was changed successfully, and the new card power profile
+information contains the values you set it to, that the card itself may
+refuse to use those settings. As the performance profile changes dynamically,
+querying the "current" value on the card can be wrong as well. So when changing
+values in BFGMiner, after a pause of 1 second, it will report to you the current
+values where you should check that your change has taken. An example is that
+6970 reference cards will accept low memory values but refuse to actually run
+those lower memory values unless they're within 125 of the engine clock speed.
+In that scenario, they usually set their real speed back to their default.
+
+BFGMiner reports the so-called "safe" range of whatever it is you are modifying
+when you ask to modify it on the fly. However, you can change settings to values
+outside this range. Despite this, the card can easily refuse to accept your
+changes, or worse, to accept your changes and then silently ignore them. So
+there is absolutely to know how far to/from where/to it can set things safely or
+otherwise, and there is nothing stopping you from at least trying to set them
+outside this range. Being very conscious of these possible failures is why
+BFGMiner will report back the current values for you to examine how exactly the
+card has responded. Even within the reported range of accepted values by the
+card, it is very easy to crash just about any card, so it cannot use those
+values to determine what range to set. You have to provide something meaningful
+manually for BFGMiner to work with through experimentation.
+
+STARTUP / SHUTDOWN:
+When BFGMiner starts up, it tries to read off the current profile information
+for clock and fan speeds and stores these values. When quitting BFGMiner, it
+will then try to restore the original values. Changing settings outside of
+BFGMiner while it's running may be reset to the startup BFGMiner values when
+BFGMiner shuts down because of this.
+
+---
+
+GPU DEVICE ISSUES and use of --gpu-map
+
+GPUs mine with OpenCL software via the GPU device driver. This means you need
+to have both an OpenCL SDK installed, and the GPU device driver RUNNING (i.e.
+Xorg up and running configured for all devices that will mine on linux etc.)
+Meanwhile, the hardware monitoring that BFGMiner offers for AMD devices relies
+on the ATI Display Library (ADL) software to work. OpenCL DOES NOT TALK TO THE
+ADL. There is no 100% reliable way to know that OpenCL devices are identical
+to the ADL devices, as neither give off the same information. BFGMiner does its
+best to correlate these devices based on the order that OpenCL and ADL numbers
+them. It is possible that this will fail for the following reasons:
+
+1. The device order is listed differently by OpenCL and ADL (rare), even if the
+number of devices is the same.
+2. There are more OpenCL devices than ADL. OpenCL stupidly sees one GPU as two
+devices if you have two monitors connected to the one GPU.
+3. There are more ADL devices than OpenCL. ADL devices include any ATI GPUs,
+including ones that can't mine, like some older R4xxx cards.
+
+To cope with this, the ADVANCED option for --gpu-map is provided with BFGMiner.
+DO NOT USE THIS UNLESS YOU KNOW WHAT YOU ARE DOING. The default will work the
+vast majority of the time unless you know you have a problem already.
+
+To get useful information, start BFGMiner with just the -n option. You will get
+output that looks like this:
+
+[2012-04-25 13:17:34] CL Platform 0 vendor: Advanced Micro Devices, Inc.
+[2012-04-25 13:17:34] CL Platform 0 name: AMD Accelerated Parallel Processing
+[2012-04-25 13:17:34] CL Platform 0 version: OpenCL 1.1 AMD-APP (844.4)
+[2012-04-25 13:17:34] Platform 0 devices: 3
+[2012-04-25 13:17:34]   0       Tahiti
+[2012-04-25 13:17:34]   1       Tahiti
+[2012-04-25 13:17:34]   2       Cayman
+[2012-04-25 13:17:34] GPU 0 AMD Radeon HD 7900 Series  hardware monitoring enabled
+[2012-04-25 13:17:34] GPU 1 AMD Radeon HD 7900 Series  hardware monitoring enabled
+[2012-04-25 13:17:34] GPU 2 AMD Radeon HD 6900 Series hardware monitoring enabled
+[2012-04-25 13:17:34] 3 GPU devices max detected
+
+Note the number of devices here match, and the order is the same. If devices 1
+and 2 were different between Tahiti and Cayman, you could run BFGMiner with:
+--gpu-map 2:1,1:2
+And it would swap the monitoring it received from ADL device 1 and put it to
+OpenCL device 2 and vice versa.
+
+If you have 2 monitors connected to the first device it would look like this:
+
+[2012-04-25 13:17:34] Platform 0 devices: 4
+[2012-04-25 13:17:34]   0       Tahiti
+[2012-04-25 13:17:34]   1       Tahiti
+[2012-04-25 13:17:34]   2       Tahiti
+[2012-04-25 13:17:34]   3       Cayman
+[2012-04-25 13:17:34] GPU 0 AMD Radeon HD 7900 Series  hardware monitoring enabled
+[2012-04-25 13:17:34] GPU 1 AMD Radeon HD 7900 Series  hardware monitoring enabled
+[2012-04-25 13:17:34] GPU 2 AMD Radeon HD 6900 Series hardware monitoring enabled
+
+To work around this, you would use:
+-d 0 -d 2 -d 3 --gpu-map 2:1,3:2
+
+If you have an older card as well as the rest it would look like this:
+
+[2012-04-25 13:17:34] Platform 0 devices: 3
+[2012-04-25 13:17:34]   0       Tahiti
+[2012-04-25 13:17:34]   1       Tahiti
+[2012-04-25 13:17:34]   2       Cayman
+[2012-04-25 13:17:34] GPU 0 AMD Radeon HD 4500 Series  hardware monitoring enabled
+[2012-04-25 13:17:34] GPU 1 AMD Radeon HD 7900 Series  hardware monitoring enabled
+[2012-04-25 13:17:34] GPU 2 AMD Radeon HD 7900 Series  hardware monitoring enabled
+[2012-04-25 13:17:34] GPU 3 AMD Radeon HD 6900 Series hardware monitoring enabled
+
+To work around this you would use:
+--gpu-map 0:1,1:2,2:3
+
+
+---
+GPU FAQ:
+
+Q: Can I change the intensity settings individually for each GPU?
+A: Yes, specify the devices by identifier: --set-device intensity=9 --set-device
+OCL0:intensity=d --set-device OCL1:intensity=4 (be sure you set the catch-all
+first!)
+
+Q: The CPU usage is high.
+A: The ATI drivers after 11.6 have a bug that makes them consume 100% of one
+CPU core unnecessarily, so downgrade to 11.6. Binding BFGMiner to one CPU core
+on windows can minimise it to 100% (instead of more than one core). Driver
+version 11.11 on linux and 11.12 on windows appear to have fixed this issue.
+Note that later drivers may have an apparent return of high CPU usage. Try
+'export GPU_USE_SYNC_OBJECTS=1' on Linux before starting BFGMiner. You can also
+set this variable in windows via a batch file or on the command line before
+starting BFGMiner with 'setx GPU_USE_SYNC_OBJECTS 1'
+
+Q: My GPU hangs and I have to reboot it to get it going again?
+A: The more aggressively the mining software uses your GPU, the less overclock
+you will be able to run. You are more likely to hit your limits with BFGMiner
+and you will find you may need to overclock your GPU less aggressively. The
+software cannot be responsible and make your GPU hang directly. If you simply
+cannot get it to ever stop hanging, try decreasing the intensity, and if even
+that fails, try changing to the poclbm kernel with --set-device
+OCL:kernel=poclbm, though you will sacrifice performance. BFGMiner is designed
+to try and safely restart GPUs as much as possible, but NOT if that restart
+might actually crash the rest of the GPUs mining, or even the machine. It tries
+to restart them with a separate thread and if that separate thread dies, it
+gives up trying to restart any more GPUs.
+
+Q: Can you change the autofan/autogpu to change speeds in a different manner?
+A: The defaults are sane and safe. I'm not interested in changing them further.
+The starting fan speed is set to 50% in auto-fan mode as a safety precaution.
+
+Q: I upgraded BFGMiner version and my hashrate suddenly dropped!
+A: No, you upgraded your SDK version unwittingly between upgrades of BFGMiner
+and that caused your hashrate to drop. Please see the next question.
+
+Q: I upgraded my ATI driver/SDK/BFGMiner and my hashrate suddenly dropped!
+A: The hashrate performance in BFGMiner is tied to the version of the ATI SDK
+that is installed only for the very first time BFGMiner is run. This generates
+binaries that are used by the GPU every time after that. Any upgrades to the
+SDK after that time will have no effect on the binaries. However, if you
+install a fresh version of BFGMiner, and have since upgraded your SDK, new
+binaries will be built. It is known that the 2.6 ATI SDK has a huge hashrate
+penalty on generating new binaries. It is recommended to not use this SDK at
+this time unless you are using an ATI 7xxx card that needs it.
+
+Q: Which AMD SDK is the best for BFGMiner?
+A: At the moment, versions 2.4 and 2.5 work the best for 5xxx and 6xxx GPUs. SDK
+2.6 or 2.7 works best for 7xxx. SDK 2.8 is known to have many problems. If you
+need to use the 2.6+ SDK (7xxx and later), the phatk kernel will perform poorly,
+while the diablo or (modified) poclbm kernel are optimised for it.
+
+Q: Which AMD driver is the best?
+A: Unfortunately AMD has a history of having quite a few releases with issues
+when it comes to mining, either in terms of breaking mining, increasing CPU
+usage or very low hashrates. Only experimentation can tell you for sure, but
+some good releases were 11.6, 11.12, 12.4 and 12.8. Note that older cards may
+not work with the newer drivers.
+
+Q: I have multiple SDKs installed, can I choose which one it uses?
+A: Run bfgminer with the -n option and it will list all the platforms currently
+installed. Then you can tell BFGMiner which platform to use with --gpu-platform.
+
+Q: BFGMiner reports no devices or only one device on startup on Linux although
+I have multiple devices and drivers+SDK installed properly?
+A: Try "export DISPLAY=:0" before running BFGMiner.
+
+Q: BFGMiner crashes immediately on startup.
+A: One of the common reasons for this is that you have mixed files on your
+machine for the driver or SDK. Windows has a nasty history of not cleanly
+uninstalling files so you may have to use third party tools like driversweeper
+to remove old versions. The other common reason for this is windows antivirus
+software is disabling one of the DLLs from working. If BFGMiner starts with the
+-T option but never starts without it, this is a sure fire sign you have this
+problem and will have to disable your antivirus or set up some exceptions in it
+if possible.
+
+Q: Is it faster to mine on Windows or Linux?
+A: It makes no difference. It comes down to choice of operating system for their
+various features. Linux offers much better long term stability and remote
+monitoring and security, while Windows offers you overclocking tools that can
+achieve much more than BFGMiner can do on Linux.
+
+Q: BFGMiner cannot see any of my GPUs even though I have configured them all to
+be enabled and installed OpenCL (+/- Xorg is running and the DISPLAY variable is
+exported on Linux)?
+A: Check the output of 'bfgminer -S opencl:auto -d?', it will list what OpenCL
+devices your installed SDK recognises. If it lists none, you have a problem with
+your version or installation of the SDK.
+
+Q: BFGMiner is mining on the wrong GPU, I want it on the AMD but it's mining on
+my on board GPU?
+A: Make sure the AMD OpenCL SDK is installed, check the output of 'bfgminer -S
+opencl:auto -d?' and use the appropriate parameter with --gpu-platform.
+
+Q: I'm getting much lower hashrates than I should be for my GPU?
+A: Look at your driver/SDK combination and disable power saving options for your
+GPU. Specifically look to disable ULPS. Make sure not to set intensity above 11
+for Bitcoin mining.
+
+Q: Can I mine with AMD while running Nvidia or Intel GPUs at the same time?
+A: If you can install both drivers successfully (easier on windows) then yes,
+using the --gpu-platform option.
+
+Q: Can I mine with Nvidia or Intel GPUs?
+A: Yes, but the hashrate on these is very poor and it is likely you'll be using
+much more energy than you'll be earning in coins.
+
+Q: Can I mine on both Nvidia and AMD GPUs at the same time?
+A: No, you must run one instance of BFGMiner with the --gpu-platform option for
+each.
+
+Q: Can I mine on Linux without running Xorg?
+A: With Nvidia you can, but with AMD you cannot.
+
+Q: I'm trying to mine a scrypt cryptocurrency but BFGMiner shows MH values
+instead of kH and submits no shares?
+A: Add the --scrypt parameter to your BFGMiner startup command.
+
+Q: I can't get anywhere near enough hashrate for scrypt compared to other
+people?
+A: You may not have enough system RAM, as this is also required.
+
+Q: My scrypt hashrate is high but the pool reports only a tiny proportion of my
+hashrate?
+A: You are generating garbage hashes due to your choice of settings. Try
+decreasing your intensity, do not increase the number of gpu-threads, and
+consider adding system RAM to match your GPU ram. You may also be using a bad
+combination of driver and/or SDK.
+
+Q: Scrypt fails to initialise the kernel every time?
+A: Your parameters are too high. Don't add GPU threads, don't set intensity too
+high, decrease thread concurrency. See the README.scrypt for a lot more help.
+
+Q: Are OpenCL kernels from other mining software useable in BFGMiner?
+A: The interfaces are often slightly different between the different software,
+so in most cases they will not work without modifying BFGMiner itself. However,
+if the kernel is compatible with one BFGMiner supports, you can edit it in a
+text editor and add a line that looks like this to the top:
+    // kernel-interface: poclbm
+This will instruct BFGMiner to use the poclbm kernel interface. Then to use the
+kernel, just use --set OCL:kernel=mykernel where the filename is mykernel.cl.
+
+Q: BFGMiner stops mining (or my GPUs go DEAD) and I can't close it?
+A: Once the driver has crashed, there is no way for BFGMiner to close cleanly.
+You will have to kill it, and depending on how corrupted your driver state has
+gotten, you may even need to reboot. Windows is known to reset drivers when they
+fail and BFGMiner will be stuck trying to use the old driver instance.
+
+Q: I can't get any monitoring of temperatures or fanspeed with BFGMiner when I
+start it remotely?
+A: With Linux, make sure to export the DISPLAY variable. On Windows, you cannot
+access these monitoring values via RDP. This should work with TightVNC or
+TeamViewer, though.
+
+Q: I change my GPU engine/memory/voltage and BFGMiner reports back no change?
+A: BFGMiner asks the GPU using the ATI Display Library to change settings, but
+the driver and hardware are free to do what it wants with that query, including
+ignoring it. Some GPUs are locked with one or more of those properties as well.
+The most common of these is that many GPUs only allow a fixed difference
+between the engine clock speed and the memory clock speed (such as the memory
+being no lower than the engine - 150). Other 3rd party tools have unofficial
+data on these devices on windows and can get the memory clock speed down
+further but BFGMiner does not have access to these means.
+
+Q: I have multiple GPUs and although many devices show up, it appears to be
+working only on one GPU splitting it up.
+A: Your driver setup is failing to properly use the accessory GPUs. Your driver
+may be misconfigured or you have a driver version that needs a dummy plug on all
+the GPUs that aren't connected to a monitor.
+
+Q: I have some random GPU performance related problem not addressed above.
+A: Seriously, it's the driver and/or SDK. Uninstall them and start again,
+also noting there is no clean way to uninstall them so you will likely have to
+use extra tools or do it manually.
+
+Q: Do I need to recompile after updating my driver/SDK?
+A: No. The software is unchanged regardless of which driver/SDK/ADL version you
+are running.
+
+Q: I do not want BFGMiner to modify my engine/clock/fanspeed?
+A: BFGMiner only modifies values if you tell it to via the parameters.
+Otherwise it will just monitor the values.
+
+Q: Should I use crossfire/SLI?
+A: It does not benefit mining at all and depending on the GPU may actually
+worsen performance.

packages/bfgminer/README.RPC.txt

@@ -0,0 +1,1766 @@
+
+This README contains details about the BFGMiner RPC API
+
+It also includes some detailed information at the end,
+about using miner.php
+
+
+If you start BFGMiner with the "--api-listen" option, it will listen on a
+simple TCP/IP socket for single string API requests from the same machine
+running BFGMiner and reply with a string and then close the socket each time
+If you add the "--api-network" option, it will accept API requests from any
+network attached computer.
+
+You can only access the commands that reply with data in this mode.
+By default, you cannot access any privileged command that affects the miner -
+you will receive an access denied status message instead. See --api-allow below
+for more details.
+
+You can specify IP addresses/prefixes that are only allowed to access the API
+with the "--api-allow" option, e.g. --api-allow W:192.168.0.1,10.0.0/24
+will allow 192.168.0.1 or any address matching 10.0.0.*, but nothing else.
+IP addresses are automatically padded with extra '.0's as needed
+Without a /prefix is the same as specifying /32.
+0/0 means all IP addresses.
+The 'W:' on the front gives that address/subnet privileged access to commands
+that modify BFGMiner (thus all API commands).
+Without it those commands return an access denied status.
+See --api-groups below to define other groups like W:
+Privileged access is checked in the order the IP addresses were supplied to
+"--api-allow"
+The first match determines the privilege level.
+Using the "--api-allow" option overrides the "--api-network" option if they
+are both specified
+With "--api-allow", 127.0.0.1 is not by default given access unless specified
+
+If you start BFGMiner also with the "--api-mcast" option, it will listen for
+a multicast message and reply to it with a message containing it's API port
+number, but only if the IP address of the sender is allowed API access.
+
+More groups (like the privileged group W:) can be defined using the
+--api-groups command
+Valid groups are only the letters A-Z (except R & W are predefined) and are
+not case sensitive.
+The R: group is the same as not privileged access.
+The W: group is (as stated) privileged access (thus all API commands).
+To give an IP address/subnet access to a group you use the group letter
+in front of the IP address instead of W: e.g. P:192.168.0/32
+An IP address/subnet can only be a member of one group.
+A sample API group would be:
+ --api-groups
+        P:switchpool:enablepool:addpool:disablepool:removepool:poolpriority:*
+This would create a group 'P' that can do all current pool commands and all
+non-privileged commands - the '*' means all non-privileged commands.
+Without the '*' the group would only have access to the pool commands.
+Defining multiple groups example:
+ --api-groups Q:quit:restart:*,S:save
+This would define 2 groups:
+ Q: that can 'quit' and 'restart' as well as all non-privileged commands.
+ S: that can only 'save' and no other commands.
+
+The RPC API request can be either simple text or JSON.
+
+If the request is JSON (starts with '{'), it will reply with a JSON formatted
+response, otherwise it replies with text formatted as described further below.
+
+The JSON request format required is '{"command":"CMD","parameter":"PARAM"}'
+(though of course parameter is not required for all requests)
+where "CMD" is from the "Request" column below and "PARAM" would be e.g.
+the device number if required.
+
+An example request in both formats to set device 0 fan to 80%:
+  pgaset|0,fan,80
+  {"command":"pgaset","parameter":"0,fan,80"}
+
+The format of each reply (unless stated otherwise) is a STATUS section
+followed by an optional detail section.
+
+From API version 1.7 onwards, reply strings in JSON and Text have the
+necessary escaping as required to avoid ambiguity - they didn't before 1.7.
+For JSON the 2 characters '"' and '\' are escaped with a '\' before them.
+For Text the 4 characters '|' ',' '=' and '\' are escaped the same way.
+
+Only user entered information will contain characters that require being
+escaped, such as Pool URL, User and Password or the Config save filename,
+when they are returned in messages or as their values by the API.
+
+For API version 1.4 and later:
+
+The STATUS section is:
+
+ STATUS=X,When=NNN,Code=N,Msg=string,Description=string|
+
+  STATUS=X Where X is one of:
+   W - Warning
+   I - Informational
+   S - Success
+   E - Error
+   F - Fatal (code bug)
+
+  When=NNN
+   Standard long time of request in seconds.
+
+  Code=N
+   Each unique reply has a unique Code (See api.c - #define MSG_NNNNNN).
+
+  Msg=string
+   Message matching the Code value N.
+
+  Description=string
+   This defaults to the BFGMiner version but is the value of --api-description
+   if it was specified at runtime.
+
+With API V3.1 you can also request multiple report replies in a single command
+request
+e.g. to request both summary and devs, the command would be summary+devs
+
+This is only available for report commands that don't need parameters,
+and is not available for commands that change anything
+Any parameters supplied will be ignored
+
+The extra formatting of the result is to have a section for each command
+e.g. CMD=summary|STATUS=....|CMD=devs|STATUS=...
+With JSON, each result is within a section of the command name
+e.g. {"summary":{"STATUS":[{"STATUS":"S"...}],"SUMMARY":[...],"id":1},
+      "devs":{"STATUS":[{"STATUS:"S"...}],"DEVS":[...],"id":1},"id":1}
+
+As before, if you supply bad JSON you'll just get a single 'E' STATUS section
+in the old format, since it doesn't switch to using the new format until it
+correctly processes the JSON and can match a '+' in the command
+
+If you request a command multiple times, e.g. devs+devs
+you'll just get it once
+If this results in only one command, it will still use the new layout
+with just the one command
+
+If you request a command that can't be used due to requiring parameters,
+a command that isn't a report, or an invalid command, you'll get an 'E' STATUS
+for that one but it will still attempt to process all other commands supplied
+
+Blank/missing commands are ignore e.g. +devs++
+will just show 'devs' using the new layout
+
+For API version 1.10 and later:
+
+The list of requests - a (*) means it requires privileged access - and replies:
+
+ Request       Reply Section  Details
+ -------       -------------  -------
+ version       VERSION        Miner="BFGMiner " BFGMiner version
+                              CGMiner=BFGMiner version
+                              API=API version
+
+ config        CONFIG         Some miner configuration information:
+                              PGA Count=N, <- the number of PGAs
+                              Pool Count=N, <- the number of Pools
+                              ADL=X, <- Y or N if ADL is compiled in the code
+                              ADL in use=X, <- Y or N if any GPU has ADL
+                              Strategy=Name, <- the current pool strategy
+                              Rotate Period=N, <- rotate strategy period
+                              Log Interval=N, <- log interval (--log N)
+                              Device Code=GPU ICA , <- spaced list of compiled
+                                                       device drivers
+                              OS=Linux/Apple/..., <- operating System
+                              Failover-Only=true/false, <- failover-only setting
+                              ScanTime=N, <- --scan-time setting
+                              Queue=N, <- --queue setting
+                              Expiry=N, <- --expiry setting
+                              Coinbase-Sig=X, <- extra coinbase data in blocks
+                              ConfigFileN=X| <- filename of configs loaded
+
+ summary       SUMMARY        The status summary of the miner
+                              e.g. Elapsed=NNN,Found Blocks=N,Getworks=N,...|
+
+ pools         POOLS          The status of each pool e.g.
+                              Pool=0,URL=http://pool.com:6311,Status=Alive,...|
+
+ devs          DEVS           Each available device with their status
+                              e.g. PGA=0,Accepted=NN,MHS av=NNN,...,Intensity=D|
+                              Last Share Time=NNN, <- standard long time in sec
+                               (or 0 if none) of last accepted share
+                              Last Share Pool=N, <- pool number (or -1 if none)
+                              Last Valid Work=NNN, <- standand long time in sec
+                               of last work returned that wasn't an HW:
+
+ procs         DEVS           The details of each processor in the same format
+                              and details as for DEVS
+
+ devscan|info  DEVS           Probes for a device specified by info, which is
+                              the same format as the --scan-serial command line
+                              option
+
+ pga|N         PGA            The details of a single PGA number N in the same
+                              format and details as for DEVS
+                              This is only available if PGA mining is enabled
+                              Use 'pgacount' or 'config' first to see if there
+                              are any
+
+ proc|N        PGA            The details of a single processor number N in the
+                              same format and details as for DEVS
+
+ pgacount      PGAS           Count=N| <- the number of PGAs
+                              Always returns 0 if PGA mining is disabled
+
+ proccount     PGAS           Count=N| <- the number of processors
+
+ switchpool|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of switching pool N to the
+                              highest priority (the pool is also enabled)
+                              The Msg includes the pool URL
+
+ enablepool|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of enabling pool N
+                              The Msg includes the pool URL
+
+ addpool|URL,USR,PASS[,GOAL] (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of attempting to add pool N
+                              The Msg includes the pool URL
+                              Use '\\' to get a '\' and '\,' to include a comma
+                              inside URL, USR, PASS, or GOAL
+
+ poolpriority|N,... (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of changing pool priorities
+                              See usage below
+
+ poolquota|N,Q (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of changing pool quota to Q
+
+ disablepool|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of disabling pool N
+                              The Msg includes the pool URL
+
+ removepool|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of removing pool N
+                              The Msg includes the pool URL
+                              N.B. all details for the pool will be lost
+
+ save|filename (*)
+               none           There is no reply section just the STATUS section
+                              stating success or failure saving the BFGMiner
+                              config to filename
+                              The filename is optional and will use the BFGMiner
+                              default if not specified
+
+ quit (*)      none           There is no reply section just the STATUS section
+                              before BFGMiner quits
+
+ notify        NOTIFY         The last status and history count of each devices
+                              problem
+                              e.g. NOTIFY=0,Name=PGA,ID=0,ProcID=0,Last Well=1332432290,...|
+
+ privileged (*)
+               none           There is no reply section just the STATUS section
+                              stating an error if you do not have privileged
+                              access to the API and success if you do have
+                              privilege
+                              The command doesn't change anything in BFGMiner
+
+ pgaenable|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of the enable request
+                              You cannot enable a PGA if its status is not WELL
+                              This is only available if PGA mining is enabled
+
+ pgadisable|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of the disable request
+                              This is only available if PGA mining is enabled
+
+ pgarestart|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of the restart request
+
+ pgaidentify|N (*)
+               none           This is equivalent to PROCIDENTIFY on the first
+                              processor of any given device
+                              This is only available if PGA mining is enabled
+
+ procenable|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of the enable request
+
+ procdisable|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of the disable request
+
+ procidentify|N (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of the identify request
+                              On most supported devices, it will flash the led
+                              for approximately 4s
+                              All unsupported devices, it will return a warning
+                              status message stating that they don't support it
+                              For BFL, this adds a 4s delay to the share being
+                              processed so you may get a message stating that
+                              processing took longer than 7000ms if the request
+                              was sent towards the end of the timing of any work
+                              being worked on
+                              e.g.: BFL0: took 8438ms - longer than 7000ms
+                              You should ignore this
+
+ devdetails    DEVDETAILS     Each device with a list of their static details
+                              This lists all devices including those not
+                              supported by the 'devs' command
+                              e.g. DEVDETAILS=0,Name=BFL,ID=0,ProcID=0,Driver=bitforce,...|
+
+ restart (*)   none           There is no reply section just the STATUS section
+                              before BFGMiner restarts
+
+ stats         STATS          Each device or pool that has 1 or more getworks
+                              with a list of stats regarding getwork times
+                              The values returned by stats may change in future
+                              versions thus would not normally be displayed
+                              Device drivers are also able to add stats to the
+                              end of the details returned
+
+ check|cmd     COMMAND        Exists=Y/N, <- 'cmd' exists in this version
+                              Access=Y/N| <- you have access to use 'cmd'
+
+ failover-only|true/false (*)
+               none           There is no reply section just the STATUS section
+                              stating what failover-only was set to
+
+ coin          COIN           Coin mining information:
+                              Hash Method=sha256/scrypt,
+                              Current Block Time=N.N, <- 0 means none
+                              Current Block Hash=XXXX..., <- blank if none
+                              LP=true/false, <- LP is in use on at least 1 pool
+                              Network Difficulty=NN.NN|
+
+ debug|setting (*)
+               DEBUG          Debug settings
+                              The optional commands for 'setting' are the same
+                              as the screen curses debug settings
+                              You can only specify one setting
+                              Only the first character is checked - case
+                              insensitive:
+                              Silent, Quiet, Verbose, Debug, RPCProto,
+                              PerDevice, WorkTime, Normal
+                              The output fields are (as above):
+                              Silent=true/false,
+                              Quiet=true/false,
+                              Verbose=true/false,
+                              Debug=true/false,
+                              RPCProto=true/false,
+                              PerDevice=true/false,
+                              WorkTime=true/false|
+
+ setconfig|name,value (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of setting 'name'
+                              The valid values for name are currently:
+                              queue, scantime, expiry (integer in the range
+                                                       0 to 9999)
+                              coinbase-sig (string)
+                              http-port (valid port number)
+                              strategy (name of valid strategy, and optional
+                                        number of minutes if rotate)
+                              stratum-port (valid port number)
+
+ pgaset|N,opt[,val] (*)
+               none           This is equivalent to PROCSET on the first
+                              processor of any given device
+                              This is only available if PGA mining is enabled
+
+ procset|N,opt[,val] (*)
+               none           There is no reply section just the STATUS section
+                              stating the results of setting processor N with
+                              opt[,val]
+
+                              If the processor does not support any set options,
+                              it will always return a WARN stating pgaset isn't
+                              supported
+
+                              If opt=help it will return an INFO status with a
+                              help message about the options available
+
+                              The current options are:
+                               MMQ opt=clock val=2 to 250 (a multiple of 2)
+                               XBS opt=clock val=2 to 250 (a multiple of 2)
+
+ zero|Which,true/false (*)
+               none           There is no reply section just the STATUS section
+                              stating that the zero, and optional summary, was
+                              done
+                              If Which='all', all normal BFGMiner and API
+                              statistics will be zeroed other than the numbers
+                              displayed by the stats command
+                              If Which='bestshare', only the 'Best Share' values
+                              are zeroed for each pool and the global
+                              'Best Share'
+                              The true/false option determines if a full summary
+                              is shown on the BFGMiner display like is normally
+                              displayed on exit.
+
+When you enable, disable or restart a device, you will also get Thread messages
+in the BFGMiner status window.
+
+The 'poolpriority' command can be used to reset the priority order of multiple
+pools with a single command - 'switchpool' only sets a single pool to first
+priority. Each pool should be listed by id number in order of preference (first
+= most preferred). Any pools not listed will be prioritised after the ones that
+are listed, in the priority order they were originally If the priority change
+affects the miner's preference for mining, it may switch immediately.
+
+When you switch to a different pool to the current one (including by priority
+change), you will get a 'Switching to URL' message in the BFGMiner status
+windows.
+
+Obviously, the JSON format is simply just the names as given before the '='
+with the values after the '='.
+
+If you enable BFGMiner debug (--debug or using RPC), you will also get messages
+showing some details of the requests received and the replies.
+
+There are included 5 program examples for accessing the API:
+
+api-example.php - a PHP script to access the API.
+  usage: php api-example.php command
+ by default it sends a 'summary' request to the miner at 127.0.0.1:4028
+ If you specify a command it will send that request instead.
+ You must modify the line "$socket = getsock('127.0.0.1', 4028);" at the
+ beginning of "function request($cmd)" to change where it looks for BFGMiner.
+
+api-example.c - a 'C' program to access the API (with source code).
+  usage: api-example [command [ip/host [port]]]
+ again, as above, missing or blank parameters are replaced as if you entered:
+  api-example summary 127.0.0.1 4028
+
+miner.php - an example web page to access the API.
+ This includes buttons and inputs to attempt access to the privileged commands.
+ See the end of this README.RPC for details of how to tune the display
+ and also to use the option to display a multi-rig summary.
+
+api-example.py - a Python script to access the API.
+  usage: python api-example.py [--host HOST] [--port PORT] [command] [parameter]
+ by default it sends a 'summary' request to the miner at 127.0.0.1:4028
+ If you specify a command it will send that request instead.
+
+api-example.rb - a Ruby script to access the API.
+  usage: ruby api-example.rb command[:parameter] [HOST [PORT]]
+
+If you are using Node.js, you can also use the miner-rpc package and script:
+https://www.npmjs.org/package/miner-rpc
+
+----------
+
+Feature Changelog for external applications using the API:
+
+
+API V3.4 (BFGMiner v5.4.0)
+
+Modified API commands:
+ 'config' - add 'Rotate Period'
+ 'setconfig' - add 'strategy'
+
+---------
+
+API V3.3 (BFGMiner v5.0.0)
+
+Modified API command:
+ 'addpool' - accept an additional argument to indicate mining goal by name
+ 'coin' - return multiple elements, when there are multiple mining goals
+          defined; add 'Difficulty Accepted'
+ 'pools' - add 'Mining Goal'
+
+---------
+
+API V3.2 (BFGMiner v4.1.0)
+
+Modified API command:
+ 'config' - add 'ConfigFile'N
+
+---------
+
+API V3.1 (BFGMiner v4.0.0)
+
+Multiple report request command with '+' e.g. summary+devs
+
+CPU and OpenCL devices are now included as "PGAs", to enable migration to a simpler interface.
+
+Added API commands:
+ 'pgarestart'
+
+Modified API commands:
+ 'devs' - remove 'GPU Count' and 'CPU Count'
+ 'quit' - expand reply to include a complete STATUS section
+ 'restart' - expand reply to include a complete STATUS section
+ 'summary' - add 'MHS rolling'
+ 'version' - add 'Miner'
+
+Deprecated API commands:
+ 'cpu'
+ 'cpucount'
+ 'cpuenable'
+ 'cpudisable'
+ 'cpurestart'
+ 'gpu'
+ 'gpucount'
+ 'gpuenable'
+ 'gpudisable'
+ 'gpurestart'
+ 'gpuintensity'
+ 'gpumem'
+ 'gpuengine'
+ 'gpufan'
+ 'gpuvddc'
+
+---------
+
+API V2.3 (BFGMiner v3.7.0)
+
+Modified API command:
+ 'devdetails' - Add 'Processors', 'Manufacturer', 'Product', 'Serial',
+                    'Target Temperature', 'Cutoff Temperature'
+ 'procdetails' - Add 'Manufacturer', 'Product', 'Serial', 'Target Temperature',
+                     'Cutoff Temperature'
+
+---------
+
+API V2.2 (BFGMiner v3.6.0)
+
+Modified API command:
+ 'pools' - add 'Works'
+
+---------
+
+API V2.1 (BFGMiner v3.4.0)
+
+Added API command:
+ 'poolquota' - Set pool quota for load-balance strategy.
+
+Modified API command:
+ 'devs', 'gpu', 'pga', 'procs' and 'asc' - add 'Device Elapsed', 'Stale',
+                                             'Work Utility', 'Difficulty Stale'
+ 'pools' - add 'Quota'
+ 'summary' - add 'Diff1 Work', 'MHS %ds' (where %d is the log interval)
+
+---------
+
+API V2.0 (BFGMiner v3.3.0)
+
+Removed API commands:
+ 'devdetail' - Use newer 'devdetails' for same information.
+
+Modified API commands:
+ 'devs' - display status of each full device only (not processors)
+ 'pga' - lookup and display device by device (not processor) number
+ 'pgacount' - count only full devices (not processors)
+ 'pgaenable' - enable all processors for a numbered full device
+ 'pgadisable' - disable all processors for a numbered full device
+ 'pgaidentify' - choose first processor of numbered full device
+ 'pgaset' - choose first processor of numbered full device
+ 'setconfig' - add 'stratum-port' number
+
+Added API commands:
+ 'procs'
+ 'proc'
+ 'proccount'
+ 'procenable'
+ 'procdisable'
+ 'procidentify'
+ 'procset'
+
+----------
+
+API V1.25.3 (BFGMiner v3.2.0)
+
+Modified API commands:
+ 'devs', 'pga', 'gpu' - add 'Device Hardware%' and 'Device Rejected%'
+ 'pools' - add 'Pool Rejected%' and 'Pool Stale%'
+ 'setconfig' - add 'http-port' number
+ 'summary' - add 'Device Hardware%', 'Device Rejected%', 'Pool Rejected%',
+                 'Pool Stale%'
+
+Removed output limitation:
+ All replies can now be longer than the previous limitation of 64k, and will
+  only be truncated on a 50ms timeout sending.
+
+Basic support for cgminer-compatible multicast RPC detection added.
+
+----------
+
+API V1.25.2 (BFGMiner v3.1.4)
+
+Modified API commands:
+ 'pgaset' - added: XBS opt=clock val=2 to 250 (and a multiple of 2)
+
+----------
+
+API V1.25.1 (BFGMiner v3.1.2)
+
+Added API commands:
+ 'devscan'
+
+----------
+
+API V1.25 (BFGMiner v3.0.1)
+
+Modified API commands:
+ 'devs' 'gpu' and 'pga' - add 'Last Valid Work'
+
+----------
+
+API V1.24.1 (BFGMiner v3.0.0)
+
+Modified API commands:
+ 'cpustatus' - add 'ProcID'
+ 'gpustatus' - add 'ProcID'
+ 'pgastatus' - add 'ProcID'
+ 'devstatus' - add 'ProcID'
+ 'notify' - add 'ProcID'
+ 'devdetails' - add 'ProcID'
+ 'devdetail' - add 'Name', 'ID', and 'ProcID'
+ 'pools' - add 'Message'
+ 'coin' - add 'Network Difficulty'
+
+Pretty much updated every method returning 'Name' and 'ID' to also return
+'ProcID'. This is a number starting with 0 for 'a', 1 for 'b', etc.
+
+----------
+
+API V1.24 (BFGMiner v2.10.3)
+
+Added API commands:
+ 'zero'
+
+Modified API commands:
+ 'pools' - add 'Best Share'
+ 'stats' - rename 'Bytes Sent' and 'Bytes Recv' to 'Net Bytes Sent' and
+                  'Net Bytes Recv'
+
+----------
+
+API V1.23 (BFGMiner v2.10.1)
+
+Added API commands:
+ 'pgaset' - with: MMQ opt=clock val=2 to 230 (and a multiple of 2)
+
+----------
+
+API V1.22 (not released)
+
+Enforced output limitation:
+ all extra records beyond the output limit of the API (~64k) are ignored and
+  chopped off at the record boundary before the limit is reached however, JSON
+  brackets will be correctly closed and the JSON id will be set to 0 (instead
+  of 1) if any data was truncated.
+
+Modified API commands:
+ 'stats' - add 'Times Sent', 'Bytes Sent', 'Times Recv', 'Bytes Recv'
+
+----------
+
+API V1.21 (BFGMiner v2.10.0)
+
+Modified API commands:
+ 'summary' - add 'Best Share'
+
+----------
+
+API V1.20b (BFGMiner v2.9.1)
+
+Support for the X6500 FPGA was added.
+
+----------
+
+API V1.20 (BFGMiner v2.9.0)
+
+Modified API commands:
+ 'pools' - add 'Has Stratum', 'Stratum Active', 'Stratum URL'
+
+----------
+
+API V1.19b (BFGMiner v2.8.1)
+
+Added API commands:
+ 'pgaidentify|N' (only works for BitForce Singles so far)
+
+Modified API commands:
+ Change pool field name back from 'Diff1 Work' to 'Diff1 Shares'
+ 'devs' - add 'Difficulty Accepted', 'Difficulty Rejected',
+              'Last Share Difficulty' to all devices
+ 'gpu|N' - add 'Difficulty Accepted', 'Difficulty Rejected',
+              'Last Share Difficulty'
+ 'pga|N' - add 'Difficulty Accepted', 'Difficulty Rejected',
+              'Last Share Difficulty'
+ 'notify' - add '*Dev Throttle' (for BitForce Singles)
+ 'pools' - add 'Difficulty Accepted', 'Difficulty Rejected',
+               'Difficulty Stale', 'Last Share Difficulty'
+ 'stats' - add 'Work Diff', 'Min Diff', 'Max Diff', 'Min Diff Count',
+               'Max Diff Count' to the pool stats
+ 'setconfig|name,value' - add 'Coinbase-Sig' string
+
+----------
+
+API V1.19 (BFGMiner v2.8.0)
+
+Added API commands:
+ 'debug'
+ 'setconfig|name,N'
+
+Modified API commands:
+ Change pool field name 'Diff1 Shares' to 'Diff1 Work'
+ 'devs' - add 'Diff1 Work' to all devices
+ 'gpu|N' - add 'Diff1 Work'
+ 'pga|N' - add 'Diff1 Work'
+ 'pools' - add 'Proxy'
+ 'config' - add 'Queue', 'Expiry'
+
+----------
+
+API V1.18 (BFGMiner v2.7.4)
+
+Modified API commands:
+ 'stats' - add 'Work Had Roll Time', 'Work Can Roll', 'Work Had Expire',
+           and 'Work Roll Time' to the pool stats
+ 'config' - include 'ScanTime'
+
+----------
+
+API V1.17b (BFGMiner v2.7.1)
+
+Modified API commands:
+ 'summary' - add 'Work Utility'
+ 'pools' - add 'Diff1 Shares'
+
+----------
+
+API V1.17 (BFGMiner v2.6.5)
+
+Added API commands:
+ 'coin'
+
+----------
+
+API V1.16 (BFGMiner v2.6.5)
+
+Added API commands:
+ 'failover-only'
+
+Modified API commands:
+ 'config' - include failover-only state
+
+----------
+
+API V1.15 (BFGMiner v2.5.2)
+
+Added API commands:
+ 'poolpriority'
+
+----------
+
+API V1.14 (BFGMiner v2.5.0)
+
+Modified API commands:
+ 'stats' - more Icarus timing stats added
+ 'notify' - include new device comms error counter
+
+The internal code for handling data was rewritten (~25% of the code)
+Completely backward compatible
+
+----------
+
+API V1.13 (BFGMiner v2.4.4)
+
+Added API commands:
+ 'check'
+
+Support was added to BFGMiner for API access groups with the --api-groups option
+It's 100% backward compatible with previous --api-access commands
+
+----------
+
+API V1.12 (BFGMiner v2.4.3)
+
+Modified API commands:
+ 'stats' - more pool stats added
+
+Support for the ModMiner FPGA was added
+
+----------
+
+API V1.11 (BFGMiner v2.4.2)
+
+Modified API commands:
+ 'save' no longer requires a filename (use default if not specified)
+
+'save' incorrectly returned status E (error) on success before.
+It now correctly returns S (success)
+
+----------
+
+API V1.10 (BFGMiner v2.4.1)
+
+Added API commands:
+ 'stats'
+
+N.B. the 'stats' command can change at any time so any specific content
+present should not be relied upon.
+The data content is mainly used for debugging purposes or hidden options
+in BFGMiner and can change as development work requires.
+
+Modified API commands:
+ 'pools' added "Last Share Time"
+
+----------
+
+API V1.9 (BFGMiner v2.4.0)
+
+Added API commands:
+ 'restart'
+
+Modified API commands:
+ 'notify' corrected invalid JSON
+
+----------
+
+API V1.8 (BFGMiner v2.3.5)
+
+Added API commands:
+ 'devdetails'
+
+Support for the ZTEX FPGA was added.
+
+----------
+
+API V1.8-pre (BFGMiner v2.3.4)
+
+Added API commands:
+ 'devdetail'
+
+----------
+
+API V1.7 (BFGMiner v2.3.4)
+
+Added API commands:
+ 'removepool'
+
+Modified API commands:
+ 'pools' added "User"
+
+From API version 1.7 onwards, reply strings in JSON and Text have the
+necessary escaping as required to avoid ambiguity.
+For JSON the 2 characters '"' and '\' are escaped with a '\' before them.
+For Text the 4 characters '|' ',' '=' and '\' are escaped the same way.
+
+----------
+
+API V1.6 (cgminer v2.3.2)
+
+Added API commands:
+ 'pga'
+ 'pgaenable'
+ 'pgadisable'
+ 'pgacount'
+
+Modified API commands:
+ 'devs' now includes Icarus and BitForce FPGA devices.
+ 'notify' added "*" to the front of the name of all numeric error fields.
+ 'config' correct "Log Interval" to use numeric (not text) type for JSON.
+
+Support for Icarus and BitForce FPGAs was added.
+
+----------
+
+API V1.5 was not released
+
+----------
+
+API V1.4 (Kano's interim release of cgminer v2.3.1)
+
+Added API commands:
+ 'notify'
+
+Modified API commands:
+ 'config' added "Device Code" and "OS"
+
+Added "When" to the STATUS reply section of all commands.
+
+----------
+
+API V1.3 (cgminer v2.3.1-2)
+
+Added API commands:
+ 'addpool'
+
+Modified API commands:
+ 'devs'/'gpu' added "Total MH" for each device
+ 'summary' added "Total MH"
+
+----------
+
+API V1.2 (cgminer v2.3.0)
+
+Added API commands:
+ 'enablepool'
+ 'disablepool'
+ 'privileged'
+
+Modified API commands:
+ 'config' added "Log Interval"
+
+Starting with API V1.2, any attempt to access a command that requires
+privileged security, from an IP address that does not have privileged
+security, will return an "Access denied" Error Status.
+
+----------
+
+API V1.1 (cgminer v2.2.4)
+
+There were no changes to the API commands in cgminer v2.2.4,
+however support was added to cgminer for IP address restrictions
+with the --api-allow option.
+
+----------
+
+API V1.1 (cgminer v2.2.2)
+
+Prior to V1.1, devs/gpu incorrectly reported GPU0 Intensity for all GPUs.
+
+Modified API commands:
+ 'devs'/'gpu' added "Last Share Pool" and "Last Share Time" for each device
+
+----------
+
+API V1.0 (cgminer v2.2.0)
+
+Remove default CPU support.
+
+Added API commands:
+ 'config'
+ 'gpucount'
+ 'cpucount'
+ 'switchpool'
+ 'gpuintensity'
+ 'gpumem'
+ 'gpuengine'
+ 'gpufan'
+ 'gpuvddc'
+ 'save'
+
+----------
+
+API V0.7 (cgminer v2.1.0)
+
+Initial release of the API in the main cgminer git
+
+Commands:
+ 'version'
+ 'devs'
+ 'pools'
+ 'summary'
+ 'gpuenable'
+ 'gpudisable'
+ 'gpurestart'
+ 'gpu'
+ 'cpu'
+ 'gpucount'
+ 'cpucount'
+ 'quit'
+
+----------------------------------------
+
+miner.php
+=========
+
+miner.php is a PHP based interface to the BFGMiner RPC API
+(referred to simply as the API below).
+
+It can show rig details, summaries and input fields to allow you to change
+BFGMiner.
+You can also create custom summary pages with it
+
+It has two levels to the security:
+1) BFGMiner can be configured to allow or disallow API access and access level
+   security for miner.php
+2) miner.php can be configured to allow or disallow privileged BFGMiner
+   access, if BFGMiner is configured to allow privileged access for miner.php
+
+---------
+
+To use miner.php requires a web server with PHP.
+
+Basics: On Xubuntu 11.04, to install Apache and PHP, the commands are:
+ sudo apt-get install apache2
+ sudo apt-get install php5
+ sudo /etc/init.d/apache2 reload
+
+On Fedora 17:
+ yum install httpd php
+ systemctl restart httpd.service
+ systemctl enable httpd.service --system
+
+On windows there are a few options.
+Try one of these (apparently the first one is easiest - thanks jborkl)
+ http://www.easyphp.org/
+ http://www.apachefriends.org/en/xampp.html
+ http://www.wampserver.com/en/
+
+---------
+
+The basic BFGMiner option to enable the API is:
+
+ --api-listen
+
+or in your bfgminer.conf:
+
+ "api-listen" : true,
+
+(without the ',' on the end if it is the last item.)
+
+If the web server is running on the BFGMiner computer, the above
+is the only change required to give miner.php basic access to
+the BFGMiner API.
+
+-
+
+If the web server runs on a different computer to BFGMiner,
+you will also need to tell BFGMiner to allow the web server
+to access BFGMiner's API and tell miner.php where BFGMiner is.
+
+Assuming a.b.c.d is the IP address of the web server, you
+would add the following to BFGMiner:
+
+ --api-listen --api-allow a.b.c.d
+
+or in your bfgminer.conf:
+
+ "api-listen" : true,
+ "api-allow" : "a.b.c.d",
+
+to tell BFGMiner to give the web server read access to the API.
+
+You also need to tell miner.php where BFGMiner is.
+Assuming BFGMiner is at IP address e.f.g.h, then you would
+edit miner.php and change the line:
+
+ $rigs = array('127.0.0.1:4028');
+
+to
+
+ $rigs = array('e.f.g.h:4028');
+
+See --api-network or --api-allow for more access details
+and how to give write access.
+
+You can however, also tell miner.php to find your mining rigs automatically
+on the local subnet.
+
+Add the following to each BFGMiner:
+
+ --api-mcast
+
+or in your bfgminer.conf:
+
+ "api-mcast" : true,
+
+And in miner.php set $mcast = true;
+
+This will ignore the value of $rigs and overwrite it with the list of zero or
+more rigs found on the network in the timeout specified.
+A rig will not reply if the API settings would mean it would also ignore an
+API request from the web server running miner.php
+
+---------
+
+Once you have a web server with PHP running:
+
+ copy your miner.php to the main web folder
+
+On Xubuntu 11.04:
+ /var/www/
+
+On Fedora 17:
+ /var/www/html/
+
+On Windows:
+ Please check your windows Web/PHP documentation.
+
+Assuming the IP address of the web server is a.b.c.d
+Then in your web browser go to:
+
+ http://a.b.c.d/miner.php
+
+Done :)
+
+---------
+
+The rest of this documentation deals with the more complex
+functions of miner.php, using myminer.php, creating custom
+summaries and displaying multiple BFGMiner rigs.
+
+---------
+
+If you create a file called myminer.php in the same web folder
+where you put miner.php, miner.php will load it when it runs.
+
+This is useful, to put any changes you need to make to miner.php
+instead of changing miner.php.
+Thus if you update/get a new miner.php, you won't lose the changes
+you have made if you put all your changes in myminer.php
+(and haven't changed miner.php at all)
+
+A simple example myminer.php that defines 2 rigs
+(that I will keep referring to further below) is:
+
+<?php
+#
+$rigs = array('192.168.0.100:4028:A', '192.168.0.102:4028:B');
+#
+?>
+
+Changes in myminer.php supersede what is in miner.php
+However, this is only valid for variables in miner.php before the
+2 lines where myminer.php is included by miner.php:
+
+ if (file_exists('myminer.php'))
+  include_once('myminer.php');
+ 
+Every variable in miner.php above those 2 lines, can be changed by
+simply defining them in your myminer.php
+
+So although miner.php originally contains the line:
+
+ $rigs = array('127.0.0.1:4028');
+
+if you created the example myminer.php given above, it would actually
+change the value of $rigs that is used when miner.php is running.
+i.e. you don't have to remove or comment out the $rigs line in miner.php
+It will be superseded by myminer.php
+
+---------
+
+The example myminer.php above also shows how to define more that one rig
+to be shown my miner.php:
+
+Each rig string is 2 or 3 values separated by colons ':'
+They are simply an IP address or hostname, followed by the
+port number (usually 4028) and an optional Name string.
+
+miner.php displays rig buttons that will show the details of a single
+rig when you click on it - the button shows either the rig number,
+or the 'Name' string if you provide it.
+
+PHP arrays contain each string separated by a comma, but no comma after
+the last one.
+
+So an example for 3 rigs would be:
+
+ $rigs = array('192.168.0.100:4028:A', '192.168.0.102:4028:B',
+               '192.168.0.110:4028:C');
+
+Of course each of the rigs listed would also have to have the API
+running and be set to allow the web server to access the API - as
+covered earlier in this document.
+
+---------
+
+So basically, any variable explained below can be put in myminer.php if you want
+to set it to something different to its default value and did not want to change
+miner.php itself every time you update it.
+
+Below is a list of the variables that can be changed and an explanation of each.
+
+---------
+
+Default:
+ $dfmt = 'H:i:s j-M-Y \U\T\CP';
+
+Define the date format used to print full length dates.
+If you get the string 'UTCP' on the end of your dates shown, that
+means you are using an older version of PHP and you can instead use:
+ $dfmt = 'H:i:s j-M-Y \U\T\CO';
+
+The PHP documentation on the date format is here:
+ http://us.php.net/manual/en/function.date.php
+
+---------
+
+Default:
+ $title = 'Mine';
+
+Web page title.
+If you know PHP you can of course use code to define it e.g.
+ $title = 'My Rig at: '.date($dfmt);
+
+Which would set the web page title to something like:
+ My Rig at: 10:34:00 22-Aug-2012 UTC+10:00
+
+---------
+
+Default:
+ $readonly = false;
+
+Set $readonly to true to force miner.php to be readonly.
+This means it won't allow you to change BFGMiner even if the RPC API
+options allow it to.
+
+If you set $readonly to false then it will check BFGMiner 'privileged'
+and will show input fields and buttons on the single rig page,
+allowing you to change devices, pools and even quit or restart
+BFGMiner.
+
+However, if the 'privileged' test fails, the code will set $readonly to
+true.
+
+---------
+
+Default:
+ $userlist = null;
+
+Define password checking and default access null means there is no password
+checking.
+
+$userlist is an array of 3 arrays, e.g.
+$userlist = array('sys' => array('boss' => 'bpass'),
+                  'usr' => array('user' => 'upass', 'pleb' => 'ppass'),
+                  'def' => array('Pools'));
+
+'sys' is an array of system users and passwords (full access).
+'usr' is an array of user level users and passwords (readonly access).
+'def' is an array of custompages that anyone not logged in can view.
+
+Any of the 3 can be null, meaning there are none of that item.
+
+All validated 'usr' users are given $readonly = true; access.
+All validated 'sys' users are given the $readonly access you defined.
+
+If 'def' has one or more values, and allowcustompages is true, then anyone
+without a password can see the list of custompage buttons given in 'def' and
+will see the first one when they go to the web page, with a login button at the
+top right.
+
+From the login page, if you login with no username or password, it will show
+the first 'def' custompage (if there are any).
+
+If you are logged in, it will show a logout button at the top right.
+
+---------
+
+Default:
+ $notify = true;
+
+Set $notify to false to NOT attempt to display the notify command table of data
+
+Set $notify to true to attempt to display the notify command on the single rig
+page.
+If your older version of BFGMiner returns an 'Invalid command' because it
+doesn't have notify - it just shows the error status table.
+
+---------
+
+Default:
+ $checklastshare = true;
+
+Set $checklastshare to true to do the following checks:
+If a device's last share is 12x expected ago then display as an error.
+If a device's last share is 8x expected ago then display as a warning.
+If either of the above is true, also display the whole line highlighted
+This assumes shares are 1 difficulty shares.
+
+Set $checklastshare to false to not do the above checks.
+
+'expected' is calculated from the device Mh/s value.
+So for example, a device that hashes at 380Mh/s should (on average) find a
+share every 11.3s.
+If the last share was found more than 11.3 x 12 seconds (135.6s) ago, it is
+considered an error and highlighted.
+If the last share was found more than 11.3 x 8 seconds (90.4s) ago, it is
+considered a warning and highlighted.
+
+The default highlighting is very subtle, so change it if you want it to be more
+obvious.
+
+---------
+
+Default:
+ $poolinputs = false;
+
+Set $poolinputs to true to show the input fields for adding a pool and changing
+the pool priorities on a single rig page.
+However, if $readonly is true, it will not display them.
+
+---------
+
+Default:
+ $rigport = 4028;
+
+Default port to use if any $rigs entries don't specify the port number
+
+---------
+
+Default:
+ $rigs = array('127.0.0.1:4028');
+
+Set $rigs to an array of your BFGMiner rigs that are running format: 'IP' or
+ 'Host' or 'IP:Port' or 'Host:Port' or 'Host:Port:Name'.
+If you only have one rig, it will just show the detail of that rig.
+If you have more than one rig it will show a summary of all the rigs with
+ buttons to show the details of each rig - the button contents will be 'Name'
+ rather than rig number, if you specify 'Name'.
+If Port is missing or blank, it will try $rigport
+e.g. $rigs = array('127.0.0.1:4028','myrig.com:4028:Sugoi');
+
+---------
+
+Default:
+ $rignames = false;
+
+Set $rignames to false to not affect the display.
+Set $rignames to one of 'ip' or 'ipx' to alter the name displayed
+if the rig doesn't have a 'name' in $rigs
+Currently:
+ 'ip' means use the 4th byte of the rig IP address as an integer
+ 'ipx' means use the 4th byte of the rig IP address as 2 hex bytes
+
+---------
+
+Default:
+ $rigbuttons = true;
+
+Set $rigbuttons to false to display a link rather than a button on
+the left of any summary table with rig buttons, in order to reduce
+the height of the table cells
+
+---------
+
+Default:
+ $mcast = false;
+
+Set $mcast to true to look for your rigs and ignore $rigs.
+
+---------
+
+Default:
+ $mcastexpect = 0;
+
+The minimum number of rigs expected to be found when $mcast is true.
+If fewer are found, an error will be included at the top of the page.
+
+---------
+
+Default:
+ $mcastaddr = '224.0.0.75';
+
+API Multicast address all miners are listening on.
+
+---------
+
+Default:
+ $mcastport = 4028;
+
+API Multicast UDP port all miners are listening on.
+
+---------
+
+Default:
+ $mcastcode = 'FTW';
+
+The code all miners expect in the Multicast message sent.
+The message sent is "cgm-code-listport".
+Don't use the '-' character if you change it.
+
+---------
+
+Default:
+ $mcastlistport = 4027;
+
+UDP port number that is added to the broadcast message sent
+that specifies to the miners the port to reply on.
+
+---------
+
+Default:
+ $mcasttimeout = 1.5;
+
+Set $mcasttimeout to the number of seconds (floating point)
+to wait for replies to the Multicast message.
+N.B. the accuracy of the timing used to wait for the replies is
+~0.1s so there's no point making it more than one decimal place.
+
+---------
+
+Default:
+ $mcastretries = 0;
+
+Set $mcastretries to the number of times to retry the multicast.
+
+If $mcastexpect is 0, this is simply the number of extra times
+that it will send the multicast request.
+N.B. BFGMiner doesn't listen for multicast requests for 1000ms after
+each one it hears.
+
+If $mcastexpect is > 0, it will stop looking for replies once it
+has found at least $mcastexpect rigs, but it only checks this rig
+limit each time it reaches the $mcasttimeout limit, thus it can find
+more than $mcastexpect rigs if more exist.
+It will send the multicast message up to $mcastretries extra times or
+until it has found at least $mcastexpect rigs.
+When using $mcastretries, it is however possible for it to sometimes
+ignore some rigs on the network if $mcastexpect is less than the
+number of rigs on the network and some rigs are too slow to reply.
+
+---------
+
+Default:
+ $allowgen = false;
+
+Set $allowgen to true to allow customsummarypages to use 'gen',
+false means ignore any 'gen' options.
+This is disabled by default due to the possible security risk
+of using it, please see the end of this document for an explanation.
+
+---------
+
+Default:
+ $rigipsecurity = true;
+
+Set $rigipsecurity to false to show the IP/Port of the rig in the socket error
+ messages and also show the full socket message.
+
+---------
+
+Default:
+ $rigtotals = true;
+ $forcerigtotals = false;
+
+Set $rigtotals to true to display totals on the single rig page, 'false' means
+ no totals (and ignores $forcerigtotals).
+
+If $rigtotals is true, all data is also right aligned.
+With false, it's as before, left aligned.
+
+This option is just here to allow people to set it to false if they prefer the
+ old non-total display when viewing a single rig.
+
+Also, if there is only one line shown in any section, then no total will be
+ shown (to save screen space).
+You can force it to always show rig totals on the single rig page, even if
+ there is only one line, by setting $forcerigtotals = true;
+
+---------
+
+Default:
+ $socksndtimeoutsec = 10;
+ $sockrcvtimeoutsec = 40;
+
+The numbers are integer seconds.
+
+The defaults should be OK for most cases.
+However, the longer SND is, the longer you have to wait while PHP hangs if the
+target BFGMiner isn't running or listening.
+
+RCV should only ever be relevant if BFGMiner has hung but the API thread is
+still running, RCV would normally be >= SND.
+
+Feel free to increase SND if your network is very slow or decrease RCV if that
+happens often to you.
+
+Also, on some windows PHP, apparently the $usec is ignored (so usec can't be
+specified).
+
+---------
+
+Default:
+ $hidefields = array();
+
+List of fields NOT to be displayed.
+You can use this to hide data you don't want to see or don't want shown on a
+public web page.
+The list of sections are:
+ SUMMARY, POOL, PGA, GPU, NOTIFY, CONFIG, DEVDETAILS, DEVS
+See the web page for the list of field names (the table headers).
+It is an array of 'SECTION.Field Name' => 1
+
+This example would hide the slightly more sensitive pool information:
+Pool URL and pool username:
+ $hidefields = array('POOL.URL' => 1, 'POOL.User' => 1);
+
+If you just want to hide the pool username:
+ $hidefields = array('POOL.User' => 1);
+
+---------
+
+Default:
+ $ignorerefresh = false;
+ $changerefresh = true;
+ $autorefresh = 0;
+
+Auto-refresh of the page (in seconds) - integers only.
+
+$ignorerefresh = true/false always ignore refresh parameters.
+$changerefresh = true/false show buttons to change the value.
+$autorefresh = default value, 0 means don't auto-refresh.
+
+---------
+
+Default:
+ $placebuttons = 'top';
+
+Where to place the Refresh, Summary, Custom Pages, Quit, etc. buttons.
+
+Valid values are: 'top' 'bot' 'both'
+ Anything else means don't show them. (case sensitive)
+
+---------
+
+Default:
+ $miner_font_family = 'verdana,arial,sans';
+ $miner_font_size = '13pt';
+
+Change these to set the font and font size used on the web page.
+
+---------
+
+Default:
+ $colouroverride = array();
+
+Use this to change the web page colour scheme.
+
+See $colourtable in miner.php for the list of possible names to change.
+
+Simply put in $colouroverride, just the colours you wish to change.
+
+e.g. to change the colour of the header font and background
+you could do the following:
+
+ $colouroverride = array(
+	'td.h color'		=> 'green',
+	'td.h background'	=> 'blue'
+ );
+
+---------
+
+Default:
+ $allowcustompages = true;
+
+Should we allow custom pages?
+(or just completely ignore them and don't display the buttons.)
+
+---------
+
+OK this part is more complex: Custom Summary Pages.
+
+A custom summary page in an array of 'section' => array('FieldA','FieldB'...)
+
+The section defines what data you want in the summary table and the Fields
+define what data you want shown from that section.
+
+Standard sections are:
+ SUMMARY, POOL, PGA, GPU, NOTIFY, CONFIG, DEVDETAILS, DEVS, STATS, COIN
+
+Fields are the names as shown on the headers on the normal pages.
+
+Fields can be 'name=new name' to display 'name' with a different heading
+'new name'.
+
+There are also now joined sections:
+ SUMMARY+POOL, SUMMARY+DEVS, SUMMARY+CONFIG, DEVS+NOTIFY, DEVS+DEVDETAILS
+ SUMMARY+COIN
+
+These sections are an SQL join of the two sections and the fields in them
+are named section.field where 'section.' is the section the field comes from
+See the example further down.
+
+Also note:
+- empty tables are not shown.
+- empty columns (e.g. an unknown field) are not shown.
+- missing field data shows as blank.
+- the field name '*' matches all fields except in joined sections
+  (useful for STATS and COIN).
+
+There are 2 hard coded sections:
+ DATE - displays a date table like at the start of 'Summary'.
+ RIGS - displays a rig table like at the start of 'Summary'.
+
+Each custom summary requires a second array, that can be empty, listing fields
+to be totalled for each section.
+If there is no matching total data, no total will show.
+
+---------
+
+Looking at the Mobile example:
+
+ $mobilepage = array(
+  'DATE' => null,
+  'RIGS' => null,
+  'SUMMARY' => array('Elapsed', 'MHS av', 'Found Blocks=Blks', 
+			Accepted', 'Rejected=Rej', 'Utility'),
+  'DEVS+NOTIFY' => array('DEVS.Name=Name', 'DEVS.ID=ID', 'DEVS.ProcID=Proc',
+			'DEVS.Status=Status',
+			'DEVS.Temperature=Temp', 'DEVS.MHS av=MHS av',
+			'DEVS.Accepted=Accept', 'DEVS.Rejected=Rej',
+			'DEVS.Utility=Utility', 'NOTIFY.Last Not Well=Not Well'),
+  'POOL' => array('POOL', 'Status', 'Accepted', 'Rejected=Rej',
+                  'Last Share Time'));
+
+ $mobilesum = array(
+  'SUMMARY' => array('MHS av', 'Found Blocks', 'Accepted', 'Rejected',
+                     'Utility'),
+  'DEVS+NOTIFY' => array('DEVS.MHS av', 'DEVS.Accepted', 'DEVS.Rejected',
+                         'DEVS.Utility'),
+  'POOL' => array('Accepted', 'Rejected'));
+
+ $customsummarypages = array('Mobile' => array($mobilepage, $mobilesum));
+
+This will show 5 tables (according to $mobilepage).
+Each table will have the chosen details for all the rigs specified in $rigs
+
+ DATE
+	A single box with the web server's current date and time.
+
+ RIGS
+	A table of the rigs: description, time, versions etc.
+
+ SUMMARY
+
+	This will use the API 'summary' command and show the selected fields:
+		Elapsed, MHS av, Found Blocks, Accepted, Rejected and Utility
+	However, 'Rejected=Rej' means that the header displayed for the 'Rejected'
+	field will be 'Rej', instead of 'Rejected' (to save space).
+	Same for 'Found Blocks=Blks' - to save space.
+
+ DEVS+NOTIFY
+
+	This will list each of the devices on each rig and display the list of
+	fields as shown.
+	It will also include the 'Last Not Well' field from the 'notify' command
+	so you know when the device was last not well.
+
+	You will notice that you need to rename each field e.g. 'DEVS.Name=Name'
+	since each field name in the join between DEVS and NOTIFY is actually
+	section.fieldname, not just fieldname.
+
+	The join code automatically adds 2 fields to each GPU device: 'Name', 'ID',
+	and 'ProcID'. They don't exist in the API 'devs' output but we can correctly
+	calculate them from the GPU device data. These two fields are used to join
+	DEVS to NOTIFY: i.e. find the NOTIFY record that has the same Name/ID/ProcID
+	as the DEVS record and join them.
+
+ POOL
+
+	This will use the API 'pools' command and show the selected fields:
+		POOL, Status, Accepted, Rejected, Last Share Time
+	Again, I renamed the 'Rejected' field using 'Rejected=Rej', to save space.
+
+$mobilesum lists the sections and fields that should have a total.
+You can't define them for 'DATE' or 'RIGS' since they are hard coded tables.
+The example given:
+
+ SUMMARY
+	Show a total at the bottom of the columns for:
+		MHS av, Found Blocks, Accepted, Rejected, Utility
+
+	Firstly note that you use the original name i.e. for 'Rejected=Rej'
+	you use 'Rejected', not 'Rej' and not 'Rejected=Rej'.
+
+	Secondly note that it simply adds up the fields.
+	If you ask for a total of a string field you will get the numerical
+	sum of the string data.
+
+ DEVS+NOTIFY
+
+	Simply note in this join example that you must use the original field
+	names which are section.fieldname, not just fieldname.
+
+ POOL
+	Show a total at the bottom of the columns for:
+		Accepted and Rejected
+
+	Again remember to use the original field name 'Rejected'.
+
+---------
+
+With BFGMiner 2.10.1 and later, miner.php includes an extension to the custom
+pages that allows you to apply SQL style commands to the data: where, group,
+and having
+BFGMiner 3.4.0 also includes another option 'gen'.
+
+As an example, miner.php includes a more complex custom page called 'Pools'
+which includes the extension:
+
+$poolsext = array(
+ 'POOL+STATS' => array(
+        'where' => null,
+        'group' => array('POOL.URL', 'POOL.Has Stratum',
+                         'POOL.Stratum Active'),
+        'calc' => array('STATS.Bytes Sent' => 'sum',
+                        'STATS.Bytes Recv' => 'sum'),
+        'gen' => array('AvShr', 'POOL.Difficulty Accepted/max(POOL.Accepted,1)),
+        'having' => array(array('STATS.Bytes Recv', '>', 0)))
+);
+
+This allows you to group records together from one or more rigs.
+In the example, you'll get each Pool (with the same URL+Stratum info) listed
+once for all rigs and a sum of each of the fields listed in 'calc'.
+
+
+'where' and 'having' are an array of fields and restrictions to apply.
+
+In the above example, it will only display the rows where it contains the
+'STATS.Bytes Recv' field with a value greater than zero.
+If the row doesn't have the field, it will always be included.
+All restrictions must be true in order for the row to be included.
+Any restiction that is invalid or unknown is true.
+An empty array, or null, means there are no restrictions.
+
+A restriction is formatted as: array('Field', 'restriction', 'value')
+Field is the simple field name as normally displayed, or SECTION.Field if it is
+a joined section (as in this case 'POOL+STATS').
+The list of restrictions are:
+'set' - true if the row contains the 'Field' ('value' is not required or used)
+'=', '<', '<=', '>', '>' - a numerical comparison.
+'eq', 'lt', 'le', 'gt', 'ge' - a case insensitive string comparison.
+
+You can have multiple restrictions on a 'Field' - but all must be true to
+include the row containing the 'Field'.
+e.g. a number range between 0 and 10 would be:
+array('STATS.Bytes Recv', '>', 0), array('STATS.Bytes Recv', '<', 10)
+
+The difference between 'where' and 'having' is that 'where' is applied to the
+data before grouping it and 'having' is applied to the data after grouping it
+- otherwise they work the same.
+
+
+'group' lists the fields to group over and 'calc' lists the function to apply
+to other fields that are not part of 'group'.
+
+You can only see fields listed in 'group' and 'calc'.
+
+A 'calc' is formatted as: 'Field' => 'function'
+The current list of operations available for 'calc' are:
+'sum', 'avg', 'min', 'max', 'lo', 'hi', 'count', 'any'
+The first 4 are as expected - the numerical sum, average, minimum or maximum.
+'lo' is the first string of the list, sorted ignoring case.
+'hi' is the last string of the list, sorted ignoring case.
+'count' is the number of rows in the section specified in the calc e.g.
+ ('DEVS.Name' => 'count') would be the number of DEVS selected in the 'where'
+ of course any valid 'DEVS.Xyz' would give the same 'count' value.
+'any' is effectively random: the field value in the 1st row of the grouped data.
+An unrecognised 'function' uses 'any'.
+
+A 'gen' allows you to generate new fields from any php valid function of any
+of the other fields.
+ e.g. 'gen' => array('AvShr', 'POOL.Difficulty Accepted/max(POOL.Accepted,1)),
+will generate a new field called GEN.AvShr that is the function shown, which
+in this case is the average difficulty of each share submitted.
+
+THERE IS A SECURITY RISK WITH HOW GEN WORKS!
+It simply replaces all the variables with their values and then requests PHP
+to execute the formula - thus if a field value returned from a BFGMiner API
+request contained PHP code, it could be executed by your web server.
+Of course BFGMiner doesn't do this, but if you do not control the BFGMiner that
+returns the data in the API calls, someone could modify BFGMiner to return a
+PHP string in a field you use in 'gen'.
+Thus use 'gen' at your own risk.
+If someone feels the urge to write a mathematical interpreter in PHP to get
+around this risk, feel free to write one and submit it to the API author for
+consideration.

packages/bfgminer/README.scrypt.txt

@@ -0,0 +1,242 @@
+If you wish to donate to the author of scrypt support, Con Kolivas, for his past
+work (he no longer maintains this), please send your donations to:
+15qSxP1SQcUX3o4nhkfdbgyoWEFMomJ4rZ
+
+---
+
+Scrypt mining for GPU is completely different to sha256 used for bitcoin
+mining. It has very different requirements to bitcoin mining and is a
+lot more complicated to get working well. Note that it is a ram dependent
+workload, and requires you to have enough system ram as well as fast enough
+GPU ram.
+
+Since scrypt ASICs are widely available, GPUs are not used by default. If you
+want to use them, use the -S opencl:auto option. Note that scrypt ASICs are
+documented in README.ASIC rather than this file, which only deals with GPU
+mining.
+
+There are 5 main parameters to tuning scrypt, all of which are optional for
+further fine tuning. When you start scrypt mining with the --scrypt option,
+BFGMiner will fail IN RANDOM WAYS. They are all due to parameters being outside
+what the GPU can cope with.
+
+NOTE that if it does not fail at startup, the presence of hardware errors (HW)
+are a sure sign that you have set the parameters too high.
+
+
+DRIVERS AND OPENCL SDK
+
+The choice of driver version for your GPU is critical, as some are known to
+break scrypt mining entirely while others give poor hashrates. As for the
+OpenCL SDK installed, for AMD it must be version 2.6 or later.
+
+
+Step 1 on Linux:
+export GPU_MAX_ALLOC_PERCENT=100
+If you do not do this, you may find it impossible to scrypt mine. You may find
+a value of 40 is enough and increasing this further has little effect.
+
+export GPU_USE_SYNC_OBJECTS=1
+may help CPU usage a little as well.
+
+On windows the same commands can be passed via a batch file if the following
+lines are in the .bat before starting BFGMiner:
+setx GPU_MAX_ALLOC_PERCENT 100
+setx GPU_USE_SYNC_OBJECTS 1
+
+intensity=XX
+
+Just like in Bitcoin mining, scrypt mining takes an intensity, however the
+scale goes from 0 to 31. 
+The reason this is crucial is that too high an intensity can actually be
+disastrous with scrypt because it CAN run out of ram. High intensities
+start writing over the same ram and it is highly dependent on the GPU, but they
+can start actually DECREASING your hashrate, or even worse, start producing
+garbage with HW errors skyrocketing. Note that if you do NOT specify an
+intensity, BFGMiner uses dynamic mode which is designed to minimise the harm
+to a running desktop and performance WILL be poor. The lower limit to intensity
+with scrypt is usually 8 and BFGMiner will prevent it going too low.
+SUMMARY: Setting this for reasonable hashrates is mandatory.
+
+shaders=XXX
+
+is a new option where you tell BFGMiner how many shaders your GPU has. This
+helps BFGMiner try to choose some meaningful baseline parameters. Use this table
+below to determine how many shaders your GPU has, and note that there are some
+variants of these cards, and Nvidia shaders are much much lower and virtually
+pointless trying to mine on. If this is not set, BFGMiner will query the
+device for how much memory it supports and will try to set a value based on
+that instead.
+SUMMARY: This will get you started but fine tuning for optimal performance is
+required.
+
+GPU  Shaders
+7750 512
+7770 640
+7850 1024
+7870 1280
+7950 1792
+7970 2048
+
+6850 960
+6870 1120
+6950 1408
+6970 1536
+6990 (6970x2)
+
+6570 480
+6670 480
+6790 800
+
+6450 160
+
+5670 400
+5750 720
+5770 800
+5830 1120
+5850 1440
+5870 1600
+5970 (5870x2)
+
+These are only used as a rough guide for BFGMiner, and it is rare that this is
+all you will need to set.
+
+
+Optional parameters to tune:
+kernel, threads, thread-concurrency, lookup-gap
+
+kernel:
+This selects the OpenCL code to use. By default, the kernel named "scrypt" will
+be used. BFGMiner also includes optimised versions from Zuikkis and Pavel
+Semjanov, which you can specify by filename:
+    --set-device OCL:kernel=zuikkis
+    --set-device OCL:kernel=psw
+Note that Zuikkis' version requires the default lookup-gap of 2.
+
+thread-concurrency:
+This tunes the optimal size of work that scrypt can do. It is internally tuned
+by BFGMiner to be the highest reasonable multiple of shaders that it can
+allocate on your GPU. Ideally it should be a multiple of your shader count.
+vliw5 architecture (R5XXX) would be best at 5x shaders, while VLIW4 (R6xxx and
+R7xxx) are best at 4x. Setting thread concurrency overrides anything you put
+into the shaders config and is ultimately a BETTER way to tune performance.
+SUMMARY: Spend lots of time finding the highest value that your device likes
+and increases hashrate.
+
+threads:
+Once you have found the optimal shaders and intensity, you can start increasing
+the threads value till BFGMiner fails to start. This is really only of value if
+you want to run low intensities as you will be unable to run more than 1.
+SUMMARY: Don't touch this.
+
+lookup-gap:
+This tunes a compromise between ram usage and performance. Performance peaks
+at a gap of 2, but increasing the gap can save you some GPU ram, but almost
+always at the cost of significant loss of hashrate. Setting lookup gap
+overrides the default of 2, but BFGMiner will use the provided shaders value to
+choose a thread-concurrency if you haven't chosen one.
+SUMMARY: Don't touch this.
+
+
+Related parameters:
+work_size=XX
+Has a minor effect, should be a multiple of 64 up to 256 maximum.
+SUMMARY: Worth playing with once everything else has been tried but will
+probably do nothing.
+
+vectors=XX
+Vectors are NOT used by scrypt mining kernels.
+SUMMARY: Does nothing.
+
+
+Overclocking for scrypt mining:
+First of all, do not underclock your memory initially. Scrypt mining requires
+memory speed and on most, but not all, GPUs, lowering memory speed lowers
+mining performance.
+
+Second, absolute engine clock speeds do NOT correlate with hashrate. The ratio
+of engine clock speed to memory matters, so if you set your memory to the
+default value, and then start overclocking as you are running it, you should
+find a sweet spot where the hashrate peaks and then it might actually drop if
+you increase the engine clock speed further.
+
+Third, the combination of motherboard, CPU and system ram ALSO makes a
+difference, so values that work for a GPU on one system may not work for the
+same GPU on a different system. A decent amount of system ram is actually
+required for scrypt mining, and 4GB is suggested.
+
+Finally, the power consumption while mining at high engine clocks, very high
+memory clocks can be far in excess of what you might imagine.
+For example, a 7970 running with the following settings:
+--set-device OCL:thread-concurrency=22392 --set-device OCL:clock=1135
+--set-device OCL:memclock=1890
+was using 305W!
+
+---
+TUNING AN AMD RADEON 7970
+Example tuning a 7970 for Scrypt mining:
+
+On Linux run this command:
+export GPU_MAX_ALLOC_PERCENT=100
+or on Windows this:
+setx GPU_MAX_ALLOC_PERCENT 100
+in the same console/bash/dos prompt/bat file/whatever you want to call it,
+before running BFGMiner.
+
+First, find the highest thread concurrency that you can start it at. They should
+all start at 8192 but some will go up to 3 times that. Don't go too high on the
+intensity while testing and don't change gpu threads. If you cannot go above
+8192, don't fret as you can still get a high hashrate.
+
+Delete any .bin files so you're starting from scratch and see what bins get
+generated.
+
+First try without any thread concurrency or even shaders, as BFGMiner will try to
+find an optimal value:
+bfgminer --set-device OCL:intensity=13
+
+If that starts mining, see what bin was generated, it is likely the largest
+meaningful TC you can set.
+Starting it on mine I get:
+scrypt130302Tahitiglg2tc22392w64l8.bin
+
+Note that tc22392 tells you what thread concurrency it was. It should start
+without TC parameters, but you never know. So if it doesn't, start with
+--set-device OCL:thread-concurrency=8192 and add 2048 to it at a time till you
+find the highest value it will start successfully at.
+
+If you wish to get a little extra from your hardware, you may also try
+overclocking. Do note that this will damage your GPUs and void your warranty,
+so unless you are willing to take that risk, skip the clock and memclock
+parameters!
+
+Then start overclocking the eyeballs off your memory, as 7970s are exquisitely
+sensitive to memory speed and amazingly overclockable but please make sure it
+keeps adequately cooled with --auto-fan! Do it while it's running from the GPU
+menu. Go up by 25 at a time every 30 seconds or so until your GPU crashes. Then
+reboot and start it 25 lower as a rough start. One example runs stable at 1900
+memory without overvolting.
+
+Then once you find the maximum memory clock speed, you need to find the sweet
+spot engine clock speed that matches it. It's a fine line where one more MHz
+will make the hashrate drop by 20%. It's somewhere in the .57 - 0.6 ratio range.
+Start your engine clock speed at half your memory clock speed and then increase
+it by 5 at a time. The hashrate should climb a little each rise in engine speed
+and then suddenly drop above a certain value. Decrease it by 1 then until you
+find it climbs dramatically. If your engine clock speed cannot get that high
+without crashing the GPU, you will have to use a lower memclock.
+
+Then, and only then, bother trying to increase intensity further.
+
+My final settings were:
+--set-device OCL:clock=1141 --set-device OCL:memclock=1875 --set-device OCL:intensity=20
+for a hashrate of 745kH.
+
+Note I did not bother setting a thread concurrency. Once you have the magic
+endpoint, look at what tc was chosen by the bin file generated and then hard
+code that in next time (eg --set-device OCL:thread-concurrency=22392) as slight
+changes in thread concurrency will happen every time if you don't specify one,
+and the tc to clock ratios are critical!
+
+Your numbers will be your numbers depending on your hardware combination and OS,
+so don't expect to get exactly the same results!

packages/bfgminer/README.txt

@@ -0,0 +1,961 @@
+BFGMiner:
+St. Barbara's Faithfully Glorified Mining Initiative Naturally Exceeding Rivals
+or Basically a Freaking Good Miner
+
+This is a multi-threaded, multi-blockchain, multi-pool ASIC, FPGA, GPU and CPU
+miner with dynamic clocking, monitoring, and fanspeed support for bitcoin.
+
+This code is provided entirely free of charge by the programmer in his spare
+time so donations would be greatly appreciated. Please consider donating to the
+address below.
+
+Luke-Jr <luke-jr+bfgminer@utopios.org>
+1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh
+
+DOWNLOADS:
+
+http://luke.dashjr.org/programs/bitcoin/files/bfgminer
+
+GIT TREE:
+
+https://github.com/luke-jr/bfgminer
+
+Bug reports:
+
+https://github.com/luke-jr/bfgminer/issues
+
+IRC Channel:
+
+irc://irc.freenode.net/eligius
+
+License: GPLv3.  See COPYING for details.
+
+SEE ALSO README.ASIC, README.FPGA, README.GPU, README.RPC, AND README.scrypt FOR
+MORE INFORMATION ON EACH.
+
+---
+
+EXECUTIVE SUMMARY ON USAGE:
+
+Single pool:
+
+bfgminer -o http://pool:port -u username -p password
+
+Multiple pools:
+
+bfgminer -o http://pool1:port -u pool1username -p pool1password -o http://pool2:port -u pool2usernmae -p pool2password
+
+Multiple blockchains:
+
+bfgminer -o http://pool1:port -u pool1username -p pool1password --pool-goal default -o http://pool2:port -u pool2usernmae -p pool2password --pool-goal freicoin
+
+Single pool with a standard http proxy:
+
+bfgminer -o http://pool:port -x http://proxy:port -u username -p password
+
+Single pool with a socks5 proxy:
+
+bfgminer -o http://pool:port -x socks5://proxy:port -u username -p password
+
+The list of proxy types are:
+ http:    standard http 1.1 proxy
+ socks4:  socks4 proxy
+ socks5:  socks5 proxy
+ socks4a: socks4a proxy
+ socks5h: socks5 proxy using a hostname
+
+Proxy support requires cURL version 7.21.7 or newer.
+
+If you specify the --socks-proxy option to BFGMiner, it will only be applied to
+all pools that don't specify their own proxy setting like above
+
+
+After saving configuration from the menu ([S],[W]) you do not need to give
+BFGMiner any arguments, it will load your configuration instead.
+
+Any configuration file may also contain a single
+	"include" : "filename"
+to recursively include another configuration file.
+Writing the configuration will save all settings from all files to the output
+configuration file.
+
+
+---
+BUILDING BFGMINER
+
+Everything you probably want, condensed:
+	build-essential autoconf automake libtool pkg-config libcurl4-gnutls-dev
+	libjansson-dev uthash-dev libncursesw5-dev libudev-dev libusb-1.0-0-dev
+	libevent-dev libmicrohttpd-dev hidapi
+
+Dependencies:
+	autoconf             http://www.gnu.org/software/autoconf/
+	automake             http://www.gnu.org/software/automake/
+	libtool              http://www.gnu.org/software/libtool/
+	pkg-config           http://www.freedesktop.org/wiki/Software/pkg-config
+	...or pkgconf        https://github.com/pkgconf/pkgconf
+
+	libcurl4-gnutls-dev  http://curl.haxx.se/libcurl/
+
+	libjansson-dev 2.0+  http://www.digip.org/jansson/
+	
+	uthash-dev 1.9.4+    http://troydhanson.github.io/uthash/
+
+Optional Dependencies:
+	Text-User-Interface (TUI): curses dev library; any one of:
+	  libncurses5-dev    http://www.gnu.org/software/ncurses/ (Linux and Mac)
+	  libncursesw5-dev       ^ same
+	  libpdcurses        http://pdcurses.sourceforge.net/ (Linux/Mac/Windows)
+
+	Multiple ASIC/FPGA autodetection: any one of:
+	  sysfs              (built-in to most Linux kernels, just mount on /sys)
+	  libudev-dev        http://www.freedesktop.org/software/systemd/libudev/
+	
+	HashBuster Nano & NanoFury USB devices:
+	  hidapi             https://github.com/signal11/hidapi
+	
+	getwork server for Block Erupter Blades:
+	  libmicrohttpd-dev 0.9.5+  http://www.gnu.org/software/libmicrohttpd/
+	
+	Stratum proxy:
+	  libevent 2.0.3+    http://libevent.org/
+
+	HashBuster Micro, Klondike, X6500 and ZTEX FPGA boards:
+	  libusb-1.0-0-dev   http://www.libusb.org/
+
+	Video card GPU mining (free):
+	  llvm 3.3+          http://llvm.org/
+	  clang 3.3+         http://clang.llvm.org/
+	  libclc             http://libclc.llvm.org/
+	  Mesa 9.2.0+        http://www.mesa3d.org/
+	
+	ATi/AMD video card GPU mining (non-free):
+	  AMD APP SDK        http://developer.amd.com/tools/heterogeneous-computing/amd-accelerated-parallel-processing-app-sdk/
+
+	CPU mining optimized assembly algorithms:
+	  yasm 1.0.1+        http://yasm.tortall.net/
+
+
+BFGMiner driver configuration options:
+	--disable-other-drivers Build without drivers by default unless explicitly
+	                        enabled
+	--enable-broad-udevrules
+	                        Include udev rules for ambiguous devices which may
+	                        not be miners
+	--enable-alchemist      Compile support for AlcheMist (default disabled)
+	--disable-avalon        Compile support for Avalon (default enabled)
+	--disable-avalonmm      Compile support for Avalon2/3 (default enabled)
+	--enable-bfsb           Compile support for BFSB (default disabled)
+	--disable-bfx           Compile support for BFx2 (default enabled)
+	--disable-bifury        Compile support for Bi*Fury (default enabled)
+	--disable-bigpic        Compile support for Big Picture Mining USB (default
+	                        enabled)
+	--disable-bitforce      Compile support for BitForce (default enabled)
+	--disable-bitfury       Compile support for Bitfury (default enabled)
+	--enable-bitmain        Compile support for Bitmain Antminer S* series
+	                        (default disabled)
+	--disable-cointerra     Compile support for CoinTerra (default enabled)
+	--enable-cpumining      Compile support for CPU mining (default disabled)
+	--disable-drillbit      Compile support for DrillBit (default enabled)
+	--disable-dualminer     Compile support for DualMiner (default enabled)
+	--disable-gridseed      Compile support for GridSeed (default enabled)
+	--disable-hashbuster    Compile support for HashBuster Nano (default
+	                        enabled)
+	--disable-hashbusterusb Compile support for HashBuster Micro (default
+	                        enabled)
+	--disable-hashfast      Compile support for HashFast (default enabled)
+	--disable-icarus        Compile support for Icarus (default enabled)
+	--enable-jingtian       Compile support for JingTian (default disabled)
+	--disable-klondike      Compile support for Klondike (default enabled)
+	--enable-knc            Compile support for KnC (default disabled)
+	--enable-kncasic        Compile support for KnC gen 2 (default disabled)
+	--disable-littlefury    Compile support for LittleFury (default enabled)
+	--enable-metabank       Compile support for Metabank (default disabled)
+	--enable-minergate      Compile support for Spondoolies minergate interface
+	                        (default disabled)
+	--enable-minion         Compile support for Minion (default disabled)
+	--disable-modminer      Compile support for ModMiner (default enabled)
+	--disable-nanofury      Compile support for NanoFury (default enabled)
+	--enable-opencl         Compile support for OpenCL (default disabled)
+	--disable-adl           Build without ADL monitoring (default enabled)
+	--disable-rockminer     Compile support for RockMiner (default enabled)
+	--enable-titan          Compile support for KnC Titan (default disabled)
+	--disable-twinfury      Compile support for Twinfury (default enabled)
+	--disable-x6500         Compile support for X6500 (default enabled)
+	--disable-zeusminer     Compile support for ZeusMiner (default enabled)
+	--disable-ztex          Compile support for ZTEX (default enabled)
+
+BFGMiner algorithm configuration option:
+	--enable-keccak         Compile support for Keccak (default disabled)
+	--disable-sha256d       Compile support for SHA256d (default enabled)
+	--enable-scrypt         Compile support for scrypt (default disabled)
+
+BFGMiner dependency configuration options:
+	--without-curses        Compile support for curses TUI (default enabled)
+	--without-libevent      Compile support for libevent stratum server (default
+	                        enabled)
+	--without-libmicrohttpd Compile support for libmicrohttpd getwork server
+	                        (default enabled)
+	--without-libudev       Autodetect FPGAs using libudev (default enabled)
+	--without-libusb        Compile using libusb (default enabled)
+	--without-sensors       Build with libsensors monitoring (default enabled)
+	--with-system-libblkmaker
+	                        Use system libblkmaker rather than bundled one
+	                        (default disabled)
+	--with-udevrulesdir=DIR Install udev rules into this directory
+	--with-udevrules-group=groupname
+	                        Configure mining devices to be owned by a specific
+	                        group (default `video')
+	--without-uio           Compile support for PCI devices via Linux UIO
+	                        interface (default enabled)
+	--without-vfio          Compile support for PCI devices via Linux VFIO
+	                        interface (default enabled)
+
+Basic *nix build instructions:
+
+./autogen.sh    # only needed if building from git repo
+./configure  # list configuration options here
+make
+
+No installation is necessary. You may run BFGMiner from the build directory
+directly.
+
+On Mac OS X, you can use Homebrew to install the dependency libraries. When you
+are ready to build BFGMiner, you may need to point the configure script at one
+or more pkg-config paths. For example:
+	./configure PKG_CONFIG_PATH=/usr/local/opt/curl/lib/pkgconfig:/usr/local/opt/jansson/lib/pkgconfig
+
+Native WIN32 build instructions: see windows-build.txt
+
+If you build BFGMiner from source, it is recommended that you run it from the
+build directory. On *nix, you will usually need to prepend your command with a
+path like this (if you are in the bfgminer directory already): ./bfgminer
+To install system wide run 'sudo make install' or 'make install' as root. You
+can then run from any terminal.
+
+---
+
+Usage instructions:  Run "bfgminer --help" to see options:
+
+Usage: bfgminer [-DdElmpPQqUsTouOchnV]
+
+Options for both config file and command line:
+--api-allow         Allow API access (if enabled) only to the given list of [W:]IP[/Prefix] address[/subnets]
+                    This overrides --api-network and you must specify 127.0.0.1 if it is required
+                    W: in front of the IP address gives that address privileged access to all api commands
+--api-description   Description placed in the API status header (default: BFGMiner version)
+--api-groups        API one letter groups G:cmd:cmd[,P:cmd:*...]
+                    See README.RPC for usage
+--api-listen        Listen for API requests (default: disabled)
+                    By default any command that does not just display data returns access denied
+                    See --api-allow to overcome this
+--api-mcast         Enable API Multicast listener, default: disabled
+--api-mcast-addr <arg> API Multicast listen address (default: "224.0.0.75")
+--api-mcast-code <arg> Code expected in the API Multicast message, don't use '-' (default: "FTW")
+--api-mcast-des <arg>  Description appended to the API Multicast reply, default: ''
+--api-mcast-port <arg> API Multicast listen port (default: 4028)
+--api-network       Allow API (if enabled) to listen on/for any address (default: only 127.0.0.1)
+--api-port          Port number of miner API (default: 4028)
+--balance           Change multipool strategy from failover to even share balance
+--benchmark         Run BFGMiner in benchmark mode - produces no shares
+--benchmark-intense Run BFGMiner in intensive benchmark mode - produces no shares
+--chroot-dir <arg>  Chroot to a directory right after startup
+--cmd-idle <arg>    Execute a command when a device is allowed to be idle (rest or wait)
+--cmd-sick <arg>    Execute a command when a device is declared sick
+--cmd-dead <arg>    Execute a command when a device is declared dead
+--coinbase-check-addr <arg> A list of address to check against in coinbase payout list received from the previous-defined pool, separated by ','
+--coinbase-check-total <arg> The least total payout amount expected in coinbase received from the previous-defined pool
+--coinbase-check-percent <arg> The least benefit percentage expected for the sum of addr(s) listed in --cbaddr argument for previous-defined pool
+--coinbase-sig <arg> Set coinbase signature when possible
+--compact           Use compact display without per device statistics
+--debug|-D          Enable debug output
+--debuglog          Enable debug logging
+--device-protocol-dump Verbose dump of device protocol-level activities
+--device|-d <arg>   Enable only devices matching pattern (default: all)
+--disable-rejecting Automatically disable pools that continually reject shares
+--http-port <arg>   Port number to listen on for HTTP getwork miners (-1 means disabled) (default: -1)
+--expiry <arg>      Upper bound on how many seconds after getting work we consider a share from it stale (w/o longpoll active) (default: 120)
+--expiry-lp <arg>   Upper bound on how many seconds after getting work we consider a share from it stale (with longpoll active) (default: 3600)
+--failover-only     Don't leak work to backup pools when primary pool is lagging
+--failover-switch-delay <arg> Delay in seconds before switching back to a failed pool (default: 300)
+--generate-to <arg> Set an address to generate to for solo mining
+--force-dev-init    Always initialize devices when possible (such as bitstream uploads to some FPGAs)
+--kernel-path <arg> Specify a path to where bitstream and kernel files are
+--load-balance      Change multipool strategy from failover to quota based balance
+--log|-l <arg>      Interval in seconds between log output (default: 20)
+--log-file|-L <arg> Append log file for output messages
+--log-microseconds  Include microseconds in log output
+--monitor|-m <arg>  Use custom pipe cmd for output messages
+--net-delay         Impose small delays in networking to avoid overloading slow routers
+--no-gbt            Disable getblocktemplate support
+--no-getwork        Disable getwork support
+--no-hotplug        Disable hotplug detection
+--no-local-bitcoin  Disable adding pools for local bitcoin RPC servers
+--no-longpoll       Disable X-Long-Polling support
+--no-pool-redirect  Ignore pool requests to redirect to another server
+--no-restart        Do not attempt to restart devices that hang
+--no-stratum        Disable Stratum detection
+--no-submit-stale   Don't submit shares if they are detected as stale
+--no-unicode        Don't use Unicode characters in TUI
+--noncelog <arg>    Create log of all nonces found
+--pass|-p <arg>     Password for bitcoin JSON-RPC server
+--per-device-stats  Force verbose mode and output per-device statistics
+--pool-goal <arg>   Named goal for the previous-defined pool
+--pool-priority <arg> Priority for just the previous-defined pool
+--pool-proxy|-x     Proxy URI to use for connecting to just the previous-defined pool
+--protocol-dump|-P  Verbose dump of protocol-level activities
+--queue|-Q <arg>    Minimum number of work items to have queued (0 - 10) (default: 1)
+--quiet|-q          Disable logging output, display status and errors
+--quit-summary <arg> Summary printed when you quit: none/devs/procs/detailed
+--quota|-U <arg>    quota;URL combination for server with load-balance strategy quotas
+--real-quiet        Disable all output
+--request-diff <arg> Request a specific difficulty from pools (default: 1.0)
+--retries <arg>     Number of times to retry failed submissions before giving up (-1 means never) (default: -1)
+--rotate <arg>      Change multipool strategy from failover to regularly rotate at N minutes (default: 0)
+--round-robin       Change multipool strategy from failover to round robin on failure
+--scan|-S <arg>     Configure how to scan for mining devices
+--scan-time <arg>   Upper bound on time spent scanning current work, in seconds (default: 60)
+--sched-start <arg> Set a time of day in HH:MM to start mining (a once off without a stop time)
+--sched-stop <arg>  Set a time of day in HH:MM to stop mining (will quit without a start time)
+--scrypt            Use the scrypt algorithm for mining (non-bitcoin)
+--set-device|--set <arg> Set default parameters on devices; eg, NFY:osc6_bits=50
+--setuid <arg>      Username of an unprivileged user to run as
+--sharelog <arg>    Append share log to file
+--shares <arg>      Quit after mining 2^32 * N hashes worth of shares (default: unlimited)
+--show-processors   Show per processor statistics in summary
+--skip-security-checks <arg> Skip security checks sometimes to save bandwidth; only check 1/<arg>th of the time (default: never skip)
+--socks-proxy <arg> Set socks proxy (host:port) for all pools without a proxy specified
+--stratum-port <arg> Port number to listen on for stratum miners (-1 means disabled) (default: -1)
+--submit-threads    Minimum number of concurrent share submissions (default: 64)
+--syslog            Use system log for output messages (default: standard error)
+--temp-hysteresis <arg> Set how much the temperature can fluctuate outside limits when automanaging speeds (default: 3)
+--text-only|-T      Disable ncurses formatted screen output
+--unicode           Use Unicode characters in TUI
+--url|-o <arg>      URL for bitcoin JSON-RPC server
+--user|-u <arg>     Username for bitcoin JSON-RPC server
+--verbose           Log verbose output to stderr as well as status output
+--weighed-stats     Display statistics weighed to difficulty 1
+--userpass|-O <arg> Username:Password pair for bitcoin JSON-RPC server
+--worktime                     Display extra work time debug information
+Options for command line only:
+--config|-c <arg>   Load a JSON-format configuration file
+See example.conf for an example configuration.
+--no-default-config Inhibit loading default config file
+--default-config    Always load the default config file
+--help|-h           Print this message
+--version|-V        Display version and exit
+
+
+GPU only options:
+
+--gpu-map <arg>     Map OpenCL to ADL device order manually, paired CSV (e.g. 1:0,2:1 maps OpenCL 1 to ADL 0, 2 to 1)
+--gpu-platform <arg> Select OpenCL platform ID to use for GPU mining
+--gpu-reorder       Attempt to reorder GPU devices according to PCI Bus ID
+--no-adl            Disable the ATI display library used for monitoring and setting GPU parameters
+
+GPU mining is disabled by default for SHA256d if you have any dedicated mining
+devices, but can be enabled explicitly specifying the -S opencl:auto option.
+
+See README.GPU for more information regarding GPU mining.
+See README.scrypt for more information regarding (non-bitcoin) scrypt mining.
+
+
+To use ASICs or FPGAs, you will need to be sure the user BFGMiner is running as
+has appropriate permissions. This varies by operating system.
+On Linux, with BFGMiner's udev rules: sudo usermod <username> -a -G video
+Note that on GNU/Linux systems, you will usually need to login again before
+group changes take effect.
+
+By default, BFGMiner will scan for autodetected devices. If you want to prevent
+BFGMiner from doing this, you can use "-S noauto". If you want to probe all
+serial ports, you can use "-S all"; note that this may write data to non-mining
+devices which may then behave in unexpected ways!
+
+On Linux, <arg> is usually of the format /dev/ttyUSBn
+On Mac OS X, <arg> is usually of the format /dev/cu.usb*
+On Windows, <arg> is usually of the format \\.\COMn
+(where n = the correct device number for the device)
+
+The official supplied binaries are compiled with support for all ASICs/FPGAs.
+To force the code to only attempt detection with a specific driver,
+prepend the argument with the driver name followed by an "at" symbol.
+For example, "icarus@/dev/ttyUSB0" or "bitforce@\\.\COM5"
+or using the short name: "ica@/dev/ttyUSB0" or "bfl@\\.\COM5"
+
+Some FPGAs do not have non-volatile storage for their bitstreams and must be
+programmed every power cycle, including first use. To use these devices, you
+must download the proper bitstream from the vendor's website and copy it to the
+"bitstreams" directory into your BFGMiner application directory.
+
+See README.ASIC and README.FPGA for more information regarding these.
+
+See README.CPU for information regarding CPU mining.
+
+---
+
+WHILE RUNNING:
+
+The following options are available while running with a single keypress:
+
+[M]anage devices [P]ool management [S]ettings [D]isplay options  [H]elp [Q]uit
+
+M gives you something like:
+
+Select processor to manage using up/down arrow keys
+ BFL 0a: 78.0C |  3.64/ 3.70/ 2.91Gh/s | A:46 R:0+0(none) HW:  2/none
+  BitFORCE SHA256 SC from Butterfly Labs
+Serial: FTWN6T67
+
+[D]isable
+Or press Enter when done
+
+
+P gives you:
+
+Current pool management strategy: Failover
+[F]ailover only disabled
+[A]dd pool [R]emove pool [D]isable pool [E]nable pool
+[C]hange management strategy [S]witch pool [I]nformation
+
+
+S gives you:
+
+[L]ongpoll: On
+[Q]ueue: 1
+[S]cantime: 60
+[E]xpiry: 120
+[R]etries: -1
+[W]rite config file
+[B]FGMiner restart
+
+
+D gives you:
+
+[N]ormal [C]lear [S]ilent mode (disable all output)
+[D]ebug:off
+[P]er-device:off
+[Q]uiet:off
+[V]erbose:off
+[R]PC debug:off
+[W]orkTime details:off
+co[M]pact: off
+[L]og interval:5
+
+
+Q quits the application.
+
+
+The running log shows output similar to that below:
+
+ [2013-02-13 00:26:30] Accepted 1758e8df BFL 0  pool 0 Diff 10/1
+ [2013-02-13 00:26:32] Accepted 1d9a2199 MMQ 0a pool 0 Diff 8/1
+ [2013-02-13 00:26:33] Accepted b1304924 ZTX 0  pool 0 Diff 1/1
+ [2013-02-13 00:26:33] Accepted c3ad22f4 XBS 0b pool 0 Diff 1/1
+
+The 8 byte hex value are the 2nd set of 32 bits from the share submitted to the
+pool. The 2 diff values are the actual difficulty target that share reached
+followed by the difficulty target the pool is currently asking for.
+
+---
+Also many issues and FAQs are covered in the forum threads
+dedicated to this program,
+	https://bitcointalk.org/?topic=78192
+	https://bitcointalk.org/?topic=168174
+
+If you are mining on a single pool, the pool display shows:
+ Pool 0: ...s.m.eligius.st   Diff:16  +Strtm  LU:[03:26:16]  User:1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh
+
+This tells you which pool you're using, as well as its current share difficulty,
+protocol, and last explicit work update. If BFGMiner has a working block
+notification source, the protocol will be prefixed by a plus sign. If not, a
+minus sign.
+
+If you are mining on multiple pools at once, the pool display instead shows:
+ Pools: 2 (0,1)              Diff:4-16  +  LU:[03:25:30]
+
+You get the total number of working pools, the pool numbers for each of those,
+the range of current share difficulties, whether block notification is working
+(plus/minus), and the oldest explicit work update currently being used for new
+work.
+
+The block display shows:
+Block #217364: ...1b89f8d3  Diff:7.67M (54.93T)  Started: [17:17:22]  I:12.99mBTC/hr
+
+This shows a short stretch of the next block's height, the current block,
+difficulty (including the network hashrate that difficulty represents), when the
+search for the new block started, and finally expected Income, calculated by
+actual shares submitted in 100% PPS value (assumes Bitcoin, does not account for
+altcoin conversions!).
+
+The BFGMiner status line shows:
+ ST:1  F:0  NB:1  AS:0  BW:[ 75/241 B/s]  E:2.42  BS:2.71k
+
+ST is STaged work items (ready to use).
+F  is network Failure occasions (server down or slow to provide work)
+NB is New Blocks detected on the network
+AS is Active Submissions (shares in the process of submitting)
+BW is BandWidth usage on the network (received/sent)
+E  is Efficiency defined as number of shares accepted (multiplied by their
+          difficulty) per 2 KB of bandwidth
+BS is the all time Best Share difficulty you've found
+
+The totals line shows the following:
+ 6/32   75.0C | 171.3/170.8/171.2Gh/s | A:729 R:8+0(.01%) HW:0/.81%
+
+Each column is as follows:
+  The number of devices and processors currently mining
+  Hottest temperature reported by any processor
+  20 second exponentially decaying average hash rate (configurable with --log
+      option)
+  An all time average hash rate
+  An all time average hash rate based on actual nonces found, adjusted for pool
+      reject and stale rate
+  The number of Accepted shares
+  The number of Rejected shares and stale shares discarded (never submitted),
+      and the percentage these are of total found.
+  The number of HardWare errors, and percentage invalid of nonces returned
+
+Each device shows:
+ BFL 2: 74.0C | 51.97/58.90/57.17Gh/s | A:847 R:15+0(.54%) HW:496/.91%
+
+Columns are the same as in the totals line.
+
+
+---
+MULTIPOOL
+
+FAILOVER STRATEGIES WITH MULTIPOOL:
+A number of different strategies for dealing with multipool setups are
+available. Each has their advantages and disadvantages so multiple strategies
+are available by user choice, as per the following list:
+
+FAILOVER:
+The default strategy is failover. This means that if you input a number of
+pools, it will try to use them as a priority list, moving away from the 1st
+to the 2nd, 2nd to 3rd and so on. If any of the earlier pools recover, it will
+move back to the higher priority ones.
+
+ROUND ROBIN:
+This strategy only moves from one pool to the next when the current one falls
+idle and makes no attempt to move otherwise.
+
+ROTATE:
+This strategy moves at user-defined intervals from one active pool to the next,
+skipping pools that are idle.
+
+LOAD BALANCE:
+This strategy sends work to all the pools on a quota basis. By default, all
+pools are allocated equal quotas unless specified with --quota. This
+apportioning of work is based on work handed out, not shares returned so is
+independent of difficulty targets or rejected shares. While a pool is disabled
+or dead, its quota is dropped until it is re-enabled. Quotas are forward
+looking, so if the quota is changed on the fly, it only affects future work.
+If all pools are set to zero quota or all pools with quota are dead, it will
+fall back to a failover mode. See quota below for more information.
+
+The failover-only flag has special meaning in combination with load-balance
+mode and it will distribute quota back to priority pool 0 from any pools that
+are unable to provide work for any reason so as to maintain quota ratios
+between the rest of the pools.
+
+BALANCE:
+This strategy monitors the amount of difficulty 1 shares solved for each pool
+and uses it as a basis for trying to doing the same amount of work for each
+pool.
+
+
+---
+SOLO MINING
+
+BFGMiner supports solo mining with any GBT-compatible bitcoin node (such as
+bitcoind). To use this mode, you need to specify the URL of your bitcoind node
+using the usual pool options (--url, --userpass, etc), and the --generate-to
+option to specify the Bitcoin address you wish to receive the block rewards
+mined. When you run Bitcoin Core on the same computer as your miner, the pool
+itself will be automatically configured for you (on the default goal). Please be
+aware that solo mining via GBT is at this time only supported for Bitcoin.
+
+IMPORTANT: If you are solo mining with more than one instance of BFGMiner (or
+any other software) per payout address, you must also specify data using the
+--coinbase-sig option to ensure each miner is working on unique work. Note
+that this data will be publicly seen if your miner finds a block using any
+GBT-enabled pool, even when not solo mining (such as failover).
+
+If your bitcoin node does not support longpolling (for example, bitcoind 0.8.x),
+you should consider setting up a failover pool to provide you with block
+notifications. Note that solo mining does not use shares, so BFGMiner's adjusted
+hashrate (third column) may suddenly drop to zero if a block you submit is
+rejected; this does not indicate that it has stopped mining.
+
+Example solo mining usage:
+
+bfgminer -o http://localhost:8332 -u username -p password \
+    --generate-to 1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh \
+    --coinbase-sig "rig1: This is Joe's block!"
+
+If you want to solo mine on multiple GBT-compatible Bitcoin blockchains, you can
+specify --generate-to multiple times with a goal name prefix followed by a
+colon. Note that at this time, the coinbase sig is always shared across all
+goals/pools.
+
+Example multi-blockchain solo mining usage:
+
+bfgminer -o http://localhost:8332 -u username -p password \
+    --generate-to 1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh \
+    -o http://localhost:7221 -u user2 -p password --pool-goal mychain \
+    --generate-to mychain:1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh \
+    --coinbase-sig "rig1: This is Joe's block!"
+
+
+---
+QUOTAS
+
+The load-balance multipool strategy works off a quota based scheduler. The
+quotas handed out by default are equal, but the user is allowed to specify any
+arbitrary ratio of quotas. For example, if all the quota values add up to 100,
+each quota value will be a percentage, but if 2 pools are specified and pool0
+is given a quota of 1 and pool1 is given a quota of 9, pool0 will get 10% of
+the work and pool1 will get 90%. Quotas can be changed on the fly with RPC,
+and do not act retrospectively. Setting a quota to zero will effectively
+disable that pool unless all other pools are disabled or dead. In that
+scenario, load-balance falls back to regular failover priority-based strategy.
+While a pool is dead, it loses its quota and no attempt is made to catch up
+when it comes back to life.
+
+To specify quotas on the command line, pools should be specified with a
+semicolon separated --quota(or -U) entry instead of --url. Pools specified with
+--url are given a nominal quota value of 1 and entries can be mixed.
+
+For example:
+--url poolA:portA -u usernameA -p passA --quota "2;poolB:portB" -u usernameB -p passB
+Will give poolA 1/3 of the work and poolB 2/3 of the work.
+
+Writing configuration files with quotas is likewise supported. To use the above
+quotas in a configuration file they would be specified thus:
+
+"pools" : [
+        {
+                "url" : "poolA:portA",
+                "user" : "usernameA",
+                "pass" : "passA"
+        },
+        {
+                "quota" : "2;poolB:portB",
+                "user" : "usernameB",
+                "pass" : "passB"
+        }
+]
+
+
+---
+LOGGING
+
+BFGMiner will log to stderr if it detects stderr is being redirected to a file.
+To enable logging simply add 2>logfile.txt to your command line and logfile.txt
+will contain the logged output at the log level you specify (normal, verbose,
+debug etc.)
+
+In other words if you would normally use:
+./bfgminer -o xxx -u yyy -p zzz
+if you use
+./bfgminer -o xxx -u yyy -p zzz 2>logfile.txt
+it will log to a file called logfile.txt and otherwise work the same.
+
+There is also the -m option on linux which will spawn a command of your choice
+and pipe the output directly to that command.
+
+The WorkTime details 'debug' option adds details on the end of each line
+displayed for Accepted or Rejected work done. An example would be:
+
+ <-00000059.ed4834a3 M:X D:1.0 G:17:02:38:0.405 C:1.855 (2.995) W:3.440 (0.000) S:0.461 R:17:02:47
+
+The first 2 hex codes are the previous block hash, the rest are reported in
+seconds unless stated otherwise:
+The previous hash is followed by the getwork mode used M:X where X is one of
+P:Pool, T:Test Pool, L:LP or B:Benchmark,
+then D:d.ddd is the difficulty required to get a share from the work,
+then G:hh:mm:ss:n.nnn, which is when the getwork or LP was sent to the pool and
+the n.nnn is how long it took to reply,
+followed by 'O' on its own if it is an original getwork, or 'C:n.nnn' if it was
+a clone with n.nnn stating how long after the work was recieved that it was
+cloned, (m.mmm) is how long from when the original work was received until work
+started,
+W:n.nnn is how long the work took to process until it was ready to submit,
+(m.mmm) is how long from ready to submit to actually doing the submit, this is
+usually 0.000 unless there was a problem with submitting the work,
+S:n.nnn is how long it took to submit the completed work and await the reply,
+R:hh:mm:ss is the actual time the work submit reply was received
+
+If you start BFGMiner with the --sharelog option, you can get detailed
+information for each share found. The argument to the option may be "-" for
+standard output (not advisable with the ncurses UI), any valid positive number
+for that file descriptor, or a filename.
+
+To log share data to a file named "share.log", you can use either:
+./bfgminer --sharelog 50 -o xxx -u yyy -p zzz 50>share.log
+./bfgminer --sharelog share.log -o xxx -u yyy -p zzz
+
+For every share found, data will be logged in a CSV (Comma Separated Value)
+format:
+    timestamp,disposition,target,pool,dev,thr,sharehash,sharedata
+For example (this is wrapped, but it's all on one line for real):
+    1335313090,reject,
+    ffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000,
+    http://localhost:8337,GPU0,0,
+    6f983c918f3299b58febf95ec4d0c7094ed634bc13754553ec34fc3800000000,
+    00000001a0980aff4ce4a96d53f4b89a2d5f0e765c978640fe24372a000001c5
+    000000004a4366808f81d44f26df3d69d7dc4b3473385930462d9ab707b50498
+    f681634a4f1f63d01a0cd43fb338000000000080000000000000000000000000
+    0000000000000000000000000000000000000000000000000000000080020000
+
+---
+
+RPC API
+
+For RPC API details see the README.RPC file
+
+---
+
+FAQ
+
+Q: Why can't BFGMiner find lib<something> even after I installed it from source
+code?
+A: On UNIX-like operating systems, you often need to run one or more commands to
+reload library caches, such as "ldconfig" or similar. A couple of systems (such
+as Fedora) ship with /usr/local/lib missing from their library search path. In
+this case, you can usually add it like this:
+    echo /usr/local/lib >/etc/ld.so.conf.d/local.conf
+Please note that if your libraries installed into lib64 instead of lib, you
+should use that in the ld.so config file above instead.
+
+Q: BFGMiner segfaults when I change my shell window size.
+A: Older versions of libncurses have a bug to do with refreshing a window
+after a size change. Upgrading to a new version of curses will fix it.
+
+Q: I have multiple USB stick devices but I can't get them all to work at once?
+A: Very few USB hubs deliver the promised power required to run as many devices
+as they fit if all of them draw power from USB. Devices may use up to 2.5 watts
+of power (or 4.5 watts for USB 3 devices), and mining USB sticks usually need it
+all. You can estimate how much power your USB hub can provide by multiplying its
+power supply's output amps by volts (so, if it says 12V 2.5A, you have 12*2.5=
+30 watts).
+
+Q: I've confirmed my USB miners are powered sufficiently, but BFGMiner still
+is having problems running more than a few at once?
+A: Some USB hosts cannot deal with polling as often as miners may need for quick
+delivery of shares. On Linux, you can request putting VCOM devices in "high
+latency" mode (or rather, disabling the default "low latency" mode) using the
+setserial command:
+    setserial /dev/ttyUSB0 '^low_latency'
+You can further tweak device latency by finding the latency_timer attribute in
+sysfs.
+
+Q: I've plugged my devices into my USB hub but nothing shows up?
+A: RPis and Windows have incomplete or non-standard USB3 support so they may
+never work. It may be possible to get a USB3 hub to work by plugging it into a
+USB2 hub.
+
+Q: Can I mine on servers from different networks (eg smartcoin and bitcoin) at
+the same time?
+A: No, BFGMiner keeps a database of the block it's working on to ensure it does
+not work on stale blocks, and having different blocks from two networks would
+make it invalidate the work from each other.
+
+Q: Can I configure BFGMiner to mine with different login credentials or pools
+for each separate device?
+A: No such feature has been implemented to support this.
+
+Q: Can I put multiple pools in the config file?
+A: Yes, check the example.conf file. Alternatively, set up everything either on
+the command line or via the menu after startup and choose [S]ettings->[W]rite
+config file and the file will be loaded one each startup.
+
+Q: The build fails with gcc is unable to build a binary.
+A: Remove the "-march=native" component of your CFLAGS as your version of GCC
+does not support it.
+
+Q: Can you implement feature X?
+A: I can, but time is limited, and people who donate are more likely to get
+their feature requests implemented.
+
+Q: Work keeps going to my backup pool even though my primary pool hasn't
+failed?
+A: BFGMiner checks for conditions where the primary pool is lagging and will
+pass some work to the backup servers under those conditions. The reason for
+doing this is to try its absolute best to keep the devices working on something
+useful and not risk idle periods. You can disable this behaviour with the
+option --failover-only.
+
+Q: Is this a virus?
+A: As BFGMiner is being packaged with other trojan scripts, some antivirus
+software is falsely accusing bfgminer.exe as being the actual virus, rather than
+whatever it is being packaged with. If you installed BFGMiner yourself from a
+reputable source then you do not have a virus on your computer. Complain to your
+antivirus software company. They seem to be flagging even source code from
+BFGMiner as malicious now, even though text source files can't do anything by
+themselves.
+
+Q: Can you modify the display to include more of one thing in the output and
+less of another, or can you change the quiet mode or can you add yet another
+output mode?
+A: Everyone will always have their own view of what is important to monitor.
+The defaults are very sane and I have very little interest in changing this
+any further.
+
+Q: Why is my efficiency above/below 1.00?
+A: Efficiency simply means how many shares you return for the amount of
+bandwidth used. It does not correlate with efficient use of your hardware, and
+is a measure of a combination of hardware speed, block luck, pool design and
+many other factors.
+
+Q: What are the best parameters to pass for X pool/hardware/device.
+A: Virtually always, the DEFAULT parameters give the best results. Most user
+defined settings lead to worse performance.
+
+Q: What happened to CPU mining?
+A: See README.CPU for more information.
+
+Q: Is there a GUI version?
+A: Yes, there are a number of GUI interfaces for BFGMiner:
+Name        Website                                Operating system(s)
+----        -------                                -------------------
+EasyMiner   http://www.butterflylabs.com/drivers/  Android, Linux, Windows
+MacMiner    http://fabulouspanda.co.uk/macminer/   Mac
+MultiMiner  http://www.multiminerapp.com/          Linux, Mac, Windows (.NET)
+
+Q: Is there a "bare-metal" version?
+A: Yes, there are a few dedicated mining operating systems built on BFGMiner:
+Name        Website                              Hardware
+----        -------                              --------
+Controla    http://hashra.com/support            Raspberry Pi
+MinePeon    http://mineforeman.com/minepeon/     BeagleBone Black, Raspberry Pi
+Minera      http://getminera.com/                Raspberry Pi
+PiMP        http://getpimp.org/                  x86
+
+Q: I'm having an issue. What debugging information should I provide?
+A: Start BFGMiner with your regular commands and add -D -T --verbose and provide
+the full startup output and a summary of your hardware, operating system, and if
+applicable, ATI driver version and ATI stream version.
+
+Q: Why isn't BFGMiner performing well or working on my Raspberry Pi?
+A: Raspberry Pis have hardware defect(s) which affect USB devices to varying
+degrees. Some devices will never be able to work on them, some work fine, and
+some require hacks to workaround the problem. One common workaround is to add
+the dwc_otg.speed=1 parameter to /boot/cmdline.txt. Note that this will slow
+down the USB bus to USB 1.1 speeds, which also affects network bandwidth since
+the Raspberry Pi uses a USB network interface. You may wish to consider
+upgrading to a BeagleBone or UDOO controller.
+
+Q: Can I mine with BFGMiner on a Mac?
+A: BFGMiner will compile on OS X, but the performance of GPU mining is
+compromised due to the OpenCL implementation on OS X, there is no temperature or
+fanspeed monitoring and the cooling design of most Macs, despite having
+powerful GPUs, will usually not cope with constant usage leading to a high risk
+of thermal damage. It is highly recommended not to mine on a Mac unless it is
+with an external USB device.
+
+Q: My network gets slower and slower and then dies for a minute?
+A; Try the --net-delay option if you are on a getwork or GBT server.
+
+Q: How do I tune for P2Pool?
+A: P2Pool has very rapid expiration of work and new blocks, it is suggested you
+decrease intensity by 1 from your optimal value, and decrease GPU threads to 1
+with --set-device OCL:threads=1. It is also recommended to use --failover-only
+since the work is effectively like a different block chain. If mining with a
+Mini Rig, it is worth adding the --bfl-range option.
+
+Q: I run PHP on windows to access the API with the example miner.php. Why does
+it fail when php is installed properly but I only get errors about Sockets not
+working in the logs?
+A: Please check http://us.php.net/manual/en/sockets.installation.php
+
+Q: What is a PGA?
+A: At the moment, BFGMiner supports 5 FPGAs: BitForce, Icarus, ModMiner, X6500,
+and ZTEX.
+They are Field-Programmable Gate Arrays that have been programmed to do Bitcoin
+mining. Since the acronym needs to be only 3 characters, the "Field-" part has
+been skipped. "PGA" is also used for devices built with Application-Specific
+Integrated Circuits (ASICs).
+
+Q: What is an ASIC?
+A: They are Application Specific Integrated Circuit devices and provide the
+highest performance per unit power due to being dedicated to only one purpose.
+
+Q: How do I get my BFL/Icarus/Lancelot/Cairnsmore device to auto-recognise?
+A: On Linux, if the /dev/ttyUSB* devices don't automatically appear, the only
+thing that needs to be done is to load the driver for them:
+  BitForce:   sudo modprobe ftdi_sio vendor=0x0403 product=0x6014
+  Erupter:    sudo modprobe cp210x   vendor=0x10c4 product=0xea60
+  Icarus:     sudo modprobe pl2303   vendor=0x067b product=0x0230
+  Lancelot:   sudo modprobe ftdi_sio vendor=0x0403 product=0x6001
+  Cairnsmore: sudo modprobe ftdi_sio vendor=0x0403 product=0x8350
+On some systems you must manally install the driver required for the device.
+OpenWrt drivers (install with opkg):
+  FTDI:       kmod-usb-serial-ftdi
+  Erupter:    kmod-usb-serial-cp210x
+  Icarus:     kmod-usb-serial-pl2303
+Windows drivers:
+  FTDI:       http://www.ftdichip.com/Drivers/VCP.htm
+  Erupter:    http://www.silabs.com/products/mcu/pages/usbtouartbridgevcpdrivers.aspx
+  Icarus:     http://prolificusa.com/pl-2303hx-drivers/
+
+Q: I ran cgminer, and now BFGMiner doesn't work!
+A: cgminer has its own non-standard implementations of the drivers for most USB
+devices, and requires you to replace the official drivers with WinUSB on Windows
+(usually using Zadig). Before you can use BFGMiner, you will need to restore the
+original driver. Uninstalling the device (and WinUSB driver) from Device Manager
+and re-plugging it will usually trigger driver re-installation to the default
+drivers.
+
+Q: On Linux I can see the /dev/ttyUSB* devices, but BFGMiner can't mine on them?
+A: Make sure you have the required privileges to access the /dev/ttyUSB*
+devices:
+ sudo ls -las /dev/ttyUSB*
+will give output like:
+ 0 crw-rw---- 1 root video   188, 0 2012-09-11 13:49 /dev/ttyUSB0
+This means your account must have the group 'video' or root privileges.
+To permanently give your account the 'video' group:
+ sudo usermod -G video -a `whoami`
+Then logout and back in again.
+
+Q: Can I mine scrypt with FPGAs or ASICs?
+A: BFGMiner supports scrypt mining with GridSeed GC3355 ASICs, using either
+DualMiner USB sticks or the 5-chip orb.
+
+Q: Why does BFGMiner show a fractional difficulty when mining scrypt?
+A: BFGMiner consistently uses pdiff measurement for difficulty everywhere,
+rather than other measurements that may exist. For scrypt, pdiff 1 is very
+difficult, and higher get exponentially harder. It is unlikely you will want to
+use pdiff 1+ with scrypt any time soon.
+
+Q: What is stratum and how do I use it?
+A: Stratum is a protocol designed to reduce resources for mining pools at the
+cost of keeping the miner in the dark and blindly transferring his mining
+authority to the pool. It is a return to the problems of the old centralized
+"getwork" protocol, but capable of scaling to hardware of any speed like the
+standard GBT protocol. If a pool uses stratum instead of GBT, BFGMiner will
+automatically detect it and switch to the support as advertised if it can.
+Stratum uses direct TCP connections to the pool and thus it will NOT currently
+work through a http proxy but will work via a socks proxy if you need to use
+one. If you input the stratum port directly into your configuration, or use the
+special prefix "stratum+tcp://" instead of "http://", BFGMiner will ONLY try to
+use stratum protocol mining.
+
+Q: Why don't the statistics add up: Accepted, Rejected, Stale, Hardware Errors,
+Diff1 Work, etc. when mining greater than 1 difficulty shares?
+A: As an example, if you look at 'Difficulty Accepted' in the RPC API, the number
+of difficulty shares accepted does not usually exactly equal the amount of work
+done to find them. If you are mining at 8 difficulty, then you would expect on
+average to find one 8 difficulty share, per 8 single difficulty shares found.
+However, the number is actually random and converges over time as it is an
+average, not an exact value, thus you may find more or less than the expected
+average.
+
+---
+
+This code is provided entirely free of charge by the programmer in his spare
+time so donations would be greatly appreciated. Please consider donating to the
+address below.
+
+Luke-Jr <luke-jr+bfgminer@utopios.org>
+1QATWksNFGeUJCWBrN4g6hGM178Lovm7Wh

packages/bfgminer/Start_Moonlander2.bat

@@ -0,0 +1,2 @@
+bfgminer.exe --scrypt -o stratum+tcp://us.litecoinpool.org:3333 -u wareck.2 -p 1,d=128  -S all --set MLD:clock=600
+pause

packages/bfgminer/example.conf

@@ -0,0 +1,48 @@
+{
+"pools" : [
+	{
+		"url" : "http://url1:8332",
+		"user" : "user1",
+		"pass" : "pass1"
+	},
+	{
+		"url" : "http://url2:8344",
+		"pool-proxy" : "socks5://127.0.0.1:1080",
+		"user" : "user2",
+		"pass" : "pass2"
+	},
+	{
+		"url" : "http://url3:8332",
+		"user" : "user3",
+		"pass" : "pass3"
+	}
+],
+
+"intensity" : "d,9,9,9",
+"gpu-engine" : "0-985,0-950,0-960,0-1000",
+"gpu-fan" : "0-85,0-85,0-85,0-85",
+"gpu-memclock" : "860,825,835,875",
+"gpu-powertune" : "20,20,20,20",
+"temp-cutoff" : "95,95,95,95",
+"temp-overheat" : "85,85,85,85",
+"temp-target" : "75,75,75,75",
+
+"auto-fan" : true,
+"auto-gpu" : true,
+"expiry" : 120,
+"failover-only" : true,
+"gpu-threads" : 2,
+"log" : 5,
+"queue" : 1,
+"scan-time" : 60,
+"temp-hysteresis" : 3,
+
+"scan-serial" : [
+	"/dev/ttyUSB0",
+	"/dev/ttyUSB1",
+	"/dev/ttyUSB2",
+	"/dev/ttyUSB3"
+],
+
+"kernel-path" : "/usr/local/bin"
+}

packages/bfgminer/miner.php

@@ -0,0 +1,3126 @@
+<?php
+session_start();
+date_default_timezone_set(@date_default_timezone_get());
+#
+global $doctype, $title, $miner, $port, $readonly, $notify;
+global $rigport, $rigs, $rignames, $rigbuttons;
+global $mcast, $mcastexpect, $mcastaddr, $mcastport, $mcastcode;
+global $mcastlistport, $mcasttimeout, $mcastretries, $allowgen;
+global $rigipsecurity, $rigtotals, $forcerigtotals;
+global $socksndtimeoutsec, $sockrcvtimeoutsec;
+global $checklastshare, $poolinputs, $hidefields;
+global $ignorerefresh, $changerefresh, $autorefresh;
+global $allowcustompages, $customsummarypages;
+global $miner_font_family, $miner_font_size;
+global $bad_font_family, $bad_font_size;
+global $colouroverride, $placebuttons, $userlist;
+global $per_proc;
+#
+$doctype = "<!DOCTYPE html>\n";
+#
+# See README.RPC for more details of these variables and how
+# to configure miner.php
+#
+# Web page title
+$title = 'Mine';
+#
+# Set $readonly to true to force miner.php to be readonly
+# Set $readonly to false then it will check BFGMiner 'privileged'
+$readonly = false;
+#
+# Set $userlist to null to allow anyone access or read README.RPC
+$userlist = null;
+#
+# Set $per_proc to false to display only full device summaries
+$per_proc = true;
+#
+# Set $notify to false to NOT attempt to display the notify command
+# Set $notify to true to attempt to display the notify command
+$notify = true;
+#
+# Set $checklastshare to true to do the following checks:
+# If a device's last share is 12x expected ago then display as an error
+# If a device's last share is 8x expected ago then display as a warning
+# If either of the above is true, also display the whole line highlighted
+# This assumes shares are 1 difficulty shares
+$checklastshare = true;
+#
+# Set $poolinputs to true to show the input fields for adding a pool
+# and changing the pool priorities
+# N.B. also if $readonly is true, it will not display the fields
+$poolinputs = false;
+#
+# Default port to use if any $rigs entries don't specify the port number
+$rigport = 4028;
+#
+# Set $rigs to an array of your BFGMiner rigs that are running
+#  format: 'IP' or 'Host' or 'IP:Port' or 'Host:Port' or 'Host:Port:Name'
+$rigs = array('127.0.0.1:4028');
+#
+# Set $rignames to false, or one of 'ip' or 'ipx'
+#  this says what to use if $rigs doesn't have a 'name'
+$rignames = false;
+#
+# Set $rigbuttons to false to display a link rather than a button
+$rigbuttons = true;
+#
+# Set $mcast to true to look for your rigs and ignore $rigs
+$mcast = false;
+#
+# Set $mcastexpect to at least how many rigs you expect it to find
+$mcastexpect = 0;
+#
+# API Multicast address all cgminers are listening on
+$mcastaddr = '224.0.0.75';
+#
+# API Multicast UDP port all cgminers are listening on
+$mcastport = 4028;
+#
+# The code all cgminers expect in the Multicast message sent
+$mcastcode = 'FTW';
+#
+# UDP port cgminers are to reply on (by request)
+$mcastlistport = 4027;
+#
+# Set $mcasttimeout to the number of seconds (floating point)
+# to wait for replies to the Multicast message
+$mcasttimeout = 1.5;
+#
+# Set $mcastretries to the number of times to retry the multicast
+$mcastretries = 0;
+#
+# Set $allowgen to true to allow customsummarypages to use 'gen' 
+# false means ignore any 'gen' options
+$allowgen = false;
+#
+# Set $rigipsecurity to false to show the IP/Port of the rig
+# in the socket error messages and also show the full socket message
+$rigipsecurity = true;
+#
+# Set $rigtotals to true to display totals on the single rig page
+# 'false' means no totals (and ignores $forcerigtotals)
+# You can force it to always show rig totals when there is only
+# one line by setting $forcerigtotals = true;
+$rigtotals = true;
+$forcerigtotals = false;
+#
+# These should be OK for most cases
+$socksndtimeoutsec = 10;
+$sockrcvtimeoutsec = 40;
+#
+# List of fields NOT to be displayed
+# This example would hide the slightly more sensitive pool information
+#$hidefields = array('POOL.URL' => 1, 'POOL.User' => 1);
+$hidefields = array();
+#
+# Auto-refresh of the page (in seconds) - integers only
+# $ignorerefresh = true/false always ignore refresh parameters
+# $changerefresh = true/false show buttons to change the value
+# $autorefresh = default value, 0 means dont auto-refresh
+$ignorerefresh = false;
+$changerefresh = true;
+$autorefresh = 0;
+#
+# Should we allow custom pages?
+# (or just completely ignore them and don't display the buttons)
+$allowcustompages = true;
+#
+# OK this is a bit more complex item: Custom Summary Pages
+# As mentioned above, see README.RPC
+# see the example below (if there is no matching data, no total will show)
+$mobilepage = array(
+ 'DATE' => null,
+ 'RIGS' => null,
+ 'SUMMARY' => array('Elapsed', 'MHS av', 'Found Blocks=Blks', 'Accepted', 'Rejected=Rej', 'Utility'),
+ 'DEVS+NOTIFY' => array('DEVS.Name=Name', 'DEVS.ID=ID', 'DEVS.ProcID=Proc',
+			'DEVS.Status=Status', 'DEVS.Temperature=Temp',
+			'DEVS.MHS av=MHS av', 'DEVS.Accepted=Accept', 'DEVS.Rejected=Rej',
+			'DEVS.Utility=Utility', 'NOTIFY.Last Not Well=Not Well'),
+ 'POOL' => array('POOL', 'Status', 'Accepted', 'Rejected=Rej', 'Last Share Time'));
+$mobilesum = array(
+ 'SUMMARY' => array('MHS av', 'Found Blocks', 'Accepted', 'Rejected', 'Utility'),
+ 'DEVS+NOTIFY' => array('DEVS.MHS av', 'DEVS.Accepted', 'DEVS.Rejected', 'DEVS.Utility'),
+ 'POOL' => array('Accepted', 'Rejected'));
+#
+$statspage = array(
+ 'DATE' => null,
+ 'RIGS' => null,
+ 'SUMMARY' => array('Elapsed', 'MHS av', 'Found Blocks=Blks',
+			'Accepted', 'Rejected=Rej', 'Utility',
+			'Hardware Errors=HW Errs', 'Network Blocks=Net Blks',
+			'Work Utility'),
+ 'COIN' => array('*'),
+ 'STATS' => array('*'));
+#
+$statssum = array(
+ 'SUMMARY' => array('MHS av', 'Found Blocks', 'Accepted',
+			'Rejected', 'Utility', 'Hardware Errors',
+			'Work Utility'));
+#
+$poolspage = array(
+ 'DATE' => null,
+ 'RIGS' => null,
+ 'SUMMARY' => array('Elapsed', 'MHS av', 'Found Blocks=Blks', 'Accepted', 'Rejected=Rej',
+			'Utility', 'Hardware Errors=HW Errs', 'Network Blocks=Net Blks'),
+ 'POOL+STATS' => array('STATS.ID=ID', 'POOL.URL=URL',
+			'POOL.Has Stratum=Stratum', 'POOL.Stratum Active=StrAct',
+			'STATS.Net Bytes Sent=NSent',
+			'STATS.Net Bytes Recv=NRecv', 'GEN.AvShr=AvShr'));
+#
+$poolssum = array(
+ 'SUMMARY' => array('MHS av', 'Found Blocks', 'Accepted',
+			'Rejected', 'Utility', 'Hardware Errors'),
+ 'POOL+STATS' => array(
+			'STATS.Net Bytes Sent',
+			'STATS.Net Bytes Recv'));
+#
+$poolsext = array(
+ 'POOL+STATS' => array(
+	'where' => null,
+	'group' => array('POOL.URL', 'POOL.Has Stratum', 'POOL.Stratum Active'),
+	'calc' => array(
+			'STATS.Net Bytes Sent' => 'sum',
+			'STATS.Net Bytes Recv' => 'sum',
+			'POOL.Accepted' => 'sum'),
+	'gen' => array('AvShr' => 'round(POOL.Difficulty Accepted/max(POOL.Accepted,1)*100)/100'),
+	'having' => array(array('STATS.Bytes Recv', '>', 0)))
+);
+
+#
+# customsummarypages is an array of these Custom Summary Pages
+$customsummarypages = array('Mobile' => array($mobilepage, $mobilesum),
+ 'Stats' => array($statspage, $statssum),
+ 'Pools' => array($poolspage, $poolssum, $poolsext));
+#
+$here = basename(__FILE__);
+#
+global $tablebegin, $tableend, $warnfont, $warnoff, $dfmt;
+#
+$tablebegin = '<tr><td><table border=1 cellpadding=5 cellspacing=0>';
+$tableend = '</table></td></tr>';
+$warnfont = '<font color=red><b>';
+$warnoff = '</b></font>';
+$dfmt = 'H:i:s j-M-Y \U\T\CP';
+#
+$miner_font_family = 'Verdana, Arial, sans-serif, sans';
+$miner_font_size = '13pt';
+#
+$bad_font_family = '"Times New Roman", Times, serif';
+$bad_font_size = '18pt';
+#
+# Edit this or redefine it in myminer.php to change the colour scheme
+# See $colourtable below for the list of names
+$colouroverride = array();
+#
+# Where to place the buttons: 'top' 'bot' 'both'
+#  anything else means don't show them - case sensitive
+$placebuttons = 'top';
+#
+# This below allows you to put your own settings into a seperate file
+# so you don't need to update miner.php with your preferred settings
+# every time a new version is released
+# Just create the file 'myminer.php' in the same directory as
+# 'miner.php' - and put your own settings in there
+if (file_exists('myminer.php'))
+ include_once('myminer.php');
+#
+# This is the system default that must always contain all necessary
+# colours so it must be a constant
+# You can override these values with $colouroverride
+# The only one missing is $warnfont
+# - which you can override directly anyway
+global $colourtable;
+$colourtable = array(
+	'body bgcolor'		=> '#ecffff',
+	'td color'		=> 'blue',
+	'td.two color'		=> 'blue',
+	'td.two background'	=> '#ecffff',
+	'td.h color'		=> 'blue',
+	'td.h background'	=> '#c4ffff',
+	'td.err color'		=> 'black',
+	'td.err background'	=> '#ff3050',
+	'td.bad color'		=> 'black',
+	'td.bad background'	=> '#ff3050',
+	'td.warn color'		=> 'black',
+	'td.warn background'	=> '#ffb050',
+	'td.sta color'		=> 'green',
+	'td.tot color'		=> 'blue',
+	'td.tot background'	=> '#fff8f2',
+	'td.lst color'		=> 'blue',
+	'td.lst background'	=> '#ffffdd',
+	'td.hi color'		=> 'blue',
+	'td.hi background'	=> '#f6ffff',
+	'td.lo color'		=> 'blue',
+	'td.lo background'	=> '#deffff'
+);
+#
+# Don't touch these 2
+$miner = null;
+$port = null;
+#
+global $rigips;
+$rigips = array();
+#
+# Ensure it is only ever shown once
+global $showndate;
+$showndate = false;
+#
+# For summary page to stop retrying failed rigs
+global $rigerror;
+$rigerror = array();
+#
+global $rownum;
+$rownum = 0;
+#
+// Login
+global $ses;
+$ses = 'rutroh';
+#
+function getcss($cssname, $dom = false)
+{
+ global $colourtable, $colouroverride;
+
+ $css = '';
+ foreach ($colourtable as $cssdata => $value)
+ {
+	$cssobj = explode(' ', $cssdata, 2);
+	if ($cssobj[0] == $cssname)
+	{
+		if (isset($colouroverride[$cssdata]))
+			$value = $colouroverride[$cssdata];
+
+		if ($dom == true)
+			$css .= ' '.$cssobj[1].'='.$value;
+		else
+			$css .= $cssobj[1].':'.$value.'; ';
+	}
+ }
+ return $css;
+}
+#
+function getdom($domname)
+{
+ return getcss($domname, true);
+}
+#
+# N.B. don't call this before calling htmlhead()
+function php_pr($cmd)
+{
+ global $here, $autorefresh;
+
+ return "$here?ref=$autorefresh$cmd";
+}
+#
+function htmlhead($mcerr, $checkapi, $rig, $pg = null, $noscript = false)
+{
+ global $doctype, $title, $miner_font_family, $miner_font_size;
+ global $bad_font_family, $bad_font_size;
+ global $error, $readonly, $poolinputs, $here;
+ global $ignorerefresh, $autorefresh;
+
+ $extraparams = '';
+ if ($rig != null && $rig != '')
+	$extraparams = "&rig=$rig";
+ else
+	if ($pg != null && $pg != '')
+		$extraparams = "&pg=$pg";
+
+ if ($ignorerefresh == true || $autorefresh == 0)
+	$refreshmeta = '';
+ else
+ {
+	$url = "$here?ref=$autorefresh$extraparams";
+	$refreshmeta = "\n<meta http-equiv='refresh' content='$autorefresh;url=$url'>";
+ }
+
+ if ($readonly === false && $checkapi === true)
+ {
+	$error = null;
+	$access = api($rig, 'privileged');
+	if ($error != null
+	||  !isset($access['STATUS']['STATUS'])
+	||  $access['STATUS']['STATUS'] != 'S')
+		$readonly = true;
+ }
+ $miner_font = "font-family:$miner_font_family; font-size:$miner_font_size;";
+ $bad_font = "font-family:$bad_font_family; font-size:$bad_font_size;";
+
+ echo "$doctype<html><head>$refreshmeta
+<title>$title</title>
+<style type='text/css'>
+td { $miner_font ".getcss('td')."}
+td.two { $miner_font ".getcss('td.two')."}
+td.h { $miner_font ".getcss('td.h')."}
+td.err { $miner_font ".getcss('td.err')."}
+td.bad { $bad_font ".getcss('td.bad')."}
+td.warn { $miner_font ".getcss('td.warn')."}
+td.sta { $miner_font ".getcss('td.sta')."}
+td.tot { $miner_font ".getcss('td.tot')."}
+td.lst { $miner_font ".getcss('td.lst')."}
+td.hi { $miner_font ".getcss('td.hi')."}
+td.lo { $miner_font ".getcss('td.lo')."}
+</style>
+</head><body".getdom('body').">\n";
+if ($noscript === false)
+{
+echo "<script type='text/javascript'>
+function pr(a,m){if(m!=null){if(!confirm(m+'?'))return}window.location='$here?ref=$autorefresh'+a}\n";
+
+if ($ignorerefresh == false)
+ echo "function prr(a){if(a){v=document.getElementById('refval').value}else{v=0}window.location='$here?ref='+v+'$extraparams'}\n";
+
+ if ($readonly === false && $checkapi === true)
+ {
+echo "function prc(a,m){pr('&arg='+a,m)}
+function prs(a,r){var c=a.substr(3);var z=c.split('|',2);var m=z[0].substr(0,1).toUpperCase()+z[0].substr(1)+' GPU '+z[1];prc(a+'&rig='+r,m)}
+function prs2(a,n,r){var v=document.getElementById('gi'+n).value;var c=a.substr(3);var z=c.split('|',2);var m='Set GPU '+z[1]+' '+z[0].substr(0,1).toUpperCase()+z[0].substr(1)+' to '+v;prc(a+','+v+'&rig='+r,m)}\n";
+	if ($poolinputs === true)
+		echo "function cbs(s){var t=s.replace(/\\\\/g,'\\\\\\\\'); return t.replace(/,/g, '\\\\,')}\nfunction pla(r){var u=document.getElementById('purl').value;var w=document.getElementById('pwork').value;var p=document.getElementById('ppass').value;pr('&rig='+r+'&arg=addpool|'+cbs(u)+','+cbs(w)+','+cbs(p),'Add Pool '+u)}\nfunction psp(r){var p=document.getElementById('prio').value;pr('&rig='+r+'&arg=poolpriority|'+p,'Set Pool Priorities to '+p)}\n";
+ }
+echo "</script>\n";
+}
+?>
+<table width=100% height=100% border=0 cellpadding=0 cellspacing=0 summary='Mine'>
+<tr><td align=center valign=top>
+<table border=0 cellpadding=4 cellspacing=0 summary='Mine'>
+<?php
+ echo $mcerr;
+}
+#
+function minhead($mcerr = '')
+{
+ global $readonly;
+ $readonly = true;
+ htmlhead($mcerr, false, null, null, true);
+}
+#
+global $haderror, $error;
+$haderror = false;
+$error = null;
+#
+function mcastrigs()
+{
+ global $rigs, $mcastexpect, $mcastaddr, $mcastport, $mcastcode;
+ global $mcastlistport, $mcasttimeout, $mcastretries, $error;
+
+ $listname = "0.0.0.0";
+
+ $rigs = array();
+
+ $rep_soc = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
+ if ($rep_soc === false || $rep_soc == null)
+ {
+	$msg = "ERR: mcast listen socket create(UDP) failed";
+	if ($rigipsecurity === false)
+	{
+		$error = socket_strerror(socket_last_error());
+		$error = "$msg '$error'\n";
+	}
+	else
+		$error = "$msg\n";
+
+	return;
+ }
+
+ $res = socket_bind($rep_soc, $listname, $mcastlistport);
+ if ($res === false)
+ {
+	$msg1 = "ERR: mcast listen socket bind(";
+	$msg2 = ") failed";
+	if ($rigipsecurity === false)
+	{
+		$error = socket_strerror(socket_last_error());
+		$error = "$msg1$listname,$mcastlistport$msg2 '$error'\n";
+	}
+	else
+		$error = "$msg1$msg2\n";
+
+	socket_close($rep_soc);
+	return;
+ }
+
+ $retries = $mcastretries;
+ $doretry = ($retries > 0);
+ do
+ {
+	$mcast_soc = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
+	if ($mcast_soc === false || $mcast_soc == null)
+	{
+		$msg = "ERR: mcast send socket create(UDP) failed";
+		if ($rigipsecurity === false)
+		{
+			$error = socket_strerror(socket_last_error());
+			$error = "$msg '$error'\n";
+		}
+		else
+			$error = "$msg\n";
+
+		socket_close($rep_soc);
+		return;
+	}
+
+	$buf = "cgminer-$mcastcode-$mcastlistport";
+	socket_sendto($mcast_soc, $buf, strlen($buf), 0, $mcastaddr, $mcastport);
+	socket_close($mcast_soc);
+
+	$stt = microtime(true);
+	while (true)
+	{
+		$got = @socket_recvfrom($rep_soc, $buf, 32, MSG_DONTWAIT, $ip, $p);
+		if ($got !== false && $got > 0)
+		{
+			$ans = explode('-', $buf, 4);
+			if (count($ans) >= 3 && $ans[0] == 'cgm' && $ans[1] == 'FTW')
+			{
+				$rp = intval($ans[2]);
+
+				if (count($ans) > 3)
+					$mdes = str_replace("\0", '', $ans[3]);
+				else
+					$mdes = '';
+
+				if (strlen($mdes) > 0)
+					$rig = "$ip:$rp:$mdes";
+				else
+					$rig = "$ip:$rp";
+
+				if (!in_array($rig, $rigs))
+					$rigs[] = $rig;
+			}
+		}
+		if ((microtime(true) - $stt) >= $mcasttimeout)
+			break;
+
+		usleep(100000);
+	}
+
+	if ($mcastexpect > 0 && count($rigs) >= $mcastexpect)
+		$doretry = false;
+
+ } while ($doretry && --$retries > 0);
+
+ socket_close($rep_soc);
+}
+#
+function getrigs()
+{
+ global $rigs;
+
+ mcastrigs();
+
+ sort($rigs);
+}
+#
+function getsock($rig, $addr, $port)
+{
+ global $rigport, $rigips, $rignames, $rigipsecurity;
+ global $haderror, $error, $socksndtimeoutsec, $sockrcvtimeoutsec;
+
+ $port = trim($port);
+ if (strlen($port) == 0)
+	$port = $rigport;
+ $error = null;
+ $socket = null;
+ $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
+ if ($socket === false || $socket === null)
+ {
+	$haderror = true;
+	if ($rigipsecurity === false)
+	{
+		$error = socket_strerror(socket_last_error());
+		$msg = "socket create(TCP) failed";
+		$error = "ERR: $msg '$error'\n";
+	}
+	else
+		$error = "ERR: socket create(TCP) failed\n";
+
+	return null;
+ }
+
+ // Ignore if this fails since the socket connect may work anyway
+ //  and nothing is gained by aborting if the option cannot be set
+ //  since we don't know in advance if it can connect
+ socket_set_option($socket, SOL_SOCKET, SO_SNDTIMEO, array('sec' => $socksndtimeoutsec, 'usec' => 0));
+ socket_set_option($socket, SOL_SOCKET, SO_RCVTIMEO, array('sec' => $sockrcvtimeoutsec, 'usec' => 0));
+
+ $res = socket_connect($socket, $addr, $port);
+ if ($res === false)
+ {
+	$haderror = true;
+	if ($rigipsecurity === false)
+	{
+		$error = socket_strerror(socket_last_error());
+		$msg = "socket connect($addr,$port) failed";
+		$error = "ERR: $msg '$error'\n";
+	}
+	else
+		$error = "ERR: socket connect($rig) failed\n";
+
+	socket_close($socket);
+	return null;
+ }
+ if ($rignames !== false && !isset($rigips[$addr]))
+	if (socket_getpeername($socket, $ip) == true)
+		$rigips[$addr] = $ip;
+ return $socket;
+}
+#
+function readsockline($socket)
+{
+ $line = '';
+ while (true)
+ {
+	$byte = socket_read($socket, 1);
+	if ($byte === false || $byte === '')
+		break;
+	if ($byte === "\0")
+		break;
+	$line .= $byte;
+ }
+ return $line;
+}
+#
+function api_convert_escape($str)
+{
+ $res = '';
+ $len = strlen($str);
+ for ($i = 0; $i < $len; $i++)
+ {
+	$ch = substr($str, $i, 1);
+	if ($ch != '\\' || $i == ($len-1))
+		$res .= $ch;
+	else
+	{
+		$i++;
+		$ch = substr($str, $i, 1);
+		switch ($ch)
+		{
+		case '|':
+			$res .= "\1";
+			break;
+		case '\\':
+			$res .= "\2";
+			break;
+		case '=':
+			$res .= "\3";
+			break;
+		case ',':
+			$res .= "\4";
+			break;
+		default:
+			$res .= $ch;
+		}
+	}
+ }
+ return $res;
+}
+#
+function revert($str)
+{
+ return str_replace(array("\1", "\2", "\3", "\4"), array("|", "\\", "=", ","), $str);
+}
+#
+function api($rig, $cmd)
+{
+ global $haderror, $error;
+ global $miner, $port, $hidefields;
+ global $per_proc;
+
+ if ($per_proc)
+ {
+	$cmd = preg_replace('/^devs\b/', 'procs', $cmd);
+	$cmd = preg_replace('/^pga/', 'proc', $cmd);
+ }
+
+ $socket = getsock($rig, $miner, $port);
+ if ($socket != null)
+ {
+	socket_write($socket, $cmd, strlen($cmd));
+	$line = readsockline($socket);
+	socket_close($socket);
+
+	if (strlen($line) == 0)
+	{
+		$haderror = true;
+		$error = "WARN: '$cmd' returned nothing\n";
+		return $line;
+	}
+
+#	print "$cmd returned '$line'\n";
+
+	$line = api_convert_escape($line);
+
+	$data = array();
+
+	$objs = explode('|', $line);
+	foreach ($objs as $obj)
+	{
+		if (strlen($obj) > 0)
+		{
+			$items = explode(',', $obj);
+			$item = $items[0];
+			$id = explode('=', $items[0], 2);
+			if (count($id) == 1 or !ctype_digit($id[1]))
+				$name = $id[0];
+			else
+				$name = $id[0].$id[1];
+
+			if (strlen($name) == 0)
+				$name = 'null';
+
+			$sectionname = preg_replace('/\d/', '', $name);
+
+			if (isset($data[$name]))
+			{
+				$num = 1;
+				while (isset($data[$name.$num]))
+					$num++;
+				$name .= $num;
+			}
+
+			$counter = 0;
+			foreach ($items as $item)
+			{
+				$id = explode('=', $item, 2);
+
+				if (isset($hidefields[$sectionname.'.'.$id[0]]))
+					continue;
+
+				if (count($id) == 2)
+					$data[$name][$id[0]] = revert($id[1]);
+				else
+					$data[$name][$counter] = $id[0];
+
+				$counter++;
+			}
+		}
+	}
+	return $data;
+ }
+ return null;
+}
+#
+function getparam($name, $both = false)
+{
+ $a = null;
+ if (isset($_POST[$name]))
+	$a = $_POST[$name];
+
+ if (($both === true) and ($a === null))
+ {
+	if (isset($_GET[$name]))
+		$a = $_GET[$name];
+ }
+
+ if ($a == '' || $a == null)
+	return null;
+
+ // limit to 1K just to be safe
+ return substr($a, 0, 1024);
+}
+#
+function newtable()
+{
+ global $tablebegin, $rownum;
+ echo $tablebegin;
+ $rownum = 0;
+}
+#
+function newrow()
+{
+ echo '<tr>';
+}
+#
+function othrow($row)
+{
+ return "<tr>$row</tr>";
+}
+#
+function otherrow($row)
+{
+ echo othrow($row);
+}
+#
+function endrow()
+{
+ global $rownum;
+ echo '</tr>';
+ $rownum++;
+}
+#
+function endtable()
+{
+ global $tableend;
+ echo $tableend;
+}
+#
+function classlastshare($when, $alldata, $warnclass, $errorclass)
+{
+ global $checklastshare;
+
+ if ($checklastshare === false)
+	return '';
+
+ if ($when == 0)
+	return '';
+
+ if (!isset($alldata['MHS av']))
+	return '';
+
+ if ($alldata['MHS av'] == 0)
+	return '';
+
+ if (!isset($alldata['Last Share Time']))
+	return '';
+
+ if (!isset($alldata['Last Share Difficulty']))
+	return '';
+
+ $expected = pow(2, 32) / ($alldata['MHS av'] * pow(10, 6));
+
+ // If the share difficulty changes while waiting on a share,
+ // this calculation will of course be incorrect
+ $expected *= $alldata['Last Share Difficulty'];
+
+ $howlong = $when - $alldata['Last Share Time'];
+ if ($howlong < 1)
+	$howlong = 1;
+
+ if ($howlong > ($expected * 12))
+	return $errorclass;
+
+ if ($howlong > ($expected * 8))
+	return $warnclass;
+
+ return '';
+}
+#
+function endzero($num)
+{
+ $rep = preg_replace('/0*$/', '', $num);
+ if ($rep === '')
+	$rep = '0';
+ return $rep;
+}
+#
+function fmt($section, $name, $value, $when, $alldata)
+{
+ global $dfmt, $rownum;
+
+ if ($alldata == null)
+	$alldata = array();
+
+ $errorclass = ' class=err';
+ $warnclass = ' class=warn';
+ $lstclass = ' class=lst';
+ $hiclass = ' class=hi';
+ $loclass = ' class=lo';
+ $c2class = ' class=two';
+ $totclass = ' class=tot';
+ $b = '&nbsp;';
+
+ $ret = $value;
+ $class = '';
+
+ $nams = explode('.', $name);
+ if (count($nams) > 1)
+	$name = $nams[count($nams)-1];
+
+ if ($value === null)
+	$ret = $b;
+ else
+	switch ($section.'.'.$name)
+	{
+	case 'GPU.Last Share Time':
+	case 'PGA.Last Share Time':
+	case 'DEVS.Last Share Time':
+		if ($value == 0
+		||  (isset($alldata['Last Share Pool']) && $alldata['Last Share Pool'] == -1))
+		{
+			$ret = 'Never';
+			$class = $warnclass;
+		}
+		else
+		{
+			$ret = date('H:i:s', $value);
+			$class = classlastshare($when, $alldata, $warnclass, $errorclass);
+		}
+		break;
+	case 'GPU.Last Valid Work':
+	case 'PGA.Last Valid Work':
+	case 'DEVS.Last Valid Work':
+		if ($value == 0)
+			$ret = 'Never';
+		else
+			$ret = ($value - $when) . 's';
+		break;
+	case 'POOL.Last Share Time':
+		if ($value == 0)
+			$ret = 'Never';
+		else
+			$ret = date('H:i:s d-M', $value);
+		break;
+	case 'GPU.Last Share Pool':
+	case 'PGA.Last Share Pool':
+	case 'DEVS.Last Share Pool':
+		if ($value == -1)
+		{
+			$ret = 'None';
+			$class = $warnclass;
+		}
+		break;
+	case 'SUMMARY.Elapsed':
+	case 'STATS.Elapsed':
+		$s = $value % 60;
+		$value -= $s;
+		$value /= 60;
+		if ($value == 0)
+			$ret = $s.'s';
+		else
+		{
+			$m = $value % 60;
+			$value -= $m;
+			$value /= 60;
+			if ($value == 0)
+				$ret = sprintf("%dm$b%02ds", $m, $s);
+			else
+			{
+				$h = $value % 24;
+				$value -= $h;
+				$value /= 24;
+				if ($value == 0)
+					$ret = sprintf("%dh$b%02dm$b%02ds", $h, $m, $s);
+				else
+				{
+					if ($value == 1)
+						$days = '';
+					else
+						$days = 's';
+	
+					$ret = sprintf("%dday$days$b%02dh$b%02dm$b%02ds", $value, $h, $m, $s);
+				}
+			}
+		}
+		break;
+	case 'NOTIFY.Last Well':
+		if ($value == '0')
+		{
+			$ret = 'Never';
+			$class = $warnclass;
+		}
+		else
+			$ret = date('H:i:s', $value);
+		break;
+	case 'NOTIFY.Last Not Well':
+		if ($value == '0')
+			$ret = 'Never';
+		else
+		{
+			$ret = date('H:i:s', $value);
+			$class = $errorclass;
+		}
+		break;
+	case 'NOTIFY.Reason Not Well':
+		if ($value != 'None')
+			$class = $errorclass;
+		break;
+	case 'GPU.Utility':
+	case 'PGA.Utility':
+	case 'DEVS.Utility':
+	case 'SUMMARY.Utility':
+	case 'total.Utility':
+		$ret = $value.'/m';
+		if ($value == 0)
+			$class = $errorclass;
+		else
+			if (isset($alldata['Difficulty Accepted'])
+			&&  isset($alldata['Accepted'])
+			&&  isset($alldata['MHS av'])
+			&&  ($alldata['Difficulty Accepted'] > 0)
+			&&  ($alldata['Accepted'] > 0))
+			{
+				$expected = 60 * $alldata['MHS av'] * (pow(10, 6) / pow(2, 32));
+				if ($expected == 0)
+					$expected = 0.000001; // 1 H/s
+
+				$da = $alldata['Difficulty Accepted'];
+				$a = $alldata['Accepted'];
+				$expected /= ($da / $a);
+
+				$ratio = $value / $expected;
+				if ($ratio < 0.9)
+					$class = $loclass;
+				else
+					if ($ratio > 1.1)
+						$class = $hiclass;
+			}
+		break;
+	case 'PGA.Temperature':
+	case 'GPU.Temperature':
+	case 'DEVS.Temperature':
+		$ret = $value.'&deg;C';
+		if (!isset($alldata['GPU']))
+		{
+			if ($value == 0)
+				$ret = '&nbsp;';
+			break;
+		}
+	case 'GPU.GPU Clock':
+	case 'DEVS.GPU Clock':
+	case 'GPU.Memory Clock':
+	case 'DEVS.Memory Clock':
+	case 'GPU.GPU Voltage':
+	case 'DEVS.GPU Voltage':
+	case 'GPU.GPU Activity':
+	case 'DEVS.GPU Activity':
+		if ($value == 0)
+			$class = $warnclass;
+		break;
+	case 'GPU.Fan Percent':
+	case 'DEVS.Fan Percent':
+		if ($value == 0)
+			$class = $warnclass;
+		else
+		{
+			if ($value == 100)
+				$class = $errorclass;
+			else
+				if ($value > 85)
+					$class = $warnclass;
+		}
+		break;
+	case 'GPU.Fan Speed':
+	case 'DEVS.Fan Speed':
+		if ($value == 0)
+			$class = $warnclass;
+		else
+			if (isset($alldata['Fan Percent']))
+			{
+				$test = $alldata['Fan Percent'];
+				if ($test == 100)
+					$class = $errorclass;
+				else
+					if ($test > 85)
+						$class = $warnclass;
+			}
+		break;
+	case 'GPU.MHS av':
+	case 'PGA.MHS av':
+	case 'DEVS.MHS av':
+	case 'SUMMARY.MHS av':
+	case 'total.MHS av':
+		$parts = explode('.', $value, 2);
+		if (count($parts) == 1)
+			$dec = '';
+		else
+			$dec = '.'.$parts[1];
+		$ret = number_format((float)$parts[0]).$dec;
+
+		if ($value == 0)
+			$class = $errorclass;
+		else
+			if (isset($alldata['Difficulty Accepted'])
+			&&  isset($alldata['Accepted'])
+			&&  isset($alldata['Utility'])
+			&&  ($alldata['Difficulty Accepted'] > 0)
+			&&  ($alldata['Accepted'] > 0))
+			{
+				$expected = 60 * $value * (pow(10, 6) / pow(2, 32));
+				if ($expected == 0)
+					$expected = 0.000001; // 1 H/s
+
+				$da = $alldata['Difficulty Accepted'];
+				$a = $alldata['Accepted'];
+				$expected /= ($da / $a);
+
+				$ratio = $alldata['Utility'] / $expected;
+				if ($ratio < 0.9)
+					$class = $hiclass;
+				else
+					if ($ratio > 1.1)
+						$class = $loclass;
+			}
+		break;
+	case 'GPU.Total MH':
+	case 'PGA.Total MH':
+	case 'DEVS.Total MH':
+	case 'SUMMARY.Total MH':
+	case 'total.Total MH':
+	case 'SUMMARY.Getworks':
+	case 'POOL.Getworks':
+	case 'total.Getworks':
+	case 'GPU.Accepted':
+	case 'PGA.Accepted':
+	case 'DEVS.Accepted':
+	case 'SUMMARY.Accepted':
+	case 'POOL.Accepted':
+	case 'total.Accepted':
+	case 'GPU.Rejected':
+	case 'PGA.Rejected':
+	case 'DEVS.Rejected':
+	case 'SUMMARY.Rejected':
+	case 'POOL.Rejected':
+	case 'total.Rejected':
+	case 'SUMMARY.Local Work':
+	case 'total.Local Work':
+	case 'SUMMARY.Discarded':
+	case 'POOL.Discarded':
+	case 'total.Discarded':
+	case 'POOL.Diff1 Shares':
+	case 'total.Diff1 Shares':
+	case 'GPU.Diff1 Work':
+	case 'PGA.Diff1 Work':
+	case 'total.Diff1 Work':
+	case 'STATS.Times Sent':
+	case 'STATS.Bytes Sent':
+	case 'STATS.Net Bytes Sent':
+	case 'STATS.Times Recv':
+	case 'STATS.Bytes Recv':
+	case 'STATS.Net Bytes Recv':
+	case 'total.Times Sent':
+	case 'total.Bytes Sent':
+	case 'total.Net Bytes Sent':
+	case 'total.Times Recv':
+	case 'total.Bytes Recv':
+	case 'total.Net Bytes Recv':
+		$parts = explode('.', $value, 2);
+		if (count($parts) == 1)
+			$dec = '';
+		else
+			$dec = '.'.$parts[1];
+		$ret = number_format((float)$parts[0]).$dec;
+		break;
+	case 'STATS.Hs':
+	case 'STATS.W':
+	case 'STATS.history_time':
+	case 'STATS.Pool Wait':
+	case 'STATS.Pool Max':
+	case 'STATS.Pool Min':
+	case 'STATS.Pool Av':
+	case 'STATS.Min Diff':
+	case 'STATS.Max Diff':
+	case 'STATS.Work Diff':
+		$parts = explode('.', $value, 2);
+		if (count($parts) == 1)
+			$dec = '';
+		else
+			$dec = '.'.endzero($parts[1]);
+		$ret = number_format((float)$parts[0]).$dec;
+		break;
+	case 'GPU.Status':
+	case 'PGA.Status':
+	case 'DEVS.Status':
+	case 'POOL.Status':
+		if ($value != 'Alive')
+			$class = $errorclass;
+		break;
+	case 'GPU.Enabled':
+	case 'PGA.Enabled':
+	case 'DEVS.Enabled':
+		if ($value != 'Y')
+			$class = $warnclass;
+		break;
+	case 'STATUS.When':
+	case 'COIN.Current Block Time':
+		$ret = date($dfmt, $value);
+		break;
+	case 'BUTTON.Rig':
+	case 'BUTTON.Pool':
+	case 'BUTTON.GPU':
+		$ret = $value;
+		break;
+	case 'SUMMARY.Difficulty Accepted':
+	case 'GPU.Difficulty Accepted':
+	case 'PGA.Difficulty Accepted':
+	case 'DEVS.Difficulty Accepted':
+	case 'POOL.Difficulty Accepted':
+	case 'total.Difficulty Accepted':
+	case 'SUMMARY.Difficulty Rejected':
+	case 'GPU.Difficulty Rejected':
+	case 'PGA.Difficulty Rejected':
+	case 'DEVS.Difficulty Rejected':
+	case 'POOL.Difficulty Rejected':
+	case 'total.Difficulty Rejected':
+	case 'SUMMARY.Difficulty Stale':
+	case 'POOL.Difficulty Stale':
+	case 'total.Difficulty Stale':
+	case 'GPU.Last Share Difficulty':
+	case 'PGA.Last Share Difficulty':
+	case 'DEVS.Last Share Difficulty':
+	case 'POOL.Last Share Difficulty':
+		if ($value != '')
+			$ret = number_format((float)$value, 2);
+		break;
+	case 'DEVS.Device Hardware%':
+	case 'DEVS.Device Rejected%':
+	case 'PGA.Device Hardware%':
+	case 'PGA.Device Rejected%':
+	case 'GPU.Device Hardware%':
+	case 'GPU.Device Rejected%':
+	case 'POOL.Pool Rejected%':
+	case 'POOL.Pool Stale%':
+	case 'SUMMARY.Device Hardware%':
+	case 'SUMMARY.Device Rejected%':
+	case 'SUMMARY.Pool Rejected%':
+	case 'SUMMARY.Pool Stale%':
+		if ($value != '')
+			$ret = number_format((float)$value, 2) . '%';
+		break;
+	case 'SUMMARY.Best Share':
+		if ($value != '')
+			$ret = number_format((float)$value);
+		break;
+	}
+
+ if ($section == 'NOTIFY' && substr($name, 0, 1) == '*' && $value != '0')
+	$class = $errorclass;
+
+ if ($class == '' && $section != 'POOL')
+	$class = classlastshare($when, $alldata, $lstclass, $lstclass);
+
+ if ($class == '' && $section == 'total')
+	$class = $totclass;
+
+ if ($class == '' && ($rownum % 2) == 0)
+	$class = $c2class;
+
+ if ($ret === '')
+	$ret = $b;
+
+ return array($ret, $class);
+}
+#
+global $poolcmd;
+$poolcmd = array(	'Switch to'	=> 'switchpool',
+			'Enable'	=> 'enablepool',
+			'Disable'	=> 'disablepool',
+			'Remove'	=> 'removepool' );
+#
+function showhead($cmd, $values, $justnames = false)
+{
+ global $poolcmd, $readonly;
+
+ newrow();
+
+ foreach ($values as $name => $value)
+ {
+	if ($name == '0' or $name == '')
+		$name = '&nbsp;';
+	echo "<td valign=bottom class=h>$name</td>";
+ }
+
+ if ($justnames === false && $cmd == 'pools' && $readonly === false)
+	foreach ($poolcmd as $name => $pcmd)
+		echo "<td valign=bottom class=h>$name</td>";
+
+ endrow();
+}
+#
+function showdatetime()
+{
+ global $dfmt;
+
+ otherrow('<td class=sta>Date: '.date($dfmt).'</td>');
+}
+#
+global $singlerigsum;
+$singlerigsum = array(
+ 'devs' => array('MHS av' => 1, 'MHS rolling' => 1, 'Accepted' => 1, 'Rejected' => 1,
+                 'Temperature' => 2,
+			'Hardware Errors' => 1, 'Utility' => 1, 'Total MH' => 1),
+ 'pools' => array('Getworks' => 1, 'Accepted' => 1, 'Rejected' => 1, 'Discarded' => 1,
+			'Stale' => 1, 'Get Failures' => 1, 'Remote Failures' => 1),
+ 'notify' => array('*' => 1));
+#
+function showtotal($total, $when, $oldvalues)
+{
+ global $rigtotals;
+
+ list($showvalue, $class) = fmt('total', '', 'Total:', $when, null);
+ echo "<td$class align=right>$showvalue</td>";
+
+ $skipfirst = true;
+ foreach ($oldvalues as $name => $value)
+ {
+	if ($skipfirst === true)
+	{
+		$skipfirst = false;
+		continue;
+	}
+
+	if (isset($total[$name]))
+		$newvalue = $total[$name];
+	else
+		$newvalue = '';
+
+	list($showvalue, $class) = fmt('total', $name, $newvalue, $when, null);
+	echo "<td$class";
+	if ($rigtotals === true)
+		echo ' align=right';
+	echo ">$showvalue</td>";
+ }
+}
+#
+function details($cmd, $list, $rig)
+{
+ global $dfmt, $poolcmd, $readonly, $showndate;
+ global $rownum, $rigtotals, $forcerigtotals, $singlerigsum;
+
+ $when = 0;
+
+ $stas = array('S' => 'Success', 'W' => 'Warning', 'I' => 'Informational', 'E' => 'Error', 'F' => 'Fatal');
+
+ newtable();
+
+ if ($showndate === false)
+ {
+	showdatetime();
+
+	endtable();
+	newtable();
+
+	$showndate = true;
+ }
+
+ if (isset($list['STATUS']))
+ {
+	newrow();
+	echo '<td>Computer: '.$list['STATUS']['Description'].'</td>';
+	if (isset($list['STATUS']['When']))
+	{
+		echo '<td>When: '.date($dfmt, $list['STATUS']['When']).'</td>';
+		$when = $list['STATUS']['When'];
+	}
+	$sta = $list['STATUS']['STATUS'];
+	echo '<td>Status: '.$stas[$sta].'</td>';
+	echo '<td>Message: '.$list['STATUS']['Msg'].'</td>';
+	endrow();
+ }
+
+ if ($rigtotals === true && isset($singlerigsum[$cmd]))
+	$dototal = $singlerigsum[$cmd];
+ else
+	$dototal = array();
+ $total = array();
+
+ $section = '';
+ $oldvalues = null;
+
+ // Build a common row column for all entries
+ $columns = array();
+ $columnsByIndex = array();
+ foreach ($list as $item => $values)
+ {
+	if ($item == 'STATUS')
+		continue;
+	if (isset($values['ID']))
+	{
+		$repr = $values['Name'].$values['ID'];
+		if (isset($values['ProcID']))
+			$repr .= join_get_field('ProcID', $values);
+		$list[$item] = $values = array('Device' => $repr) + array_slice($values, 1);
+		unset($values['Name']);
+		unset($values['ID']);
+		unset($values['ProcID']);
+	}
+	$namesByIndex = array_keys($values);
+	$nameCount = count($namesByIndex);
+	for ($i = 0; $i < $nameCount; ++$i)
+	{
+		$name = $namesByIndex[$i];
+		if (isset($columns[$name]))
+			continue;
+		$value = $values[$name];
+		$before = null;
+		for ($j = $i + 1; $j < $nameCount; ++$j)
+		{
+			$maybebefore = $namesByIndex[$j];
+			if (isset($columns[$maybebefore]))
+			{
+				$before = $columns[$maybebefore];
+				break;
+			}
+		}
+		if (!$before)
+		{
+			$columns[$name] = array_push($columnsByIndex, $name) - 1;
+			continue;
+		}
+		array_splice($columnsByIndex, $before, 0, $name);
+		$columns[$name] = $before;
+		$columnCount = count($columnsByIndex);
+		for ($j = $before + 1; $j < $columnCount; ++$j)
+			$columns[$columnsByIndex[$j]] = $j;
+	}
+ }
+ asort($columns);
+ endtable();
+ newtable();
+ showhead($cmd, $columns);
+
+ foreach ($list as $item => $values)
+ {
+	if ($item == 'STATUS')
+		continue;
+
+	newrow();
+
+	foreach ($columns as $name => $columnidx)
+	{
+		if (!isset($values[$name]))
+		{
+			echo '<td></td>';
+			continue;
+		}
+		$value = $values[$name];
+
+		list($showvalue, $class) = fmt($section, $name, $value, $when, $values);
+		echo "<td$class";
+		if ($rigtotals === true)
+			echo ' align=right';
+		echo ">$showvalue</td>";
+
+		if (isset($dototal[$name])
+		||  (isset($dototal['*']) and substr($name, 0, 1) == '*'))
+		{
+			if (isset($total[$name]))
+			{
+				if (isset($dototal[$name]) && $dototal[$name] == 2)
+					$total[$name] = max($total[$name], $value);
+				else
+					$total[$name] += $value;
+			}
+			else
+				$total[$name] = $value;
+		}
+	}
+
+	if ($cmd == 'pools' && $readonly === false)
+	{
+		reset($values);
+		$pool = current($values);
+		foreach ($poolcmd as $name => $pcmd)
+		{
+			list($ignore, $class) = fmt('BUTTON', 'Pool', '', $when, $values);
+			echo "<td$class>";
+			if ($pool === false)
+				echo '&nbsp;';
+			else
+			{
+				echo "<input type=button value='Pool $pool'";
+				echo " onclick='prc(\"$pcmd|$pool&rig=$rig\",\"$name Pool $pool\")'>";
+			}
+			echo '</td>';
+		}
+	}
+	endrow();
+
+	$oldvalues = $values;
+ }
+
+ if ($oldvalues != null && count($total) > 0
+ &&  ($rownum > 2 || $forcerigtotals === true))
+	showtotal($total, $when, $columns);
+
+ endtable();
+}
+#
+global $devs;
+$devs = null;
+#
+function gpubuttons($count, $rig)
+{
+ global $devs;
+
+ $basic = array( 'GPU', 'Enable', 'Disable', 'Restart' );
+
+ $options = array(	'intensity' => 'Intensity',
+			'fan' => 'Fan Percent',
+			'engine' => 'GPU Clock',
+			'mem' => 'Memory Clock',
+			'vddc' => 'GPU Voltage' );
+
+ newtable();
+ newrow();
+
+ foreach ($basic as $head)
+	echo "<td class=h>$head</td>";
+
+ foreach ($options as $name => $des)
+	echo "<td class=h nowrap>$des</td>";
+
+ $n = 0;
+ for ($c = 0; $c < $count; $c++)
+ {
+	endrow();
+	newrow();
+
+	foreach ($basic as $name)
+	{
+		list($ignore, $class) = fmt('BUTTON', 'GPU', '', 0, null);
+		echo "<td$class>";
+
+		if ($name == 'GPU')
+			echo $c;
+		else
+		{
+			echo "<input type=button value='$name $c' onclick='prs(\"gpu";
+			echo strtolower($name);
+			echo "|$c\",$rig)'>";
+		}
+
+		echo '</td>';
+	}
+
+	foreach ($options as $name => $des)
+	{
+		list($ignore, $class) = fmt('BUTTON', 'GPU', '', 0, null);
+		echo "<td$class>";
+
+		if (!isset($devs["GPU$c"][$des]))
+			echo '&nbsp;';
+		else
+		{
+			$value = $devs["GPU$c"][$des];
+			echo "<input type=button value='Set $c:' onclick='prs2(\"gpu$name|$c\",$n,$rig)'>";
+			echo "<input size=7 type=text name=gi$n value='$value' id=gi$n>";
+			$n++;
+		}
+
+		echo '</td>';
+	}
+
+ }
+ endrow();
+ endtable();
+}
+#
+function processgpus($rig)
+{
+ global $error;
+ global $warnfont, $warnoff;
+
+ $gpus = api($rig, 'gpucount');
+
+ if ($error != null)
+	otherrow("<td>Error getting GPU count: $warnfont$error$warnoff</td>");
+ else
+ {
+	if (!isset($gpus['GPUS']['Count']))
+	{
+		$rw = '<td>No GPU count returned: '.$warnfont;
+		$rw .= $gpus['STATUS']['STATUS'].' '.$gpus['STATUS']['Msg'];
+		$rw .= $warnoff.'</td>';
+		otherrow($rw);
+	}
+	else
+	{
+		$count = $gpus['GPUS']['Count'];
+		if ($count == 0)
+			otherrow('<td>No GPUs</td>');
+		else
+			gpubuttons($count, $rig);
+	}
+ }
+}
+#
+function showpoolinputs($rig, $ans)
+{
+ global $readonly, $poolinputs;
+
+ if ($readonly === true || $poolinputs === false)
+	return;
+
+ newtable();
+ newrow();
+
+ $inps = array('Pool URL' => array('purl', 20),
+		'Worker Name' => array('pwork', 10),
+		'Worker Password' => array('ppass', 10));
+ $b = '&nbsp;';
+
+ echo "<td align=right class=h> Add a pool: </td><td>";
+
+ foreach ($inps as $text => $name)
+	echo "$text: <input name='".$name[0]."' id='".$name[0]."' value='' type=text size=".$name[1]."> ";
+
+ echo "</td><td align=middle><input type=button value='Add' onclick='pla($rig)'></td>";
+
+ endrow();
+
+ if (count($ans) > 1)
+ {
+	newrow();
+
+	echo '<td align=right class=h> Set pool priorities: </td>';
+	echo "<td> Comma list of pool numbers: <input type=text name=prio id=prio size=20>";
+	echo "</td><td align=middle><input type=button value='Set' onclick='psp($rig)'></td>";
+
+	endrow();
+ }
+ endtable();
+}
+#
+function process($cmds, $rig)
+{
+ global $error, $devs;
+ global $warnfont, $warnoff;
+
+ $count = count($cmds);
+ foreach ($cmds as $cmd => $des)
+ {
+	$process = api($rig, $cmd);
+
+	if ($error != null)
+	{
+		otherrow("<td colspan=100>Error getting $des: $warnfont$error$warnoff</td>");
+		break;
+	}
+	else
+	{
+		details($cmd, $process, $rig);
+
+		if ($cmd == 'devs')
+			$devs = $process;
+
+		if ($cmd == 'pools')
+			showpoolinputs($rig, $process);
+
+		# Not after the last one
+		if (--$count > 0)
+			otherrow('<td><br><br></td>');
+	}
+ }
+}
+#
+function rigname($rig, $rigname)
+{
+ global $rigs, $rignames, $rigips;
+
+ if (isset($rigs[$rig]))
+ {
+	$parts = explode(':', $rigs[$rig], 3);
+	if (count($parts) == 3)
+		$rigname = $parts[2];
+	else
+		if ($rignames !== false)
+		{
+			switch ($rignames)
+			{
+			case 'ip':
+				if (isset($parts[0]) && isset($rigips[$parts[0]]))
+				{
+					$ip = explode('.', $rigips[$parts[0]]);
+					if (count($ip) == 4)
+						$rigname = intval($ip[3]);
+				}
+				break;
+			case 'ipx':
+				if (isset($parts[0]) && isset($rigips[$parts[0]]))
+				{
+					$ip = explode('.', $rigips[$parts[0]]);
+					if (count($ip) == 4)
+						$rigname = intval($ip[3], 16);
+				}
+				break;
+			}
+		}
+ }
+
+ return $rigname;
+}
+#
+function riginput($rig, $rigname, $usebuttons)
+{
+ $rigname = rigname($rig, $rigname);
+
+ if ($usebuttons === true)
+	return "<input type=button value='$rigname' onclick='pr(\"&rig=$rig\",null)'>";
+ else
+	return "<a href='".php_pr("&rig=$rig")."'>$rigname</a>";
+}
+#
+function rigbutton($rig, $rigname, $when, $row, $usebuttons)
+{
+ list($value, $class) = fmt('BUTTON', 'Rig', '', $when, $row);
+
+ if ($rig === '')
+	$ri = '&nbsp;';
+ else
+	$ri = riginput($rig, $rigname, $usebuttons);
+
+ return "<td align=middle$class>$ri</td>";
+}
+#
+function showrigs($anss, $headname, $rigname)
+{
+ global $rigbuttons;
+
+ $dthead = array($headname => 1, 'STATUS' => 1, 'Description' => 1, 'When' => 1, 'API' => 1, 'CGMiner' => 1);
+ showhead('', $dthead);
+
+ foreach ($anss as $rig => $ans)
+ {
+	if ($ans == null)
+		continue;
+
+	newrow();
+
+	$when = 0;
+	if (isset($ans['STATUS']['When']))
+		$when = $ans['STATUS']['When'];
+
+	foreach ($ans as $item => $row)
+	{
+		if ($item != 'STATUS' && $item != 'VERSION')
+			continue;
+
+		foreach ($dthead as $name => $x)
+		{
+			if ($item == 'STATUS' && $name == $headname)
+				echo rigbutton($rig, $rigname.$rig, $when, null, $rigbuttons);
+			else
+			{
+				if (isset($row[$name]))
+				{
+					list($showvalue, $class) = fmt('STATUS', $name, $row[$name], $when, null);
+					echo "<td$class align=right>$showvalue</td>";
+				}
+			}
+		}
+	}
+	endrow();
+ }
+}
+#
+# $head is a hack but this is just a demo anyway :)
+function doforeach($cmd, $des, $sum, $head, $datetime)
+{
+ global $miner, $port;
+ global $error, $readonly, $notify, $rigs, $rigbuttons;
+ global $warnfont, $warnoff, $dfmt;
+ global $rigerror;
+
+ $when = 0;
+
+ $header = $head;
+ $anss = array();
+
+ $count = 0;
+ $preverr = count($rigerror);
+ foreach ($rigs as $num => $rig)
+ {
+	$anss[$num] = null;
+
+	if (isset($rigerror[$rig]))
+		continue;
+
+	$parts = explode(':', $rig, 3);
+	if (count($parts) >= 1)
+	{
+		$miner = $parts[0];
+		if (count($parts) >= 2)
+			$port = $parts[1];
+		else
+			$port = '';
+
+		if (count($parts) > 2)
+			$name = $parts[2];
+		else
+			$name = $num;
+
+		$ans = api($name, $cmd);
+
+		if ($error != null)
+		{
+			$rw = "<td colspan=100>Error on rig $name getting ";
+			$rw .= "$des: $warnfont$error$warnoff</td>";
+			otherrow($rw);
+			$rigerror[$rig] = $error;
+			$error = null;
+		}
+		else
+		{
+			$anss[$num] = $ans;
+			$count++;
+		}
+	}
+ }
+
+ if ($count == 0)
+ {
+	$rw = '<td>Failed to access any rigs successfully';
+	if ($preverr > 0)
+		$rw .= ' (or rigs had previous errors)';
+	$rw .= '</td>';
+	otherrow($rw);
+	return;
+ }
+
+ if ($datetime)
+ {
+	showdatetime();
+	endtable();
+	newtable();
+	showrigs($anss, '', 'Rig ');
+	endtable();
+	otherrow('<td><br><br></td>');
+	newtable();
+
+	return;
+ }
+
+ $total = array();
+
+ foreach ($anss as $rig => $ans)
+ {
+	if ($ans == null)
+		continue;
+
+	foreach ($ans as $item => $row)
+	{
+		if ($item == 'STATUS')
+			continue;
+
+		if (count($row) > count($header))
+		{
+			$header = $head;
+			foreach ($row as $name => $value)
+				if (!isset($header[$name]))
+					$header[$name] = '';
+		}
+
+		if ($sum != null)
+			foreach ($sum as $name)
+			{
+				if (isset($row[$name]))
+				{
+					if (isset($total[$name]))
+						$total[$name] += $row[$name];
+					else
+						$total[$name] = $row[$name];
+				}
+			}
+	}
+ }
+
+ if ($sum != null)
+	$anss['total']['total'] = $total;
+
+ showhead('', $header);
+
+ foreach ($anss as $rig => $ans)
+ {
+	if ($ans == null)
+		continue;
+
+	$when = 0;
+	if (isset($ans['STATUS']['When']))
+		$when = $ans['STATUS']['When'];
+
+	foreach ($ans as $item => $row)
+	{
+		if ($item == 'STATUS')
+			continue;
+
+		newrow();
+
+		$section = preg_replace('/\d/', '', $item);
+
+		foreach ($header as $name => $x)
+		{
+			if ($name == '')
+			{
+				if ($rig === 'total')
+				{
+					list($ignore, $class) = fmt($rig, '', '', $when, $row);
+					echo "<td align=right$class>Total:</td>";
+				}
+				else
+					echo rigbutton($rig, "Rig $rig", $when, $row, $rigbuttons);
+			}
+			else
+			{
+				if (isset($row[$name]))
+					$value = $row[$name];
+				else
+					$value = null;
+
+				list($showvalue, $class) = fmt($section, $name, $value, $when, $row);
+				echo "<td$class align=right>$showvalue</td>";
+			}
+		}
+		endrow();
+	}
+ }
+}
+#
+function refreshbuttons()
+{
+ global $ignorerefresh, $changerefresh, $autorefresh;
+
+ if ($ignorerefresh == false && $changerefresh == true)
+ {
+	echo '&nbsp;&nbsp;&nbsp;&nbsp;';
+	echo "<input type=button value='Auto Refresh:' onclick='prr(true)'>";
+	echo "<input type=text name='refval' id='refval' size=2 value='$autorefresh'>";
+	echo "<input type=button value='Off' onclick='prr(false)'>";
+ }
+}
+#
+function pagebuttons($rig, $pg)
+{
+ global $readonly, $rigs, $rigbuttons, $userlist, $ses;
+ global $allowcustompages, $customsummarypages;
+
+ if ($rig === null)
+ {
+	$prev = null;
+	$next = null;
+
+	if ($pg === null)
+		$refresh = '';
+	else
+		$refresh = "&pg=$pg";
+ }
+ else
+ {
+	switch (count($rigs))
+	{
+	case 0:
+	case 1:
+		$prev = null;
+		$next = null;
+		break;
+	case 2:
+		$prev = null;
+		$next = ($rig + 1) % count($rigs);
+		break;
+	default:
+		$prev = ($rig - 1) % count($rigs);
+		$next = ($rig + 1) % count($rigs);
+		break;
+	}
+
+	$refresh = "&rig=$rig";
+ }
+
+ echo '<tr><td><table cellpadding=0 cellspacing=0 border=0><tr><td nowrap>';
+ if ($userlist === null || isset($_SESSION[$ses]))
+ {
+	if ($prev !== null)
+		echo riginput($prev, 'Prev', true).'&nbsp;';
+
+	echo "<input type=button value='Refresh' onclick='pr(\"$refresh\",null)'>&nbsp;";
+
+	if ($next !== null)
+		echo riginput($next, 'Next', true).'&nbsp;';
+	echo '&nbsp;';
+	if (count($rigs) > 1)
+		echo "<input type=button value='Summary' onclick='pr(\"\",null)'>&nbsp;";
+ }
+
+ if ($allowcustompages === true)
+ {
+	if ($userlist === null || isset($_SESSION[$ses]))
+		$list = $customsummarypages;
+	else
+	{
+		if ($userlist !== null && isset($userlist['def']))
+			$list = array_flip($userlist['def']);
+		else
+			$list = array();
+	}
+
+	foreach ($list as $pagename => $data)
+		echo "<input type=button value='$pagename' onclick='pr(\"&pg=$pagename\",null)'>&nbsp;";
+ }
+
+ echo '</td><td width=100%>&nbsp;</td><td nowrap>';
+ if ($rig !== null && $readonly === false)
+ {
+	$rg = '';
+	if (count($rigs) > 1)
+		$rg = " Rig $rig";
+	echo "<input type=button value='Restart' onclick='prc(\"restart&rig=$rig\",\"Restart BFGMiner$rg\")'>";
+	echo "&nbsp;<input type=button value='Quit' onclick='prc(\"quit&rig=$rig\",\"Quit BFGMiner$rg\")'>";
+ }
+ refreshbuttons();
+ if (isset($_SESSION[$ses]))
+	echo "&nbsp;<input type=button value='Logout' onclick='pr(\"&logout=1\",null)'>";
+ else
+	if ($userlist !== null)
+		echo "&nbsp;<input type=button value='Login' onclick='pr(\"&login=1\",null)'>";
+
+ echo "</td></tr></table></td></tr>";
+}
+#
+function doOne($rig, $preprocess)
+{
+ global $haderror, $readonly, $notify, $rigs;
+ global $placebuttons;
+
+ if ($placebuttons == 'top' || $placebuttons == 'both')
+	pagebuttons($rig, null);
+
+ if ($preprocess != null)
+	process(array($preprocess => $preprocess), $rig);
+
+ $cmds = array(	'devs'    => 'device list',
+		'summary' => 'summary information',
+		'pools'   => 'pool list');
+
+ if ($notify)
+	$cmds['notify'] = 'device status';
+
+ $cmds['config'] = 'BFGMiner config';
+
+ process($cmds, $rig);
+
+ if ($haderror == false && $readonly === false)
+	processgpus($rig);
+
+ if ($placebuttons == 'bot' || $placebuttons == 'both')
+	pagebuttons($rig, null);
+}
+#
+global $sectionmap;
+# map sections to their api command
+# DEVS is a special case that will match GPU or PGA
+# so you can have a single table with both in it
+# DATE is hard coded so not in here
+$sectionmap = array(
+	'RIGS' => 'version',
+	'SUMMARY' => 'summary',
+	'POOL' => 'pools',
+	'DEVS' => 'devs',
+	'GPU' => 'devs',	// You would normally use DEVS
+	'PGA' => 'devs',	// You would normally use DEVS
+	'NOTIFY' => 'notify',
+	'DEVDETAILS' => 'devdetails',
+	'STATS' => 'stats',
+	'CONFIG' => 'config',
+	'COIN' => 'coin');
+#
+function joinfields($section1, $section2, $join, $results)
+{
+ global $sectionmap;
+
+ $name1 = $sectionmap[$section1];
+ $name2 = $sectionmap[$section2];
+ $newres = array();
+
+ // foreach rig in section1
+ foreach ($results[$name1] as $rig => $result)
+ {
+	$status = null;
+
+	// foreach answer section in the rig api call
+	foreach ($result as $name1b => $fields1b)
+	{
+		if ($name1b == 'STATUS')
+		{
+			// remember the STATUS from section1
+			$status = $result[$name1b];
+			continue;
+		}
+
+		// foreach answer section in the rig api call (for the other api command)
+		foreach ($results[$name2][$rig] as $name2b => $fields2b)
+		{
+			if ($name2b == 'STATUS')
+				continue;
+
+			// If match the same field values of fields in $join
+			$match = true;
+			foreach ($join as $field)
+				if ($fields1b[$field] != $fields2b[$field])
+				{
+					$match = false;
+					break;
+				}
+
+			if ($match === true)
+			{
+				if ($status != null)
+				{
+					$newres[$rig]['STATUS'] = $status;
+					$status = null;
+				}
+
+				$subsection = $section1.'+'.$section2;
+				$subsection .= preg_replace('/[^0-9]/', '', $name1b.$name2b);
+
+				foreach ($fields1b as $nam => $val)
+					$newres[$rig][$subsection]["$section1.$nam"] = $val;
+				foreach ($fields2b as $nam => $val)
+					$newres[$rig][$subsection]["$section2.$nam"] = $val;
+			}
+		}
+	}
+ }
+ return $newres;
+}
+#
+function join_get_field($field, $fields)
+{
+	// : means a string constant otherwise it's a field name
+	// ProcID field name is converted to a lowercase letter
+	if (substr($field, 0, 1) == ':')
+		return substr($field, 1);
+	else
+	if ($field == 'ProcID')
+		return chr(97 + $fields[$field]);
+	else
+		return $fields[$field];
+}
+#
+function joinlr($section1, $section2, $join, $results)
+{
+ global $sectionmap;
+
+ $name1 = $sectionmap[$section1];
+ $name2 = $sectionmap[$section2];
+ $newres = array();
+
+ // foreach rig in section1
+ foreach ($results[$name1] as $rig => $result)
+ {
+	$status = null;
+
+	// foreach answer section in the rig api call
+	foreach ($result as $name1b => $fields1b)
+	{
+		if ($name1b == 'STATUS')
+		{
+			// remember the STATUS from section1
+			$status = $result[$name1b];
+			continue;
+		}
+
+		// Build L string to be matched
+		$Lval = '';
+		foreach ($join['L'] as $field)
+			$Lval .= join_get_field($field, $fields1b);
+
+		// foreach answer section in the rig api call (for the other api command)
+		foreach ($results[$name2][$rig] as $name2b => $fields2b)
+		{
+			if ($name2b == 'STATUS')
+				continue;
+
+			// Build R string and compare
+			$Rval = '';
+			foreach ($join['R'] as $field)
+				$Rval .= join_get_field($field, $fields2b);
+
+			if ($Lval === $Rval)
+			{
+				if ($status != null)
+				{
+					$newres[$rig]['STATUS'] = $status;
+					$status = null;
+				}
+
+				$subsection = $section1.'+'.$section2;
+				$subsection .= preg_replace('/[^0-9]/', '', $name1b.$name2b);
+
+				foreach ($fields1b as $nam => $val)
+					$newres[$rig][$subsection]["$section1.$nam"] = $val;
+				foreach ($fields2b as $nam => $val)
+					$newres[$rig][$subsection]["$section2.$nam"] = $val;
+			}
+		}
+	}
+ }
+ return $newres;
+}
+#
+function joinall($section1, $section2, $results)
+{
+ global $sectionmap;
+
+ $name1 = $sectionmap[$section1];
+ $name2 = $sectionmap[$section2];
+ $newres = array();
+
+ // foreach rig in section1
+ foreach ($results[$name1] as $rig => $result)
+ {
+	// foreach answer section in the rig api call
+	foreach ($result as $name1b => $fields1b)
+	{
+		if ($name1b == 'STATUS')
+		{
+			// copy the STATUS from section1
+			$newres[$rig][$name1b] = $result[$name1b];
+			continue;
+		}
+
+		// foreach answer section in the rig api call (for the other api command)
+		foreach ($results[$name2][$rig] as $name2b => $fields2b)
+		{
+			if ($name2b == 'STATUS')
+				continue;
+
+			$subsection = $section1.'+'.$section2;
+			$subsection .= preg_replace('/[^0-9]/', '', $name1b.$name2b);
+
+			foreach ($fields1b as $nam => $val)
+				$newres[$rig][$subsection]["$section1.$nam"] = $val;
+			foreach ($fields2b as $nam => $val)
+				$newres[$rig][$subsection]["$section2.$nam"] = $val;
+		}
+	}
+ }
+ return $newres;
+}
+#
+function joinsections($sections, $results, $errors)
+{
+ global $sectionmap;
+
+ // GPU's don't have Name,ID,ProcID fields - so create them
+ foreach ($results as $section => $res)
+	foreach ($res as $rig => $result)
+		foreach ($result as $name => $fields)
+		{
+			$subname = preg_replace('/[0-9]/', '', $name);
+			if ($subname == 'GPU' and isset($result[$name]['GPU']))
+			{
+				$results[$section][$rig][$name]['Name'] = 'GPU';
+				$results[$section][$rig][$name]['ID'] = $result[$name]['GPU'];
+				$results[$section][$rig][$name]['ProcID'] = 0;
+			}
+		}
+
+ foreach ($sections as $section => $fields)
+	if ($section != 'DATE' && !isset($sectionmap[$section]))
+	{
+		$both = explode('+', $section, 2);
+		if (count($both) > 1)
+		{
+			switch($both[0])
+			{
+			case 'SUMMARY':
+				switch($both[1])
+				{
+				case 'POOL':
+				case 'DEVS':
+				case 'CONFIG':
+				case 'COIN':
+					$sectionmap[$section] = $section;
+					$results[$section] = joinall($both[0], $both[1], $results);
+					break;
+				default:
+					$errors[] = "Error: Invalid section '$section'";
+					break;
+				}
+				break;
+			case 'DEVS':
+				switch($both[1])
+				{
+				case 'NOTIFY':
+				case 'DEVDETAILS':
+				case 'USBSTATS':
+					$join = array('Name', 'ID', 'ProcID');
+					$sectionmap[$section] = $section;
+					$results[$section] = joinfields($both[0], $both[1], $join, $results);
+					break;
+				case 'STATS':
+					$join = array('L' => array('Name','ID','ProcID'), 'R' => array('ID'));
+					$sectionmap[$section] = $section;
+					$results[$section] = joinlr($both[0], $both[1], $join, $results);
+					break;
+				default:
+					$errors[] = "Error: Invalid section '$section'";
+					break;
+				}
+				break;
+			case 'POOL':
+				switch($both[1])
+				{
+				case 'STATS':
+					$join = array('L' => array(':POOL','POOL'), 'R' => array('ID'));
+					$sectionmap[$section] = $section;
+					$results[$section] = joinlr($both[0], $both[1], $join, $results);
+					break;
+				default:
+					$errors[] = "Error: Invalid section '$section'";
+					break;
+				}
+				break;
+			default:
+				$errors[] = "Error: Invalid section '$section'";
+				break;
+			}
+		}
+		else
+			$errors[] = "Error: Invalid section '$section'";
+	}
+
+ return array($results, $errors);
+}
+#
+function secmatch($section, $field)
+{
+ if ($section == $field)
+	return true;
+
+ if ($section == 'DEVS'
+ &&  ($field == 'GPU' || $field == 'PGA'))
+	return true;
+
+ return false;
+}
+#
+function customset($showfields, $sum, $section, $rig, $isbutton, $result, $total)
+{
+ global $rigbuttons;
+
+ foreach ($result as $sec => $row)
+ {
+	$secname = preg_replace('/\d/', '', $sec);
+
+	if ($sec != 'total')
+		if (!secmatch($section, $secname))
+			continue;
+
+	newrow();
+
+	$when = 0;
+	if (isset($result['STATUS']['When']))
+		$when = $result['STATUS']['When'];
+
+
+	if ($isbutton)
+		echo rigbutton($rig, $rig, $when, $row, $rigbuttons);
+	else
+	{
+		list($ignore, $class) = fmt('total', '', '', $when, $row);
+		echo "<td align=middle$class>$rig</td>";
+	}
+
+	foreach ($showfields as $name => $one)
+	{
+		if (isset($row[$name]))
+		{
+			$value = $row[$name];
+
+			if (isset($sum[$section][$name]))
+			{
+				if (isset($total[$name]))
+					$total[$name] += $value;
+				else
+					$total[$name] = $value;
+			}
+		}
+		else
+		{
+			if ($sec == 'total' && isset($total[$name]))
+				$value = $total[$name];
+			else
+				$value = null;
+		}
+
+		if (strpos($secname, '+') === false)
+			list($showvalue, $class) = fmt($secname, $name, $value, $when, $row);
+		else
+		{
+			$parts = explode('.', $name, 2);
+			list($showvalue, $class) = fmt($parts[0], $parts[1], $value, $when, $row);
+		}
+
+		echo "<td$class align=right>$showvalue</td>";
+	}
+	endrow();
+ }
+ return $total;
+}
+#
+function docalc($func, $data)
+{
+ switch ($func)
+ {
+ case 'sum':
+	$tot = 0;
+	foreach ($data as $val)
+		$tot += $val;
+	return $tot;
+ case 'avg':
+	$tot = 0;
+	foreach ($data as $val)
+		$tot += $val;
+	return ($tot / count($data));
+ case 'min':
+	$ans = null;
+	foreach ($data as $val)
+		if ($ans === null)
+			$ans = $val;
+		else
+			if ($val < $ans)
+				$ans = $val;
+	return $ans;
+ case 'max':
+	$ans = null;
+	foreach ($data as $val)
+		if ($ans === null)
+			$ans = $val;
+		else
+			if ($val > $ans)
+				$ans = $val;
+	return $ans;
+ case 'lo':
+	$ans = null;
+	foreach ($data as $val)
+		if ($ans === null)
+			$ans = $val;
+		else
+			if (strcasecmp($val, $ans) < 0)
+				$ans = $val;
+	return $ans;
+ case 'hi':
+	$ans = null;
+	foreach ($data as $val)
+		if ($ans === null)
+			$ans = $val;
+		else
+			if (strcasecmp($val, $ans) > 0)
+				$ans = $val;
+	return $ans;
+ case 'count':
+	return count($data);
+ case 'any':
+ default:
+	return $data[0];
+ }
+}
+#
+function docompare($row, $test)
+{
+ // invalid $test data means true
+ if (count($test) < 2)
+	return true;
+
+ if (isset($row[$test[0]]))
+	$val = $row[$test[0]];
+ else
+	$val = null;
+
+ if ($test[1] == 'set')
+	return ($val !== null);
+
+ if ($val === null || count($test) < 3)
+	return true;
+
+ switch($test[1])
+ {
+ case '=':
+	return ($val == $test[2]);
+ case '<':
+	return ($val < $test[2]);
+ case '<=':
+	return ($val <= $test[2]);
+ case '>':
+	return ($val > $test[2]);
+ case '>=':
+	return ($val >= $test[2]);
+ case 'eq':
+	return (strcasecmp($val, $test[2]) == 0);
+ case 'lt':
+	return (strcasecmp($val, $test[2]) < 0);
+ case 'le':
+	return (strcasecmp($val, $test[2]) <= 0);
+ case 'gt':
+	return (strcasecmp($val, $test[2]) > 0);
+ case 'ge':
+	return (strcasecmp($val, $test[2]) >= 0);
+ default:
+	return true;
+ }
+}
+#
+function processcompare($which, $ext, $section, $res)
+{
+ if (isset($ext[$section][$which]))
+ {
+	$proc = $ext[$section][$which];
+	if ($proc !== null)
+	{
+		$res2 = array();
+		foreach ($res as $rig => $result)
+			foreach ($result as $sec => $row)
+			{
+				$secname = preg_replace('/\d/', '', $sec);
+				if (!secmatch($section, $secname))
+					$res2[$rig][$sec] = $row;
+				else
+				{
+					$keep = true;
+					foreach ($proc as $test)
+						if (!docompare($row, $test))
+						{
+							$keep = false;
+							break;
+						}
+					if ($keep)
+						$res2[$rig][$sec] = $row;
+				}
+			}
+
+		$res = $res2;
+	}
+ }
+ return $res;
+}
+#
+function ss($a, $b)
+{
+ $la = strlen($a);
+ $lb = strlen($b);
+ if ($la != $lb)
+	return $lb - $la;
+ return strcmp($a, $b);
+}
+#
+function genfld($row, $calc)
+{
+ uksort($row, "ss");
+
+ foreach ($row as $name => $value)
+	if (strstr($calc, $name) !== FALSE)
+		$calc = str_replace($name, $value, $calc);
+
+ eval("\$val = $calc;");
+
+ return $val;
+}
+#
+function dogen($ext, $section, &$res, &$fields)
+{
+ $gen = $ext[$section]['gen'];
+
+ foreach ($gen as $fld => $calc)
+	$fields[] = "GEN.$fld";
+
+ foreach ($res as $rig => $result)
+	foreach ($result as $sec => $row)
+	{
+		$secname = preg_replace('/\d/', '', $sec);
+		if (secmatch($section, $secname))
+			foreach ($gen as $fld => $calc)
+			{
+				$name = "GEN.$fld";
+
+				$val = genfld($row, $calc);
+
+				$res[$rig][$sec][$name] = $val;
+			}
+	}
+}
+#
+function processext($ext, $section, $res, &$fields)
+{
+ global $allowgen;
+
+ $res = processcompare('where', $ext, $section, $res);
+
+ if (isset($ext[$section]['group']))
+ {
+	$grp = $ext[$section]['group'];
+	$calc = $ext[$section]['calc'];
+	if ($grp !== null)
+	{
+		$interim = array();
+		$res2 = array();
+		$cou = 0;
+		foreach ($res as $rig => $result)
+			foreach ($result as $sec => $row)
+			{
+				$secname = preg_replace('/\d/', '', $sec);
+				if (!secmatch($section, $secname))
+				{
+					// STATUS may be problematic ...
+					if (!isset($res2[$sec]))
+						$res2[$sec] = $row;
+				}
+				else
+				{
+					$grpkey = '';
+					$newrow = array();
+					foreach ($grp as $field)
+					{
+						if (isset($row[$field]))
+						{
+							$grpkey .= $row[$field].'.';
+							$newrow[$field] = $row[$field];
+						}
+						else
+							$grpkey .= '.';
+					}
+
+					if (!isset($interim[$grpkey]))
+					{
+						$interim[$grpkey]['grp'] = $newrow;
+						$interim[$grpkey]['sec'] = $secname.$cou;
+						$cou++;
+					}
+
+					if ($calc !== null)
+						foreach ($calc as $field => $func)
+						{
+							if (!isset($interim[$grpkey]['cal'][$field]))
+								$interim[$grpkey]['cal'][$field] = array();
+							$interim[$grpkey]['cal'][$field][] = $row[$field];
+						}
+				}
+			}
+
+		// Build the rest of $res2 from $interim
+		foreach ($interim as $rowkey => $row)
+		{
+			$key = $row['sec'];
+			foreach ($row['grp'] as $field => $value)
+				$res2[$key][$field] = $value;
+			foreach ($row['cal'] as $field => $data)
+				$res2[$key][$field] = docalc($calc[$field], $data);
+		}
+
+		$res = array('' => $res2);
+	}
+ }
+
+ // Generated fields (functions of other fields)
+ if ($allowgen === true && isset($ext[$section]['gen']))
+	dogen($ext, $section, $res, $fields);
+
+ return processcompare('having', $ext, $section, $res);
+}
+#
+function processcustompage($pagename, $sections, $sum, $ext, $namemap)
+{
+ global $sectionmap;
+ global $miner, $port;
+ global $rigs, $error;
+ global $warnfont, $warnoff;
+ global $dfmt;
+ global $readonly, $showndate;
+
+ $cmds = array();
+ $errors = array();
+ foreach ($sections as $section => $fields)
+ {
+	$all = explode('+', $section);
+	foreach ($all as $section)
+	{
+		if (isset($sectionmap[$section]))
+		{
+			$cmd = $sectionmap[$section];
+			if (!isset($cmds[$cmd]))
+				$cmds[$cmd] = 1;
+		}
+		else
+			if ($section != 'DATE')
+				$errors[] = "Error: unknown section '$section' in custom summary page '$pagename'";
+	}
+ }
+
+ $results = array();
+ foreach ($rigs as $num => $rig)
+ {
+	$parts = explode(':', $rig, 3);
+	if (count($parts) >= 1)
+	{
+		$miner = $parts[0];
+		if (count($parts) >= 2)
+			$port = $parts[1];
+		else
+			$port = '';
+
+		if (count($parts) > 2)
+			$name = $parts[2];
+		else
+			$name = $rig;
+
+		foreach ($cmds as $cmd => $one)
+		{
+			$process = api($name, $cmd);
+
+			if ($error != null)
+			{
+				$errors[] = "Error getting $cmd for $name $warnfont$error$warnoff";
+				break;
+			}
+			else
+				$results[$cmd][$num] = $process;
+		}
+	}
+	else
+		otherrow('<td class=bad>Bad "$rigs" array</td>');
+ }
+
+ $shownsomething = false;
+ if (count($results) > 0)
+ {
+	list($results, $errors) = joinsections($sections, $results, $errors);
+	$first = true;
+	foreach ($sections as $section => $fields)
+	{
+		if ($section === 'DATE')
+		{
+			if ($shownsomething)
+				otherrow('<td>&nbsp;</td>');
+
+			newtable();
+			showdatetime();
+			endtable();
+			// On top of the next table
+			$shownsomething = false;
+			continue;
+		}
+
+		if ($section === 'RIGS')
+		{
+			if ($shownsomething)
+				otherrow('<td>&nbsp;</td>');
+
+			newtable();
+			showrigs($results['version'], 'Rig', '');
+			endtable();
+			$shownsomething = true;
+			continue;
+		}
+
+		if (isset($results[$sectionmap[$section]]))
+		{
+			$rigresults = processext($ext, $section, $results[$sectionmap[$section]], $fields);
+
+			$showfields = array();
+			$showhead = array();
+			foreach ($fields as $field)
+				foreach ($rigresults as $result)
+					foreach ($result as $sec => $row)
+					{
+						$secname = preg_replace('/\d/', '', $sec);
+						if (secmatch($section, $secname))
+						{
+							if ($field === '*')
+							{
+								foreach ($row as $f => $v)
+								{
+									$showfields[$f] = 1;
+									$map = $section.'.'.$f;
+									if (isset($namemap[$map]))
+										$showhead[$namemap[$map]] = 1;
+									else
+										$showhead[$f] = 1;
+								}
+							}
+							elseif (isset($row[$field]))
+							{
+								$showfields[$field] = 1;
+								$map = $section.'.'.$field;
+								if (isset($namemap[$map]))
+									$showhead[$namemap[$map]] = 1;
+								else
+									$showhead[$field] = 1;
+							}
+						}
+					}
+
+			if (count($showfields) > 0)
+			{
+				if ($shownsomething)
+					otherrow('<td>&nbsp;</td>');
+
+				newtable();
+				if (count($rigresults) == 1 && isset($rigresults['']))
+					$ri = array('' => 1) + $showhead;
+				else
+					$ri = array('Rig' => 1) + $showhead;
+				showhead('', $ri, true);
+
+				$total = array();
+				$add = array('total' => array());
+
+				foreach ($rigresults as $num => $result)
+					$total = customset($showfields, $sum, $section, $num, true, $result, $total);
+
+				if (count($total) > 0)
+					customset($showfields, $sum, $section, '&Sigma;', false, $add, $total);
+
+				$first = false;
+
+				endtable();
+				$shownsomething = true;
+			}
+		}
+	}
+ }
+
+ if (count($errors) > 0)
+ {
+	if (count($results) > 0)
+		otherrow('<td>&nbsp;</td>');
+
+	foreach ($errors as $err)
+		otherrow("<td colspan=100>$err</td>");
+ }
+}
+#
+function showcustompage($pagename)
+{
+ global $customsummarypages;
+ global $placebuttons;
+
+ if ($placebuttons == 'top' || $placebuttons == 'both')
+	pagebuttons(null, $pagename);
+
+ if (!isset($customsummarypages[$pagename]))
+ {
+	otherrow("<td colspan=100 class=bad>Unknown custom summary page '$pagename'</td>");
+	return;
+ }
+
+ $c = count($customsummarypages[$pagename]);
+ if ($c < 2 || $c > 3)
+ {
+	$rw = "<td colspan=100 class=bad>Invalid custom summary page '$pagename' (";
+	$rw .= count($customsummarypages[$pagename]).')</td>';
+	otherrow($rw);
+	return;
+ }
+
+ $page = $customsummarypages[$pagename][0];
+ $namemap = array();
+ foreach ($page as $name => $fields)
+ {
+	if ($fields === null)
+		$page[$name] = array();
+	else
+		foreach ($fields as $num => $field)
+		{
+			$pos = strpos($field, '=');
+			if ($pos !== false)
+			{
+				$names = explode('=', $field, 2);
+				if (strlen($names[1]) > 0)
+					$namemap[$name.'.'.$names[0]] = $names[1];
+				$page[$name][$num] = $names[0];
+			}
+		}
+ }
+
+ $ext = null;
+ if (isset($customsummarypages[$pagename][2]))
+	$ext = $customsummarypages[$pagename][2];
+
+ $sum = $customsummarypages[$pagename][1];
+ if ($sum === null)
+	$sum = array();
+
+ // convert them to searchable via isset()
+ foreach ($sum as $section => $fields)
+ {
+	$newfields = array();
+	foreach ($fields as $field)
+		$newfields[$field] = 1;
+	$sum[$section] = $newfields;
+ }
+
+ if (count($page) <= 1)
+ {
+	otherrow("<td colspan=100 class=bad>Invalid custom summary page '$pagename' no content </td>");
+	return;
+ }
+
+ processcustompage($pagename, $page, $sum, $ext, $namemap);
+
+ if ($placebuttons == 'bot' || $placebuttons == 'both')
+	pagebuttons(null, $pagename);
+}
+#
+function onlylogin()
+{
+ global $here;
+
+ htmlhead('', false, null, null, true);
+
+?>
+<tr height=15%><td>&nbsp;</td></tr>
+<tr><td>
+ <center>
+  <table width=384 height=368 cellpadding=0 cellspacing=0 border=0>
+   <tr><td>
+    <table width=100% height=100% border=0 align=center cellpadding=5 cellspacing=0>
+     <tr><td><form action='<?php echo $here; ?>' method=post>
+      <table width=200 border=0 align=center cellpadding=5 cellspacing=0>
+       <tr><td height=120 colspan=2>&nbsp;</td></tr>
+       <tr><td colspan=2 align=center valign=middle>
+        <h2>LOGIN</h2></td></tr>
+       <tr><td align=center valign=middle><div align=right>Username:</div></td>
+        <td height=33 align=center valign=middle>
+        <input type=text name=rut size=18></td></tr>
+       <tr><td align=center valign=middle><div align=right>Password:</div></td>
+        <td height=33 align=center valign=middle>
+        <input type=password name=roh size=18></td></tr>
+       <tr valign=top><td></td><td><input type=submit value=Login>
+        </td></tr>
+      </table></form></td></tr>
+    </table></td></tr>
+  </table></center>
+</td></tr>
+<?php
+}
+#
+function checklogin()
+{
+ global $allowcustompages, $customsummarypages;
+ global $readonly, $userlist, $ses;
+
+ $out = trim(getparam('logout', true));
+ if ($out !== null && $out !== '' && isset($_SESSION[$ses]))
+	unset($_SESSION[$ses]);
+
+ $login = trim(getparam('login', true));
+ if ($login !== null && $login !== '')
+ {
+	if (isset($_SESSION[$ses]))
+		unset($_SESSION[$ses]);
+
+	onlylogin();
+	return 'login';
+ }
+
+ if ($userlist === null)
+	return false;
+
+ $rut = trim(getparam('rut', true));
+ $roh = trim(getparam('roh', true));
+
+ if (($rut !== null && $rut !== '') || ($roh !== null && $roh !== ''))
+ {
+	if (isset($_SESSION[$ses]))
+		unset($_SESSION[$ses]);
+
+	if ($rut !== null && $rut !== '' && $roh !== null && $roh !== '')
+	{
+		if (isset($userlist['sys']) && isset($userlist['sys'][$rut])
+		&&  ($userlist['sys'][$rut] === $roh))
+		{
+			$_SESSION[$ses] = true;
+			return false;
+		}
+
+		if (isset($userlist['usr']) && isset($userlist['usr'][$rut])
+		&&  ($userlist['usr'][$rut] === $roh))
+		{
+			$_SESSION[$ses] = false;
+			$readonly = true;
+			return false;
+		}
+	}
+ }
+
+ if (isset($_SESSION[$ses]))
+ {
+	if ($_SESSION[$ses] == false)
+		$readonly = true;
+	return false;
+ }
+
+ if (isset($userlist['def']) && $allowcustompages === true)
+ {
+	// Ensure at least one exists
+	foreach ($userlist['def'] as $pg)
+		if (isset($customsummarypages[$pg]))
+			return true;
+ }
+
+ onlylogin();
+ return 'login';
+}
+#
+function display()
+{
+ global $miner, $port;
+ global $mcast, $mcastexpect;
+ global $readonly, $notify, $rigs;
+ global $ignorerefresh, $autorefresh;
+ global $allowcustompages, $customsummarypages;
+ global $placebuttons;
+ global $userlist, $ses;
+
+ $pagesonly = checklogin();
+
+ if ($pagesonly === 'login')
+	return;
+
+ $mcerr = '';
+
+ if ($rigs == null or count($rigs) == 0)
+ {
+	if ($mcast === true)
+		$action = 'found';
+	else
+		$action = 'defined';
+
+	minhead();
+	otherrow("<td class=bad>No rigs $action</td>");
+	return;
+ }
+ else
+ {
+	if ($mcast === true && count($rigs) < $mcastexpect)
+		$mcerr = othrow('<td class=bad>Found '.count($rigs)." rigs but expected at least $mcastexpect</td>");
+ }
+
+ if ($ignorerefresh == false)
+ {
+	$ref = trim(getparam('ref', true));
+	if ($ref != null && $ref != '')
+		$autorefresh = intval($ref);
+ }
+
+ if ($pagesonly !== true)
+ {
+	$rig = trim(getparam('rig', true));
+
+	$arg = trim(getparam('arg', true));
+	$preprocess = null;
+	if ($arg != null and $arg != '')
+	{
+		if ($rig != null and $rig != '' and $rig >= 0 and $rig < count($rigs))
+		{
+			$parts = explode(':', $rigs[$rig], 3);
+			if (count($parts) >= 1)
+			{
+				$miner = $parts[0];
+				if (count($parts) >= 2)
+					$port = $parts[1];
+				else
+					$port = '';
+
+				if ($readonly !== true)
+					$preprocess = $arg;
+			}
+		}
+	}
+ }
+
+ if ($allowcustompages === true)
+ {
+	$pg = urlencode(trim(getparam('pg', true)));
+	if ($pagesonly === true)
+	{
+		if ($pg !== null && $pg !== '')
+		{
+			if ($userlist !== null && isset($userlist['def'])
+			&&  !in_array($pg, $userlist['def']))
+				$pg = null;
+		}
+		else
+		{
+			if ($userlist !== null && isset($userlist['def']))
+				foreach ($userlist['def'] as $pglook)
+					if (isset($customsummarypages[$pglook]))
+					{
+						$pg = $pglook;
+						break;
+					}
+		}
+	}
+
+	if ($pg !== null && $pg !== '')
+	{
+		htmlhead($mcerr, false, null, $pg);
+		showcustompage($pg, $mcerr);
+		return;
+	}
+ }
+
+ if ($pagesonly === true)
+ {
+	onlylogin();
+	return;
+ }
+
+ if (count($rigs) == 1)
+ {
+	$parts = explode(':', $rigs[0], 3);
+	if (count($parts) >= 1)
+	{
+		$miner = $parts[0];
+		if (count($parts) >= 2)
+			$port = $parts[1];
+		else
+			$port = '';
+
+		htmlhead($mcerr, true, 0);
+		doOne(0, $preprocess);
+	}
+	else
+	{
+		minhead($mcerr);
+		otherrow('<td class=bad>Invalid "$rigs" array</td>');
+	}
+
+	return;
+ }
+
+ if ($rig != null and $rig != '' and $rig >= 0 and $rig < count($rigs))
+ {
+	$parts = explode(':', $rigs[$rig], 3);
+	if (count($parts) >= 1)
+	{
+		$miner = $parts[0];
+		if (count($parts) >= 2)
+			$port = $parts[1];
+		else
+			$port = '';
+
+		htmlhead($mcerr, true, 0);
+		doOne($rig, $preprocess);
+	}
+	else
+	{
+		minhead($mcerr);
+		otherrow('<td class=bad>Invalid "$rigs" array</td>');
+	}
+
+	return;
+ }
+
+ htmlhead($mcerr, false, null);
+
+ if ($placebuttons == 'top' || $placebuttons == 'both')
+	pagebuttons(null, null);
+
+ if ($preprocess != null)
+	process(array($preprocess => $preprocess), $rig);
+
+ newtable();
+ doforeach('version', 'rig summary', array(), array(), true);
+ $sum = array('MHS av', 'Getworks', 'Found Blocks', 'Accepted', 'Rejected', 'Discarded', 'Stale', 'Utility', 'Local Work', 'Total MH');
+ doforeach('summary', 'summary information', $sum, array(), false);
+ endtable();
+ otherrow('<td><br><br></td>');
+ newtable();
+ doforeach('devs', 'device list', $sum, array(''=>'','ProcID'=>'','ID'=>'','Name'=>''), false);
+ endtable();
+ otherrow('<td><br><br></td>');
+ newtable();
+ doforeach('pools', 'pool list', $sum, array(''=>''), false);
+ endtable();
+
+ if ($placebuttons == 'bot' || $placebuttons == 'both')
+	pagebuttons(null, null);
+}
+#
+if ($mcast === true)
+ getrigs();
+display();
+#
+?>
+</table></td></tr></table>
+</body></html>

packages/bfgminer/windows-build.txt

@@ -0,0 +1,272 @@
+*******************
+** Install MinGW **
+*******************
+
+1.  Go to https://sourceforge.net/downloads/mingw
+2.  Download and execute mingw-get-setup.exe
+3.  Complete the installation wizard leaving default values
+
+*********************
+** Configure MinGW **
+*********************
+
+1.  Launch the MinGW Installation Manager
+2.  Select Basic Setup on the left
+3.  Mark the following packages for installation: mingw-developer-toolkit, mingw32-base, mingw-gcc-g++, and msys-base
+4.  Select All Packages on the left
+5.  Mark the following packages for installation: mingw32-pthreads-w32 (dev), mingw32-libpdcurses (dev), mingw32-pdcurses (bin), msys-libopenssl (dev)
+6.  Click Installation > Apply Changes
+7.  Click Apply
+8.  Wait...
+9.  Click Close
+10. Close MinGW Installation Manager
+
+************************
+** MinGW Post-Install **
+************************
+
+1.  Check your Start menu for “MinGW Shell”
+2.  If the shortcut exists, continue to the next section, otherwise:
+3.  Navigate to C:\MinGW\msys\1.0\postinstall
+4.  Run pi.bat & answer the questions
+5.  Navigate to C:\MinGW\msys\1.0
+6.  Right-click msys.bat and click Copy 
+7.  Click the Start button
+8.  Right-click All Programs and click Open
+9.  Right-click on the opened folder and click “Paste shortcut”
+10. Right-click the new shortcut and click Properties
+11. On the General tab, rename the shortcut to “MinGW Shell”
+12. On the Shortcut tab, change Start in to C:\MinGW\msys\1.0\bin
+13. Click OK
+
+******************************************
+** Install YASM (optional - CPU mining) **
+******************************************
+
+1.  Visit http://yasm.tortall.net/Download.html
+2.  Download the Win32 or Win64 .exe, depending on your version of Windows
+3.  Rename the downloaded executable to yasm.exe
+4.  Copy the executable to C:\MinGW\bin
+
+********************
+** Install uthash **
+********************
+
+1.  Visit http://troydhanson.github.io/uthash/
+2.  Download the uthash-master.zip file
+3.  Extract the contents of the uthash-master/src folder into C:\MinGW\include
+
+******************************
+** Install GTK+ for Windows **
+******************************
+
+1.  Visit http://sourceforge.net/projects/gtk-win/
+2.  Download and execute the gtk2-runtime installer
+3.  Complete the installation wizard leaving default values
+4.  Copy libglib-2.0-0.dll from C:\Program Files\GTK2-Runtime\bin to C:\MinGW\bin
+
+************************
+** Install pkg-config **
+************************
+
+1.  Visit http://www.gtk.org/download/win32.php
+2.  Search for a version of pkg-config that includes both the Tool and Dev downloads
+3.  Click and download both the Tool link and the Dev link
+4.  Open the pkg-config zip file and extract the bin folder to C:\MinGW
+5.  Open the pkg-config-dev zip file and extract the share folder to C:\MinGW
+
+*********************
+** Install libcurl **
+*********************
+
+1.  Visit http://curl.haxx.se/download.html#Win32
+2.  Look for the Win32 - Generic heading
+3.  Download the link that indicates both *libcurl* (not just binary) and *SSL*
+4.  Open the zip file and extract the lib, include, and bin folders to C:\MinGW
+5.  Edit C:\MinGW\lib\pkgconfig\libcurl.pc
+6.  Change "-lcurl" to "-lcurl -lcurldll"
+
+************************
+** Install libjansson **
+************************
+
+1.  Visit http://www.digip.org/jansson/releases/
+2.  Download the latest .tar.gz file (not doc.tar.gz)
+3.  Open the .tar.gz file and extract the jansson folder to C:\MinGW\msys\1.0\home\USER (where USER is your user name)
+4.  Click Start and launch MinGW Shell
+5.  Type the following (replace X.X with actual version):
+
+	cd ~/jansson-X.X
+	./configure --prefix=/MinGW
+	make
+	make check
+	make install
+
+********************
+** Install libusb **
+********************
+
+1.  Visit http://git.libusb.org/?p=libusb.git;a=snapshot;h=master;sf=zip
+2.  Download and open the resulting zip file
+3.  Extract the libusb-master folder to C:\MinGW\msys\1.0\home\USER
+4.  Return to the MinGW Shell
+5.  Type the following (replace XYZ with actual identifier):
+
+	cd ~/libusb-master-XYZ
+	./autogen.sh --disable-debug-log --prefix=/MinGW
+	make
+	make install 
+
+******************************************************
+** Install libmicrohttpd (optional - Stratum Proxy) **
+******************************************************
+
+1.  Visit http://ftp.gnu.org/gnu/libmicrohttpd/
+2.  Download the latest w32.zip file
+3.  Open the zip file and extract the share, lib, include, and bin folders to C:\MinGW
+
+*************************************************
+** Install libevent (optional - Stratum Proxy) **
+*************************************************
+
+1.  Visit http://libevent.org/
+2.  Download the latest stable.tar.gz file
+3.  Open the .tar.gz file and extract the libevent-X.Y.Z-stable folder to C:\MinGW\msys\1.0\home\USER
+4.  Return to the MinGW Shell
+5.  Type the following (replace X.Y.Z with actual version):
+
+	cd ~/libevent-X.Y.Z-stable
+	./configure --disable-openssl --prefix=/MinGW
+	make
+	make install
+
+*******************************************************
+** Install HIDAPI (optional - Hashbuster & Nanofury) **
+*******************************************************
+
+1.  Visit https://github.com/signal11/hidapi
+2.  Click Releases and download the latest zip file
+3.  Open the zip file and extract the hidapi-hidapi folder to C:\MinGW\msys\1.0\home\USER
+4.  Return to the MinGW Shell
+5.  Type the following (replace X.Y.Z with actual version):
+
+	cd ~/hidapi-hidapi-X.Y.Z
+	./bootstrap
+	./configure --prefix=/MinGW
+	make
+	make install
+
+*****************
+** Install Git **
+*****************
+
+1.  Visit http://git-scm.com/downloads
+2.  Click the Download for Windows
+3.  Run the resulting installer once downloaded
+4.  Complete the installation wizard leaving default values
+
+****************************
+** Configure Git in MinGW **
+****************************
+
+1.  Navigate to C:\MinGW\msys\1.0\home\USER
+2.  Create a new text file with Notepad called profile.txt with the contents:
+
+PATH=$PATH:/c/Program\ Files/Git/bin
+
+3.  Return to the MinGW Shell
+4.  Type the following:
+
+	mv ~/profile.txt ~/.profile
+
+5.  Restart the MinGW Shell
+
+******************
+** OS Header(s) **
+******************
+
+1.  Navigate to C:\MinGW\include
+2.  Use Notepad to create a new file called mstcpip.h (not .txt) with the contents:
+
+struct tcp_keepalive
+{
+    u_long onoff;
+    u_long keepalivetime;
+    u_long keepaliveinterval;
+};
+
+#ifndef USE_WS_PREFIX
+
+#define SIO_KEEPALIVE_VALS    _WSAIOW(IOC_VENDOR, 4)
+
+#else
+
+#define WS_SIO_KEEPALIVE_VALS    _WSAIOW(WS_IOC_VENDOR, 4)
+
+#endif
+
+**********************
+** Compile bfgminer **
+**********************
+
+1.  Return to the MinGW Shell
+2.  Type the following:
+
+	cd ~/
+	git clone git://github.com/luke-jr/bfgminer.git
+	cd bfgminer/
+	./autogen.sh
+	./configure
+	make
+
+* Note: see the README for bfgminer ./configure options
+
+**********************
+** Package Binaries **
+**********************
+
+Create a new folder anywhere and copy the following items there:
+
+C:\MinGW\msys\1.0\home\USER\bfgminer
+
+	bfgminer.exe
+	bfgminer-rpc.exe
+	COPYING
+	LICENSE 
+	README*
+
+C:\MinGW\msys\1.0\home\USER\bfgminer\opencl
+
+	*.cl
+
+C:\MinGW\msys\1.0\home\USER\bfgminer\libbase58\.libs
+
+	libbase58-0.dll
+
+C:\MinGW\msys\1.0\home\USER\bfgminer\libblkmaker\.libs  
+
+	libblkmaker-0.1-6.dll
+	libblkmaker_jansson-0.1-6.dll
+
+C:\MinGW\bin
+
+	libcurl.dll
+	libjansson-4.dll
+	libmicrohttpd-10.dll
+	libpdcursesw.dll
+	pthreadGC2.dll
+	libusb-1.0.dll
+	libidn-11.dll
+	libeay32.dll
+	ssleay32.dll
+	libgcc_s_dw2-1.dll
+	libgnutls-28.dll
+	libgcrypt-11.dll
+	libplibc-1.dll
+	libgmp.dll
+	libintl-8.dll
+	libgpg-error-0.dll
+	libiconv-2.dll
+	libevent-2-0-5.dll
+	zlib1.dll
+

packages/mingw-bundledlls

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+
+# The MIT License (MIT)
+#
+# Copyright (c) 2015 Martin Preisler
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+
+import subprocess
+import os.path
+import argparse
+import shutil
+
+# The mingw path matches where Fedora 21 installs mingw32; this is the default
+# fallback if no other search path is specified in $MINGW_BUNDLEDLLS_SEARCH_PATH
+DEFAULT_PATH_PREFIXES = [
+    "", "/usr/bin", "/usr/i686-w64-mingw32/sys-root/mingw/bin", "/mingw64/bin",
+    "/usr/i686-w64-mingw32/sys-root/mingw/lib",
+    "C:\\msys64\\mingw64\\bin",
+    "/opt/mxe/usr/i686-w64-mingw32.shared/lib",
+    "/opt/mxe/usr/i686-w64-mingw32.shared/bin",
+    "/home/alexander/bfgminer/libbase58/.libs",
+    "/home/alexander/bfgminer/libblkmaker/.libs"
+    
+
+]
+
+env_path_prefixes = os.environ.get('MINGW_BUNDLEDLLS_SEARCH_PATH', None)
+if env_path_prefixes is not None:
+    path_prefixes = [path for path in env_path_prefixes.split(os.pathsep) if path]
+else:
+    path_prefixes = DEFAULT_PATH_PREFIXES
+
+# This blacklist may need extending
+blacklist = [
+    "advapi32.dll", "kernel32.dll", "msvcrt.dll", "ole32.dll", "user32.dll",
+    "ws2_32.dll", "comdlg32.dll", "gdi32.dll", "imm32.dll", "oleaut32.dll",
+    "shell32.dll", "winmm.dll", "winspool.drv", "wldap32.dll",
+    "ntdll.dll", "d3d9.dll", "mpr.dll", "crypt32.dll", "dnsapi.dll",
+    "shlwapi.dll", "version.dll", "iphlpapi.dll", "msimg32.dll", "setupapi.dll",
+    "opengl32.dll", "dwmapi.dll", "uxtheme.dll", "secur32.dll", "gdiplus.dll",
+    "usp10.dll", "comctl32.dll", "wsock32.dll", "netapi32.dll", "userenv.dll",
+    "avicap32.dll", "avrt.dll", "psapi.dll", "mswsock.dll", "glu32.dll",
+    "bcrypt.dll", "rpcrt4.dll"
+]
+
+
+def find_full_path(filename, path_prefixes):
+    for path_prefix in path_prefixes:
+        path = os.path.join(path_prefix, filename)
+        path_low = os.path.join(path_prefix, filename.lower())
+        if os.path.exists(path):
+            return path
+        if os.path.exists(path_low):
+            return path_low
+
+    else:
+        raise RuntimeError(
+            "Can't find " + filename + ". If it is an inbuilt Windows DLL, "
+            "please add it to the blacklist variable in the script and send "
+            "a pull request!"
+        )
+
+
+def gather_deps(path, path_prefixes, seen):
+    ret = [path]
+    output = subprocess.check_output(["objdump", "-p", path]).decode(
+        "utf-8", "replace").split("\n")
+    for line in output:
+        if not line.startswith("\tDLL Name: "):
+            continue
+
+        dep = line.split("DLL Name: ")[1].strip()
+        ldep = dep.lower()
+
+        if ldep in blacklist:
+            continue
+
+        if ldep in seen:
+            continue
+
+        dep_path = find_full_path(dep, path_prefixes)
+        seen.add(ldep)
+        subdeps = gather_deps(dep_path, path_prefixes, seen)
+        ret.extend(subdeps)
+
+    return ret
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "exe_file",
+        help="EXE or DLL file that you need to bundle dependencies for"
+    )
+    parser.add_argument(
+        "--copy",
+        action="store_true",
+        help="In addition to printing out the dependencies, also copy them next to the exe_file"
+    )
+    parser.add_argument(
+        "--upx",
+        action="store_true",
+        help="Only valid if --copy is provided. Run UPX on all the DLLs and EXE."
+    )
+    args = parser.parse_args()
+
+    if args.upx and not args.copy:
+        raise RuntimeError("Can't run UPX if --copy hasn't been provided.")
+
+    all_deps = set(gather_deps(args.exe_file, path_prefixes, set()))
+    all_deps.remove(args.exe_file)
+
+    print("\n".join(all_deps))
+
+    if args.copy:
+        print("Copying enabled, will now copy all dependencies next to the exe_file.\n")
+
+        parent_dir = os.path.dirname(os.path.abspath(args.exe_file))
+
+        for dep in all_deps:
+            target = os.path.join(parent_dir, os.path.basename(dep))
+
+            try:
+                print("Copying '%s' to '%s'" % (dep, target))
+                shutil.copy(dep, parent_dir)
+
+            except shutil.SameFileError:
+                print("Dependency '%s' was already in target directory, "
+                      "skipping..." % (dep))
+
+            if args.upx:
+                subprocess.call(["upx", target])
+
+
+if __name__ == "__main__":
+    main()