ビットコイン・インスティテュート

[patch] プルーフ・オブ・ワークの検査が失敗したときに、追加の出力を表示する

1件のメッセージ BitcoinTalk ジェフ・ガージック 2010年12月20日 — 2010年12月20日

この書式の意味は、あとの「注」の節を見てほしい。

編集:これは、パッチとしてhttp://yyz.us/bitcoin/patch.bitcoin-pow-failで保守している。

Please pull from branch ‘pow-fail’ of
git://github.com/jgarzik/bitcoin.git pow-fail

to receive the following updates:

Jeff Garzik (1):
     Add -printpowfail to display hash data when proof-of-work verification fails

main.cpp | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/main.cpp b/main.cpp
index 8db6c39..d0eac7c 100644
--- a/main.cpp
+++ b/main.cpp
@@ -3397,8 +3397,12 @@ bool CheckWork(CBlock* pblock, CReserveKey& reservekey)
     uint256 hash = pblock->GetHash();
     uint256 hashTarget = CBigNum().SetCompact(pblock->nBits).getuint256();
 
-    if (hash > hashTarget)
+    if (hash > hashTarget) {
+       if (GetBoolArg("-printpowfail"))
+            printf("proof-of-work check FAILED...\n  hash: %s\ntarget: %s\n",
+                   hash.GetHex().c_str(), hashTarget.GetHex().c_str());
         return false;
+    }
 
     //// debug print
     printf("BitcoinMiner:\n");

注

注1:これは、Linuxカーネルで標準になっている、gitのプルリクエストの書式だ。カーネルでは、プルリクエストの前に、パッチが少なくとも一度のレビューを経ていることが多い。サブシステムのメンテナーが、個々の提出者の変更を見ているのだ。この投稿では、短くするためとコメントしやすくするために、大きなソフトウェアのプロジェクトなら二つある段階を、一つにまとめている。

注2:英語の文面は「please pull」(プルしてください)と、通る前提のように書いてあるが、提出者は通ると決めてかかることはない。次の繰り返しが基本だと考える。

  • 手順1:プルリクエストを投稿する
  • 手順2:受け入れられるものなら、メンテナーがプルする。やった、変更が採用された!
  • 手順3:そうでなければ、意見をもとに直して(あるいは、やり方をまるごと捨てて!)、手順1に戻る

注3:そう、ブランチの名前は「Please pull」の行と次の行に、二度書いてある。二行目は、「git pull」を実行する人が楽にコピーして貼り付けられるようにしてある。

注4:「receive the following updates」のあとの部分は、「git shortlog」の出力だ

注5:その次が差分の統計で、diffstat(1)が作ったもの

注6:そのあとに、公開でレビューし、引用してコメントできるように、パッチの全文が続く。

注7:普通は、第三者からのプルは統合用のブランチに入れ、壊れたものや「悪意のある」ものが入っていないと納得してから、そのあとで統合用のブランチを本流のブランチにプルする。