[#btck_chainstate_manager_options_set_database_cache_bytes]
= btck_chainstate_manager_options_set_database_cache_bytes
:mrdocs:

Set the total database cache used by the chainstate manager.

== Synopsis

Declared in `<kernel/bitcoinkernel.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[nodiscard, __nonnull__]]
int
btck_chainstate_manager_options_set_database_cache_bytes(
    xref:btck_ChainstateManagerOptions-08.adoc[btck_ChainstateManagerOptions]* chainstate_manager_options,
    uint64_t database_cache_bytes);
----

== Description

The total cache is split internally between the block tree database, chainstate database, and in‐memory coins cache. If this function is not called, the total cache defaults to 450 MiB.

== Return Value

0 if the set was successful, non‐zero if the set failed.

[NOTE]
====
The return value https://en.cppreference.com/cpp/language/attributes/nodiscard[should not be discarded^].
====
== Parameters

[cols="1,4"]
|===
| Name| Description
| *chainstate_manager_options* [in]
| Non‐null, options to be set.
| *database_cache_bytes* [in]
| The total database cache size in bytes. Values below 4 MiB are rejected. On 32‐bit systems, values above 1 GiB are also rejected.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#