CCoinsViewErrorCatcher Class Reference

This is a minimally invasive approach to shutdown on LevelDB read errors from the chainstate, while keeping user interface out of the common library, which is shared between bitcoind, and bitcoin-qt and non-server tools. More...

#include <coins.h>

Inheritance diagram for CCoinsViewErrorCatcher:

Collaboration diagram for CCoinsViewErrorCatcher:

Public Member Functions
	CCoinsViewErrorCatcher (CCoinsView *view)
void	AddReadErrCallback (std::function< void()> f)
std::optional< Coin >	GetCoin (const COutPoint &outpoint) const override
	Retrieve the Coin (unspent transaction output) for a given outpoint. More...
bool	HaveCoin (const COutPoint &outpoint) const override
	Just check whether a given outpoint is unspent. More...
std::optional< Coin >	PeekCoin (const COutPoint &outpoint) const override
	Retrieve the Coin (unspent transaction output) for a given outpoint, without caching results. More...
Public Member Functions inherited from CCoinsViewBacked
	CCoinsViewBacked (CCoinsView *viewIn)
std::optional< Coin >	GetCoin (const COutPoint &outpoint) const override
	Retrieve the Coin (unspent transaction output) for a given outpoint. More...
std::optional< Coin >	PeekCoin (const COutPoint &outpoint) const override
	Retrieve the Coin (unspent transaction output) for a given outpoint, without caching results. More...
bool	HaveCoin (const COutPoint &outpoint) const override
	Just check whether a given outpoint is unspent. More...
uint256	GetBestBlock () const override
	Retrieve the block hash whose state this CCoinsView currently represents. More...
std::vector< uint256 >	GetHeadBlocks () const override
	Retrieve the range of blocks that may have been only partially written. More...
void	SetBackend (CCoinsView &viewIn)
void	BatchWrite (CoinsViewCacheCursor &cursor, const uint256 &hashBlock) override
	Do a bulk modification (multiple Coin changes + BestBlock change). More...
std::unique_ptr< CCoinsViewCursor >	Cursor () const override
	Get a cursor to iterate over the whole state. More...
size_t	EstimateSize () const override
	Estimate database size (0 if not implemented) More...
Public Member Functions inherited from CCoinsView
virtual std::optional< Coin >	GetCoin (const COutPoint &outpoint) const
	Retrieve the Coin (unspent transaction output) for a given outpoint. More...
virtual std::optional< Coin >	PeekCoin (const COutPoint &outpoint) const
	Retrieve the Coin (unspent transaction output) for a given outpoint, without caching results. More...
virtual bool	HaveCoin (const COutPoint &outpoint) const
	Just check whether a given outpoint is unspent. More...
virtual uint256	GetBestBlock () const
	Retrieve the block hash whose state this CCoinsView currently represents. More...
virtual std::vector< uint256 >	GetHeadBlocks () const
	Retrieve the range of blocks that may have been only partially written. More...
virtual void	BatchWrite (CoinsViewCacheCursor &cursor, const uint256 &hashBlock)
	Do a bulk modification (multiple Coin changes + BestBlock change). More...
virtual std::unique_ptr< CCoinsViewCursor >	Cursor () const
	Get a cursor to iterate over the whole state. More...
virtual	~CCoinsView ()=default
	As we use CCoinsViews polymorphically, have a virtual destructor. More...
virtual size_t	EstimateSize () const
	Estimate database size (0 if not implemented) More...

Private Attributes
std::vector< std::function< void()> >	m_err_callbacks
	A list of callbacks to execute upon leveldb read error. More...

Additional Inherited Members
Protected Attributes inherited from CCoinsViewBacked
CCoinsView *	base

Detailed Description

This is a minimally invasive approach to shutdown on LevelDB read errors from the chainstate, while keeping user interface out of the common library, which is shared between bitcoind, and bitcoin-qt and non-server tools.

Writes do not need similar protection, as failure to write is handled by the caller.

Definition at line 570 of file coins.h.

Constructor & Destructor Documentation

CCoinsViewErrorCatcher()

CCoinsViewErrorCatcher::CCoinsViewErrorCatcher ( CCoinsView *  view )

inlineexplicit

Definition at line 573 of file coins.h.

Member Function Documentation

AddReadErrCallback()

void CCoinsViewErrorCatcher::AddReadErrCallback ( std::function< void()>  f )

inline

Definition at line 575 of file coins.h.

GetCoin()

std::optional< Coin > CCoinsViewErrorCatcher::GetCoin ( const COutPoint &  outpoint ) const

overridevirtual

Retrieve the Coin (unspent transaction output) for a given outpoint.

May populate the cache. Use PeekCoin() to perform a non-caching lookup.

Reimplemented from CCoinsViewBacked.

Definition at line 415 of file coins.cpp.

Here is the call graph for this function:

HaveCoin()

bool CCoinsViewErrorCatcher::HaveCoin ( const COutPoint &  outpoint ) const

overridevirtual

Just check whether a given outpoint is unspent.

May populate the cache. Use PeekCoin() to perform a non-caching lookup.

Reimplemented from CCoinsViewBacked.

Definition at line 420 of file coins.cpp.

Here is the call graph for this function:

PeekCoin()

std::optional< Coin > CCoinsViewErrorCatcher::PeekCoin ( const COutPoint &  outpoint ) const

overridevirtual

Retrieve the Coin (unspent transaction output) for a given outpoint, without caching results.

Does not populate the cache. Use GetCoin() to cache the result.

Reimplemented from CCoinsViewBacked.

Definition at line 425 of file coins.cpp.

Here is the call graph for this function:

Member Data Documentation

m_err_callbacks

std::vector<std::function<void()> > CCoinsViewErrorCatcher::m_err_callbacks

private

A list of callbacks to execute upon leveldb read error.

Definition at line 585 of file coins.h.

---

The documentation for this class was generated from the following files:

• src/coins.h
• src/coins.cpp