[#util-log]
= xref:util.adoc[util]::log
:relfileprefix: ../
:mrdocs:

Application‐agnostic logging interface shared across Bitcoin Core.

== Types

[cols="1,4"]
|===
| Name| Description
| xref:util/log/Entry.adoc[`Entry`] 
| A single log message together with its metadata.
| xref:util/log/NoRateLimitTag.adoc[`NoRateLimitTag`] 
| Structure and constant for tagging not to rate limit.
|===


== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:util/log/Category.adoc[`Category`] 
| Opaque to util::log; interpreted by consumers (e.g., BCLog::LogFlags).
|===


== Enums

[cols="1,4"]
|===
| Name| Description
| xref:util/log/Level.adoc[`Level`] 
| Severity level of a log entry.
|===


== Functions

[cols="1,4"]
|===
| Name| Description
| xref:util/log/Log.adoc[`Log`] 
| Send message to be logged. Applications using the logging library need to provide this.
| xref:util/log/LogPrintFormatInternal-08.adoc[`LogPrintFormatInternal`] 
| `LogPrintFormatInternal` overloads
| xref:util/log/LogPrintFormatInternal_.adoc[`LogPrintFormatInternal_`] 
| Format a log message and forward it to util::log::Log.
| xref:util/log/ShouldDebugLog.adoc[`ShouldDebugLog`] 
| Return whether messages with specified category should be debug logged. Applications using the logging library need to provide this.
| xref:util/log/ShouldTraceLog.adoc[`ShouldTraceLog`] 
| Return whether messages with specified category should be trace logged. Applications using the logging library need to provide this.
|===


== Variables

[cols="1,4"]
|===
| Name| Description
| xref:util/log/NO_RATE_LIMIT.adoc[`NO_RATE_LIMIT`] 
| Tag value passed to logging macros to opt out of rate limiting.
|===



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