#include "rcl/allocator.h"
#include "rcl/macros.h"
#include "rcl/types.h"
#include "rcl/visibility_control.h"

Include dependency graph for log_level.h:

This graph shows which files directly or indirectly include this file:

Classes
struct	rcl_logger_setting_s
	A logger item to specify a name and a log level. More...

struct	rcl_log_levels_s
	Hold default logger level and other logger setting. More...

Typedefs
typedef enum RCUTILS_LOG_SEVERITY	rcl_log_severity_t
	typedef for RCUTILS_LOG_SEVERITY;

typedef struct rcl_logger_setting_s	rcl_logger_setting_t
	A logger item to specify a name and a log level.

typedef struct rcl_log_levels_s	rcl_log_levels_t
	Hold default logger level and other logger setting.

Functions
RCL_PUBLIC RCL_WARN_UNUSED rcl_log_levels_t	rcl_get_zero_initialized_log_levels (void)
	Return a rcl_log_levels_t struct with members initialized to zero value. More...

RCL_PUBLIC RCL_WARN_UNUSED rcl_ret_t	rcl_log_levels_init (rcl_log_levels_t log_levels, const rcl_allocator_t allocator, size_t logger_count)
	Initialize a log levels structure. More...

RCL_PUBLIC RCL_WARN_UNUSED rcl_ret_t	rcl_log_levels_copy (const rcl_log_levels_t src, rcl_log_levels_t dst)
	Copy one log levels structure into another. More...

RCL_PUBLIC rcl_ret_t	rcl_log_levels_fini (rcl_log_levels_t *log_levels)
	Reclaim resources held inside rcl_log_levels_t structure. More...

RCL_PUBLIC rcl_ret_t	rcl_log_levels_shrink_to_size (rcl_log_levels_t *log_levels)
	Shrink log levels structure. More...

RCL_PUBLIC rcl_ret_t	rcl_log_levels_add_logger_setting (rcl_log_levels_t log_levels, const char logger_name, rcl_log_severity_t log_level)
	Add logger setting with a name and a level. More...

Function Documentation

◆ rcl_get_zero_initialized_log_levels()

RCL_PUBLIC RCL_WARN_UNUSED rcl_log_levels_t rcl_get_zero_initialized_log_levels ( void )

Return a rcl_log_levels_t struct with members initialized to zero value.

Attribute	Adherence
Allocates Memory	No
Thread-Safe	Yes
Uses Atomics	No
Lock-Free	Yes

Returns: a rcl_log_levels_t struct with members initialized to zero value.

Definition at line 23 of file log_level.c.

References rcl_log_levels_s::default_logger_level.

◆ rcl_log_levels_add_logger_setting()

RCL_PUBLIC rcl_ret_t rcl_log_levels_add_logger_setting	(	rcl_log_levels_t *	log_levels,
		const char *	logger_name,
		rcl_log_severity_t	log_level
	)

Add logger setting with a name and a level.

Attribute	Adherence
Allocates Memory	Yes
Thread-Safe	No
Uses Atomics	No
Lock-Free	Yes

Parameters

[in]	log_levels	The structure where to set the logger log level.
[in]	logger_name	Name for the logger, a copy of it will be stored in the structure.
[in]	log_level	Minimum log level severity to be set for logger_name.

Returns: RCL_RET_OK if add logger setting successfully, or; RCL_RET_BAD_ALLOC if allocating memory failed, or; RCL_RET_INVALID_ARGUMENT if log_levels is NULL, or; RCL_RET_INVALID_ARGUMENT if log_levels was not initialized, or; RCL_RET_INVALID_ARGUMENT if log_levels allocator is invalid, or; RCL_RET_INVALID_ARGUMENT if logger_name is NULL, or; RCL_RET_ERROR if the log_levels structure is already full.

Definition at line 145 of file log_level.c.

References rcl_log_levels_s::allocator, rcl_log_levels_s::capacity_logger_settings, rcl_logger_setting_s::level, rcl_log_levels_s::logger_settings, rcl_logger_setting_s::name, rcl_log_levels_s::num_logger_settings, RCL_CHECK_ALLOCATOR_WITH_MSG, RCL_RET_BAD_ALLOC, RCL_RET_ERROR, RCL_RET_INVALID_ARGUMENT, and RCL_RET_OK.

◆ rcl_log_levels_copy()

RCL_PUBLIC RCL_WARN_UNUSED rcl_ret_t rcl_log_levels_copy	(	const rcl_log_levels_t *	src,
		rcl_log_levels_t *	dst
	)

Copy one log levels structure into another.

Attribute	Adherence
Allocates Memory	Yes
Thread-Safe	No
Uses Atomics	No
Lock-Free	Yes

Parameters

[in]	src	The structure to be copied. Its allocator is used to copy memory into the new structure.
[out]	dst	A log levels structure to be copied into.

Returns: RCL_RET_OK if the structure was copied successfully, or; RCL_RET_INVALID_ARGUMENT if src is NULL, or; RCL_RET_INVALID_ARGUMENT if src allocator is invalid, or; RCL_RET_INVALID_ARGUMENT if dst is NULL, or; RCL_RET_INVALID_ARGUMENT if dst contains already allocated memory, or; RCL_RET_BAD_ALLOC if allocating memory failed.

Definition at line 64 of file log_level.c.

References rcl_log_levels_s::allocator, rcl_log_levels_s::capacity_logger_settings, rcl_log_levels_s::default_logger_level, rcl_logger_setting_s::level, rcl_log_levels_s::logger_settings, rcl_logger_setting_s::name, rcl_log_levels_s::num_logger_settings, RCL_CHECK_ALLOCATOR_WITH_MSG, rcl_log_levels_fini(), RCL_RET_BAD_ALLOC, RCL_RET_INVALID_ARGUMENT, and RCL_RET_OK.

Here is the call graph for this function:

◆ rcl_log_levels_fini()

RCL_PUBLIC rcl_ret_t rcl_log_levels_fini ( rcl_log_levels_t * log_levels )

Reclaim resources held inside rcl_log_levels_t structure.

Attribute	Adherence
Allocates Memory	No
Thread-Safe	No
Uses Atomics	No
Lock-Free	Yes

Parameters

[in] log_levels The structure which its resources have to be deallocated.

Returns: RCL_RET_OK if the memory was successfully freed, or; RCL_RET_INVALID_ARGUMENT if log_levels is NULL, or; RCL_RET_INVALID_ARGUMENT if the log_levels allocator is invalid and the structure contains initialized memory.

Definition at line 102 of file log_level.c.

References rcl_log_levels_s::allocator, rcl_log_levels_s::logger_settings, rcl_logger_setting_s::name, rcl_log_levels_s::num_logger_settings, RCL_CHECK_ALLOCATOR_WITH_MSG, RCL_RET_INVALID_ARGUMENT, and RCL_RET_OK.

Referenced by rcl_log_levels_copy().

Here is the caller graph for this function:

◆ rcl_log_levels_init()

RCL_PUBLIC RCL_WARN_UNUSED rcl_ret_t rcl_log_levels_init	(	rcl_log_levels_t *	log_levels,
		const rcl_allocator_t *	allocator,
		size_t	logger_count
	)

Initialize a log levels structure.

Attribute	Adherence
Allocates Memory	Yes
Thread-Safe	No
Uses Atomics	No
Lock-Free	Yes

Parameters

[in]	log_levels	The structure to be initialized.
[in]	allocator	Memory allocator to be used and assigned into log_levels.
[in]	logger_count	Number of logger settings to be allocated. This reserves memory for logger_settings, but doesn't initialize it.

Returns: RCL_RET_OK if the structure was initialized successfully, or; RCL_RET_INVALID_ARGUMENT if log_levels is NULL, or; RCL_RET_INVALID_ARGUMENT if log_levels contains initialized memory, or; RCL_RET_INVALID_ARGUMENT if allocator is invalid, or; RCL_RET_BAD_ALLOC if allocating memory failed.

Definition at line 36 of file log_level.c.

References rcl_log_levels_s::allocator, rcl_log_levels_s::capacity_logger_settings, rcl_log_levels_s::default_logger_level, rcl_log_levels_s::logger_settings, rcl_log_levels_s::num_logger_settings, RCL_CHECK_ALLOCATOR_WITH_MSG, RCL_RET_BAD_ALLOC, RCL_RET_INVALID_ARGUMENT, and RCL_RET_OK.

◆ rcl_log_levels_shrink_to_size()

RCL_PUBLIC rcl_ret_t rcl_log_levels_shrink_to_size ( rcl_log_levels_t * log_levels )

Shrink log levels structure.

Attribute	Adherence
Allocates Memory	Yes
Thread-Safe	No
Uses Atomics	No
Lock-Free	Yes

Parameters

[in] log_levels The structure to be shrunk.

Returns: RCL_RET_OK if the memory was successfully shrunk, or; RCL_RET_INVALID_ARGUMENT if log_levels is NULL or if its allocator is invalid, or; RCL_RET_BAD_ALLOC if reallocating memory failed.

Definition at line 121 of file log_level.c.

References rcl_log_levels_s::allocator, rcl_log_levels_s::capacity_logger_settings, rcl_log_levels_s::logger_settings, rcl_log_levels_s::num_logger_settings, RCL_CHECK_ALLOCATOR_WITH_MSG, RCL_RET_BAD_ALLOC, RCL_RET_INVALID_ARGUMENT, and RCL_RET_OK.

Classes

Typedefs

Functions

Function Documentation

◆ rcl_get_zero_initialized_log_levels()

◆ rcl_log_levels_add_logger_setting()

◆ rcl_log_levels_copy()

◆ rcl_log_levels_fini()

◆ rcl_log_levels_init()

◆ rcl_log_levels_shrink_to_size()