| /* |
| * Copyright (c) 2018 Nordic Semiconductor ASA |
| * |
| * SPDX-License-Identifier: Apache-2.0 |
| */ |
| #ifndef ZEPHYR_INCLUDE_LOGGING_LOG_CORE_H_ |
| #define ZEPHYR_INCLUDE_LOGGING_LOG_CORE_H_ |
| |
| #include <logging/log_msg.h> |
| #include <logging/log_instance.h> |
| #include <stdbool.h> |
| #include <stdint.h> |
| #include <stdarg.h> |
| #include <syscall.h> |
| #include <sys/util.h> |
| #include <sys/printk.h> |
| |
| #define LOG_LEVEL_NONE 0 |
| #define LOG_LEVEL_ERR 1 |
| #define LOG_LEVEL_WRN 2 |
| #define LOG_LEVEL_INF 3 |
| #define LOG_LEVEL_DBG 4 |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| #ifndef CONFIG_LOG |
| #define CONFIG_LOG_DEFAULT_LEVEL 0 |
| #define CONFIG_LOG_MAX_LEVEL 0 |
| #endif |
| |
| #if !defined(CONFIG_LOG) || defined(CONFIG_LOG_MINIMAL) |
| #define CONFIG_LOG_DOMAIN_ID 0 |
| #endif |
| |
| #define LOG_FUNCTION_PREFIX_MASK \ |
| (((u32_t)IS_ENABLED(CONFIG_LOG_FUNC_NAME_PREFIX_ERR) << \ |
| LOG_LEVEL_ERR) | \ |
| ((u32_t)IS_ENABLED(CONFIG_LOG_FUNC_NAME_PREFIX_WRN) << \ |
| LOG_LEVEL_WRN) | \ |
| ((u32_t)IS_ENABLED(CONFIG_LOG_FUNC_NAME_PREFIX_INF) << \ |
| LOG_LEVEL_INF) | \ |
| ((u32_t)IS_ENABLED(CONFIG_LOG_FUNC_NAME_PREFIX_DBG) << LOG_LEVEL_DBG)) |
| |
| /** @brief Macro for returning local level value if defined or default. |
| * |
| * Check @ref IS_ENABLED macro for detailed explanation of the trick. |
| */ |
| #define Z_LOG_RESOLVED_LEVEL(_level, _default) \ |
| Z_LOG_RESOLVED_LEVEL1(_level, _default) |
| |
| #define Z_LOG_RESOLVED_LEVEL1(_level, _default) \ |
| __COND_CODE(_LOG_XXXX##_level, (_level), (_default)) |
| |
| #define _LOG_XXXX0 _LOG_YYYY, |
| #define _LOG_XXXX1 _LOG_YYYY, |
| #define _LOG_XXXX2 _LOG_YYYY, |
| #define _LOG_XXXX3 _LOG_YYYY, |
| #define _LOG_XXXX4 _LOG_YYYY, |
| |
| /** |
| * @brief Macro for conditional code generation if provided log level allows. |
| * |
| * Macro behaves similarly to standard \#if \#else \#endif clause. The |
| * difference is that it is evaluated when used and not when header file is |
| * included. |
| * |
| * @param _eval_level Evaluated level. If level evaluates to one of existing log |
| * log level (1-4) then macro evaluates to _iftrue. |
| * @param _iftrue Code that should be inserted when evaluated to true. Note, |
| * that parameter must be provided in brackets. |
| * @param _iffalse Code that should be inserted when evaluated to false. |
| * Note, that parameter must be provided in brackets. |
| */ |
| #define Z_LOG_EVAL(_eval_level, _iftrue, _iffalse) \ |
| Z_LOG_EVAL1(_eval_level, _iftrue, _iffalse) |
| |
| #define Z_LOG_EVAL1(_eval_level, _iftrue, _iffalse) \ |
| __COND_CODE(_LOG_ZZZZ##_eval_level, _iftrue, _iffalse) |
| |
| #define _LOG_ZZZZ1 _LOG_YYYY, |
| #define _LOG_ZZZZ2 _LOG_YYYY, |
| #define _LOG_ZZZZ3 _LOG_YYYY, |
| #define _LOG_ZZZZ4 _LOG_YYYY, |
| |
| /** @brief Macro for getting log level for given module. |
| * |
| * It is evaluated to LOG_LEVEL if defined. Otherwise CONFIG_LOG_DEFAULT_LEVEL |
| * is used. |
| */ |
| #define _LOG_LEVEL() Z_LOG_RESOLVED_LEVEL(LOG_LEVEL, CONFIG_LOG_DEFAULT_LEVEL) |
| |
| /** |
| * @def LOG_CONST_ID_GET |
| * @brief Macro for getting ID of the element of the section. |
| * |
| * @param _addr Address of the element. |
| */ |
| #define LOG_CONST_ID_GET(_addr) \ |
| Z_LOG_EVAL(\ |
| CONFIG_LOG,\ |
| (__log_level ? \ |
| log_const_source_id((const struct log_source_const_data *)_addr) : \ |
| 0),\ |
| (0)\ |
| ) |
| |
| /** |
| * @def LOG_CURRENT_MODULE_ID |
| * @brief Macro for getting ID of current module. |
| */ |
| #define LOG_CURRENT_MODULE_ID() (__log_level != 0 ? \ |
| log_const_source_id(__log_current_const_data) : 0) |
| |
| /** |
| * @def LOG_CURRENT_DYNAMIC_DATA_ADDR |
| * @brief Macro for getting address of dynamic structure of current module. |
| */ |
| #define LOG_CURRENT_DYNAMIC_DATA_ADDR() (__log_level ? \ |
| __log_current_dynamic_data : (struct log_source_dynamic_data *)0) |
| |
| /** @brief Macro for getting ID of the element of the section. |
| * |
| * @param _addr Address of the element. |
| */ |
| #define LOG_DYNAMIC_ID_GET(_addr) \ |
| Z_LOG_EVAL(\ |
| CONFIG_LOG,\ |
| (__log_level ? \ |
| log_dynamic_source_id((struct log_source_dynamic_data *)_addr) : 0),\ |
| (0)\ |
| ) |
| |
| /** |
| * @brief Macro for optional injection of function name as first argument of |
| * formatted string. COND_CODE_0() macro is used to handle no arguments |
| * case. |
| * |
| * The purpose of this macro is to prefix string literal with format |
| * specifier for function name and inject function name as first |
| * argument. In order to handle string with no arguments _LOG_Z_EVAL is |
| * used. |
| */ |
| |
| #define Z_LOG_STR(...) "%s: " GET_ARG1(__VA_ARGS__), __func__\ |
| COND_CODE_0(NUM_VA_ARGS_LESS_1(__VA_ARGS__),\ |
| (),\ |
| (, GET_ARGS_LESS_1(__VA_ARGS__))\ |
| ) |
| |
| |
| /******************************************************************************/ |
| /****************** Internal macros for log frontend **************************/ |
| /******************************************************************************/ |
| /**@brief Second stage for Z_LOG_NARGS_POSTFIX */ |
| #define _LOG_NARGS_POSTFIX_IMPL( \ |
| _ignored, \ |
| _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, \ |
| _11, _12, _13, _14, N, ...) N |
| |
| /**@brief Macro to get the postfix for further log message processing. |
| * |
| * Logs with more than 3 arguments are processed in a generic way. |
| * |
| * param[in] ... List of arguments |
| * |
| * @retval Postfix, number of arguments or _LONG when more than 3 arguments. |
| */ |
| #define Z_LOG_NARGS_POSTFIX(...) \ |
| _LOG_NARGS_POSTFIX_IMPL(__VA_ARGS__, LONG, LONG, LONG, LONG, LONG, \ |
| LONG, LONG, LONG, LONG, LONG, LONG, LONG, 3, 2, 1, 0, ~) |
| |
| #define Z_LOG_INTERNAL_X(N, ...) UTIL_CAT(_LOG_INTERNAL_, N)(__VA_ARGS__) |
| |
| #define __LOG_INTERNAL(is_user_context, _src_level, ...) \ |
| do { \ |
| if (is_user_context) { \ |
| log_from_user(_src_level, __VA_ARGS__); \ |
| } else if (IS_ENABLED(CONFIG_LOG_IMMEDIATE)) { \ |
| log_string_sync(_src_level, __VA_ARGS__); \ |
| } else { \ |
| Z_LOG_INTERNAL_X(Z_LOG_NARGS_POSTFIX(__VA_ARGS__), \ |
| _src_level, __VA_ARGS__);\ |
| } \ |
| } while (false) |
| |
| #define _LOG_INTERNAL_0(_src_level, _str) \ |
| log_0(_str, _src_level) |
| |
| #define _LOG_INTERNAL_1(_src_level, _str, _arg0) \ |
| log_1(_str, (log_arg_t)(_arg0), _src_level) |
| |
| #define _LOG_INTERNAL_2(_src_level, _str, _arg0, _arg1) \ |
| log_2(_str, (log_arg_t)(_arg0), (log_arg_t)(_arg1), _src_level) |
| |
| #define _LOG_INTERNAL_3(_src_level, _str, _arg0, _arg1, _arg2) \ |
| log_3(_str, (log_arg_t)(_arg0), (log_arg_t)(_arg1), (log_arg_t)(_arg2), _src_level) |
| |
| #define __LOG_ARG_CAST(_x) (log_arg_t)(_x), |
| |
| #define __LOG_ARGUMENTS(...) MACRO_MAP(__LOG_ARG_CAST, __VA_ARGS__) |
| |
| #define _LOG_INTERNAL_LONG(_src_level, _str, ...) \ |
| do { \ |
| log_arg_t args[] = {__LOG_ARGUMENTS(__VA_ARGS__)};\ |
| log_n(_str, args, ARRAY_SIZE(args), _src_level); \ |
| } while (false) |
| |
| #define Z_LOG_LEVEL_CHECK(_level, _check_level, _default_level) \ |
| (_level <= Z_LOG_RESOLVED_LEVEL(_check_level, _default_level)) |
| |
| #define Z_LOG_CONST_LEVEL_CHECK(_level) \ |
| (IS_ENABLED(CONFIG_LOG) && \ |
| (Z_LOG_LEVEL_CHECK(_level, CONFIG_LOG_OVERRIDE_LEVEL, LOG_LEVEL_NONE) \ |
| || \ |
| ((IS_ENABLED(CONFIG_LOG_OVERRIDE_LEVEL) == false) && \ |
| (_level <= __log_level) && \ |
| (_level <= CONFIG_LOG_MAX_LEVEL) \ |
| ) \ |
| )) |
| |
| /******************************************************************************/ |
| /****************** Defiinitions used by minimal logging **********************/ |
| /******************************************************************************/ |
| void log_minimal_hexdump_print(int level, const char *data, size_t size); |
| |
| #define Z_LOG_TO_PRINTK(_level, fmt, ...) do { \ |
| printk("%c: " fmt "\n", z_log_minimal_level_to_char(_level), \ |
| ##__VA_ARGS__); \ |
| } while (false) |
| |
| static inline char z_log_minimal_level_to_char(int level) |
| { |
| switch (level) { |
| case LOG_LEVEL_ERR: |
| return 'E'; |
| case LOG_LEVEL_WRN: |
| return 'W'; |
| case LOG_LEVEL_INF: |
| return 'I'; |
| case LOG_LEVEL_DBG: |
| return 'D'; |
| default: |
| return '?'; |
| } |
| } |
| /******************************************************************************/ |
| /****************** Macros for standard logging *******************************/ |
| /******************************************************************************/ |
| #define __LOG(_level, _id, _filter, ...) \ |
| do { \ |
| bool is_user_context = _is_user_context(); \ |
| \ |
| if (Z_LOG_CONST_LEVEL_CHECK(_level)) { \ |
| if (IS_ENABLED(CONFIG_LOG_MINIMAL)) { \ |
| Z_LOG_TO_PRINTK(_level, __VA_ARGS__); \ |
| } else if (is_user_context || \ |
| (_level <= LOG_RUNTIME_FILTER(_filter))) { \ |
| struct log_msg_ids src_level = { \ |
| .level = _level, \ |
| .domain_id = CONFIG_LOG_DOMAIN_ID, \ |
| .source_id = _id \ |
| }; \ |
| \ |
| if ((BIT(_level) & \ |
| LOG_FUNCTION_PREFIX_MASK) != 0U) { \ |
| __LOG_INTERNAL(is_user_context, \ |
| src_level, \ |
| Z_LOG_STR(__VA_ARGS__));\ |
| } else { \ |
| __LOG_INTERNAL(is_user_context, \ |
| src_level, \ |
| __VA_ARGS__); \ |
| } \ |
| } \ |
| } \ |
| if (false) { \ |
| /* Arguments checker present but never evaluated.*/ \ |
| /* Placed here to ensure that __VA_ARGS__ are*/ \ |
| /* evaluated once when log is enabled.*/ \ |
| log_printf_arg_checker(__VA_ARGS__); \ |
| } \ |
| } while (false) |
| |
| #define Z_LOG(_level, ...) \ |
| __LOG(_level, \ |
| (u16_t)LOG_CURRENT_MODULE_ID(), \ |
| LOG_CURRENT_DYNAMIC_DATA_ADDR(), \ |
| __VA_ARGS__) |
| |
| #define Z_LOG_INSTANCE(_level, _inst, ...) \ |
| __LOG(_level, \ |
| IS_ENABLED(CONFIG_LOG_RUNTIME_FILTERING) ? \ |
| LOG_DYNAMIC_ID_GET(_inst) : \ |
| LOG_CONST_ID_GET(_inst), \ |
| _inst, \ |
| __VA_ARGS__) |
| |
| |
| /******************************************************************************/ |
| /****************** Macros for hexdump logging ********************************/ |
| /******************************************************************************/ |
| #define __LOG_HEXDUMP(_level, _id, _filter, _data, _length, _str) \ |
| do { \ |
| bool is_user_context = _is_user_context(); \ |
| \ |
| if (Z_LOG_CONST_LEVEL_CHECK(_level)) { \ |
| if (IS_ENABLED(CONFIG_LOG_MINIMAL)) { \ |
| Z_LOG_TO_PRINTK(_level, "%s", _str); \ |
| log_minimal_hexdump_print(_level, _data, \ |
| _length); \ |
| } else if (is_user_context || \ |
| (_level <= LOG_RUNTIME_FILTER(_filter))) { \ |
| struct log_msg_ids src_level = { \ |
| .level = _level, \ |
| .source_id = _id, \ |
| .domain_id = CONFIG_LOG_DOMAIN_ID \ |
| }; \ |
| \ |
| if (is_user_context) { \ |
| log_hexdump_from_user(src_level, _str, \ |
| _data, _length); \ |
| } else if (IS_ENABLED(CONFIG_LOG_IMMEDIATE)) { \ |
| log_hexdump_sync(src_level, _str, \ |
| _data, _length); \ |
| } else { \ |
| log_hexdump(_str, _data, _length, \ |
| src_level); \ |
| } \ |
| } \ |
| } \ |
| } while (false) |
| |
| #define Z_LOG_HEXDUMP(_level, _data, _length, _str) \ |
| __LOG_HEXDUMP(_level, \ |
| LOG_CURRENT_MODULE_ID(), \ |
| LOG_CURRENT_DYNAMIC_DATA_ADDR(), \ |
| _data, _length, _str) |
| |
| #define Z_LOG_HEXDUMP_INSTANCE(_level, _inst, _data, _length, _str) \ |
| __LOG_HEXDUMP(_level, \ |
| IS_ENABLED(CONFIG_LOG_RUNTIME_FILTERING) ? \ |
| LOG_DYNAMIC_ID_GET(_inst) : \ |
| LOG_CONST_ID_GET(_inst), \ |
| _inst, \ |
| _data, \ |
| _length, \ |
| _str) |
| |
| /******************************************************************************/ |
| /****************** Filtering macros ******************************************/ |
| /******************************************************************************/ |
| |
| /** @brief Number of bits used to encode log level. */ |
| #define LOG_LEVEL_BITS 3 |
| |
| /** @brief Filter slot size. */ |
| #define LOG_FILTER_SLOT_SIZE LOG_LEVEL_BITS |
| |
| /** @brief Number of slots in one word. */ |
| #define LOG_FILTERS_NUM_OF_SLOTS (32 / LOG_FILTER_SLOT_SIZE) |
| |
| /** @brief Slot mask. */ |
| #define LOG_FILTER_SLOT_MASK (BIT(LOG_FILTER_SLOT_SIZE) - 1) |
| |
| /** @brief Bit offset of a slot. |
| * |
| * @param _id Slot ID. |
| */ |
| #define LOG_FILTER_SLOT_SHIFT(_id) (LOG_FILTER_SLOT_SIZE * (_id)) |
| |
| #define LOG_FILTER_SLOT_GET(_filters, _id) \ |
| ((*(_filters) >> LOG_FILTER_SLOT_SHIFT(_id)) & LOG_FILTER_SLOT_MASK) |
| |
| #define LOG_FILTER_SLOT_SET(_filters, _id, _filter) \ |
| do { \ |
| *(_filters) &= ~(LOG_FILTER_SLOT_MASK << \ |
| LOG_FILTER_SLOT_SHIFT(_id)); \ |
| *(_filters) |= ((_filter) & LOG_FILTER_SLOT_MASK) << \ |
| LOG_FILTER_SLOT_SHIFT(_id); \ |
| } while (false) |
| |
| #define LOG_FILTER_AGGR_SLOT_IDX 0 |
| |
| #define LOG_FILTER_AGGR_SLOT_GET(_filters) \ |
| LOG_FILTER_SLOT_GET(_filters, LOG_FILTER_AGGR_SLOT_IDX) |
| |
| #define LOG_FILTER_FIRST_BACKEND_SLOT_IDX 1 |
| |
| #ifdef CONFIG_LOG_RUNTIME_FILTERING |
| #define LOG_RUNTIME_FILTER(_filter) \ |
| LOG_FILTER_SLOT_GET(&(_filter)->filters, LOG_FILTER_AGGR_SLOT_IDX) |
| #else |
| #define LOG_RUNTIME_FILTER(_filter) LOG_LEVEL_DBG |
| #endif |
| |
| /** @brief Log level value used to indicate log entry that should not be |
| * formatted (raw string). |
| */ |
| #define LOG_LEVEL_INTERNAL_RAW_STRING LOG_LEVEL_NONE |
| |
| extern struct log_source_const_data __log_const_start[0]; |
| extern struct log_source_const_data __log_const_end[0]; |
| |
| /** @brief Get name of the log source. |
| * |
| * @param source_id Source ID. |
| * @return Name. |
| */ |
| static inline const char *log_name_get(u32_t source_id) |
| { |
| return __log_const_start[source_id].name; |
| } |
| |
| /** @brief Get compiled level of the log source. |
| * |
| * @param source_id Source ID. |
| * @return Level. |
| */ |
| static inline u8_t log_compiled_level_get(u32_t source_id) |
| { |
| return __log_const_start[source_id].level; |
| } |
| |
| /** @brief Get index of the log source based on the address of the constant data |
| * associated with the source. |
| * |
| * @param data Address of the constant data. |
| * |
| * @return Source ID. |
| */ |
| static inline u32_t log_const_source_id( |
| const struct log_source_const_data *data) |
| { |
| return ((u8_t *)data - (u8_t *)__log_const_start)/ |
| sizeof(struct log_source_const_data); |
| } |
| |
| /** @brief Get number of registered sources. */ |
| static inline u32_t log_sources_count(void) |
| { |
| return log_const_source_id(__log_const_end); |
| } |
| |
| extern struct log_source_dynamic_data __log_dynamic_start[0]; |
| extern struct log_source_dynamic_data __log_dynamic_end[0]; |
| |
| /** @brief Creates name of variable and section for runtime log data. |
| * |
| * @param _name Name. |
| */ |
| #define LOG_ITEM_DYNAMIC_DATA(_name) UTIL_CAT(log_dynamic_, _name) |
| |
| #define LOG_INSTANCE_DYNAMIC_DATA(_module_name, _inst) \ |
| LOG_ITEM_DYNAMIC_DATA(LOG_INSTANCE_FULL_NAME(_module_name, _inst)) |
| |
| /** @brief Get pointer to the filter set of the log source. |
| * |
| * @param source_id Source ID. |
| * |
| * @return Pointer to the filter set. |
| */ |
| static inline u32_t *log_dynamic_filters_get(u32_t source_id) |
| { |
| return &__log_dynamic_start[source_id].filters; |
| } |
| |
| /** @brief Get index of the log source based on the address of the dynamic data |
| * associated with the source. |
| * |
| * @param data Address of the dynamic data. |
| * |
| * @return Source ID. |
| */ |
| static inline u32_t log_dynamic_source_id(struct log_source_dynamic_data *data) |
| { |
| return ((u8_t *)data - (u8_t *)__log_dynamic_start)/ |
| sizeof(struct log_source_dynamic_data); |
| } |
| |
| /** @brief Dummy function to trigger log messages arguments type checking. */ |
| static inline __printf_like(1, 2) |
| void log_printf_arg_checker(const char *fmt, ...) |
| { |
| ARG_UNUSED(fmt); |
| } |
| |
| /** @brief Standard log with no arguments. |
| * |
| * @param str String. |
| * @param src_level Log identification. |
| */ |
| void log_0(const char *str, struct log_msg_ids src_level); |
| |
| /** @brief Standard log with one argument. |
| * |
| * @param str String. |
| * @param arg1 First argument. |
| * @param src_level Log identification. |
| */ |
| void log_1(const char *str, |
| log_arg_t arg1, |
| struct log_msg_ids src_level); |
| |
| /** @brief Standard log with two arguments. |
| * |
| * @param str String. |
| * @param arg1 First argument. |
| * @param arg2 Second argument. |
| * @param src_level Log identification. |
| */ |
| void log_2(const char *str, |
| log_arg_t arg1, |
| log_arg_t arg2, |
| struct log_msg_ids src_level); |
| |
| /** @brief Standard log with three arguments. |
| * |
| * @param str String. |
| * @param arg1 First argument. |
| * @param arg2 Second argument. |
| * @param arg3 Third argument. |
| * @param src_level Log identification. |
| */ |
| void log_3(const char *str, |
| log_arg_t arg1, |
| log_arg_t arg2, |
| log_arg_t arg3, |
| struct log_msg_ids src_level); |
| |
| /** @brief Standard log with arguments list. |
| * |
| * @param str String. |
| * @param args Array with arguments. |
| * @param narg Number of arguments in the array. |
| * @param src_level Log identification. |
| */ |
| void log_n(const char *str, |
| log_arg_t *args, |
| u32_t narg, |
| struct log_msg_ids src_level); |
| |
| /** @brief Hexdump log. |
| * |
| * @param str String. |
| * @param data Data. |
| * @param length Data length. |
| * @param src_level Log identification. |
| */ |
| void log_hexdump(const char *str, |
| const u8_t *data, |
| u32_t length, |
| struct log_msg_ids src_level); |
| |
| /** @brief Process log message synchronously. |
| * |
| * @param src_level Log message details. |
| * @param fmt String to format. |
| * @param ... Variable list of arguments. |
| */ |
| void log_string_sync(struct log_msg_ids src_level, const char *fmt, ...); |
| |
| /** @brief Process log hexdump message synchronously. |
| * |
| * @param src_level Log message details. |
| * @param metadata Raw string associated with the data. |
| * @param data Data. |
| * @param len Data length. |
| */ |
| void log_hexdump_sync(struct log_msg_ids src_level, const char *metadata, |
| const u8_t *data, u32_t len); |
| |
| /** |
| * @brief Writes a generic log message to the log. |
| * |
| * @note This function is intended to be used when porting other log systems. |
| */ |
| void log_generic(struct log_msg_ids src_level, const char *fmt, va_list ap); |
| |
| /** |
| * @brief Writes a generic log message to the log from user mode. |
| * |
| * @note This function is intended to be used internally |
| * by the logging subsystem. |
| */ |
| void log_generic_from_user(struct log_msg_ids src_level, |
| const char *fmt, va_list ap); |
| |
| /** @brief Check if address belongs to the memory pool used for transient. |
| * |
| * @param buf Buffer. |
| * |
| * @return True if address within the pool, false otherwise. |
| */ |
| bool log_is_strdup(const void *buf); |
| |
| /** @brief Free allocated buffer. |
| * |
| * @param buf Buffer. |
| */ |
| void log_free(void *buf); |
| |
| /** |
| * @brief Get maximal number of simultaneously allocated buffers for string |
| * duplicates. |
| * |
| * Value can be used to determine pool size. |
| */ |
| u32_t log_get_strdup_pool_utilization(void); |
| |
| /** |
| * @brief Get length of the longest string duplicated. |
| * |
| * Value can be used to determine buffer size in the string duplicates pool. |
| */ |
| u32_t log_get_strdup_longest_string(void); |
| |
| /** @brief Indicate to the log core that one log message has been dropped. |
| */ |
| void log_dropped(void); |
| |
| /** @brief Log a message from user mode context. |
| * |
| * @note This function is intended to be used internally |
| * by the logging subsystem. |
| * |
| * @param src_level Log identification. |
| * @param fmt String to format. |
| * @param ... Variable list of arguments. |
| */ |
| void __printf_like(2, 3) log_from_user(struct log_msg_ids src_level, |
| const char *fmt, ...); |
| |
| |
| /* Internal function used by log_from_user(). */ |
| __syscall void z_log_string_from_user(u32_t src_level_val, const char *str); |
| |
| /** @brief Log binary data (displayed as hexdump) from user mode context. |
| * |
| * @note This function is intended to be used internally |
| * by the logging subsystem. |
| * |
| * @param src_level Log identification. |
| * @param metadata Raw string associated with the data. |
| * @param data Data. |
| * @param len Data length. |
| */ |
| void log_hexdump_from_user(struct log_msg_ids src_level, const char *metadata, |
| const u8_t *data, u32_t len); |
| |
| /* Internal function used by log_hexdump_from_user(). */ |
| __syscall void z_log_hexdump_from_user(u32_t src_level_val, |
| const char *metadata, |
| const u8_t *data, u32_t len); |
| |
| #include <syscalls/log_core.h> |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* ZEPHYR_INCLUDE_LOGGING_LOG_CORE_H_ */ |