.. index:: pair: group; Setting interface DOWN/UP
.. _doxid-group__stress-if__down__up__loop:

Setting interface DOWN/UP
=========================

.. toctree::
	:hidden:

Check that setting interface DOWN/UP does not break the driver.

Scenarios: X3-SYS06, X3-STR03, X3-STR12.



#. If **tx_traffic** or **rx_traffic** is ``TRUE``, create a pair of connected UDP sockets on IUT and Tester.
   
   * If **IPv6** is checked, also enable **keep_addr_on_down** setting for the IUT interface to avoid IPv6 address disappearance after brinding it down.

#. If **tx_traffic** is ``TRUE``, call **rpc_pattern_sender()** in a child process on IUT and **rpc_drain_fd_duration()** in a child process on Tester to start data flow from IUT to Tester.

#. If **rx_traffic** is ``TRUE``, call **rpc_pattern_sender()** in a child process on Tester and **rpc_drain_fd_duration()** in a child process on IUT to start data flow from Tester to IUT.

#. In a loop set IUT interface DOWN and UP until **duration** seconds passes (but do it at least once). If **wait_after_if_up** is not zero, wait specified number of milliseconds at the end of every loop iteration.

#. If **tx_traffic** is ``TRUE``, check that data sending from IUT and data receiving on Tester terminated successfully.

#. If **rx_traffic** is ``TRUE``, check that data sending from Tester and data receiving on IUT terminated successfully.

Dmitry Izbitsky `Dmitry.Izbitsky@oktetlabs.ru <mailto:Dmitry.Izbitsky@oktetlabs.ru>`__



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- env

		- 
		  Testing environment:
		  
		  * :ref:`env.peer2peer <doxid-group__env-peer2peer>`
		  
		  * :ref:`env.peer2peer_ipv6 <doxid-group__env-peer2peer__ipv6>`

	*
		- duration

		- 
		  How long to run the loop setting interface DOWN/UP, in seconds:
		  
		  * ``0`` (run the loop exactly once)
		  
		  * ``100``

	*
		- wait_after_if_up

		- 
		  How long to wait after bringing interface UP, in milliseconds:
		  
		  * ``0``
		  
		  * ``500``

	*
		- tx_traffic

		- If ``TRUE``, data should be sent continuously from IUT to Tester during the testing.

	*
		- rx_traffic

		- If ``TRUE``, data should be sent continuously from Tester to IUT during the testing.