[mirror_ubuntu-jammy-kernel.git] / Documentation / networking / failover.rst

.. SPDX-License-Identifier: GPL-2.0

========
FAILOVER
========

Overview
========

The failover module provides a generic interface for paravirtual drivers
to register a netdev and a set of ops with a failover instance. The ops
are used as event handlers that get called to handle netdev register/
unregister/link change/name change events on slave pci ethernet devices
with the same mac address as the failover netdev.

This enables paravirtual drivers to use a VF as an accelerated low latency
datapath. It also allows live migration of VMs with direct attached VFs by
failing over to the paravirtual datapath when the VF is unplugged.
Commit	Line	Data
30c8bd5a SS	1	.. SPDX-License-Identifier: GPL-2.0
	2
	3	========
	4	FAILOVER
	5	========
	6
	7	Overview
	8	========
	9
	10	The failover module provides a generic interface for paravirtual drivers
	11	to register a netdev and a set of ops with a failover instance. The ops
	12	are used as event handlers that get called to handle netdev register/
	13	unregister/link change/name change events on slave pci ethernet devices
	14	with the same mac address as the failover netdev.
	15
	16	This enables paravirtual drivers to use a VF as an accelerated low latency
	17	datapath. It also allows live migration of VMs with direct attached VFs by
	18	failing over to the paravirtual datapath when the VF is unplugged.