2010-08-29 09:58:15 -07:00
|
|
|
UNIX BUILD NOTES
|
2013-05-19 21:30:00 -07:00
|
|
|
====================
|
2013-06-16 03:29:23 -07:00
|
|
|
Some notes on how to build Bitcoin in Unix.
|
2010-08-29 09:58:15 -07:00
|
|
|
|
2011-01-25 06:29:13 -08:00
|
|
|
To Build
|
2013-05-19 21:30:00 -07:00
|
|
|
---------------------
|
2011-01-25 06:29:13 -08:00
|
|
|
|
2013-05-27 16:55:01 -07:00
|
|
|
./autogen.sh
|
|
|
|
./configure
|
|
|
|
make
|
2011-04-23 02:49:47 -07:00
|
|
|
|
2013-05-27 16:55:01 -07:00
|
|
|
This will build bitcoin-qt as well if the dependencies are met.
|
|
|
|
See [readme-qt.md](readme-qt.md) for more information.
|
2011-01-25 06:29:13 -08:00
|
|
|
|
2010-08-29 09:58:15 -07:00
|
|
|
Dependencies
|
2013-05-19 21:30:00 -07:00
|
|
|
---------------------
|
2011-10-09 02:04:35 -07:00
|
|
|
|
2011-11-10 06:20:17 -08:00
|
|
|
Library Purpose Description
|
|
|
|
------- ------- -----------
|
|
|
|
libssl SSL Support Secure communications
|
|
|
|
libdb4.8 Berkeley DB Blockchain & wallet storage
|
|
|
|
libboost Boost C++ Library
|
|
|
|
miniupnpc UPnP Support Optional firewall-jumping support
|
2011-10-09 02:04:35 -07:00
|
|
|
|
2013-05-19 21:30:00 -07:00
|
|
|
[miniupnpc](http://miniupnp.free.fr/) may be used for UPnP port mapping. It can be downloaded from [here](
|
|
|
|
http://miniupnp.tuxfamily.org/files/). UPnP support is compiled in and
|
2013-05-27 16:55:01 -07:00
|
|
|
turned off by default. See the configure options for upnp behavior desired:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
2013-05-27 16:55:01 -07:00
|
|
|
--with-miniupnpc No UPnP support miniupnp not required
|
|
|
|
--disable-upnp-default (the default) UPnP support turned off by default at runtime
|
|
|
|
--enable-upnp-default UPnP support turned on by default at runtime
|
2011-10-09 02:04:35 -07:00
|
|
|
|
2012-12-03 02:34:15 -08:00
|
|
|
IPv6 support may be disabled by setting:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
2013-05-27 16:55:01 -07:00
|
|
|
--disable-ipv6 Disable IPv6 support
|
2012-03-31 08:58:25 -07:00
|
|
|
|
2011-10-09 02:04:35 -07:00
|
|
|
Licenses of statically linked libraries:
|
|
|
|
Berkeley DB New BSD license with additional requirement that linked
|
|
|
|
software must be free open source
|
|
|
|
Boost MIT-like license
|
|
|
|
miniupnpc New (3-clause) BSD license
|
|
|
|
|
2013-05-19 21:30:00 -07:00
|
|
|
- Versions used in this release:
|
|
|
|
- GCC 4.3.3
|
|
|
|
- OpenSSL 1.0.1c
|
|
|
|
- Berkeley DB 4.8.30.NC
|
|
|
|
- Boost 1.37
|
|
|
|
- miniupnpc 1.6
|
2011-10-09 02:04:35 -07:00
|
|
|
|
|
|
|
Dependency Build Instructions: Ubuntu & Debian
|
|
|
|
----------------------------------------------
|
2012-08-29 20:19:00 -07:00
|
|
|
Build requirements:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
|
|
|
sudo apt-get install build-essential
|
|
|
|
sudo apt-get install libssl-dev
|
2012-08-29 20:19:00 -07:00
|
|
|
|
|
|
|
for Ubuntu 12.04:
|
|
|
|
|
2013-05-19 21:30:00 -07:00
|
|
|
sudo apt-get install libboost-all-dev
|
|
|
|
|
|
|
|
db4.8 packages are available [here](https://launchpad.net/~bitcoin/+archive/bitcoin).
|
2012-08-29 20:19:00 -07:00
|
|
|
|
|
|
|
Ubuntu precise has packages for libdb5.1-dev and libdb5.1++-dev,
|
|
|
|
but using these will break binary wallet compatibility, and is not recommended.
|
|
|
|
|
|
|
|
for other Ubuntu & Debian:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
|
|
|
sudo apt-get install libdb4.8-dev
|
|
|
|
sudo apt-get install libdb4.8++-dev
|
|
|
|
sudo apt-get install libboost1.37-dev
|
2012-08-29 20:19:00 -07:00
|
|
|
(If using Boost 1.37, append -mt to the boost libraries in the makefile)
|
|
|
|
|
|
|
|
Optional:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
2013-05-27 16:55:01 -07:00
|
|
|
sudo apt-get install libminiupnpc-dev (see --with-miniupnpc and --enable-upnp-default)
|
2010-08-29 09:58:15 -07:00
|
|
|
|
2011-03-26 05:01:27 -07:00
|
|
|
|
2011-10-09 02:04:35 -07:00
|
|
|
Dependency Build Instructions: Gentoo
|
|
|
|
-------------------------------------
|
2011-10-09 11:23:20 -07:00
|
|
|
|
2013-05-19 21:30:00 -07:00
|
|
|
Note: If you just want to install bitcoind on Gentoo, you can add the Bitcoin overlay and use your package manager:
|
2011-10-09 11:23:20 -07:00
|
|
|
|
2013-05-19 21:30:00 -07:00
|
|
|
layman -a bitcoin && emerge bitcoind
|
|
|
|
emerge -av1 --noreplace boost glib openssl sys-libs/db:4.8
|
2010-08-29 09:58:15 -07:00
|
|
|
|
2011-10-09 02:18:34 -07:00
|
|
|
Take the following steps to build (no UPnP support):
|
2013-05-19 21:30:00 -07:00
|
|
|
|
2013-05-27 16:55:01 -07:00
|
|
|
cd ${BITCOIN_DIR}
|
|
|
|
./autogen.sh
|
|
|
|
./configure --without-miniupnpc CXXFLAGS="-i/usr/include/db4.8"
|
2013-05-19 21:30:00 -07:00
|
|
|
strip bitcoind
|
2010-08-29 09:58:15 -07:00
|
|
|
|
|
|
|
|
|
|
|
Notes
|
|
|
|
-----
|
2011-10-09 02:04:35 -07:00
|
|
|
The release is built with GCC and then "strip bitcoind" to strip the debug
|
2010-08-29 09:58:15 -07:00
|
|
|
symbols, which reduces the executable size by about 90%.
|
|
|
|
|
|
|
|
|
2011-03-26 05:01:27 -07:00
|
|
|
miniupnpc
|
|
|
|
---------
|
2013-05-19 21:30:00 -07:00
|
|
|
tar -xzvf miniupnpc-1.6.tar.gz
|
|
|
|
cd miniupnpc-1.6
|
|
|
|
make
|
|
|
|
sudo su
|
|
|
|
make install
|
2011-03-26 05:01:27 -07:00
|
|
|
|
|
|
|
|
2010-08-29 09:58:15 -07:00
|
|
|
Berkeley DB
|
|
|
|
-----------
|
2011-08-11 15:20:07 -07:00
|
|
|
You need Berkeley DB 4.8. If you have to build Berkeley DB yourself:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
|
|
|
../dist/configure --enable-cxx
|
|
|
|
make
|
2010-08-29 09:58:15 -07:00
|
|
|
|
|
|
|
|
|
|
|
Boost
|
|
|
|
-----
|
|
|
|
If you need to build Boost yourself:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
|
|
|
sudo su
|
|
|
|
./bootstrap.sh
|
|
|
|
./bjam install
|
2011-09-08 09:50:54 -07:00
|
|
|
|
|
|
|
|
|
|
|
Security
|
|
|
|
--------
|
|
|
|
To help make your bitcoin installation more secure by making certain attacks impossible to
|
2013-05-27 16:55:01 -07:00
|
|
|
exploit even if a vulnerability is found, binaries are hardened by default.
|
|
|
|
This can be disabled with:
|
|
|
|
|
|
|
|
./configure --enable-hardening
|
|
|
|
|
|
|
|
|
|
|
|
Hardening enables the following features:
|
2011-09-08 09:50:54 -07:00
|
|
|
|
|
|
|
* Position Independent Executable
|
|
|
|
Build position independent code to take advantage of Address Space Layout Randomization
|
|
|
|
offered by some kernels. An attacker who is able to cause execution of code at an arbitrary
|
|
|
|
memory location is thwarted if he doesn't know where anything useful is located.
|
|
|
|
The stack and heap are randomly located by default but this allows the code section to be
|
|
|
|
randomly located as well.
|
|
|
|
|
|
|
|
On an Amd64 processor where a library was not compiled with -fPIC, this will cause an error
|
|
|
|
such as: "relocation R_X86_64_32 against `......' can not be used when making a shared object;"
|
|
|
|
|
|
|
|
To test that you have built PIE executable, install scanelf, part of paxutils, and use:
|
2013-05-19 21:30:00 -07:00
|
|
|
|
|
|
|
scanelf -e ./bitcoin
|
2011-09-08 09:50:54 -07:00
|
|
|
|
|
|
|
The output should contain:
|
|
|
|
TYPE
|
|
|
|
ET_DYN
|
|
|
|
|
|
|
|
* Non-executable Stack
|
|
|
|
If the stack is executable then trivial stack based buffer overflow exploits are possible if
|
|
|
|
vulnerable buffers are found. By default, bitcoin should be built with a non-executable stack
|
|
|
|
but if one of the libraries it uses asks for an executable stack or someone makes a mistake
|
|
|
|
and uses a compiler extension which requires an executable stack, it will silently build an
|
|
|
|
executable without the non-executable stack protection.
|
|
|
|
|
|
|
|
To verify that the stack is non-executable after compiling use:
|
2013-05-19 21:30:00 -07:00
|
|
|
`scanelf -e ./bitcoin`
|
2011-09-08 09:50:54 -07:00
|
|
|
|
|
|
|
the output should contain:
|
2013-05-19 21:30:00 -07:00
|
|
|
STK/REL/PTL
|
|
|
|
RW- R-- RW-
|
2011-09-08 09:50:54 -07:00
|
|
|
|
|
|
|
The STK RW- means that the stack is readable and writeable but not executable.
|