X-Git-Url: https://git.novaco.in/?a=blobdiff_plain;f=doc%2Fbuild-unix.txt;h=5e8d7c6b6f06a7f020829d3bb508d69361c7d878;hb=bc33cfede4c7668b7476e1aa3894cac661c23a62;hp=c5b4205084d21c465616cbbb3fa82c2ab048292b;hpb=882164196e5b1971313493f95a6d027f05e2ec92;p=novacoin.git diff --git a/doc/build-unix.txt b/doc/build-unix.txt index c5b4205..5e8d7c6 100644 --- a/doc/build-unix.txt +++ b/doc/build-unix.txt @@ -1,4 +1,5 @@ Copyright (c) 2009-2012 Bitcoin Developers +Copyright (c) 2013 NovaCoin Developers Distributed under the MIT/X11 software license, see the accompanying file license.txt or http://www.opensource.org/licenses/mit-license.php. This product includes software developed by the OpenSSL Project for use in @@ -14,10 +15,10 @@ To Build -------- cd src/ -make -f makefile.unix # Headless bitcoin +make -f makefile.unix # Headless novacoin -See readme-qt.rst for instructions on building Bitcoin QT, -the graphical bitcoin. +See readme-qt.rst for instructions on building NovaCoin QT, +the graphical novacoin. Dependencies ------------ @@ -30,17 +31,20 @@ Dependencies miniupnpc UPnP Support Optional firewall-jumping support libqrencode QRCode generation Optional QRCode generation +Note that libexecinfo should be installed, if you building under *BSD systems. +This library provides backtrace facility. + miniupnpc may be used for UPnP port mapping. It can be downloaded from http://miniupnp.tuxfamily.org/files/. UPnP support is compiled in and turned off by default. Set USE_UPNP to a different value to control this: - USE_UPNP= No UPnP support - miniupnp not required + USE_UPNP=- No UPnP support - miniupnp not required USE_UPNP=0 (the default) UPnP support turned off by default at runtime USE_UPNP=1 UPnP support turned on by default at runtime libqrencode may be used for QRCode image generation. It can be downloaded from http://fukuchi.org/works/qrencode/index.html.en, or installed via your package manager. Set USE_QRCODE to control this: - USE_QRCODE=0 (the default) No QRCode support - libarcode not required + USE_QRCODE=0 (the default) No QRCode support - libqrcode not required USE_QRCODE=1 QRCode support enabled Licenses of statically linked libraries: @@ -72,21 +76,21 @@ If using Boost 1.37, append -mt to the boost libraries in the makefile. Dependency Build Instructions: Gentoo ------------------------------------- -Note: If you just want to install bitcoind on Gentoo, you can add the Bitcoin +Note: If you just want to install novacoind on Gentoo, you can add the Novacoin overlay and use your package manager: - layman -a bitcoin && emerge bitcoind + layman -a novacoin && emerge novacoind emerge -av1 --noreplace boost glib openssl sys-libs/db:4.8 Take the following steps to build (no UPnP support): - cd ${BITCOIN_DIR}/src + cd ${NOVACOIN_DIR}/src make -f makefile.unix USE_UPNP= BDB_INCLUDE_PATH='/usr/include/db4.8' - strip bitcoind + strip novacoind Notes ----- -The release is built with GCC and then "strip bitcoind" to strip the debug +The release is built with GCC and then "strip novacoind" to strip the debug symbols, which reduces the executable size by about 90%. @@ -116,7 +120,7 @@ sudo su Security -------- -To help make your bitcoin installation more secure by making certain attacks impossible to +To help make your novacoin installation more secure by making certain attacks impossible to exploit even if a vulnerability is found, you can take the following measures: * Position Independent Executable @@ -133,7 +137,7 @@ exploit even if a vulnerability is found, you can take the following measures: make -f makefile.unix ... -e PIE=1 To test that you have built PIE executable, install scanelf, part of paxutils, and use: - scanelf -e ./bitcoin + scanelf -e ./novacoin The output should contain: TYPE @@ -141,13 +145,13 @@ exploit even if a vulnerability is found, you can take the following measures: * 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 + vulnerable buffers are found. By default, novacoin 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: - scanelf -e ./bitcoin + scanelf -e ./novacoin the output should contain: STK/REL/PTL