Merge pull request #3098 from super3/master
Finished /Contrib Index. Standardized READMEs.
This commit is contained in:
commit
0487cc4137
|
@ -1,6 +1,9 @@
|
||||||
Contrib Index
|
Contrib Index
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
|
### [BitRPC](/contrib/bitrpc) ###
|
||||||
|
Added bitrpc.py which allows for sending of all standard Bitcoin commands via RPC rather than as command line args.
|
||||||
|
|
||||||
### [Debian](/contrib/debian) ###
|
### [Debian](/contrib/debian) ###
|
||||||
Contains files used to package bitcoind/bitcoin-qt
|
Contains files used to package bitcoind/bitcoin-qt
|
||||||
for Debian-based Linux systems. If you compile bitcoind/bitcoin-qt yourself, there are some useful files here.
|
for Debian-based Linux systems. If you compile bitcoind/bitcoin-qt yourself, there are some useful files here.
|
||||||
|
@ -11,7 +14,10 @@ Gavin's notes on getting gitian builds up and running using KVM.
|
||||||
### [Gitian-downloader](/contrib/gitian-downloader)
|
### [Gitian-downloader](/contrib/gitian-downloader)
|
||||||
Various PGP files of core developers.
|
Various PGP files of core developers.
|
||||||
|
|
||||||
### [Macdeploy](/contrib/macdeploy) ###
|
### [Linearize](/contrib/linearize) ###
|
||||||
|
Construct a linear, no-fork, best version of the blockchain.
|
||||||
|
|
||||||
|
### [MacDeploy](/contrib/macdeploy) ###
|
||||||
Scripts and notes for Mac builds.
|
Scripts and notes for Mac builds.
|
||||||
|
|
||||||
### [PyMiner](/contrib/pyminer) ###
|
### [PyMiner](/contrib/pyminer) ###
|
||||||
|
@ -32,3 +38,13 @@ address (or addresses).
|
||||||
|
|
||||||
### [TestGen](/contrib/testgen) ###
|
### [TestGen](/contrib/testgen) ###
|
||||||
Utilities to generate test vectors for the data-driven Bitcoin tests.
|
Utilities to generate test vectors for the data-driven Bitcoin tests.
|
||||||
|
|
||||||
|
### [Test Patches](/contrib/test-patches) ###
|
||||||
|
These patches are applied when the automated pull-tester
|
||||||
|
tests each pull and when master is tested using jenkins.
|
||||||
|
|
||||||
|
### [Verify SF Binaries](/contrib/verifysfbinaries) ###
|
||||||
|
This script attempts to download and verify the signature file SHA256SUMS.asc from SourceForge.
|
||||||
|
|
||||||
|
### [Wallet Tools](/contrib/wallettools) ###
|
||||||
|
Contains a wallet change password and unlock script.
|
||||||
|
|
|
@ -0,0 +1,2 @@
|
||||||
|
### BitRPC ###
|
||||||
|
Allows for sending of all standard Bitcoin commands via RPC rather than as command line args.
|
|
@ -1,7 +1,7 @@
|
||||||
Gavin's notes on getting gitian builds up and running using KVM:
|
### Gavin's notes on getting gitian builds up and running using KVM:###
|
||||||
|
|
||||||
These instructions distilled from:
|
These instructions distilled from:
|
||||||
https://help.ubuntu.com/community/KVM/Installation
|
[ https://help.ubuntu.com/community/KVM/Installation]( https://help.ubuntu.com/community/KVM/Installation)
|
||||||
... see there for complete details.
|
... see there for complete details.
|
||||||
|
|
||||||
You need the right hardware: you need a 64-bit-capable CPU with hardware virtualization support (Intel VT-x or AMD-V). Not all modern CPUs support hardware virtualization.
|
You need the right hardware: you need a 64-bit-capable CPU with hardware virtualization support (Intel VT-x or AMD-V). Not all modern CPUs support hardware virtualization.
|
||||||
|
@ -9,9 +9,11 @@ You need the right hardware: you need a 64-bit-capable CPU with hardware virtual
|
||||||
You probably need to enable hardware virtualization in your machine's BIOS.
|
You probably need to enable hardware virtualization in your machine's BIOS.
|
||||||
|
|
||||||
You need to be running a recent version of 64-bit-Ubuntu, and you need to install several prerequisites:
|
You need to be running a recent version of 64-bit-Ubuntu, and you need to install several prerequisites:
|
||||||
|
|
||||||
sudo apt-get install ruby apache2 git apt-cacher-ng python-vm-builder qemu-kvm
|
sudo apt-get install ruby apache2 git apt-cacher-ng python-vm-builder qemu-kvm
|
||||||
|
|
||||||
Sanity checks:
|
Sanity checks:
|
||||||
|
|
||||||
sudo service apt-cacher-ng status # Should return apt-cacher-ng is running
|
sudo service apt-cacher-ng status # Should return apt-cacher-ng is running
|
||||||
ls -l /dev/kvm # Should show a /dev/kvm device
|
ls -l /dev/kvm # Should show a /dev/kvm device
|
||||||
|
|
||||||
|
@ -22,9 +24,11 @@ Once you've got the right hardware and software:
|
||||||
git clone git://github.com/devrandom/gitian-builder.git
|
git clone git://github.com/devrandom/gitian-builder.git
|
||||||
mkdir gitian-builder/inputs
|
mkdir gitian-builder/inputs
|
||||||
cd gitian-builder/inputs
|
cd gitian-builder/inputs
|
||||||
|
|
||||||
# Inputs for Linux and Win32:
|
# Inputs for Linux and Win32:
|
||||||
wget -O miniupnpc-1.6.tar.gz 'http://miniupnp.tuxfamily.org/files/download.php?file=miniupnpc-1.6.tar.gz'
|
wget -O miniupnpc-1.6.tar.gz 'http://miniupnp.tuxfamily.org/files/download.php?file=miniupnpc-1.6.tar.gz'
|
||||||
wget 'http://fukuchi.org/works/qrencode/qrencode-3.2.0.tar.bz2'
|
wget 'http://fukuchi.org/works/qrencode/qrencode-3.2.0.tar.bz2'
|
||||||
|
|
||||||
# Inputs for Win32: (Linux has packages for these)
|
# Inputs for Win32: (Linux has packages for these)
|
||||||
wget 'https://downloads.sourceforge.net/project/boost/boost/1.50.0/boost_1_50_0.tar.bz2'
|
wget 'https://downloads.sourceforge.net/project/boost/boost/1.50.0/boost_1_50_0.tar.bz2'
|
||||||
wget 'http://www.openssl.org/source/openssl-1.0.1c.tar.gz'
|
wget 'http://www.openssl.org/source/openssl-1.0.1c.tar.gz'
|
||||||
|
@ -58,31 +62,29 @@ Once you've got the right hardware and software:
|
||||||
|
|
||||||
---------------------
|
---------------------
|
||||||
|
|
||||||
gitian-builder now also supports building using LXC. See
|
`gitian-builder` now also supports building using LXC. See
|
||||||
https://help.ubuntu.com/12.04/serverguide/lxc.html
|
[ https://help.ubuntu.com/12.04/serverguide/lxc.html]( https://help.ubuntu.com/12.04/serverguide/lxc.html)
|
||||||
... for how to get LXC up and running under Ubuntu.
|
... for how to get LXC up and running under Ubuntu.
|
||||||
|
|
||||||
If your main machine is a 64-bit Mac or PC with a few gigabytes of memory
|
If your main machine is a 64-bit Mac or PC with a few gigabytes of memory
|
||||||
and at least 10 gigabytes of free disk space, you can gitian-build using
|
and at least 10 gigabytes of free disk space, you can `gitian-build` using
|
||||||
LXC running inside a virtual machine.
|
LXC running inside a virtual machine.
|
||||||
|
|
||||||
Here's a description of Gavin's setup on OSX 10.6:
|
Here's a description of Gavin's setup on OSX 10.6:
|
||||||
|
|
||||||
1. Download and install VirtualBox from https://www.virtualbox.org/
|
1. Download and install VirtualBox from [https://www.virtualbox.org/](https://www.virtualbox.org/)
|
||||||
|
|
||||||
2. Download the 64-bit Ubuntu Desktop 12.04 LTS .iso CD image from
|
2. Download the 64-bit Ubuntu Desktop 12.04 LTS .iso CD image from
|
||||||
http://www.ubuntu.com/
|
[http://www.ubuntu.com/](http://www.ubuntu.com/)
|
||||||
|
|
||||||
3. Run VirtualBox and create a new virtual machine, using the
|
3. Run VirtualBox and create a new virtual machine, using the Ubuntu .iso (see the [VirtualBox documentation](https://www.virtualbox.org/wiki/Documentation) for details). Create it with at least 2 gigabytes of memory and a disk that is at least 20 gigabytes big.
|
||||||
Ubuntu .iso (see the VirtualBox documentation for details).
|
|
||||||
Create it with at least 2 gigabytes of memory and a disk
|
|
||||||
that is at least 20 gigabytes big.
|
|
||||||
|
|
||||||
4. Inside the running Ubuntu desktop, install:
|
4. Inside the running Ubuntu desktop, install:
|
||||||
|
|
||||||
sudo apt-get install debootstrap lxc ruby apache2 git apt-cacher-ng python-vm-builder
|
sudo apt-get install debootstrap lxc ruby apache2 git apt-cacher-ng python-vm-builder
|
||||||
|
|
||||||
5. Still inside Ubuntu, tell gitian-builder to use LXC, then follow the "Once you've got the right
|
5. Still inside Ubuntu, tell gitian-builder to use LXC, then follow the "Once you've got the right hardware and software" instructions above:
|
||||||
hardware and software" instructions above:
|
|
||||||
export USE_LXC=1
|
export USE_LXC=1
|
||||||
git clone git://github.com/bitcoin/bitcoin.git
|
git clone git://github.com/bitcoin/bitcoin.git
|
||||||
... etc
|
... etc
|
|
@ -0,0 +1,2 @@
|
||||||
|
### Linearize ###
|
||||||
|
Construct a linear, no-fork, best version of the blockchain.
|
|
@ -0,0 +1,19 @@
|
||||||
|
### MacDeploy ###
|
||||||
|
|
||||||
|
You will need the appscript package for the fancy disk image creation to work:
|
||||||
|
|
||||||
|
sudo easy_install appscript
|
||||||
|
|
||||||
|
For Snow Leopard (which uses [Python 2.6](http://www.python.org/download/releases/2.6/)), you will need the param_parser package:
|
||||||
|
|
||||||
|
sudo easy_install argparse
|
||||||
|
|
||||||
|
This script should not be run manually, instead, after building as usual:
|
||||||
|
|
||||||
|
make deploy
|
||||||
|
|
||||||
|
During the process, the disk image window will pop up briefly where the fancy
|
||||||
|
settings are applied. This is normal, please do not interfere.
|
||||||
|
|
||||||
|
When finished, it will produce `Bitcoin-Qt.dmg`.
|
||||||
|
|
|
@ -1,14 +0,0 @@
|
||||||
You will need the appscript package for the fancy disk image creation to work.
|
|
||||||
Install it by invoking "sudo easy_install appscript".
|
|
||||||
|
|
||||||
For Snow Leopard (which uses Python 2.6), you will need the param_parser package.
|
|
||||||
Install it by invoking "sudo easy_install argparse"
|
|
||||||
|
|
||||||
This script should not be run manually, instead, after building as usual:
|
|
||||||
"make deploy"
|
|
||||||
|
|
||||||
During the process, the disk image window will pop up briefly where the fancy
|
|
||||||
settings are applied. This is normal, please do not interfere.
|
|
||||||
|
|
||||||
When finished, it will produce Bitcoin-Qt.dmg.
|
|
||||||
|
|
|
@ -1,5 +1,6 @@
|
||||||
|
### PyMiner ###
|
||||||
|
|
||||||
This is a 'getwork' CPU mining client for bitcoin.
|
This is a 'getwork' CPU mining client for Bitcoin.
|
||||||
|
|
||||||
It is pure-python, and therefore very, very slow. The purpose is to
|
It is pure-python, and therefore very, very slow. The purpose is to
|
||||||
provide a reference implementation of a miner, for study.
|
provide a reference implementation of a miner, for study.
|
|
@ -1,3 +1,5 @@
|
||||||
|
### Qos ###
|
||||||
|
|
||||||
This is a Linux bash script that will set up tc to limit the outgoing bandwidth for connections to the Bitcoin network. It limits outbound TCP traffic with a source or destination port of 8333, but not if the destination IP is within a LAN (defined as 192.168.x.x).
|
This is a Linux bash script that will set up tc to limit the outgoing bandwidth for connections to the Bitcoin network. It limits outbound TCP traffic with a source or destination port of 8333, but not if the destination IP is within a LAN (defined as 192.168.x.x).
|
||||||
|
|
||||||
This means one can have an always-on bitcoind instance running, and another local bitcoind/bitcoin-qt instance which connects to this node and receives blocks from it.
|
This means one can have an always-on bitcoind instance running, and another local bitcoind/bitcoin-qt instance which connects to this node and receives blocks from it.
|
|
@ -1,5 +1,7 @@
|
||||||
|
### Seeds ###
|
||||||
|
|
||||||
Utility to generate the pnSeed[] array that is compiled into the client
|
Utility to generate the pnSeed[] array that is compiled into the client
|
||||||
(see src/net.cpp).
|
(see [src/net.cpp](/src/net.cpp)).
|
||||||
|
|
||||||
The 600 seeds compiled into the 0.8 release were created from sipa's DNS seed data, like this:
|
The 600 seeds compiled into the 0.8 release were created from sipa's DNS seed data, like this:
|
||||||
|
|
|
@ -1,7 +1,9 @@
|
||||||
|
### SpendFrom ###
|
||||||
|
|
||||||
Use the raw transactions API to send coins received on a particular
|
Use the raw transactions API to send coins received on a particular
|
||||||
address (or addresses).
|
address (or addresses).
|
||||||
|
|
||||||
Depends on jsonrpc
|
Depends on `jsonrpc`
|
||||||
|
|
||||||
Usage:
|
Usage:
|
||||||
|
|
||||||
|
@ -10,7 +12,7 @@ spendfrom.py --from=FROMADDRESS1[,FROMADDRESS2] --to=TOADDRESS --amount=amount \
|
||||||
|
|
||||||
With no arguments, outputs a list of amounts associated with addresses.
|
With no arguments, outputs a list of amounts associated with addresses.
|
||||||
|
|
||||||
With arguments, sends coins received by the FROMADDRESS addresses to the TOADDRESS.
|
With arguments, sends coins received by the `FROMADDRESS` addresses to the `TOADDRESS`.
|
||||||
|
|
||||||
You may explictly specify how much fee to pay (a fee more than 1% of the amount
|
You may explictly specify how much fee to pay (a fee more than 1% of the amount
|
||||||
will fail, though, to prevent bitcoin-losing accidents). Spendfrom may fail if
|
will fail, though, to prevent bitcoin-losing accidents). Spendfrom may fail if
|
||||||
|
@ -18,11 +20,11 @@ it thinks the transaction would never be confirmed (if the amount being sent is
|
||||||
too small, or if the transaction is too many bytes for the fee).
|
too small, or if the transaction is too many bytes for the fee).
|
||||||
|
|
||||||
If a change output needs to be created, the change will be sent to the last
|
If a change output needs to be created, the change will be sent to the last
|
||||||
FROMADDRESS (if you specify just one FROMADDRESS, change will go back to it).
|
`FROMADDRESS` (if you specify just one `FROMADDRESS`, change will go back to it).
|
||||||
|
|
||||||
If --datadir is not specified, the default datadir is used.
|
If `--datadir` is not specified, the default datadir is used.
|
||||||
|
|
||||||
The --dry_run option will just create and sign the the transaction and print
|
The `--dry_run` option will just create and sign the the transaction and print
|
||||||
the transaction data (as hexadecimal), instead of broadcasting it.
|
the transaction data (as hexadecimal), instead of broadcasting it.
|
||||||
|
|
||||||
If the transaction is created and broadcast successfully, a transaction id
|
If the transaction is created and broadcast successfully, a transaction id
|
|
@ -1,4 +1,7 @@
|
||||||
|
### Test Patches ###
|
||||||
|
|
||||||
These patches are applied when the automated pull-tester
|
These patches are applied when the automated pull-tester
|
||||||
tests each pull and when master is tested using jenkins.
|
tests each pull and when master is tested using jenkins.
|
||||||
You can find more information about the tests run at
|
You can find more information about the tests run at
|
||||||
http://jenkins.bluematt.me/pull-tester/files/
|
[http://jenkins.bluematt.me/pull-tester/files/
|
||||||
|
](http://jenkins.bluematt.me/pull-tester/files/)
|
|
@ -1 +0,0 @@
|
||||||
Utilities to generate test vectors for the data-driven Bitcoin tests.
|
|
|
@ -0,0 +1,8 @@
|
||||||
|
### TestGen ###
|
||||||
|
|
||||||
|
Utilities to generate test vectors for the data-driven Bitcoin tests.
|
||||||
|
|
||||||
|
Usage:
|
||||||
|
|
||||||
|
gen_base58_test_vectors.py valid 50 > ../../src/test/data/base58_keys_valid.json
|
||||||
|
gen_base58_test_vectors.py invalid 50 > ../../src/test/data/base58_keys_invalid.json
|
|
@ -0,0 +1,7 @@
|
||||||
|
### Verify SF Binaries ###
|
||||||
|
This script attempts to download the signature file `SHA256SUMS.asc` from SourceForge.
|
||||||
|
|
||||||
|
It first checks if the signature passes, and then downloads the files specified in
|
||||||
|
the file, and checks if the hashes of these files match those that are specified
|
||||||
|
in the signature file. The script returns 0 if everything passes the checks. It returns 1 if either the
|
||||||
|
signature check or the hash check doesn't pass. If an error occurs the return value is 2
|
|
@ -0,0 +1,2 @@
|
||||||
|
### Wallet Tools ###
|
||||||
|
Contains a wallet change password and unlock script.
|
Loading…
Reference in New Issue