| /* |
| * Copyright (c) 2016, The OpenThread Authors. |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions are met: |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in the |
| * documentation and/or other materials provided with the distribution. |
| * 3. Neither the name of the copyright holder nor the |
| * names of its contributors may be used to endorse or promote products |
| * derived from this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE |
| * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
| * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
| * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
| * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
| * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
| * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
| * POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| /** |
| * @file |
| * This file includes logging related macro/function definitions. |
| */ |
| |
| #ifndef LOGGING_HPP_ |
| #define LOGGING_HPP_ |
| |
| #include "openthread-core-config.h" |
| |
| #include <ctype.h> |
| #include <stdio.h> |
| |
| #include <openthread/logging.h> |
| #include <openthread/platform/logging.h> |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /** |
| * Log level prefix string definitions. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_PREPEND_LEVEL |
| #define _OT_LEVEL_NONE_PREFIX "[NONE]" |
| #define _OT_LEVEL_CRIT_PREFIX "[CRIT]" |
| #define _OT_LEVEL_WARN_PREFIX "[WARN]" |
| #define _OT_LEVEL_NOTE_PREFIX "[NOTE]" |
| #define _OT_LEVEL_INFO_PREFIX "[INFO]" |
| #define _OT_LEVEL_DEBG_PREFIX "[DEBG]" |
| #define _OT_REGION_SUFFIX ": " |
| #else |
| #define _OT_LEVEL_NONE_PREFIX "" |
| #define _OT_LEVEL_CRIT_PREFIX "" |
| #define _OT_LEVEL_WARN_PREFIX "" |
| #define _OT_LEVEL_NOTE_PREFIX "" |
| #define _OT_LEVEL_INFO_PREFIX "" |
| #define _OT_LEVEL_DEBG_PREFIX "" |
| #define _OT_REGION_SUFFIX |
| #endif |
| |
| /** |
| * Log region prefix string definitions. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_PREPEND_REGION |
| #define _OT_REGION_API_PREFIX "-API-----: " |
| #define _OT_REGION_MLE_PREFIX "-MLE-----: " |
| #define _OT_REGION_ARP_PREFIX "-ARP-----: " |
| #define _OT_REGION_NET_DATA_PREFIX "-N-DATA--: " |
| #define _OT_REGION_ICMP_PREFIX "-ICMP----: " |
| #define _OT_REGION_IP6_PREFIX "-IP6-----: " |
| #define _OT_REGION_MAC_PREFIX "-MAC-----: " |
| #define _OT_REGION_MEM_PREFIX "-MEM-----: " |
| #define _OT_REGION_NCP_PREFIX "-NCP-----: " |
| #define _OT_REGION_MESH_COP_PREFIX "-MESH-CP-: " |
| #define _OT_REGION_NET_DIAG_PREFIX "-DIAG----: " |
| #define _OT_REGION_PLATFORM_PREFIX "-PLAT----: " |
| #define _OT_REGION_COAP_PREFIX "-COAP----: " |
| #define _OT_REGION_CLI_PREFIX "-CLI-----: " |
| #define _OT_REGION_CORE_PREFIX "-CORE----: " |
| #define _OT_REGION_UTIL_PREFIX "-UTIL----: " |
| #define _OT_REGION_BBR_PREFIX "-BBR-----: " |
| #define _OT_REGION_MLR_PREFIX "-MLR-----: " |
| #else |
| #define _OT_REGION_API_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_MLE_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_ARP_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_NET_DATA_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_ICMP_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_IP6_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_MAC_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_MEM_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_NCP_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_MESH_COP_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_NET_DIAG_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_PLATFORM_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_COAP_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_CLI_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_CORE_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_UTIL_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_BBR_PREFIX _OT_REGION_SUFFIX |
| #define _OT_REGION_MLR_PREFIX _OT_REGION_SUFFIX |
| #endif |
| |
| /** |
| * @def otLogCrit |
| * |
| * Logging at log level critical. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_CRIT |
| #define otLogCrit(aRegion, ...) _otLogFormatter(OT_LOG_LEVEL_CRIT, aRegion, _OT_LEVEL_CRIT_PREFIX __VA_ARGS__, NULL) |
| #else |
| #define otLogCrit(aRegion, ...) |
| #endif |
| |
| /** |
| * @def otLogWarn |
| * |
| * Logging at log level warning. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_WARN |
| #define otLogWarn(aRegion, ...) _otLogFormatter(OT_LOG_LEVEL_WARN, aRegion, _OT_LEVEL_WARN_PREFIX __VA_ARGS__, NULL) |
| #else |
| #define otLogWarn(aRegion, ...) |
| #endif |
| |
| /** |
| * @def otLogNote |
| * |
| * Logging at log level note |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_NOTE |
| #define otLogNote(aRegion, ...) _otLogFormatter(OT_LOG_LEVEL_NOTE, aRegion, _OT_LEVEL_NOTE_PREFIX __VA_ARGS__, NULL) |
| #else |
| #define otLogNote(aRegion, ...) |
| #endif |
| |
| /** |
| * @def otLogInfo |
| * |
| * Logging at log level info. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_INFO |
| #define otLogInfo(aRegion, ...) _otLogFormatter(OT_LOG_LEVEL_INFO, aRegion, _OT_LEVEL_INFO_PREFIX __VA_ARGS__, NULL) |
| #else |
| #define otLogInfo(aRegion, ...) |
| #endif |
| |
| /** |
| * @def otLogDebg |
| * |
| * Logging at log level debug. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_DEBG |
| #define otLogDebg(aRegion, ...) _otLogFormatter(OT_LOG_LEVEL_DEBG, aRegion, _OT_LEVEL_DEBG_PREFIX __VA_ARGS__, NULL) |
| #else |
| #define otLogDebg(aRegion, ...) |
| #endif |
| |
| /** |
| * @def otLogCritApi |
| * |
| * This method generates a log with level critical for the API region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnApi |
| * |
| * This method generates a log with level warning for the API region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteApi |
| * |
| * This method generates a log with level note for the API region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoApi |
| * |
| * This method generates a log with level info for the API region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgApi |
| * |
| * This method generates a log with level debug for the API region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_API == 1 |
| #define otLogCritApi(...) otLogCrit(OT_LOG_REGION_API, _OT_REGION_API_PREFIX __VA_ARGS__) |
| #define otLogWarnApi(...) otLogWarn(OT_LOG_REGION_API, _OT_REGION_API_PREFIX __VA_ARGS__) |
| #define otLogNoteApi(...) otLogNote(OT_LOG_REGION_API, _OT_REGION_API_PREFIX __VA_ARGS__) |
| #define otLogInfoApi(...) otLogInfo(OT_LOG_REGION_API, _OT_REGION_API_PREFIX __VA_ARGS__) |
| #define otLogDebgApi(...) otLogDebg(OT_LOG_REGION_API, _OT_REGION_API_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritApi(...) |
| #define otLogWarnApi(...) |
| #define otLogNoteApi(...) |
| #define otLogInfoApi(...) |
| #define otLogDebgApi(...) |
| #endif |
| |
| /** |
| * @def otLogCritMeshCoP |
| * |
| * This method generates a log with level critical for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| * |
| */ |
| |
| /** |
| * @def otLogWarnMeshCoP |
| * |
| * This method generates a log with level warning for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteMeshCoP |
| * |
| * This method generates a log with level note for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoMeshCoP |
| * |
| * This method generates a log with level info for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgMeshCoP |
| * |
| * This method generates a log with level debug for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MESHCOP == 1 |
| #define otLogCritMeshCoP(...) otLogCrit(OT_LOG_REGION_MESH_COP, _OT_REGION_MESH_COP_PREFIX __VA_ARGS__) |
| #define otLogWarnMeshCoP(...) otLogWarn(OT_LOG_REGION_MESH_COP, _OT_REGION_MESH_COP_PREFIX __VA_ARGS__) |
| #define otLogNoteMeshCoP(...) otLogNote(OT_LOG_REGION_MESH_COP, _OT_REGION_MESH_COP_PREFIX __VA_ARGS__) |
| #define otLogInfoMeshCoP(...) otLogInfo(OT_LOG_REGION_MESH_COP, _OT_REGION_MESH_COP_PREFIX __VA_ARGS__) |
| #define otLogDebgMeshCoP(...) otLogDebg(OT_LOG_REGION_MESH_COP, _OT_REGION_MESH_COP_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritMeshCoP(...) |
| #define otLogWarnMeshCoP(...) |
| #define otLogNoteMeshCoP(...) |
| #define otLogInfoMeshCoP(...) |
| #define otLogDebgMeshCoP(...) |
| #endif |
| |
| #define otLogCritMbedTls(...) otLogCritMeshCoP(__VA_ARGS__) |
| #define otLogWarnMbedTls(...) otLogWarnMeshCoP(__VA_ARGS__) |
| #define otLogNoteMbedTls(...) otLogNoteMeshCoP(__VA_ARGS__) |
| #define otLogInfoMbedTls(...) otLogInfoMeshCoP(__VA_ARGS__) |
| #define otLogDebgMbedTls(...) otLogDebgMeshCoP(__VA_ARGS__) |
| |
| /** |
| * @def otLogCritMle |
| * |
| * This method generates a log with level critical for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnMle |
| * |
| * This method generates a log with level warning for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteMle |
| * |
| * This method generates a log with level note for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoMle |
| * |
| * This method generates a log with level info for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgMle |
| * |
| * This method generates a log with level debug for the MLE region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MLE == 1 |
| #define otLogCritMle(...) otLogCrit(OT_LOG_REGION_MLE, _OT_REGION_MLE_PREFIX __VA_ARGS__) |
| #define otLogWarnMle(...) otLogWarn(OT_LOG_REGION_MLE, _OT_REGION_MLE_PREFIX __VA_ARGS__) |
| #define otLogNoteMle(...) otLogNote(OT_LOG_REGION_MLE, _OT_REGION_MLE_PREFIX __VA_ARGS__) |
| #define otLogInfoMle(...) otLogInfo(OT_LOG_REGION_MLE, _OT_REGION_MLE_PREFIX __VA_ARGS__) |
| #define otLogDebgMle(...) otLogDebg(OT_LOG_REGION_MLE, _OT_REGION_MLE_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritMle(...) |
| #define otLogWarnMle(...) |
| #define otLogNoteMle(...) |
| #define otLogInfoMle(...) |
| #define otLogDebgMle(...) |
| #endif |
| |
| /** |
| * @def otLogCritArp |
| * |
| * This method generates a log with level critical for the EID-to-RLOC mapping region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnArp |
| * |
| * This method generates a log with level warning for the EID-to-RLOC mapping region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteArp |
| * |
| * This method generates a log with level note for the EID-to-RLOC mapping region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoArp |
| * |
| * This method generates a log with level info for the EID-to-RLOC mapping region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgArp |
| * |
| * This method generates a log with level debug for the EID-to-RLOC mapping region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_ARP == 1 |
| #define otLogCritArp(...) otLogCrit(OT_LOG_REGION_ARP, _OT_REGION_ARP_PREFIX __VA_ARGS__) |
| #define otLogWarnArp(...) otLogWarn(OT_LOG_REGION_ARP, _OT_REGION_ARP_PREFIX __VA_ARGS__) |
| #define otLogNoteArp(...) otLogNote(OT_LOG_REGION_ARP, _OT_REGION_ARP_PREFIX __VA_ARGS__) |
| #define otLogInfoArp(...) otLogInfo(OT_LOG_REGION_ARP, _OT_REGION_ARP_PREFIX __VA_ARGS__) |
| #define otLogDebgArp(...) otLogDebg(OT_LOG_REGION_ARP, _OT_REGION_ARP_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritArp(...) |
| #define otLogWarnArp(...) |
| #define otLogNoteArp(...) |
| #define otLogInfoArp(...) |
| #define otLogDebgArp(...) |
| #endif |
| |
| /** |
| * @def otLogCritBbr |
| * |
| * This method generates a log with level critical for the Backbone Router (BBR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnBbr |
| * |
| * This method generates a log with level warning for the Backbone Router (BBR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteBbr |
| * |
| * This method generates a log with level note for the Backbone Router (BBR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoBbr |
| * |
| * This method generates a log with level info for the Backbone Router (BBR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgBbr |
| * |
| * This method generates a log with level debug for the Backbone Router (BBR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_BBR == 1 |
| #define otLogCritBbr(...) otLogCrit(OT_LOG_REGION_BBR, _OT_REGION_BBR_PREFIX __VA_ARGS__) |
| #define otLogWarnBbr(...) otLogWarn(OT_LOG_REGION_BBR, _OT_REGION_BBR_PREFIX __VA_ARGS__) |
| #define otLogNoteBbr(...) otLogNote(OT_LOG_REGION_BBR, _OT_REGION_BBR_PREFIX __VA_ARGS__) |
| #define otLogInfoBbr(...) otLogInfo(OT_LOG_REGION_BBR, _OT_REGION_BBR_PREFIX __VA_ARGS__) |
| #define otLogDebgBbr(...) otLogDebg(OT_LOG_REGION_BBR, _OT_REGION_BBR_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritBbr(...) |
| #define otLogWarnBbr(...) |
| #define otLogNoteBbr(...) |
| #define otLogInfoBbr(...) |
| #define otLogDebgBbr(...) |
| #endif |
| |
| /** |
| * @def otLogCritMlr |
| * |
| * This method generates a log with level critical for the Multicast Listener Registration (MLR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnMlr |
| * |
| * This method generates a log with level warning for the Multicast Listener Registration (MLR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteMlr |
| * |
| * This method generates a log with level note for the Multicast Listener Registration (MLR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoMlr |
| * |
| * This method generates a log with level info for the Multicast Listener Registration (MLR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgMlr |
| * |
| * This method generates a log with level debug for the Multicast Listener Registration (MLR) region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MLR == 1 |
| #define otLogCritMlr(...) otLogCrit(OT_LOG_REGION_MLR, _OT_REGION_MLR_PREFIX __VA_ARGS__) |
| #define otLogWarnMlr(...) otLogWarn(OT_LOG_REGION_MLR, _OT_REGION_MLR_PREFIX __VA_ARGS__) |
| #define otLogNoteMlr(...) otLogNote(OT_LOG_REGION_MLR, _OT_REGION_MLR_PREFIX __VA_ARGS__) |
| #define otLogInfoMlr(...) otLogInfo(OT_LOG_REGION_MLR, _OT_REGION_MLR_PREFIX __VA_ARGS__) |
| #define otLogDebgMlr(...) otLogDebg(OT_LOG_REGION_MLR, _OT_REGION_MLR_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritMlr(...) |
| #define otLogWarnMlr(...) |
| #define otLogNoteMlr(...) |
| #define otLogInfoMlr(...) |
| #define otLogDebgMlr(...) |
| #endif |
| |
| /** |
| * @def otLogCritNetData |
| * |
| * This method generates a log with level critical for the Network Data region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnNetData |
| * |
| * This method generates a log with level warning for the Network Data region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteNetData |
| * |
| * This method generates a log with level note for the Network Data region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoNetData |
| * |
| * This method generates a log with level info for the Network Data region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgNetData |
| * |
| * This method generates a log with level debug for the Network Data region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_NETDATA == 1 |
| #define otLogCritNetData(...) otLogCrit(OT_LOG_REGION_NET_DATA, _OT_REGION_NET_DATA_PREFIX __VA_ARGS__) |
| #define otLogWarnNetData(...) otLogWarn(OT_LOG_REGION_NET_DATA, _OT_REGION_NET_DATA_PREFIX __VA_ARGS__) |
| #define otLogNoteNetData(...) otLogNote(OT_LOG_REGION_NET_DATA, _OT_REGION_NET_DATA_PREFIX __VA_ARGS__) |
| #define otLogInfoNetData(...) otLogInfo(OT_LOG_REGION_NET_DATA, _OT_REGION_NET_DATA_PREFIX __VA_ARGS__) |
| #define otLogDebgNetData(...) otLogDebg(OT_LOG_REGION_NET_DATA, _OT_REGION_NET_DATA_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritNetData(...) |
| #define otLogWarnNetData(...) |
| #define otLogNoteNetData(...) |
| #define otLogInfoNetData(...) |
| #define otLogDebgNetData(...) |
| #endif |
| |
| /** |
| * @def otLogCritIcmp |
| * |
| * This method generates a log with level critical for the ICMPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnIcmp |
| * |
| * This method generates a log with level warning for the ICMPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteIcmp |
| * |
| * This method generates a log with level note for the ICMPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoIcmp |
| * |
| * This method generates a log with level info for the ICMPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgIcmp |
| * |
| * This method generates a log with level debug for the ICMPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_ICMP == 1 |
| #define otLogCritIcmp(...) otLogCrit(OT_LOG_REGION_ICMP, _OT_REGION_ICMP_PREFIX __VA_ARGS__) |
| #define otLogWarnIcmp(...) otLogWarn(OT_LOG_REGION_ICMP, _OT_REGION_ICMP_PREFIX __VA_ARGS__) |
| #define otLogNoteIcmp(...) otLogNote(OT_LOG_REGION_ICMP, _OT_REGION_ICMP_PREFIX __VA_ARGS__) |
| #define otLogInfoIcmp(...) otLogInfo(OT_LOG_REGION_ICMP, _OT_REGION_ICMP_PREFIX __VA_ARGS__) |
| #define otLogDebgIcmp(...) otLogDebg(OT_LOG_REGION_ICMP, _OT_REGION_ICMP_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritIcmp(...) |
| #define otLogWarnIcmp(...) |
| #define otLogNoteIcmp(...) |
| #define otLogInfoIcmp(...) |
| #define otLogDebgIcmp(...) |
| #endif |
| |
| /** |
| * @def otLogCritIp6 |
| * |
| * This method generates a log with level critical for the IPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnIp6 |
| * |
| * This method generates a log with level warning for the IPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteIp6 |
| * |
| * This method generates a log with level note for the IPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoIp6 |
| * |
| * This method generates a log with level info for the IPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgIp6 |
| * |
| * This method generates a log with level debug for the IPv6 region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_IP6 == 1 |
| #define otLogCritIp6(...) otLogCrit(OT_LOG_REGION_IP6, _OT_REGION_IP6_PREFIX __VA_ARGS__) |
| #define otLogWarnIp6(...) otLogWarn(OT_LOG_REGION_IP6, _OT_REGION_IP6_PREFIX __VA_ARGS__) |
| #define otLogNoteIp6(...) otLogNote(OT_LOG_REGION_IP6, _OT_REGION_IP6_PREFIX __VA_ARGS__) |
| #define otLogInfoIp6(...) otLogInfo(OT_LOG_REGION_IP6, _OT_REGION_IP6_PREFIX __VA_ARGS__) |
| #define otLogDebgIp6(...) otLogDebg(OT_LOG_REGION_IP6, _OT_REGION_IP6_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritIp6(...) |
| #define otLogWarnIp6(...) |
| #define otLogNoteIp6(...) |
| #define otLogInfoIp6(...) |
| #define otLogDebgIp6(...) |
| #endif |
| |
| /** |
| * @def otLogCritMac |
| * |
| * This method generates a log with level critical for the MAC region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnMac |
| * |
| * This method generates a log with level warning for the MAC region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteMac |
| * |
| * This method generates a log with level note for the MAC region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoMac |
| * |
| * This method generates a log with level info for the MAC region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgMac |
| * |
| * This method generates a log with level debug for the MAC region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogMac |
| * |
| * This method generates a log with a given log level for the MAC region. |
| * |
| * @param[in] aLogLevel A log level. |
| * @param[in] aFormat A pointer to the format string. |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MAC == 1 |
| #define otLogCritMac(...) otLogCrit(OT_LOG_REGION_MAC, _OT_REGION_MAC_PREFIX __VA_ARGS__) |
| #define otLogWarnMac(...) otLogWarn(OT_LOG_REGION_MAC, _OT_REGION_MAC_PREFIX __VA_ARGS__) |
| #define otLogNoteMac(...) otLogNote(OT_LOG_REGION_MAC, _OT_REGION_MAC_PREFIX __VA_ARGS__) |
| #define otLogInfoMac(...) otLogInfo(OT_LOG_REGION_MAC, _OT_REGION_MAC_PREFIX __VA_ARGS__) |
| #define otLogDebgMac(...) otLogDebg(OT_LOG_REGION_MAC, _OT_REGION_MAC_PREFIX __VA_ARGS__) |
| #define otLogMac(aLogLevel, aFormat, ...) \ |
| do \ |
| { \ |
| if (otLoggingGetLevel() >= aLogLevel) \ |
| { \ |
| _otLogFormatter(aLogLevel, OT_LOG_REGION_MAC, "%s" _OT_REGION_MAC_PREFIX aFormat, \ |
| otLogLevelToPrefixString(aLogLevel), __VA_ARGS__); \ |
| } \ |
| } while (false) |
| |
| #else |
| #define otLogCritMac(...) |
| #define otLogWarnMac(...) |
| #define otLogNoteMac(...) |
| #define otLogInfoMac(...) |
| #define otLogDebgMac(...) |
| #define otLogMac(aLogLevel, ...) |
| #endif |
| |
| /** |
| * @def otLogCritCore |
| * |
| * This method generates a log with level critical for the Core region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnCore |
| * |
| * This method generates a log with level warning for the Core region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteCore |
| * |
| * This method generates a log with level note for the Core region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoCore |
| * |
| * This method generates a log with level info for the Core region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgCore |
| * |
| * This method generates a log with level debug for the Core region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_CORE == 1 |
| #define otLogCritCore(...) otLogCrit(OT_LOG_REGION_CORE, _OT_REGION_CORE_PREFIX __VA_ARGS__) |
| #define otLogWarnCore(...) otLogWarn(OT_LOG_REGION_CORE, _OT_REGION_CORE_PREFIX __VA_ARGS__) |
| #define otLogNoteCore(...) otLogNote(OT_LOG_REGION_CORE, _OT_REGION_CORE_PREFIX __VA_ARGS__) |
| #define otLogInfoCore(...) otLogInfo(OT_LOG_REGION_CORE, _OT_REGION_CORE_PREFIX __VA_ARGS__) |
| #define otLogDebgCore(...) otLogDebg(OT_LOG_REGION_CORE, _OT_REGION_CORE_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritCore(...) |
| #define otLogWarnCore(...) |
| #define otLogInfoCore(...) |
| #define otLogDebgCore(...) |
| #endif |
| |
| /** |
| * @def otLogCritMem |
| * |
| * This method generates a log with level critical for the memory region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnMem |
| * |
| * This method generates a log with level warning for the memory region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteMem |
| * |
| * This method generates a log with level note for the memory region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoMem |
| * |
| * This method generates a log with level info for the memory region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgMem |
| * |
| * This method generates a log with level debug for the memory region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MEM == 1 |
| #define otLogCritMem(...) otLogCrit(OT_LOG_REGION_MEM, _OT_REGION_MEM_PREFIX __VA_ARGS__) |
| #define otLogWarnMem(...) otLogWarn(OT_LOG_REGION_MEM, _OT_REGION_MEM_PREFIX __VA_ARGS__) |
| #define otLogNoteMem(...) otLogNote(OT_LOG_REGION_MEM, _OT_REGION_MEM_PREFIX __VA_ARGS__) |
| #define otLogInfoMem(...) otLogInfo(OT_LOG_REGION_MEM, _OT_REGION_MEM_PREFIX __VA_ARGS__) |
| #define otLogDebgMem(...) otLogDebg(OT_LOG_REGION_MEM, _OT_REGION_MEM_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritMem(...) |
| #define otLogWarnMem(...) |
| #define otLogNoteMem(...) |
| #define otLogInfoMem(...) |
| #define otLogDebgMem(...) |
| #endif |
| |
| /** |
| * @def otLogCritUtil |
| * |
| * This method generates a log with level critical for the Util region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnUtil |
| * |
| * This method generates a log with level warning for the Util region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteUtil |
| * |
| * This method generates a log with level note for the Util region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoUtil |
| * |
| * This method generates a log with level info for the Util region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgUtil |
| * |
| * This method generates a log with level debug for the Util region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_UTIL == 1 |
| #define otLogCritUtil(...) otLogCrit(OT_LOG_REGION_UTIL, _OT_REGION_UTIL_PREFIX __VA_ARGS__) |
| #define otLogWarnUtil(...) otLogWarn(OT_LOG_REGION_UTIL, _OT_REGION_UTIL_PREFIX __VA_ARGS__) |
| #define otLogNoteUtil(...) otLogNote(OT_LOG_REGION_UTIL, _OT_REGION_UTIL_PREFIX __VA_ARGS__) |
| #define otLogInfoUtil(...) otLogInfo(OT_LOG_REGION_UTIL, _OT_REGION_UTIL_PREFIX __VA_ARGS__) |
| #define otLogDebgUtil(...) otLogDebg(OT_LOG_REGION_UTIL, _OT_REGION_UTIL_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritUtil(...) |
| #define otLogWarnUtil(...) |
| #define otLogNoteUtil(...) |
| #define otLogInfoUtil(...) |
| #define otLogDebgUtil(...) |
| #endif |
| |
| /** |
| * @def otLogCritNetDiag |
| * |
| * This method generates a log with level critical for the NETDIAG region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnNetDiag |
| * |
| * This method generates a log with level warning for the NETDIAG region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteNetDiag |
| * |
| * This method generates a log with level note for the NETDIAG region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoNetDiag |
| * |
| * This method generates a log with level info for the NETDIAG region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgNetDiag |
| * |
| * This method generates a log with level debug for the NETDIAG region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_NETDIAG == 1 |
| #define otLogCritNetDiag(...) otLogCrit(OT_LOG_REGION_NET_DIAG, _OT_REGION_NET_DIAG_PREFIX __VA_ARGS__) |
| #define otLogWarnNetDiag(...) otLogWarn(OT_LOG_REGION_NET_DIAG, _OT_REGION_NET_DIAG_PREFIX __VA_ARGS__) |
| #define otLogNoteNetDiag(...) otLogNote(OT_LOG_REGION_NET_DIAG, _OT_REGION_NET_DIAG_PREFIX __VA_ARGS__) |
| #define otLogInfoNetDiag(...) otLogInfo(OT_LOG_REGION_NET_DIAG, _OT_REGION_NET_DIAG_PREFIX __VA_ARGS__) |
| #define otLogDebgNetDiag(...) otLogDebg(OT_LOG_REGION_NET_DIAG, _OT_REGION_NET_DIAG_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritNetDiag(...) |
| #define otLogWarnNetDiag(...) |
| #define otLogNoteNetDiag(...) |
| #define otLogInfoNetDiag(...) |
| #define otLogDebgNetDiag(...) |
| #endif |
| |
| /** |
| * @def otLogCert |
| * |
| * This method generates a log with level none for the certification test. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| * |
| */ |
| #if OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE |
| #define otLogCertMeshCoP(...) _otLogFormatter(OT_LOG_LEVEL_NONE, OT_LOG_REGION_MESH_COP, __VA_ARGS__, NULL) |
| #else |
| #define otLogCertMeshCoP(...) |
| #endif |
| |
| /** |
| * @def otLogCritCli |
| * |
| * This method generates a log with level critical for the CLI region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnCli |
| * |
| * This method generates a log with level warning for the CLI region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteCli |
| * |
| * This method generates a log with level note for the CLI region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoCli |
| * |
| * This method generates a log with level info for the CLI region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgCli |
| * |
| * This method generates a log with level debug for the CLI region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_CLI == 1 |
| |
| #define otLogCritCli(...) otLogCrit(OT_LOG_REGION_CLI, _OT_REGION_CLI_PREFIX __VA_ARGS__) |
| #define otLogWarnCli(...) otLogWarn(OT_LOG_REGION_CLI, _OT_REGION_CLI_PREFIX __VA_ARGS__) |
| #define otLogNoteCli(...) otLogNote(OT_LOG_REGION_CLI, _OT_REGION_CLI_PREFIX __VA_ARGS__) |
| #define otLogInfoCli(...) otLogInfo(OT_LOG_REGION_CLI, _OT_REGION_CLI_PREFIX __VA_ARGS__) |
| #define otLogDebgCli(...) otLogDebg(OT_LOG_REGION_CLI, _OT_REGION_CLI_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritCli(...) |
| #define otLogWarnCli(...) |
| #define otLogNoteCli(...) |
| #define otLogInfoCli(...) |
| #define otLogDebgCli(...) |
| #endif |
| |
| /** |
| * @def otLogCritCoap |
| * |
| * This method generates a log with level critical for the CoAP region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnCoap |
| * |
| * This method generates a log with level warning for the CoAP region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNoteCoap |
| * |
| * This method generates a log with level note for the CoAP region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoCoap |
| * |
| * This method generates a log with level info for the CoAP region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgCoap |
| * |
| * This method generates a log with level debug for the CoAP region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_COAP == 1 |
| #define otLogCritCoap(...) otLogCrit(OT_LOG_REGION_COAP, _OT_REGION_COAP_PREFIX __VA_ARGS__) |
| #define otLogWarnCoap(...) otLogWarn(OT_LOG_REGION_COAP, _OT_REGION_COAP_PREFIX __VA_ARGS__) |
| #define otLogNoteCoap(...) otLogNote(OT_LOG_REGION_COAP, _OT_REGION_COAP_PREFIX __VA_ARGS__) |
| #define otLogInfoCoap(...) otLogInfo(OT_LOG_REGION_COAP, _OT_REGION_COAP_PREFIX __VA_ARGS__) |
| #define otLogDebgCoap(...) otLogDebg(OT_LOG_REGION_COAP, _OT_REGION_COAP_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritCoap(...) |
| #define otLogWarnCoap(...) |
| #define otLogNoteCoap(...) |
| #define otLogInfoCoap(...) |
| #define otLogDebgCoap(...) |
| #endif |
| |
| /** |
| * @def otLogCritPlat |
| * |
| * This method generates a log with level critical for the Platform region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogWarnPlat |
| * |
| * This method generates a log with level warning for the Platform region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogNotePlat |
| * |
| * This method generates a log with level note for the Platform region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogInfoPlat |
| * |
| * This method generates a log with level info for the Platform region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| |
| /** |
| * @def otLogDebgPlat |
| * |
| * This method generates a log with level debug for the Platform region. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_PLATFORM == 1 |
| #define otLogCritPlat(...) otLogCrit(OT_LOG_REGION_PLATFORM, _OT_REGION_PLATFORM_PREFIX __VA_ARGS__) |
| #define otLogWarnPlat(...) otLogWarn(OT_LOG_REGION_PLATFORM, _OT_REGION_PLATFORM_PREFIX __VA_ARGS__) |
| #define otLogNotePlat(...) otLogNote(OT_LOG_REGION_PLATFORM, _OT_REGION_PLATFORM_PREFIX __VA_ARGS__) |
| #define otLogInfoPlat(...) otLogInfo(OT_LOG_REGION_PLATFORM, _OT_REGION_PLATFORM_PREFIX __VA_ARGS__) |
| #define otLogDebgPlat(...) otLogDebg(OT_LOG_REGION_PLATFORM, _OT_REGION_PLATFORM_PREFIX __VA_ARGS__) |
| #else |
| #define otLogCritPlat(...) |
| #define otLogWarnPlat(...) |
| #define otLogNotePlat(...) |
| #define otLogInfoPlat(...) |
| #define otLogDebgPlat(...) |
| #endif |
| |
| /** |
| * @def otLogOtns |
| * |
| * This method generates a log with level none for the Core region, |
| * and is specifically for OTNS visualization use. |
| * |
| * @param[in] ... Arguments for the format specification. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_OTNS_ENABLE |
| #define otLogOtns(...) _otLogFormatter(OT_LOG_LEVEL_NONE, OT_LOG_REGION_CORE, _OT_LEVEL_NONE_PREFIX __VA_ARGS__, NULL) |
| #endif |
| |
| /** |
| * @def otDumpCrit |
| * |
| * This method generates a memory dump with log level critical. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_CRIT |
| #define otDumpCrit(aRegion, aId, aBuf, aLength) otDump(OT_LOG_LEVEL_CRIT, aRegion, aId, aBuf, aLength) |
| #else |
| #define otDumpCrit(aRegion, aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpWarn |
| * |
| * This method generates a memory dump with log level warning. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_WARN |
| #define otDumpWarn(aRegion, aId, aBuf, aLength) otDump(OT_LOG_LEVEL_WARN, aRegion, aId, aBuf, aLength) |
| #else |
| #define otDumpWarn(aRegion, aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpNote |
| * |
| * This method generates a memory dump with log level note. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_NOTE |
| #define otDumpNote(aRegion, aId, aBuf, aLength) otDump(OT_LOG_LEVEL_NOTE, aRegion, aId, aBuf, aLength) |
| #else |
| #define otDumpNote(aRegion, aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpInfo |
| * |
| * This method generates a memory dump with log level info. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_INFO |
| #define otDumpInfo(aRegion, aId, aBuf, aLength) otDump(OT_LOG_LEVEL_INFO, aRegion, aId, aBuf, aLength) |
| #else |
| #define otDumpInfo(aRegion, aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpDebg |
| * |
| * This method generates a memory dump with log level debug. |
| * |
| * @param[in] aRegion The log region. |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_LEVEL >= OT_LOG_LEVEL_DEBG |
| #define otDumpDebg(aRegion, aId, aBuf, aLength) otDump(OT_LOG_LEVEL_DEBG, aRegion, aId, aBuf, aLength) |
| #else |
| #define otDumpDebg(aRegion, aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritNetData |
| * |
| * This method generates a memory dump with log level debug and region Network Data. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnNetData |
| * |
| * This method generates a memory dump with log level warning and region Network Data. |
| * |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteNetData |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoNetData |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgNetData |
| * |
| * This method generates a memory dump with log level debug and region Network Data. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_NETDATA == 1 |
| #define otDumpCritNetData(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_NET_DATA, aId, aBuf, aLength) |
| #define otDumpWarnNetData(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_NET_DATA, aId, aBuf, aLength) |
| #define otDumpNoteNetData(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_NET_DATA, aId, aBuf, aLength) |
| #define otDumpInfoNetData(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_NET_DATA, aId, aBuf, aLength) |
| #define otDumpDebgNetData(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_NET_DATA, aId, aBuf, aLength) |
| #else |
| #define otDumpCritNetData(aId, aBuf, aLength) |
| #define otDumpWarnNetData(aId, aBuf, aLength) |
| #define otDumpNoteNetData(aId, aBuf, aLength) |
| #define otDumpInfoNetData(aId, aBuf, aLength) |
| #define otDumpDebgNetData(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritMle |
| * |
| * This method generates a memory dump with log level debug and region MLE. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnMle |
| * |
| * This method generates a memory dump with log level warning and region MLE. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteMle |
| * |
| * This method generates a memory dump with log level note and region MLE. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoMle |
| * |
| * This method generates a memory dump with log level info and region MLE. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgMle |
| * |
| * This method generates a memory dump with log level debug and region MLE. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MLE == 1 |
| #define otDumpCritMle(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_MLE, aId, aBuf, aLength) |
| #define otDumpWarnMle(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_MLE, aId, aBuf, aLength) |
| #define otDumpNoteMle(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_MLE, aId, aBuf, aLength) |
| #define otDumpInfoMle(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_MLE, aId, aBuf, aLength) |
| #define otDumpDebgMle(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_MLE, aId, aBuf, aLength) |
| #else |
| #define otDumpCritMle(aId, aBuf, aLength) |
| #define otDumpWarnMle(aId, aBuf, aLength) |
| #define otDumpNoteMle(aId, aBuf, aLength) |
| #define otDumpInfoMle(aId, aBuf, aLength) |
| #define otDumpDebgMle(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritArp |
| * |
| * This method generates a memory dump with log level debug and region EID-to-RLOC mapping. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnArp |
| * |
| * This method generates a memory dump with log level warning and region EID-to-RLOC mapping. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteArp |
| * |
| * This method generates a memory dump with log level note and region EID-to-RLOC mapping. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoArp |
| * |
| * This method generates a memory dump with log level info and region EID-to-RLOC mapping. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgArp |
| * |
| * This method generates a memory dump with log level debug and region EID-to-RLOC mapping. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_ARP == 1 |
| #define otDumpCritArp(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_ARP, aId, aBuf, aLength) |
| #define otDumpWarnArp(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_ARP, aId, aBuf, aLength) |
| #define otDumpNoteArp(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_ARP, aId, aBuf, aLength) |
| #define otDumpInfoArp(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_ARP, aId, aBuf, aLength) |
| #define otDumpDebgArp(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_ARP, aId, aBuf, aLength) |
| #else |
| #define otDumpCritArp(aId, aBuf, aLength) |
| #define otDumpWarnArp(aId, aBuf, aLength) |
| #define otDumpNoteArp(aId, aBuf, aLength) |
| #define otDumpInfoArp(aId, aBuf, aLength) |
| #define otDumpDebgArp(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritBbr |
| * |
| * This method generates a memory dump with log level critical and region Backbone Router (BBR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnBbr |
| * |
| * This method generates a memory dump with log level warning and region Backbone Router (BBR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteBbr |
| * |
| * This method generates a memory dump with log level note and region Backbone Router (BBR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoBbr |
| * |
| * This method generates a memory dump with log level info and region Backbone Router (BBR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgBbr |
| * |
| * This method generates a memory dump with log level debug and region Backbone Router (BBR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_BBR == 1 |
| #define otDumpCritBbr(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_BBR, aId, aBuf, aLength) |
| #define otDumpWarnBbr(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_BBR, aId, aBuf, aLength) |
| #define otDumpNoteBbr(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_BBR, aId, aBuf, aLength) |
| #define otDumpInfoBbr(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_BBR, aId, aBuf, aLength) |
| #define otDumpDebgBbr(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_BBR, aId, aBuf, aLength) |
| #else |
| #define otDumpCritBbr(aId, aBuf, aLength) |
| #define otDumpWarnBbr(aId, aBuf, aLength) |
| #define otDumpNoteBbr(aId, aBuf, aLength) |
| #define otDumpInfoBbr(aId, aBuf, aLength) |
| #define otDumpDebgBbr(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritMlr |
| * |
| * This method generates a memory dump with log level critical and region Multicast Listener Registration (MLR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnMlr |
| * |
| * This method generates a memory dump with log level warning and region Multicast Listener Registration (MLR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteMlr |
| * |
| * This method generates a memory dump with log level note and region Multicast Listener Registration (MLR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoMlr |
| * |
| * This method generates a memory dump with log level info and region Multicast Listener Registration (MLR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgMlr |
| * |
| * This method generates a memory dump with log level debug and region Multicast Listener Registration (MLR). |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MLR == 1 |
| #define otDumpCritMlr(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_MLR, aId, aBuf, aLength) |
| #define otDumpWarnMlr(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_MLR, aId, aBuf, aLength) |
| #define otDumpNoteMlr(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_MLR, aId, aBuf, aLength) |
| #define otDumpInfoMlr(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_MLR, aId, aBuf, aLength) |
| #define otDumpDebgMlr(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_MLR, aId, aBuf, aLength) |
| #else |
| #define otDumpCritMlr(aId, aBuf, aLength) |
| #define otDumpWarnMlr(aId, aBuf, aLength) |
| #define otDumpNoteMlr(aId, aBuf, aLength) |
| #define otDumpInfoMlr(aId, aBuf, aLength) |
| #define otDumpDebgMlr(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritIcmp |
| * |
| * This method generates a memory dump with log level debug and region ICMPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnIcmp |
| * |
| * This method generates a memory dump with log level warning and region ICMPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteIcmp |
| * |
| * This method generates a memory dump with log level note and region ICMPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoIcmp |
| * |
| * This method generates a memory dump with log level info and region ICMPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgIcmp |
| * |
| * This method generates a memory dump with log level debug and region ICMPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_ICMP == 1 |
| #define otDumpCritIcmp(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_ICMP, aId, aBuf, aLength) |
| #define otDumpWarnIcmp(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_ICMP, aId, aBuf, aLength) |
| #define otDumpNoteIcmp(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_ICMP, aId, aBuf, aLength) |
| #define otDumpInfoIcmp(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_ICMP, aId, aBuf, aLength) |
| #define otDumpDebgIcmp(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_ICMP, aId, aBuf, aLength) |
| #else |
| #define otDumpCritIcmp(aId, aBuf, aLength) |
| #define otDumpWarnIcmp(aId, aBuf, aLength) |
| #define otDumpNoteIcmp(aId, aBuf, aLength) |
| #define otDumpInfoIcmp(aId, aBuf, aLength) |
| #define otDumpDebgIcmp(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritIp6 |
| * |
| * This method generates a memory dump with log level debug and region IPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnIp6 |
| * |
| * This method generates a memory dump with log level warning and region IPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteIp6 |
| * |
| * This method generates a memory dump with log level note and region IPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoIp6 |
| * |
| * This method generates a memory dump with log level info and region IPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgIp6 |
| * |
| * This method generates a memory dump with log level debug and region IPv6. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_IP6 == 1 |
| #define otDumpCritIp6(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_IP6, aId, aBuf, aLength) |
| #define otDumpWarnIp6(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_IP6, aId, aBuf, aLength) |
| #define otDumpNoteIp6(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_IP6, aId, aBuf, aLength) |
| #define otDumpInfoIp6(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_IP6, aId, aBuf, aLength) |
| #define otDumpDebgIp6(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_IP6, aId, aBuf, aLength) |
| #else |
| #define otDumpCritIp6(aId, aBuf, aLength) |
| #define otDumpWarnIp6(aId, aBuf, aLength) |
| #define otDumpNoteIp6(aId, aBuf, aLength) |
| #define otDumpInfoIp6(aId, aBuf, aLength) |
| #define otDumpDebgIp6(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritMac |
| * |
| * This method generates a memory dump with log level debug and region MAC. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnMac |
| * |
| * This method generates a memory dump with log level warning and region MAC. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteMac |
| * |
| * This method generates a memory dump with log level note and region MAC. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoMac |
| * |
| * This method generates a memory dump with log level info and region MAC. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgMac |
| * |
| * This method generates a memory dump with log level debug and region MAC. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MAC == 1 |
| #define otDumpCritMac(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_MAC, aId, aBuf, aLength) |
| #define otDumpWarnMac(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_MAC, aId, aBuf, aLength) |
| #define otDumpNoteMac(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_MAC, aId, aBuf, aLength) |
| #define otDumpInfoMac(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_MAC, aId, aBuf, aLength) |
| #define otDumpDebgMac(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_MAC, aId, aBuf, aLength) |
| #else |
| #define otDumpCritMac(aId, aBuf, aLength) |
| #define otDumpWarnMac(aId, aBuf, aLength) |
| #define otDumpNoteMac(aId, aBuf, aLength) |
| #define otDumpInfoMac(aId, aBuf, aLength) |
| #define otDumpDebgMac(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritCore |
| * |
| * This method generates a memory dump with log level debug and region Core. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnCore |
| * |
| * This method generates a memory dump with log level warning and region Core. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteCore |
| * |
| * This method generates a memory dump with log level note and region Core. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoCore |
| * |
| * This method generates a memory dump with log level info and region Core. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgCore |
| * |
| * This method generates a memory dump with log level debug and region Core. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_CORE == 1 |
| #define otDumpCritCore(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_CORE, aId, aBuf, aLength) |
| #define otDumpWarnCore(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_CORE, aId, aBuf, aLength) |
| #define otDumpNoteCore(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_CORE, aId, aBuf, aLength) |
| #define otDumpInfoCore(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_CORE, aId, aBuf, aLength) |
| #define otDumpDebgCore(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_CORE, aId, aBuf, aLength) |
| #else |
| #define otDumpCritCore(aId, aBuf, aLength) |
| #define otDumpWarnCore(aId, aBuf, aLength) |
| #define otDumpNoteCore(aId, aBuf, aLength) |
| #define otDumpInfoCore(aId, aBuf, aLength) |
| #define otDumpDebgCore(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCritMem |
| * |
| * This method generates a memory dump with log level debug and region memory. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpWarnMem |
| * |
| * This method generates a memory dump with log level warning and region memory. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpNoteMem |
| * |
| * This method generates a memory dump with log level note and region memory. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpInfoMem |
| * |
| * This method generates a memory dump with log level info and region memory. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| |
| /** |
| * @def otDumpDebgMem |
| * |
| * This method generates a memory dump with log level debug and region memory. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_LOG_MEM == 1 |
| #define otDumpCritMem(aId, aBuf, aLength) otDumpCrit(OT_LOG_REGION_MEM, aId, aBuf, aLength) |
| #define otDumpWarnMem(aId, aBuf, aLength) otDumpWarn(OT_LOG_REGION_MEM, aId, aBuf, aLength) |
| #define otDumpNoteMem(aId, aBuf, aLength) otDumpNote(OT_LOG_REGION_MEM, aId, aBuf, aLength) |
| #define otDumpInfoMem(aId, aBuf, aLength) otDumpInfo(OT_LOG_REGION_MEM, aId, aBuf, aLength) |
| #define otDumpDebgMem(aId, aBuf, aLength) otDumpDebg(OT_LOG_REGION_MEM, aId, aBuf, aLength) |
| #else |
| #define otDumpCritMem(aId, aBuf, aLength) |
| #define otDumpWarnMem(aId, aBuf, aLength) |
| #define otDumpNoteMem(aId, aBuf, aLength) |
| #define otDumpInfoMem(aId, aBuf, aLength) |
| #define otDumpDebgMem(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * @def otDumpCert |
| * |
| * This method generates a memory dump with log level none for the certification test. |
| * |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| #if OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE |
| #define otDumpCertMeshCoP(aId, aBuf, aLength) otDump(OT_LOG_LEVEL_NONE, OT_LOG_REGION_MESH_COP, aId, aBuf, aLength) |
| #else |
| #define otDumpCertMeshCoP(aId, aBuf, aLength) |
| #endif |
| |
| /** |
| * This method dumps bytes to the log in a human-readable fashion. |
| * |
| * @param[in] aLogLevel The log level. |
| * @param[in] aLogRegion The log region. |
| * @param[in] aId A pointer to a NULL-terminated string that is printed before the bytes. |
| * @param[in] aBuf A pointer to the buffer. |
| * @param[in] aLength Number of bytes to print. |
| * |
| */ |
| void otDump(otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aId, const void *aBuf, size_t aLength); |
| |
| /** |
| * This function converts a log level to a prefix string for appending to log message. |
| * |
| * @param[in] aLogLevel A log level. |
| * |
| * @returns A C string representing the log level. |
| * |
| */ |
| const char *otLogLevelToPrefixString(otLogLevel aLogLevel); |
| |
| /** |
| * Local/private macro to format the log message |
| */ |
| #define _otLogFormatter(aLogLevel, aRegion, aFormat, ...) \ |
| _otDynamicLog(aLogLevel, aRegion, aFormat OPENTHREAD_CONFIG_LOG_SUFFIX, __VA_ARGS__) |
| |
| #if OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE == 1 |
| |
| /** |
| * Local/private macro to dynamically filter log level. |
| */ |
| #define _otDynamicLog(aLogLevel, aRegion, ...) \ |
| do \ |
| { \ |
| if (otLoggingGetLevel() >= aLogLevel) \ |
| _otPlatLog(aLogLevel, aRegion, __VA_ARGS__); \ |
| } while (false) |
| |
| #else // OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE |
| |
| #define _otDynamicLog(aLogLevel, aRegion, ...) _otPlatLog(aLogLevel, aRegion, __VA_ARGS__) |
| |
| #endif // OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE |
| |
| /** |
| * `OPENTHREAD_CONFIG_PLAT_LOG_FUNCTION` is a configuration parameter (see `config/logging.h`) which specifies the |
| * function/macro to be used for logging in OpenThread. By default it is set to `otPlatLog()`. |
| * |
| */ |
| #define _otPlatLog(aLogLevel, aRegion, ...) OPENTHREAD_CONFIG_PLAT_LOG_FUNCTION(aLogLevel, aRegion, __VA_ARGS__) |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif // LOGGING_HPP_ |
