.. _example_service_dhcp-relay_relay-config:

############
Relay-Config
############

This suite tests additional configuration options for the DHCP relay agent.
These options control relay behavior limits, packet handling, and logging:
- ``max-hop-count``: Limits how many times a packet can be relayed (default 10)
- ``max-size``: Limits the maximum DHCP packet size the relay will forward
- ``log-level``: Controls verbosity of relay logging (err, warning, notice, info, debug)
Each test verifies the relay operates correctly with the configured option
and that clients can obtain DHCP leases.

**************************************
Test Relay Max Hop Count Configuration
**************************************

Description
===========

This test configures ``max-hop-count 5`` on the DHCP relay.
The hop count tracks how many relays a DHCP packet has passed through.
Each relay increments this counter and checks it against the limit.
Packets exceeding the limit are dropped to prevent infinite loops
in misconfigured networks. The default is 10, maximum is 255.

Scenario
========

.. include:: relay-config/testrelaymaxhopcountconfiguration

.. raw:: html

  <hr>

****************************************
Test Relay Max Packet Size Configuration
****************************************

Description
===========

This test configures ``max-size 1400`` on the DHCP relay.
This limits the maximum size of DHCP packets the relay will forward.
It is useful in networks with smaller MTU (like tunnels or VPNs)
where large DHCP packets with many options could be fragmented.
Packets larger than the configured size are dropped.

Scenario
========

.. include:: relay-config/testrelaymaxpacketsizeconfiguration

.. raw:: html

  <hr>

*****************************************
Test Relay Combined Configuration Options
*****************************************

Description
===========

This test configures multiple relay options simultaneously:
``max-hop-count 8`` and ``max-size 1200``.
This verifies that multiple configuration options can be applied
together without conflicts and the relay operates correctly.

Scenario
========

.. include:: relay-config/testrelaycombinedconfigurationoptions

.. raw:: html

  <hr>

**********************************
Test Relay Log Level Configuration
**********************************

Description
===========

This test configures ``log-level debug`` on the DHCP relay.
The log level controls the verbosity of messages sent to syslog.
Available levels are: err, warning, notice, info, debug.
Higher verbosity is useful for troubleshooting relay issues.
The relay should function normally regardless of log level.

Scenario
========

.. include:: relay-config/testrelayloglevelconfiguration

.. raw:: html

  <hr>