zephyr/samples/net/lldp
Keith Packard 0b90fd5adf samples, tests, boards: Switch main return type from void to int
As both C and C++ standards require applications running under an OS to
return 'int', adapt that for Zephyr to align with those standard. This also
eliminates errors when building with clang when not using -ffreestanding,
and reduces the need for compiler flags to silence warnings for both clang
and gcc.

Most of these changes were automated using coccinelle with the following
script:

@@
@@
- void
+ int
main(...) {
	...
-	return;
+	return 0;
	...
}

Approximately 40 files had to be edited by hand as coccinelle was unable to
fix them.

Signed-off-by: Keith Packard <keithp@keithp.com>
2023-04-14 07:49:41 +09:00
..
src samples, tests, boards: Switch main return type from void to int 2023-04-14 07:49:41 +09:00
CMakeLists.txt cmake: increase minimal required version to 3.20.0 2021-08-20 09:47:34 +02:00
Kconfig kconfig: Clean up header comments and make them consistent 2019-11-04 17:31:27 -05:00
prj.conf samples: net: Remove net-app based sample applications 2019-02-01 12:29:21 +02:00
README.rst doc: use :zephyr_file: where appropriate 2019-03-09 09:50:27 -05:00
sample.yaml tests/samples: use integration_plaforms in more tests/samples 2022-11-29 16:03:23 +01:00

.. _lldp-sample:

LLDP Sample Application
#######################

Overview
********

The Link Layer Discovery Protocol sample application for Zephyr will enable
LLDP support and setup VLANs if needed.

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

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

- :ref:`networking_with_host`

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

A good way to run this sample LLDP application is inside QEMU,
as described in :ref:`networking_with_qemu` or with embedded device like
FRDM-K64F. Note that LLDP is only supported for boards that have an ethernet
port.

Follow these steps to build the LLDP sample application:

.. zephyr-app-commands::
   :zephyr-app: samples/net/lldp
   :board: <board to use>
   :conf: prj.conf
   :goals: build
   :compact:

Setting up Linux Host
=====================

If you need VLAN support in your network, then the
:zephyr_file:`samples/net/vlan/vlan-setup-linux.sh` provides a script that can be
executed on the Linux host. It creates two VLANs on the Linux host and creates
routes to Zephyr.