2013-10-16 17:04:12 +02:00
|
|
|
// Copyright (c) 2013 Conformal Systems LLC.
|
|
|
|
// Use of this source code is governed by an ISC
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
|
|
|
/*
|
|
|
|
btcd is a full-node bitcoin implementation written in Go.
|
|
|
|
|
2013-10-16 17:15:56 +02:00
|
|
|
The default options are sane for most users. This means btcd will work 'out of
|
|
|
|
the box' for most users. However, there are also a wide variety of flags that
|
|
|
|
can be used to control it.
|
|
|
|
|
|
|
|
The following section provides a usage overview which enumerates the flags. An
|
|
|
|
interesting point to note is that the long form of all of these options
|
|
|
|
(except -C) can be specified in a configuration file that is automatically
|
|
|
|
parsed when btcd starts up. By default, the configuration file is located at
|
2013-11-20 01:40:56 +01:00
|
|
|
~/.btcd/btcd.conf on POSIX-style operating systems and %LOCALAPPDATA%\btcd\btcd.conf
|
2013-10-16 17:15:56 +02:00
|
|
|
on Windows. The -C (--configfile) flag, as shown below, can be used to override
|
|
|
|
this location.
|
|
|
|
|
2013-10-16 17:04:12 +02:00
|
|
|
Usage:
|
2013-10-16 17:15:56 +02:00
|
|
|
btcd [OPTIONS]
|
2013-10-16 17:04:12 +02:00
|
|
|
|
|
|
|
The flags are:
|
|
|
|
-h, --help Show this help message
|
|
|
|
-V, --version Display version information and exit
|
|
|
|
-C, --configfile= Path to configuration file
|
|
|
|
-b, --datadir= Directory to store data
|
|
|
|
-a, --addpeer= Add a peer to connect with at startup
|
|
|
|
--connect= Connect only to the specified peers at startup
|
|
|
|
--nolisten Disable listening for incoming connections -- NOTE:
|
2013-11-20 01:16:29 +01:00
|
|
|
Listening is automatically disabled if the --connect or
|
|
|
|
--proxy options are used without also specifying listen
|
|
|
|
interfaces via --listen
|
|
|
|
--listen= Add an interface/port to listen for connections (default
|
|
|
|
all interfaces port: 8333, testnet: 18333)
|
2013-10-16 17:04:12 +02:00
|
|
|
--maxpeers= Max number of inbound and outbound peers
|
|
|
|
--banduration= How long to ban misbehaving peers. Valid time units are
|
|
|
|
{s, m, h}. Minimum 1 second
|
|
|
|
-u, --rpcuser= Username for RPC connections
|
|
|
|
-P, --rpcpass= Password for RPC connections
|
2013-11-20 01:16:29 +01:00
|
|
|
--rpclisten= Add an interface/port to listen for RPC connections
|
|
|
|
(default localhost port: 8334, testnet: 18334)
|
|
|
|
--rpccert= File containing the certificate file
|
|
|
|
--rpckey= File containing the certificate key
|
2013-10-16 17:04:12 +02:00
|
|
|
--norpc Disable built-in RPC server -- NOTE: The RPC server is
|
|
|
|
disabled by default if no rpcuser/rpcpass is specified
|
|
|
|
--nodnsseed Disable DNS seeding for peers
|
|
|
|
--proxy= Connect via SOCKS5 proxy (eg. 127.0.0.1:9050)
|
|
|
|
--proxyuser= Username for proxy server
|
|
|
|
--proxypass= Password for proxy server
|
|
|
|
--tor Specifies the proxy server used is a Tor node
|
|
|
|
--testnet Use the test network
|
|
|
|
--regtest Use the regression test network
|
|
|
|
--nocheckpoints Disable built-in checkpoints. Don't do this unless you
|
2013-11-20 01:16:29 +01:00
|
|
|
know what you're doing.
|
2013-10-16 17:04:12 +02:00
|
|
|
--dbtype= Database backend to use for the Block Chain
|
|
|
|
--profile= Enable HTTP profiling on given port -- NOTE port must be
|
|
|
|
between 1024 and 65536
|
2013-11-20 01:16:29 +01:00
|
|
|
--cpuprofile= Write CPU profile to the specified file
|
2013-11-22 03:01:11 +01:00
|
|
|
-d, --debuglevel: Logging level for all subsystems {trace, debug, info,
|
|
|
|
warn, error, critical} -- You may also specify
|
|
|
|
<subsystem>=<level>,<subsystem2>=<level>,... to set the
|
|
|
|
log level for individual subsystems -- Use show to list
|
|
|
|
available subsystems
|
2013-10-16 17:15:56 +02:00
|
|
|
|
2013-10-16 17:04:12 +02:00
|
|
|
*/
|
|
|
|
package main
|