github.com/btcsuite/btcd@v0.24.0/doc.go (about) 1 // Copyright (c) 2013-2017 The btcsuite developers 2 // Use of this source code is governed by an ISC 3 // license that can be found in the LICENSE file. 4 5 /* 6 btcd is a full-node bitcoin implementation written in Go. 7 8 The default options are sane for most users. This means btcd will work 'out of 9 the box' for most users. However, there are also a wide variety of flags that 10 can be used to control it. 11 12 The following section provides a usage overview which enumerates the flags. An 13 interesting point to note is that the long form of all of these options 14 (except -C) can be specified in a configuration file that is automatically 15 parsed when btcd starts up. By default, the configuration file is located at 16 ~/.btcd/btcd.conf on POSIX-style operating systems and %LOCALAPPDATA%\btcd\btcd.conf 17 on Windows. The -C (--configfile) flag, as shown below, can be used to override 18 this location. 19 20 Usage: 21 22 btcd [OPTIONS] 23 24 Application Options: 25 26 --addcheckpoint= Add a custom checkpoint. Format: 27 '<height>:<hash>' 28 -a, --addpeer= Add a peer to connect with at startup 29 --addrindex Maintain a full address-based transaction index 30 which makes the searchrawtransactions RPC 31 available 32 --banduration= How long to ban misbehaving peers. Valid time 33 units are {s, m, h}. Minimum 1 second (default: 34 24h0m0s) 35 --banthreshold= Maximum allowed ban score before disconnecting 36 and banning misbehaving peers. (default: 100) 37 --blockmaxsize= Maximum block size in bytes to be used when 38 creating a block (default: 750000) 39 --blockminsize= Minimum block size in bytes to be used when 40 creating a block 41 --blockmaxweight= Maximum block weight to be used when creating a 42 block (default: 3000000) 43 --blockminweight= Minimum block weight to be used when creating a 44 block 45 --blockprioritysize= Size in bytes for high-priority/low-fee 46 transactions when creating a block (default: 47 50000) 48 --blocksonly Do not accept transactions from remote peers. 49 -C, --configfile= Path to configuration file 50 --connect= Connect only to the specified peers at startup 51 --cpuprofile= Write CPU profile to the specified file 52 -b, --datadir= Directory to store data 53 --dbtype= Database backend to use for the Block Chain 54 (default: ffldb) 55 -d, --debuglevel= Logging level for all subsystems {trace, debug, 56 info, warn, error, critical} -- You may also 57 specify 58 <subsystem>=<level>,<subsystem2>=<level>,... to 59 set the log level for individual subsystems -- 60 Use show to list available subsystems (default: 61 info) 62 --dropaddrindex Deletes the address-based transaction index from 63 the database on start up and then exits. 64 --dropcfindex Deletes the index used for committed filtering 65 (CF) support from the database on start up and 66 then exits. 67 --droptxindex Deletes the hash-based transaction index from the 68 database on start up and then exits. 69 --externalip= Add an ip to the list of local addresses we claim 70 to listen on to peers 71 --generate Generate (mine) bitcoins using the CPU 72 --limitfreerelay= Limit relay of transactions with no transaction 73 fee to the given amount in thousands of bytes per 74 minute (default: 15) 75 --listen= Add an interface/port to listen for connections 76 (default all interfaces port: 8333, testnet: 77 18333, signet: 38333) 78 --logdir= Directory to log output 79 --maxorphantx= Max number of orphan transactions to keep in 80 memory (default: 100) 81 --maxpeers= Max number of inbound and outbound peers 82 (default: 125) 83 --miningaddr= Add the specified payment address to the list of 84 addresses to use for generated blocks -- At least 85 one address is required if the generate option is 86 set 87 --minrelaytxfee= The minimum transaction fee in BTC/kB to be 88 considered a non-zero fee. (default: 1e-05) 89 --nobanning Disable banning of misbehaving peers 90 --nocfilters Disable committed filtering (CF) support 91 --nocheckpoints Disable built-in checkpoints. Don't do this 92 unless you know what you're doing. 93 --nodnsseed Disable DNS seeding for peers 94 --nolisten Disable listening for incoming connections -- 95 NOTE: Listening is automatically disabled if the 96 --connect or --proxy options are used without 97 also specifying listen interfaces via --listen 98 --noonion Disable connecting to tor hidden services 99 --nopeerbloomfilters Disable bloom filtering support 100 --norelaypriority Do not require free or low-fee transactions to 101 have high priority for relaying 102 --norpc Disable built-in RPC server -- NOTE: The RPC 103 server is disabled by default if no 104 rpcuser/rpcpass or rpclimituser/rpclimitpass is 105 specified 106 --notls Disable TLS for the RPC server -- NOTE: This is 107 only allowed if the RPC server is bound to 108 localhost 109 --onion= Connect to tor hidden services via SOCKS5 proxy 110 (eg. 127.0.0.1:9050) 111 --onionpass= Password for onion proxy server 112 --onionuser= Username for onion proxy server 113 --profile= Enable HTTP profiling on given port -- NOTE port 114 must be between 1024 and 65536 115 --proxy= Connect via SOCKS5 proxy (eg. 127.0.0.1:9050) 116 --proxypass= Password for proxy server 117 --proxyuser= Username for proxy server 118 --regtest Use the regression test network 119 --rejectnonstd Reject non-standard transactions regardless of 120 the default settings for the active network. 121 --relaynonstd Relay non-standard transactions regardless of the 122 default settings for the active network. 123 --rpccert= File containing the certificate file 124 --rpckey= File containing the certificate key 125 --rpclimitpass= Password for limited RPC connections 126 --rpclimituser= Username for limited RPC connections 127 --rpclisten= Add an interface/port to listen for RPC 128 connections (default port: 8334, testnet: 18334) 129 --rpcmaxclients= Max number of RPC clients for standard 130 connections (default: 10) 131 --rpcmaxconcurrentreqs= Max number of concurrent RPC requests that may be 132 processed concurrently (default: 20) 133 --rpcmaxwebsockets= Max number of RPC websocket connections (default: 134 25) 135 --rpcquirks Mirror some JSON-RPC quirks of Bitcoin Core -- 136 NOTE: Discouraged unless interoperability issues 137 need to be worked around 138 -P, --rpcpass= Password for RPC connections 139 -u, --rpcuser= Username for RPC connections 140 --sigcachemaxsize= The maximum number of entries in the signature 141 verification cache (default: 100000) 142 --simnet Use the simulation test network 143 --testnet Use the test network 144 --torisolation Enable Tor stream isolation by randomizing user 145 credentials for each connection. 146 --trickleinterval= Minimum time between attempts to send new 147 inventory to a connected peer (default: 10s) 148 --txindex Maintain a full hash-based transaction index 149 which makes all transactions available via the 150 getrawtransaction RPC 151 --uacomment= Comment to add to the user agent -- See BIP 14 152 for more information. 153 --upnp Use UPnP to map our listening port outside of NAT 154 -V, --version Display version information and exit 155 --whitelist= Add an IP network or IP that will not be banned. 156 (eg. 192.168.1.0/24 or ::1) 157 158 Help Options: 159 160 -h, --help Show this help message 161 */ 162 package main