zephyr/samples/net/syslog_net
Jukka Rissanen 1e61d3eb9b samples: net: syslog: Add Docker based testing support
Allow the sample to be run against a rsyslog listener running
inside Docker.

Signed-off-by: Jukka Rissanen <jukka.rissanen@linux.intel.com>
2020-12-09 15:56:44 +02:00
..
boards samples: net: syslog: Add Docker based testing support 2020-12-09 15:56:44 +02:00
src samples: net: syslog: Add Docker based testing support 2020-12-09 15:56:44 +02:00
CMakeLists.txt
Kconfig samples: net: syslog: Add Docker based testing support 2020-12-09 15:56:44 +02:00
README.rst
docker-test.sh samples: net: syslog: Add Docker based testing support 2020-12-09 15:56:44 +02:00
prj.conf net: syslog: Make sure CONFIG_LOG_IMMEDIATE is not set 2020-12-04 15:46:42 +02:00
sample.yaml samples: net: syslog: Add configs for ipv4- and ipv6-only 2020-08-14 18:51:28 -04:00

README.rst

.. _syslog-net-sample:

Syslog net Application
######################

Overview
********

This sample application enables a remote syslog service that will
send syslog messages to a remote server, as configured in ``prj.conf``.
See https://tools.ietf.org/html/rfc5424 and https://tools.ietf.org/html/rfc5426
for more details about syslog protocol over UDP.

The source code for this sample application can be found at:
:zephyr_file:`samples/net/syslog_net`.

Requirements
************

- :ref:`networking_with_host`

Building and Running
********************

For configuring the remote IPv6 syslog server, set the following
variables in prj.conf file:

.. code-block:: console

	CONFIG_LOG_BACKEND_NET=y
	CONFIG_LOG_BACKEND_NET_SERVER="[2001:db8::2]:514"

Default port number is 514 if user does not specify a value.
The following syntax is supported for the server address
and port:

.. code-block:: console

	192.0.2.1:514
	192.0.2.42
	[2001:db8::1]:514
	[2001:db8::2]
	2001:db::42

Build syslog_net sample application like this:

.. zephyr-app-commands::
   :zephyr-app: samples/net/syslog_net
   :board: <board to use>
   :conf: <config file to use>
   :goals: build
   :compact: