DPDK  20.05.0
Data Structures | Macros | Functions | Variables
rte_log.h File Reference
#include <stdint.h>
#include <stdio.h>
#include <stdarg.h>
#include <stdbool.h>
#include <sys/queue.h>
#include <rte_common.h>
#include <rte_config.h>
#include <rte_compat.h>

Go to the source code of this file.

Data Structures

struct  rte_logs
 

Macros

#define RTE_LOGTYPE_EAL   0
 
#define RTE_LOGTYPE_MALLOC   1
 
#define RTE_LOGTYPE_RING   2
 
#define RTE_LOGTYPE_MEMPOOL   3
 
#define RTE_LOGTYPE_TIMER   4
 
#define RTE_LOGTYPE_PMD   5
 
#define RTE_LOGTYPE_HASH   6
 
#define RTE_LOGTYPE_LPM   7
 
#define RTE_LOGTYPE_KNI   8
 
#define RTE_LOGTYPE_ACL   9
 
#define RTE_LOGTYPE_POWER   10
 
#define RTE_LOGTYPE_METER   11
 
#define RTE_LOGTYPE_SCHED   12
 
#define RTE_LOGTYPE_PORT   13
 
#define RTE_LOGTYPE_TABLE   14
 
#define RTE_LOGTYPE_PIPELINE   15
 
#define RTE_LOGTYPE_MBUF   16
 
#define RTE_LOGTYPE_CRYPTODEV   17
 
#define RTE_LOGTYPE_EFD   18
 
#define RTE_LOGTYPE_EVENTDEV   19
 
#define RTE_LOGTYPE_GSO   20
 
#define RTE_LOGTYPE_USER1   24
 
#define RTE_LOGTYPE_USER2   25
 
#define RTE_LOGTYPE_USER3   26
 
#define RTE_LOGTYPE_USER4   27
 
#define RTE_LOGTYPE_USER5   28
 
#define RTE_LOGTYPE_USER6   29
 
#define RTE_LOGTYPE_USER7   30
 
#define RTE_LOGTYPE_USER8   31
 
#define RTE_LOGTYPE_FIRST_EXT_ID   32
 
#define RTE_LOG_EMERG   1U
 
#define RTE_LOG_ALERT   2U
 
#define RTE_LOG_CRIT   3U
 
#define RTE_LOG_ERR   4U
 
#define RTE_LOG_WARNING   5U
 
#define RTE_LOG_NOTICE   6U
 
#define RTE_LOG_INFO   7U
 
#define RTE_LOG_DEBUG   8U
 
#define RTE_LOG(l, t, ...)
 
#define RTE_LOG_DP(l, t, ...)
 

Functions

int rte_openlog_stream (FILE *f)
 
__rte_experimental FILE * rte_log_get_stream (void)
 
void rte_log_set_global_level (uint32_t level)
 
uint32_t rte_log_get_global_level (void)
 
int rte_log_get_level (uint32_t logtype)
 
__rte_experimental bool rte_log_can_log (uint32_t logtype, uint32_t loglevel)
 
int rte_log_set_level_pattern (const char *pattern, uint32_t level)
 
int rte_log_set_level_regexp (const char *regex, uint32_t level)
 
int rte_log_set_level (uint32_t logtype, uint32_t level)
 
int rte_log_cur_msg_loglevel (void)
 
int rte_log_cur_msg_logtype (void)
 
int rte_log_register (const char *name)
 
__rte_experimental int rte_log_register_type_and_pick_level (const char *name, uint32_t level_def)
 
void rte_log_dump (FILE *f)
 
int rte_log (uint32_t level, uint32_t logtype, const char *format,...) __rte_format_printf(3
 
int int rte_vlog (uint32_t level, uint32_t logtype, const char *format, va_list ap) __rte_format_printf(3
 

Variables

struct rte_logs rte_logs
 

Detailed Description

RTE Logs API

This file provides a log API to RTE applications.

Definition in file rte_log.h.

Macro Definition Documentation

#define RTE_LOGTYPE_EAL   0

Log related to eal.

Definition at line 45 of file rte_log.h.

#define RTE_LOGTYPE_MALLOC   1

Log related to malloc.

Definition at line 46 of file rte_log.h.

#define RTE_LOGTYPE_RING   2

Log related to ring.

Definition at line 47 of file rte_log.h.

#define RTE_LOGTYPE_MEMPOOL   3

Log related to mempool.

Definition at line 48 of file rte_log.h.

#define RTE_LOGTYPE_TIMER   4

Log related to timers.

Definition at line 49 of file rte_log.h.

#define RTE_LOGTYPE_PMD   5

Log related to poll mode driver.

Definition at line 50 of file rte_log.h.

#define RTE_LOGTYPE_HASH   6

Log related to hash table.

Definition at line 51 of file rte_log.h.

#define RTE_LOGTYPE_LPM   7

Log related to LPM.

Definition at line 52 of file rte_log.h.

#define RTE_LOGTYPE_KNI   8

Log related to KNI.

Definition at line 53 of file rte_log.h.

#define RTE_LOGTYPE_ACL   9

Log related to ACL.

Definition at line 54 of file rte_log.h.

#define RTE_LOGTYPE_POWER   10

Log related to power.

Definition at line 55 of file rte_log.h.

#define RTE_LOGTYPE_METER   11

Log related to QoS meter.

Definition at line 56 of file rte_log.h.

#define RTE_LOGTYPE_SCHED   12

Log related to QoS port scheduler.

Definition at line 57 of file rte_log.h.

#define RTE_LOGTYPE_PORT   13

Log related to port.

Definition at line 58 of file rte_log.h.

#define RTE_LOGTYPE_TABLE   14

Log related to table.

Definition at line 59 of file rte_log.h.

#define RTE_LOGTYPE_PIPELINE   15

Log related to pipeline.

Definition at line 60 of file rte_log.h.

#define RTE_LOGTYPE_MBUF   16

Log related to mbuf.

Definition at line 61 of file rte_log.h.

#define RTE_LOGTYPE_CRYPTODEV   17

Log related to cryptodev.

Definition at line 62 of file rte_log.h.

#define RTE_LOGTYPE_EFD   18

Log related to EFD.

Definition at line 63 of file rte_log.h.

#define RTE_LOGTYPE_EVENTDEV   19

Log related to eventdev.

Definition at line 64 of file rte_log.h.

#define RTE_LOGTYPE_GSO   20

Log related to GSO.

Definition at line 65 of file rte_log.h.

#define RTE_LOGTYPE_USER1   24

User-defined log type 1.

Definition at line 68 of file rte_log.h.

#define RTE_LOGTYPE_USER2   25

User-defined log type 2.

Definition at line 69 of file rte_log.h.

#define RTE_LOGTYPE_USER3   26

User-defined log type 3.

Definition at line 70 of file rte_log.h.

#define RTE_LOGTYPE_USER4   27

User-defined log type 4.

Definition at line 71 of file rte_log.h.

#define RTE_LOGTYPE_USER5   28

User-defined log type 5.

Definition at line 72 of file rte_log.h.

#define RTE_LOGTYPE_USER6   29

User-defined log type 6.

Definition at line 73 of file rte_log.h.

#define RTE_LOGTYPE_USER7   30

User-defined log type 7.

Definition at line 74 of file rte_log.h.

#define RTE_LOGTYPE_USER8   31

User-defined log type 8.

Definition at line 75 of file rte_log.h.

#define RTE_LOGTYPE_FIRST_EXT_ID   32

First identifier for extended logs

Definition at line 78 of file rte_log.h.

#define RTE_LOG_EMERG   1U

System is unusable.

Definition at line 81 of file rte_log.h.

#define RTE_LOG_ALERT   2U

Action must be taken immediately.

Definition at line 82 of file rte_log.h.

#define RTE_LOG_CRIT   3U

Critical conditions.

Definition at line 83 of file rte_log.h.

#define RTE_LOG_ERR   4U

Error conditions.

Definition at line 84 of file rte_log.h.

#define RTE_LOG_WARNING   5U

Warning conditions.

Definition at line 85 of file rte_log.h.

#define RTE_LOG_NOTICE   6U

Normal but significant condition.

Definition at line 86 of file rte_log.h.

#define RTE_LOG_INFO   7U

Informational.

Definition at line 87 of file rte_log.h.

#define RTE_LOG_DEBUG   8U

Debug-level messages.

Definition at line 88 of file rte_log.h.

#define RTE_LOG (   l,
  t,
  ... 
)
Value:
rte_log(RTE_LOG_ ## l, \
RTE_LOGTYPE_ ## t, # t ": " __VA_ARGS__)
int rte_log(uint32_t level, uint32_t logtype, const char *format,...) __rte_format_printf(3

Generates a log message.

The RTE_LOG() is a helper that prefixes the string with the log level and type, and call rte_log().

Parameters
lLog level. A value between EMERG (1) and DEBUG (8). The short name is expanded by the macro, so it cannot be an integer value.
tThe log type, for example, EAL. The short name is expanded by the macro, so it cannot be an integer value.
...The fmt string, as in printf(3), followed by the variable arguments required by the format.
Returns
  • 0: Success.
  • Negative on error.
Examples:
examples/distributor/main.c, examples/fips_validation/fips_dev_self_test.c, examples/fips_validation/fips_validation.c, examples/fips_validation/main.c, examples/ioat/ioatfwd.c, examples/ip_fragmentation/main.c, examples/ip_reassembly/main.c, examples/ipsec-secgw/esp.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipsec-secgw/ipsec.c, examples/ipsec-secgw/ipsec_worker.c, examples/ipsec-secgw/rt.c, examples/ipsec-secgw/sa.c, examples/ipsec-secgw/sp4.c, examples/ipsec-secgw/sp6.c, examples/ipv4_multicast/main.c, examples/kni/main.c, examples/l2fwd-crypto/main.c, examples/l2fwd-jobstats/main.c, examples/l2fwd-keepalive/main.c, examples/l2fwd-keepalive/shm.c, examples/l2fwd/main.c, examples/l3fwd-acl/main.c, examples/l3fwd-graph/main.c, examples/l3fwd-power/main.c, examples/l3fwd/l3fwd_em.c, examples/l3fwd/l3fwd_lpm.c, examples/link_status_interrupt/main.c, examples/multi_process/client_server_mp/mp_client/client.c, examples/multi_process/client_server_mp/mp_server/main.c, examples/multi_process/simple_mp/main.c, examples/multi_process/symmetric_mp/main.c, examples/packet_ordering/main.c, examples/performance-thread/common/lthread_diag.c, examples/performance-thread/common/lthread_sched.c, examples/performance-thread/l3fwd-thread/main.c, examples/qos_sched/args.c, examples/qos_sched/init.c, examples/qos_sched/main.c, examples/server_node_efd/node/node.c, examples/server_node_efd/server/main.c, examples/tep_termination/main.c, examples/tep_termination/vxlan_setup.c, examples/vdpa/main.c, examples/vhost/main.c, examples/vhost/virtio_net.c, examples/vhost_crypto/main.c, examples/vm_power_manager/channel_manager.c, examples/vm_power_manager/channel_monitor.c, examples/vm_power_manager/guest_cli/vm_power_cli_guest.c, examples/vm_power_manager/main.c, examples/vm_power_manager/oob_monitor_x86.c, and examples/vm_power_manager/power_manager.c.

Definition at line 349 of file rte_log.h.

#define RTE_LOG_DP (   l,
  t,
  ... 
)
Value:
(void)((RTE_LOG_ ## l <= RTE_LOG_DP_LEVEL) ? \
rte_log(RTE_LOG_ ## l, \
RTE_LOGTYPE_ ## t, # t ": " __VA_ARGS__) : \
0)
int rte_log(uint32_t level, uint32_t logtype, const char *format,...) __rte_format_printf(3

Generates a log message for data path.

Similar to RTE_LOG(), except that it is removed at compilation time if the RTE_LOG_DP_LEVEL configuration option is lower than the log level argument.

Parameters
lLog level. A value between EMERG (1) and DEBUG (8). The short name is expanded by the macro, so it cannot be an integer value.
tThe log type, for example, EAL. The short name is expanded by the macro, so it cannot be an integer value.
...The fmt string, as in printf(3), followed by the variable arguments required by the format.
Returns
  • 0: Success.
  • Negative on error.
Examples:
examples/distributor/main.c, examples/ipsec-secgw/esp.c, examples/ipsec-secgw/ipsec.c, examples/packet_ordering/main.c, examples/tep_termination/main.c, and examples/vhost/main.c.

Definition at line 373 of file rte_log.h.

Function Documentation

int rte_openlog_stream ( FILE *  f)

Change the stream that will be used by the logging system.

This can be done at any time. The f argument represents the stream to be used to send the logs. If f is NULL, the default output is used (stderr).

Parameters
fPointer to the stream.
Returns
  • 0 on success.
  • Negative on error.
__rte_experimental FILE* rte_log_get_stream ( void  )
Warning
EXPERIMENTAL: this API may change without prior notice

Retrieve the stream used by the logging system (see rte_openlog_stream() to change it).

Returns
Pointer to the stream.
void rte_log_set_global_level ( uint32_t  level)

Set the global log level.

After this call, logs with a level lower or equal than the level passed as argument will be displayed.

Parameters
levelLog level. A value between RTE_LOG_EMERG (1) and RTE_LOG_DEBUG (8).
uint32_t rte_log_get_global_level ( void  )

Get the global log level.

Returns
The current global log level.
int rte_log_get_level ( uint32_t  logtype)

Get the log level for a given type.

Parameters
logtypeThe log type identifier.
Returns
0 on success, a negative value if logtype is invalid.
__rte_experimental bool rte_log_can_log ( uint32_t  logtype,
uint32_t  loglevel 
)

For a given logtype, check if a log with loglevel can be printed.

Parameters
logtypeThe log type identifier
loglevelLog level. A value between RTE_LOG_EMERG (1) and RTE_LOG_DEBUG (8).
Returns
Returns 'true' if log can be printed and 'false' if it can't.
int rte_log_set_level_pattern ( const char *  pattern,
uint32_t  level 
)

Set the log level for a given type based on globbing pattern.

Parameters
patternThe globbing pattern identifying the log type.
levelThe level to be set.
Returns
0 on success, a negative value if level is invalid.
int rte_log_set_level_regexp ( const char *  regex,
uint32_t  level 
)

Set the log level for a given type based on regular expression.

Parameters
regexThe regular expression identifying the log type.
levelThe level to be set.
Returns
0 on success, a negative value if level is invalid.
int rte_log_set_level ( uint32_t  logtype,
uint32_t  level 
)

Set the log level for a given type.

Parameters
logtypeThe log type identifier.
levelThe level to be set.
Returns
0 on success, a negative value if logtype or level is invalid.
int rte_log_cur_msg_loglevel ( void  )

Get the current loglevel for the message being processed.

Before calling the user-defined stream for logging, the log subsystem sets a per-lcore variable containing the loglevel and the logtype of the message being processed. This information can be accessed by the user-defined log output function through this function.

Returns
The loglevel of the message being processed.
int rte_log_cur_msg_logtype ( void  )

Get the current logtype for the message being processed.

Before calling the user-defined stream for logging, the log subsystem sets a per-lcore variable containing the loglevel and the logtype of the message being processed. This information can be accessed by the user-defined log output function through this function.

Returns
The logtype of the message being processed.
int rte_log_register ( const char *  name)

Register a dynamic log type

If a log is already registered with the same type, the returned value is the same than the previous one.

Parameters
nameThe string identifying the log type.
Returns
  • >0: success, the returned value is the log type identifier.
  • (-ENOMEM): cannot allocate memory.
__rte_experimental int rte_log_register_type_and_pick_level ( const char *  name,
uint32_t  level_def 
)
Warning
EXPERIMENTAL: this API may change without prior notice

Register a dynamic log type and try to pick its level from EAL options

rte_log_register() is called inside. If successful, the function tries to search for matching regexp in the list of EAL log level options and pick the level from the last matching entry. If nothing can be applied from the list, the level will be set to the user-defined default value.

Parameters
nameName for the log type to be registered
level_defFallback level to be set if the global list has no matching options
Returns
void rte_log_dump ( FILE *  f)

Dump log information.

Dump the global level and the registered log types.

Parameters
fThe output stream where the dump should be sent.
int rte_log ( uint32_t  level,
uint32_t  logtype,
const char *  format,
  ... 
)

Generates a log message.

The message will be sent in the stream defined by the previous call to rte_openlog_stream().

The level argument determines if the log should be displayed or not, depending on the global rte_logs variable.

The preferred alternative is the RTE_LOG() because it adds the level and type in the logged string.

Parameters
levelLog level. A value between RTE_LOG_EMERG (1) and RTE_LOG_DEBUG (8).
logtypeThe log type, for example, RTE_LOGTYPE_EAL.
formatThe format string, as in printf(3), followed by the variable arguments required by the format.
Returns
  • 0: Success.
  • Negative on error.
int int rte_vlog ( uint32_t  level,
uint32_t  logtype,
const char *  format,
va_list  ap 
)

Generates a log message.

The message will be sent in the stream defined by the previous call to rte_openlog_stream().

The level argument determines if the log should be displayed or not, depending on the global rte_logs variable. A trailing newline may be added if needed.

The preferred alternative is the RTE_LOG() because it adds the level and type in the logged string.

Parameters
levelLog level. A value between RTE_LOG_EMERG (1) and RTE_LOG_DEBUG (8).
logtypeThe log type, for example, RTE_LOGTYPE_EAL.
formatThe format string, as in printf(3), followed by the variable arguments required by the format.
apThe va_list of the variable arguments required by the format.
Returns
  • 0: Success.
  • Negative on error.

Variable Documentation

Global log information