Logging - Thread Stack#

This module includes OpenThread logging related definitions.

Functions#

Returns the current log level.

otLoggingSetLevel(otLogLevel aLogLevel)

Sets the log level.

void
otLogCritPlat(const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at critical log level.

void void
otLogWarnPlat(const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at warning log level.

void void void
otLogNotePlat(const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at note log level.

void void void void
otLogInfoPlat(const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at info log level.

void void void void void
otLogDebgPlat(const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at debug log level.

void void void void void void
otDumpCritPlat(const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at critical log level.

void
otDumpWarnPlat(const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at warning log level.

void
otDumpNotePlat(const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at note log level.

void
otDumpInfoPlat(const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at info log level.

void
otDumpDebgPlat(const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at debug log level.

void
otLogCli(otLogLevel aLogLevel, const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2

Emits a log message at a given log level.

Function Documentation#

otLoggingGetLevel#

otLogLevel otLoggingGetLevel (void)

Returns the current log level.

Parameters
N/A

If dynamic log level feature OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE is enabled, this function returns the currently set dynamic log level. Otherwise, this function returns the build-time configured log level.

Returns

  • The log level.


Definition at line 64 of file include/openthread/logging.h

otLoggingSetLevel#

otError otLoggingSetLevel (otLogLevel aLogLevel)

Sets the log level.

Parameters
[in]aLogLevel

The log level.

Note

  • This function requires OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1.


Definition at line 77 of file include/openthread/logging.h

otLogCritPlat#

void otLogCritPlat (const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at critical log level.

Parameters
[in]aFormat

The format string.

[in]

Arguments for the format specification.

Is intended for use by platform. If OPENTHREAD_CONFIG_LOG_PLATFORM is not set or the current log level is below critical, this function does not emit any log message.


Definition at line 89 of file include/openthread/logging.h

otLogWarnPlat#

void void otLogWarnPlat (const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at warning log level.

Parameters
[in]aFormat

The format string.

[in]

Arguments for the format specification.

Is intended for use by platform. If OPENTHREAD_CONFIG_LOG_PLATFORM is not set or the current log level is below warning, this function does not emit any log message.


Definition at line 101 of file include/openthread/logging.h

otLogNotePlat#

void void void otLogNotePlat (const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at note log level.

Parameters
[in]aFormat

The format string.

[in]

Arguments for the format specification.

Is intended for use by platform. If OPENTHREAD_CONFIG_LOG_PLATFORM is not set or the current log level is below note, this function does not emit any log message.


Definition at line 113 of file include/openthread/logging.h

otLogInfoPlat#

void void void void otLogInfoPlat (const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at info log level.

Parameters
[in]aFormat

The format string.

[in]

Arguments for the format specification.

Is intended for use by platform. If OPENTHREAD_CONFIG_LOG_PLATFORM is not set or the current log level is below info, this function does not emit any log message.


Definition at line 125 of file include/openthread/logging.h

otLogDebgPlat#

void void void void void otLogDebgPlat (const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Emits a log message at debug log level.

Parameters
[in]aFormat

The format string.

[in]

Arguments for the format specification.

Is intended for use by platform. If OPENTHREAD_CONFIG_LOG_PLATFORM is not set or the current log level is below debug, this function does not emit any log message.


Definition at line 137 of file include/openthread/logging.h

otDumpCritPlat#

void void void void void void otDumpCritPlat (const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at critical log level.

Parameters
[in]aText

A string that is printed before the bytes.

[in]aData

A pointer to the data buffer.

[in]aDataLength

Number of bytes in aData.

If OPENTHREAD_CONFIG_LOG_PLATFORM or OPENTHREAD_CONFIG_LOG_PKT_DUMP is not set or the current log level is below critical this function does not emit any log message.


Definition at line 150 of file include/openthread/logging.h

otDumpWarnPlat#

void otDumpWarnPlat (const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at warning log level.

Parameters
[in]aText

A string that is printed before the bytes.

[in]aData

A pointer to the data buffer.

[in]aDataLength

Number of bytes in aData.

If OPENTHREAD_CONFIG_LOG_PLATFORM or OPENTHREAD_CONFIG_LOG_PKT_DUMP is not set or the current log level is below warning this function does not emit any log message.


Definition at line 163 of file include/openthread/logging.h

otDumpNotePlat#

void otDumpNotePlat (const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at note log level.

Parameters
[in]aText

A string that is printed before the bytes.

[in]aData

A pointer to the data buffer.

[in]aDataLength

Number of bytes in aData.

If OPENTHREAD_CONFIG_LOG_PLATFORM or OPENTHREAD_CONFIG_LOG_PKT_DUMP is not set or the current log level is below note this function does not emit any log message.


Definition at line 176 of file include/openthread/logging.h

otDumpInfoPlat#

void otDumpInfoPlat (const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at info log level.

Parameters
[in]aText

A string that is printed before the bytes.

[in]aData

A pointer to the data buffer.

[in]aDataLength

Number of bytes in aData.

If OPENTHREAD_CONFIG_LOG_PLATFORM or OPENTHREAD_CONFIG_LOG_PKT_DUMP is not set or the current log level is below info this function does not emit any log message.


Definition at line 189 of file include/openthread/logging.h

otDumpDebgPlat#

void otDumpDebgPlat (const char *aText, const void *aData, uint16_t aDataLength)

Generates a memory dump at debug log level.

Parameters
[in]aText

A string that is printed before the bytes.

[in]aData

A pointer to the data buffer.

[in]aDataLength

Number of bytes in aData.

If OPENTHREAD_CONFIG_LOG_PLATFORM or OPENTHREAD_CONFIG_LOG_PKT_DUMP is not set or the current log level is below debug this function does not emit any log message.


Definition at line 202 of file include/openthread/logging.h

otLogCli#

void otLogCli (otLogLevel aLogLevel, const char *aFormat,...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2

Emits a log message at a given log level.

Parameters
[in]aLogLevel

The log level.

[in]aFormat

The format string.

[in]

Arguments for the format specification.

Is intended for use by CLI only. If OPENTHREAD_CONFIG_LOG_CLI is not set or the current log level is below the given log level, this function does not emit any log message.


Definition at line 215 of file include/openthread/logging.h