Changeset View
Changeset View
Standalone View
Standalone View
doc/man/bitcoind.1
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.5. | .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. | ||||
.TH BITCOIND "1" "November 2017" "bitcoind v0.16.0.0" "User Commands" | .TH BITCOIND "1" "April 2018" "bitcoind v0.17.1.0" "User Commands" | ||||
.SH NAME | .SH NAME | ||||
bitcoind \- manual page for bitcoind v0.16.0.0 | bitcoind \- manual page for bitcoind v0.17.1.0 | ||||
.SH DESCRIPTION | .SH DESCRIPTION | ||||
Bitcoin ABC Daemon version v0.16.0.0\-c5cfdf732 | Bitcoin ABC Daemon version v0.17.1.0 | ||||
.SS "Usage:" | .SS "Usage:" | ||||
.TP | .TP | ||||
bitcoind [options] | bitcoind [options] | ||||
Start Bitcoin ABC Daemon | Start Bitcoin ABC Daemon | ||||
.SH OPTIONS | .SH OPTIONS | ||||
.HP | .HP | ||||
\-? | \-? | ||||
.IP | .IP | ||||
Show All 13 Lines | |||||
Execute command when the best block changes (%s in cmd is replaced by | Execute command when the best block changes (%s in cmd is replaced by | ||||
block hash) | block hash) | ||||
.HP | .HP | ||||
\fB\-assumevalid=\fR<hex> | \fB\-assumevalid=\fR<hex> | ||||
.IP | .IP | ||||
If this block is in the chain assume that it and its ancestors are valid | If this block is in the chain assume that it and its ancestors are valid | ||||
and potentially skip their script verification (0 to verify all, | and potentially skip their script verification (0 to verify all, | ||||
default: | default: | ||||
000000000000000004694d6c74b532faf99fc072181f870bfb4a6c9930f7440c, | 000000000000000001ad94189e956f1c1c28c8c34d2aae9bb8ce0c7f2b93b287, | ||||
testnet: | testnet: | ||||
00000000ba37a638c096da8e1a843df68f4cc9754124f11034a0b613bbf4ca3e) | 000000004ca1bb261765b723cab6c90d0ecfabe1aad8c16a12378c015ab35e78) | ||||
.HP | .HP | ||||
\fB\-conf=\fR<file> | \fB\-conf=\fR<file> | ||||
.IP | .IP | ||||
Specify configuration file (default: bitcoin.conf) | Specify configuration file (default: bitcoin.conf) | ||||
.HP | .HP | ||||
\fB\-daemon\fR | \fB\-daemon\fR | ||||
.IP | .IP | ||||
Run in the background as a daemon and accept commands | Run in the background as a daemon and accept commands | ||||
Show All 18 Lines | |||||
.IP | .IP | ||||
Keep the transaction memory pool below <n> megabytes (default: 300) | Keep the transaction memory pool below <n> megabytes (default: 300) | ||||
.HP | .HP | ||||
\fB\-mempoolexpiry=\fR<n> | \fB\-mempoolexpiry=\fR<n> | ||||
.IP | .IP | ||||
Do not keep transactions in the mempool longer than <n> hours (default: | Do not keep transactions in the mempool longer than <n> hours (default: | ||||
336) | 336) | ||||
.HP | .HP | ||||
\fB\-persistmempool\fR | |||||
.IP | |||||
Whether to save the mempool on shutdown and load on restart (default: 1) | |||||
.HP | |||||
\fB\-blockreconstructionextratxn=\fR<n> | \fB\-blockreconstructionextratxn=\fR<n> | ||||
.IP | .IP | ||||
Extra transactions to keep in memory for compact block reconstructions | Extra transactions to keep in memory for compact block reconstructions | ||||
(default: 100) | (default: 100) | ||||
.HP | .HP | ||||
\fB\-par=\fR<n> | \fB\-par=\fR<n> | ||||
.IP | .IP | ||||
Set the number of script verification threads (\fB\-4\fR to 16, 0 = auto, <0 = | Set the number of script verification threads (\fB\-6\fR to 16, 0 = auto, <0 = | ||||
leave that many cores free, default: 0) | leave that many cores free, default: 0) | ||||
.HP | .HP | ||||
\fB\-pid=\fR<file> | \fB\-pid=\fR<file> | ||||
.IP | .IP | ||||
Specify pid file (default: bitcoind.pid) | Specify pid file (default: bitcoind.pid) | ||||
.HP | .HP | ||||
\fB\-prune=\fR<n> | \fB\-prune=\fR<n> | ||||
.IP | .IP | ||||
Show All 19 Lines | |||||
.IP | .IP | ||||
Create new files with system default permissions, instead of umask 077 | Create new files with system default permissions, instead of umask 077 | ||||
(only effective with disabled wallet functionality) | (only effective with disabled wallet functionality) | ||||
.HP | .HP | ||||
\fB\-txindex\fR | \fB\-txindex\fR | ||||
.IP | .IP | ||||
Maintain a full transaction index, used by the getrawtransaction rpc | Maintain a full transaction index, used by the getrawtransaction rpc | ||||
call (default: 0) | call (default: 0) | ||||
.HP | |||||
\fB\-usecashaddr\fR | |||||
.IP | |||||
Use Cash Address for destination encoding instead of base58 (activate by | |||||
default on Jan, 14) | |||||
.PP | .PP | ||||
Connection options: | Connection options: | ||||
.HP | .HP | ||||
\fB\-addnode=\fR<ip> | \fB\-addnode=\fR<ip> | ||||
.IP | .IP | ||||
Add a node to connect to and attempt to keep the connection open | Add a node to connect to and attempt to keep the connection open | ||||
.HP | .HP | ||||
\fB\-banscore=\fR<n> | \fB\-banscore=\fR<n> | ||||
▲ Show 20 Lines • Show All 107 Lines • ▼ Show 20 Lines | |||||
.IP | .IP | ||||
Tor control port to use if onion listening enabled (default: | Tor control port to use if onion listening enabled (default: | ||||
127.0.0.1:9051) | 127.0.0.1:9051) | ||||
.HP | .HP | ||||
\fB\-torpassword=\fR<pass> | \fB\-torpassword=\fR<pass> | ||||
.IP | .IP | ||||
Tor control port password (default: empty) | Tor control port password (default: empty) | ||||
.HP | .HP | ||||
\fB\-upnp\fR | |||||
.IP | |||||
Use UPnP to map the listening port (default: 0) | |||||
.HP | |||||
\fB\-whitebind=\fR<addr> | \fB\-whitebind=\fR<addr> | ||||
.IP | .IP | ||||
Bind to given address and whitelist peers connecting to it. Use | Bind to given address and whitelist peers connecting to it. Use | ||||
[host]:port notation for IPv6 | [host]:port notation for IPv6 | ||||
.HP | .HP | ||||
\fB\-whitelist=\fR<IP address or network> | \fB\-whitelist=\fR<IP address or network> | ||||
.IP | .IP | ||||
Whitelist peers connecting from the given IP address (e.g. 1.2.3.4) or | Whitelist peers connecting from the given IP address (e.g. 1.2.3.4) or | ||||
Show All 20 Lines | |||||
Wallet options: | Wallet options: | ||||
.HP | .HP | ||||
\fB\-disablewallet\fR | \fB\-disablewallet\fR | ||||
.IP | .IP | ||||
Do not load the wallet and disable wallet RPC calls | Do not load the wallet and disable wallet RPC calls | ||||
.HP | .HP | ||||
\fB\-keypool=\fR<n> | \fB\-keypool=\fR<n> | ||||
.IP | .IP | ||||
Set key pool size to <n> (default: 100) | Set key pool size to <n> (default: 1000) | ||||
.HP | .HP | ||||
\fB\-fallbackfee=\fR<amt> | \fB\-fallbackfee=\fR<amt> | ||||
.IP | .IP | ||||
A fee rate (in BCC/kB) that will be used when fee estimation has | A fee rate (in BCH/kB) that will be used when fee estimation has | ||||
insufficient data (default: 0.0002) | insufficient data (default: 0.0002) | ||||
.HP | .HP | ||||
\fB\-mintxfee=\fR<amt> | \fB\-mintxfee=\fR<amt> | ||||
.IP | .IP | ||||
Fees (in BCC/kB) smaller than this are considered zero fee for | Fees (in BCH/kB) smaller than this are considered zero fee for | ||||
transaction creation (default: 0.00001) | transaction creation (default: 0.00001) | ||||
.HP | .HP | ||||
\fB\-paytxfee=\fR<amt> | \fB\-paytxfee=\fR<amt> | ||||
.IP | .IP | ||||
Fee (in BCC/kB) to add to transactions you send (default: 0.00) | Fee (in BCH/kB) to add to transactions you send (default: 0.00) | ||||
.HP | .HP | ||||
\fB\-rescan\fR | \fB\-rescan\fR | ||||
.IP | .IP | ||||
Rescan the block chain for missing wallet transactions on startup | Rescan the block chain for missing wallet transactions on startup | ||||
.HP | .HP | ||||
\fB\-salvagewallet\fR | \fB\-salvagewallet\fR | ||||
.IP | .IP | ||||
Attempt to recover private keys from a corrupt wallet on startup | Attempt to recover private keys from a corrupt wallet on startup | ||||
Show All 31 Lines | |||||
.HP | .HP | ||||
\fB\-zapwallettxes=\fR<mode> | \fB\-zapwallettxes=\fR<mode> | ||||
.IP | .IP | ||||
Delete all wallet transactions and only recover those parts of the | Delete all wallet transactions and only recover those parts of the | ||||
blockchain through \fB\-rescan\fR on startup (1 = keep tx meta data e.g. | blockchain through \fB\-rescan\fR on startup (1 = keep tx meta data e.g. | ||||
account owner and payment request information, 2 = drop tx meta | account owner and payment request information, 2 = drop tx meta | ||||
data) | data) | ||||
.PP | .PP | ||||
ZeroMQ notification options: | |||||
.HP | |||||
\fB\-zmqpubhashblock=\fR<address> | |||||
.IP | |||||
Enable publish hash block in <address> | |||||
.HP | |||||
\fB\-zmqpubhashtx=\fR<address> | |||||
.IP | |||||
Enable publish hash transaction in <address> | |||||
.HP | |||||
\fB\-zmqpubrawblock=\fR<address> | |||||
.IP | |||||
Enable publish raw block in <address> | |||||
.HP | |||||
\fB\-zmqpubrawtx=\fR<address> | |||||
.IP | |||||
Enable publish raw transaction in <address> | |||||
.PP | |||||
Debugging/Testing options: | Debugging/Testing options: | ||||
.HP | .HP | ||||
\fB\-uacomment=\fR<cmt> | \fB\-uacomment=\fR<cmt> | ||||
.IP | .IP | ||||
Append comment to the user agent string | Append comment to the user agent string | ||||
.HP | .HP | ||||
\fB\-debug=\fR<category> | \fB\-debug=\fR<category> | ||||
.IP | .IP | ||||
Output debugging information (default: 0, supplying <category> is | Output debugging information (default: 0, supplying <category> is | ||||
optional). If <category> is not supplied or if <category> = 1, | optional). If <category> is not supplied or if <category> = 1, | ||||
output all debugging information.<category> can be: addrman, | output all debugging information.<category> can be: net, tor, | ||||
alert, bench, cmpctblock, coindb, db, http, libevent, lock, | mempool, http, bench, zmq, db, rpc, estimatefee, addrman, | ||||
mempool, mempoolrej, net, proxy, prune, rand, reindex, rpc, | selectcoins, reindex, cmpctblock, rand, prune, proxy, mempoolrej, | ||||
selectcoins, tor, zmq. | libevent, coindb, qt, leveldb. | ||||
.HP | |||||
\fB\-debugexclude=\fR<category> | |||||
.IP | |||||
Exclude debugging information for a category. Can be used in conjunction | |||||
with \fB\-debug\fR=\fI\,1\/\fR to output debug logs for all categories except one | |||||
or more specified categories. | |||||
.HP | .HP | ||||
\fB\-help\-debug\fR | \fB\-help\-debug\fR | ||||
.IP | .IP | ||||
Show all debugging options (usage: \fB\-\-help\fR \fB\-help\-debug\fR) | Show all debugging options (usage: \fB\-\-help\fR \fB\-help\-debug\fR) | ||||
.HP | .HP | ||||
\fB\-logips\fR | \fB\-logips\fR | ||||
.IP | .IP | ||||
Include IP addresses in debug output (default: 0) | Include IP addresses in debug output (default: 0) | ||||
.HP | .HP | ||||
\fB\-logtimestamps\fR | \fB\-logtimestamps\fR | ||||
.IP | .IP | ||||
Prepend debug output with timestamp (default: 1) | Prepend debug output with timestamp (default: 1) | ||||
.HP | .HP | ||||
\fB\-excessutxocharge=\fR<amt> | |||||
.IP | |||||
Fees (in BCH/kB) to charge per utxo created forrelaying, and mining | |||||
(default: 0.00) | |||||
.HP | |||||
\fB\-minrelaytxfee=\fR<amt> | \fB\-minrelaytxfee=\fR<amt> | ||||
.IP | .IP | ||||
Fees (in BCC/kB) smaller than this are considered zero fee for relaying, | Fees (in BCH/kB) smaller than this are considered zero fee for relaying, | ||||
mining and transaction creation (default: 0.00001) | mining and transaction creation (default: 0.00001) | ||||
.HP | .HP | ||||
\fB\-maxtxfee=\fR<amt> | \fB\-maxtxfee=\fR<amt> | ||||
.IP | .IP | ||||
Maximum total fees (in BCC) to use in a single wallet transaction or raw | Maximum total fees (in BCH) to use in a single wallet transaction or raw | ||||
transaction; setting this too low may abort large transactions | transaction; setting this too low may abort large transactions | ||||
(default: 0.10) | (default: 0.10) | ||||
.HP | .HP | ||||
\fB\-printtoconsole\fR | \fB\-printtoconsole\fR | ||||
.IP | .IP | ||||
Send trace/debug info to console instead of debug.log file | Send trace/debug info to console instead of debug.log file | ||||
.HP | .HP | ||||
\fB\-shrinkdebugfile\fR | \fB\-shrinkdebugfile\fR | ||||
Show All 15 Lines | |||||
.HP | .HP | ||||
\fB\-datacarrier\fR | \fB\-datacarrier\fR | ||||
.IP | .IP | ||||
Relay and mine data carrier transactions (default: 1) | Relay and mine data carrier transactions (default: 1) | ||||
.HP | .HP | ||||
\fB\-datacarriersize\fR | \fB\-datacarriersize\fR | ||||
.IP | .IP | ||||
Maximum size of data in data carrier transactions we relay and mine | Maximum size of data in data carrier transactions we relay and mine | ||||
(default: 83) | (pre\-fork default: 83, post\-fork default: 223) | ||||
.PP | .PP | ||||
Block creation options: | Block creation options: | ||||
.HP | .HP | ||||
\fB\-blockmaxsize=\fR<n> | \fB\-blockmaxsize=\fR<n> | ||||
.IP | .IP | ||||
Set maximum block size in bytes (default: 2000000) | Set maximum block size in bytes (default: 2000000) | ||||
.HP | .HP | ||||
\fB\-blockprioritypercentage=\fR<n> | \fB\-blockprioritypercentage=\fR<n> | ||||
.IP | .IP | ||||
Set maximum percentage of a block reserved to high\-priority/low\-fee | Set maximum percentage of a block reserved to high\-priority/low\-fee | ||||
transactions (default: 5) | transactions (default: 5) | ||||
.HP | .HP | ||||
\fB\-blockmintxfee=\fR<amt> | \fB\-blockmintxfee=\fR<amt> | ||||
.IP | .IP | ||||
Set lowest fee rate (in BCC/kB) for transactions to be included in block | Set lowest fee rate (in BCH/kB) for transactions to be included in block | ||||
creation. (default: 0.00001) | creation. (default: 0.00001) | ||||
.PP | .PP | ||||
RPC server options: | RPC server options: | ||||
.HP | .HP | ||||
\fB\-server\fR | \fB\-server\fR | ||||
.IP | .IP | ||||
Accept command line and JSON\-RPC commands | Accept command line and JSON\-RPC commands | ||||
.HP | .HP | ||||
Show All 38 Lines | |||||
Allow JSON\-RPC connections from specified source. Valid for <ip> are a | Allow JSON\-RPC connections from specified source. Valid for <ip> are a | ||||
single IP (e.g. 1.2.3.4), a network/netmask (e.g. | single IP (e.g. 1.2.3.4), a network/netmask (e.g. | ||||
1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). This | 1.2.3.4/255.255.255.0) or a network/CIDR (e.g. 1.2.3.4/24). This | ||||
option can be specified multiple times | option can be specified multiple times | ||||
.HP | .HP | ||||
\fB\-rpcthreads=\fR<n> | \fB\-rpcthreads=\fR<n> | ||||
.IP | .IP | ||||
Set the number of threads to service RPC calls (default: 4) | Set the number of threads to service RPC calls (default: 4) | ||||
.HP | |||||
\fB\-rpccorsdomain\fR=\fI\,value\/\fR | |||||
.IP | |||||
Domain from which to accept cross origin requests (browser enforced) | |||||
.SH COPYRIGHT | .SH COPYRIGHT | ||||
Copyright (C) 2009-2017 The Bitcoin developers | Copyright (C) 2009-2018 The Bitcoin developers | ||||
Copyright (C) 2009-2017 The Bitcoin Core developers | |||||
Please contribute if you find Bitcoin ABC useful. Visit | Please contribute if you find Bitcoin ABC useful. Visit | ||||
<https://www.bitcoinabc.org> for further information about the software. | <https://www.bitcoinabc.org> for further information about the software. | ||||
The source code is available from <https://github.com/Bitcoin-ABC/bitcoin-abc>. | The source code is available from <https://github.com/Bitcoin-ABC/bitcoin-abc>. | ||||
This is experimental software. | This is experimental software. | ||||
Distributed under the MIT software license, see the accompanying file COPYING | Distributed under the MIT software license, see the accompanying file COPYING | ||||
or <https://opensource.org/licenses/MIT> | or <https://opensource.org/licenses/MIT> | ||||
This product includes software developed by the OpenSSL Project for use in the | This product includes software developed by the OpenSSL Project for use in the | ||||
OpenSSL Toolkit <https://www.openssl.org> and cryptographic software written by | OpenSSL Toolkit <https://www.openssl.org> and cryptographic software written by | ||||
Eric Young and UPnP software written by Thomas Bernard. | Eric Young and UPnP software written by Thomas Bernard. |