2010-07-14 11:54:31 -04:00
|
|
|
// Copyright (c) 2009-2010 Satoshi Nakamoto
|
2020-04-16 13:14:08 -04:00
|
|
|
// Copyright (c) 2009-2020 The Bitcoin Core developers
|
2014-11-30 22:39:44 -03:00
|
|
|
// Distributed under the MIT software license, see the accompanying
|
2012-05-18 10:02:28 -04:00
|
|
|
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
2013-04-13 02:13:08 -03:00
|
|
|
|
2011-05-15 03:11:04 -04:00
|
|
|
#ifndef BITCOIN_INIT_H
|
|
|
|
#define BITCOIN_INIT_H
|
2010-07-14 11:54:31 -04:00
|
|
|
|
2020-11-30 20:36:36 -03:00
|
|
|
#include <any>
|
2018-02-21 13:38:53 -03:00
|
|
|
#include <memory>
|
2013-10-19 13:42:14 -03:00
|
|
|
#include <string>
|
|
|
|
|
2021-01-25 18:45:54 -03:00
|
|
|
//! Default value for -daemon option
|
|
|
|
static constexpr bool DEFAULT_DAEMON = false;
|
|
|
|
//! Default value for -daemonwait option
|
|
|
|
static constexpr bool DEFAULT_DAEMONWAIT = false;
|
|
|
|
|
2020-08-21 14:13:40 -04:00
|
|
|
class ArgsManager;
|
2019-09-17 19:28:03 -03:00
|
|
|
struct NodeContext;
|
2020-05-19 09:13:50 -04:00
|
|
|
namespace interfaces {
|
|
|
|
struct BlockAndHeaderTipInfo;
|
|
|
|
}
|
2013-04-13 02:13:08 -03:00
|
|
|
|
evhttpd implementation
- *Replace usage of boost::asio with [libevent2](http://libevent.org/)*.
boost::asio is not part of C++11, so unlike other boost there is no
forwards-compatibility reason to stick with it. Together with #4738 (convert
json_spirit to UniValue), this rids Bitcoin Core of the worst offenders with
regard to compile-time slowness.
- *Replace spit-and-duct-tape http server with evhttp*. Front-end http handling
is handled by libevent, a work queue (with configurable depth and parallelism)
is used to handle application requests.
- *Wrap HTTP request in C++ class*; this makes the application code mostly
HTTP-server-neutral
- *Refactor RPC to move all http-specific code to a separate file*.
Theoreticaly this can allow building without HTTP server but with another RPC
backend, e.g. Qt's debug console (currently not implemented) or future RPC
mechanisms people may want to use.
- *HTTP dispatch mechanism*; services (e.g., RPC, REST) register which URL
paths they want to handle.
By using a proven, high-performance asynchronous networking library (also used
by Tor) and HTTP server, problems such as #5674, #5655, #344 should be avoided.
What works? bitcoind, bitcoin-cli, bitcoin-qt. Unit tests and RPC/REST tests
pass. The aim for now is everything but SSL support.
Configuration options:
- `-rpcthreads`: repurposed as "number of work handler threads". Still
defaults to 4.
- `-rpcworkqueue`: maximum depth of work queue. When this is reached, new
requests will return a 500 Internal Error.
- `-rpctimeout`: inactivity time, in seconds, after which to disconnect a
client.
- `-debug=http`: low-level http activity logging
2015-01-23 03:53:17 -03:00
|
|
|
/** Interrupt threads */
|
2019-09-17 19:28:03 -03:00
|
|
|
void Interrupt(NodeContext& node);
|
2019-09-17 18:04:39 -03:00
|
|
|
void Shutdown(NodeContext& node);
|
2015-11-26 10:03:27 -03:00
|
|
|
//!Initialize the logging infrastructure
|
2020-08-21 14:13:40 -04:00
|
|
|
void InitLogging(const ArgsManager& args);
|
2015-10-08 04:58:31 -03:00
|
|
|
//!Parameter interaction: change current parameters depending on various rules
|
2020-08-21 14:13:40 -04:00
|
|
|
void InitParameterInteraction(ArgsManager& args);
|
2016-10-25 06:34:27 -03:00
|
|
|
|
|
|
|
/** Initialize bitcoin core: Basic context setup.
|
2017-07-15 04:46:06 -04:00
|
|
|
* @note This can be done before daemonization. Do not call Shutdown() if this function fails.
|
2016-10-25 06:34:27 -03:00
|
|
|
* @pre Parameters should be parsed and config file should be read.
|
|
|
|
*/
|
2020-12-05 21:14:17 -03:00
|
|
|
bool AppInitBasicSetup(const ArgsManager& args);
|
2016-10-25 06:34:27 -03:00
|
|
|
/**
|
|
|
|
* Initialization: parameter interaction.
|
2017-07-15 04:46:06 -04:00
|
|
|
* @note This can be done before daemonization. Do not call Shutdown() if this function fails.
|
2016-10-25 06:34:27 -03:00
|
|
|
* @pre Parameters should be parsed and config file should be read, AppInitBasicSetup should have been called.
|
|
|
|
*/
|
2020-08-21 14:13:40 -04:00
|
|
|
bool AppInitParameterInteraction(const ArgsManager& args);
|
2016-10-25 06:34:27 -03:00
|
|
|
/**
|
|
|
|
* Initialization sanity checks: ecc init, sanity checks, dir lock.
|
2017-07-15 04:46:06 -04:00
|
|
|
* @note This can be done before daemonization. Do not call Shutdown() if this function fails.
|
2016-10-25 06:34:27 -03:00
|
|
|
* @pre Parameters should be parsed and config file should be read, AppInitParameterInteraction should have been called.
|
|
|
|
*/
|
|
|
|
bool AppInitSanityChecks();
|
|
|
|
/**
|
2017-07-15 04:46:06 -04:00
|
|
|
* Lock bitcoin core data directory.
|
|
|
|
* @note This should only be done after daemonization. Do not call Shutdown() if this function fails.
|
2016-10-25 06:34:27 -03:00
|
|
|
* @pre Parameters should be parsed and config file should be read, AppInitSanityChecks should have been called.
|
|
|
|
*/
|
2017-07-15 04:46:06 -04:00
|
|
|
bool AppInitLockDataDirectory();
|
2020-05-29 00:07:18 -04:00
|
|
|
/**
|
|
|
|
* Initialize node and wallet interface pointers. Has no prerequisites or side effects besides allocating memory.
|
|
|
|
*/
|
|
|
|
bool AppInitInterfaces(NodeContext& node);
|
2017-07-15 04:46:06 -04:00
|
|
|
/**
|
|
|
|
* Bitcoin core main initialization.
|
|
|
|
* @note This should only be done after daemonization. Call Shutdown() if this function fails.
|
|
|
|
* @pre Parameters should be parsed and config file should be read, AppInitLockDataDirectory should have been called.
|
|
|
|
*/
|
2021-04-02 14:35:01 -03:00
|
|
|
bool AppInitMain(NodeContext& node, interfaces::BlockAndHeaderTipInfo* tip_info = nullptr);
|
2013-10-11 18:09:59 -03:00
|
|
|
|
2018-04-28 17:54:58 -03:00
|
|
|
/**
|
2020-04-08 19:47:56 -04:00
|
|
|
* Register all arguments with the ArgsManager
|
2018-04-28 17:54:58 -03:00
|
|
|
*/
|
2017-12-05 17:57:12 -03:00
|
|
|
void SetupServerArgs(ArgsManager& argsman);
|
2013-10-11 18:09:59 -03:00
|
|
|
|
2014-06-10 10:02:46 -04:00
|
|
|
/** Returns licensing information (for -version) */
|
|
|
|
std::string LicenseInfo();
|
2011-05-15 03:11:04 -04:00
|
|
|
|
2014-08-28 16:21:03 -04:00
|
|
|
#endif // BITCOIN_INIT_H
|