Skip to content

Struct mdbx::env::reclaiming_options

ClassList > mdbx > env > reclaiming_options

Garbage reclaiming options.

  • #include <mdbx.h++>

Public Attributes

Type Name
bool lifo = {false}

Public Functions

Type Name
bool operator!= (const reclaiming_options & other) noexcept const
reclaiming_options & operator= (const reclaiming_options &) noexcept
bool operator== (const reclaiming_options & other) noexcept const
constexpr reclaiming_options () noexcept
constexpr reclaiming_options (const reclaiming_options &) noexcept
reclaiming_options (MDBX_env_flags_t) noexcept

Public Attributes Documentation

variable lifo

bool mdbx::env::reclaiming_options::lifo;

LIFO policy for recycling a Garbage Collection items.

MDBX_LIFORECLAIM flag turns on LIFO policy for recycling a Garbage Collection items, instead of FIFO by default. On systems with a disk write-back cache, this can significantly increase write performance, up to several times in a best case scenario.

LIFO recycling policy means that for reuse pages will be taken which became unused the lastest (i.e. just now or most recently). Therefore the loop of database pages circulation becomes as short as possible. In other words, the number of pages, that are overwritten in memory and on disk during a series of write transactions, will be as small as possible. Thus creates ideal conditions for the efficient operation of the disk write-back cache.

MDBX_LIFORECLAIM is compatible with all no-sync flags, but gives NO noticeable impact in combination with MDBX_SAFE_NOSYNC or MDBX_UTTERLY_NOSYNC. Because MDBX will reused pages only before the last "steady" MVCC-snapshot, i.e. the loop length of database pages circulation will be mostly defined by frequency of calling mdbx_env_sync() rather than LIFO and FIFO difference.

This flag may be changed at any time using mdbx_env_set_flags().


Public Functions Documentation

function operator!=

inline bool mdbx::env::reclaiming_options::operator!= (
    const reclaiming_options & other
) noexcept const

function operator=

reclaiming_options & mdbx::env::reclaiming_options::operator= (
    const reclaiming_options &
) noexcept

function operator==

inline bool mdbx::env::reclaiming_options::operator== (
    const reclaiming_options & other
) noexcept const

function reclaiming_options [1/3]

inline constexpr mdbx::env::reclaiming_options::reclaiming_options () noexcept

function reclaiming_options [2/3]

constexpr mdbx::env::reclaiming_options::reclaiming_options (
    const reclaiming_options &
) noexcept

function reclaiming_options [3/3]

mdbx::env::reclaiming_options::reclaiming_options (
    MDBX_env_flags_t
) noexcept


The documentation for this class was generated from the following file docs/mdbx.h++