.. _example_service_telnet_force_force-ipv4:

##########
Force-Ipv4
##########

These scenarios demonstrate how to use telnet with IP family forcing parameters
(force-ipv4 and force-ipv6) to control which IP protocol version is used for
the connection. The tests validate proper error handling when there is a mismatch
between the forced protocol and the actual IP address format.

*******************************************
Telnet Force IPv4 with IPv4 Address Success
*******************************************

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

This test demonstrates that using ``force-ipv4`` parameter with an IPv4 address
``works correctly`` and establishes a successful telnet connection. After forcing
IPv4 protocol with a matching IPv4 address, the connection proceeds normally
through the standard login flow and authentication.

Scenario
========

.. include:: force-ipv4/telnetforceipv4withipv4addresssuccess

.. raw:: html

  <hr>

***********************************************
Telnet Force IPv6 with IPv4 Address Should Fail
***********************************************

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

This test demonstrates that using ``force-ipv6`` parameter with an IPv4 address
results in a ``Server lookup failure`` error due to address family mismatch.
The telnet command attempts to force IPv6 protocol but the provided address
is IPv4, causing the connection to fail as expected.

Scenario
========

.. include:: force-ipv4/telnetforceipv6withipv4addressshouldfail

.. raw:: html

  <hr>