zephyr/subsys/logging/Kconfig

125 lines
3.3 KiB
Plaintext

#
# Copyright (c) 2016 Intel Corporation
#
# SPDX-License-Identifier: Apache-2.0
#
menu "Logging Options"
config SYS_LOG
bool
prompt "Enable Logging"
depends on PRINTK
default n
help
Global switch for logging, when turned off log calls will not be
executed.
config SYS_LOG_SHOW_TAGS
bool
prompt "Prepend level tags to logs"
depends on SYS_LOG
default y
help
Prefixes all log lines with an identifier to the log level submitted in
the C code.
config SYS_LOG_SHOW_COLOR
bool
prompt "Use colored logs"
depends on SYS_LOG
default n
help
Use color in the logs. This requires an ANSI capable terminal.
config SYS_LOG_DEFAULT_LEVEL
int
prompt "Default log level"
depends on SYS_LOG
default 0
range 0 4
help
Sets log level for modules which don't specify it explicitly. When
set to 0 it means log wont be activated for those modules.
Levels are:
0 OFF, do not write by default
1 ERROR, default to only write SYS_LOG_ERR
2 WARNING, default to write SYS_LOG_WRN in addition to previous level
3 INFO, default to write SYS_LOG_INF in addition to previous levels
4 DEBUG, default to write SYS_LOG_DBG in addition to previous levels
config SYS_LOG_OVERRIDE_LEVEL
int
prompt "Override lowest log level"
depends on SYS_LOG
default 0
range 0 4
help
Forces a minimum log level for all modules. Modules use their
specified level if it is greater than this option, otherwise they use
the level specified by this option instead of their default or
whatever was manually set.
Levels are:
0 OFF, do not override
1 ERROR, override to write SYS_LOG_ERR
2 WARNING, override to write SYS_LOG_WRN in addition to previous level
3 INFO, override to write SYS_LOG_INF in addition to previous levels
4 DEBUG, override to write SYS_LOG_DBG in addition to previous levels
config SYS_LOG_EXT_HOOK
bool
prompt "Use external hook function for logging"
depends on SYS_LOG
default n
help
Use external hook function for logging.
config SYS_LOG_BACKEND_NET
bool "Networking syslog backend"
default n
depends on SYS_LOG && NETWORKING
select SYS_LOG_EXT_HOOK
select NET_CONTEXT_NET_PKT_POOL
help
Send syslog messages to network server.
See RFC 5424 (syslog protocol) and RFC 5426 (syslog over UDP)
specifications for details.
if SYS_LOG_BACKEND_NET
config SYS_LOG_BACKEND_NET_SERVER
string "Syslog server IP address"
help
This can be either IPv4 or IPv6 address.
Server listen UDP port number can be configured here too.
Following syntax is supported:
192.0.2.1:514
192.0.2.42
[2001:db8::1]:514
[2001:db8::2]
2001:db::42
config SYS_LOG_BACKEND_NET_MAX_BUF
int "How many network buffers to allocate for sending messages"
range 3 256
default 3
help
Each syslog message will occupy one network buffer.
config SYS_LOG_BACKEND_NET_MAX_BUF_SIZE
int "Max syslog message size"
range 64 1180
default 256
help
As each syslog message needs to fit to UDP packet, set this value
so that messages are not truncated.
The RFC 5426 recommends that for IPv4 the size is 480 octets and for
IPv6 the size is 1180 octets. As each buffer will use RAM, the value
should be selected so that typical messages will fit the buffer.
The total allocated memory will be
SYS_LOG_BACKEND_NET_MAX_BUF * SYS_LOG_BACKEND_NET_MAX_BUF_SIZE
endif
endmenu