Laine Stump db64acfbda conf: parse/format <teaming> element in plain <hostdev> ... The <teaming> element in <interface> allows pairing two interfaces together as a simple "failover bond" network device in a guest. One of the devices is the "transient" interface - it will be preferred for all network traffic when it is present, but may be removed when necessary, in particular during migration, when traffic will instead go through the other interface of the pair - the "persistent" interface. As it happens, in the QEMU implementation of this teaming pair (called "virtio failover" in QEMU) the transient interface is always a host network device assigned to the guest using VFIO (aka "hostdev"); the persistent interface is always an emulated virtio NIC. When support was initially added for <teaming>, it was written to require that the transient/hostdev device be defined using <interface type='hostdev'>; this was done because the virtio failover implementation in QEMU and the virtio guest driver demands that the two interfaces in the pair have matching MAC addresses, and the only way libvirt can guarantee the MAC address of a hostdev network device is to use <interface type='hostdev'>, whose main purpose is to configure the device's MAC address before handing the device to QEMU. (note that <interface type='hostdev'> in turn requires that the network device be an SRIOV VF (Virtual Function), as that is the only type of network device whose MAC address we can set in a way that will survive the device's driver init in the guest). It has recently come up that some users are unable to use <teaming> because they are running in a container environment where libvirt doesn't have the necessary privileges or resources to set the VF's MAC address (because setting the VF MAC is done via the same device's PF (Physical Function), and the PF is not exposed to libvirt's container). At the same time, these users *are* able to set the VF's MAC address themselves in advance of staring up libvirt in the container. So they could theoretically use the <teaming> feature if libvirt just skipped the "setting the MAC address" part. Fortunately, that is *exactly* the difference between <interface type='hostdev'> (which must be a "hostdev VF") and <hostdev> (a "plain hostdev" - it could be *any* PCI device; libvirt doesn't know what type of PCI device it is, and doesn't care). But what is still needed is for libvirt to provide a small bit of information on the QEMU commandline argument for the hostdev, telling QEMU that this device will be part of a team ("failover pair"), and the id of the other device in the pair. To make both of those goals simultaneously possible, this patch adds support for the <teaming> element to plain <hostdev> - libvirt doesn't try to set any MAC addresses, and QEMU gets the extra commandline argument it needs) (actually, this patch adds only the parsing/formatting of the <teaming> element in <hostdev>. The next patch will actually wire that into the qemu driver.) Signed-off-by: Laine Stump <laine@redhat.com> Reviewed-by: Michal Privoznik <mprivozn@redhat.com>		2021-02-11 17:15:34 -05:00
..
fonts	meson: add rule to build and install only web documentation	2020-08-03 09:27:06 +02:00
gitdm	gitdm: add more individual contributors	2020-09-25 16:00:06 +02:00
html	meson: add rule to build and install only web documentation	2020-08-03 09:27:06 +02:00
internals	docs/internals/meson.build: Use template code for XSLT processing	2020-10-19 12:40:51 +02:00
js	meson: add rule to build and install only web documentation	2020-08-03 09:27:06 +02:00
kbase	docs: link to PCI docs from the kbase page	2021-01-28 12:13:44 +00:00
logos	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
manpages	docs: add manpage for virtxend	2021-01-15 19:08:00 +00:00
schemas	conf: parse/format <teaming> element in plain <hostdev>	2021-02-11 17:15:34 -05:00
404.html.in	Use https:// links for most sites	2017-10-16 10:22:34 +01:00
acl.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
aclpolkit.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
advanced-tests.rst	tests: Don't advertise VIR_TEST_EXPENSIVE to users	2020-09-23 11:30:05 +02:00
android-chrome-192x192.png	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
android-chrome-256x256.png	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
api_extension.html.in	docs: Document camelCase preference for XML elements and attributes	2020-10-19 10:18:27 +02:00
api.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
apple-touch-icon.png	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
apps.html.in	docs: Mention KubeVirt in apps using Libvirt	2021-01-11 16:06:17 +01:00
architecture.gif
architecture.html.in	docs: remove mention of legacy Xen driver	2018-04-09 11:38:47 -06:00
architecture.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
auditlog.html.in	docs: fixing typos 'libivrt' > 'libvirt'	2020-01-17 16:44:31 +01:00
auth.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
best-practices.rst	Prefer https: for Red Hat websites	2020-09-01 21:58:46 +02:00
bindings.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
browserconfig.xml	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
bugs.html.in	Prefer https: for Red Hat websites	2020-09-01 21:58:46 +02:00
cgroups.html.in	vircgroup: introduce nested cgroup to properly work with systemd	2021-02-10 13:37:12 +01:00
ci.rst	docs: Update CI documentation	2020-07-03 11:00:51 +02:00
coding-style.rst	docs: Fix dead link	2021-01-05 11:25:14 +01:00
committer-guidelines.rst	meson: adjust our documentation to mention meson instead of autoconf	2020-08-03 09:27:09 +02:00
compiling.html.in	docs: compiling: mention build dir	2021-01-29 16:00:56 +01:00
contact.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
contribute.html.in	Fix errors in contribute.html.in	2020-09-10 09:13:52 +02:00
csharp.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
daemons.rst	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
dbus.html.in	docs: point to GitLab as the primary git hosting	2020-06-03 13:38:33 +02:00
developer-tooling.rst	docs: Add developer-tooling.rst	2020-04-08 09:32:35 +02:00
devguide.html.in	docs: update all GIT repo examples to use https:// protocol	2018-03-21 14:48:01 +00:00
docs.html.in	docs: xsl: Unify stylability of main container element	2020-11-16 14:04:04 +01:00
downloads.html.in	docs: downloads: Establish handover of package signing	2021-01-11 12:04:45 +01:00
drivers.html.in	secrets: add support for running secret driver in embedded mode	2020-01-27 11:04:29 +00:00
drvbhyve.html.in	docs: bhyve: document virtio-9p support	2020-10-12 15:26:00 +04:00
drvesx.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
drvhyperv.html.in	docs: drop support for Windows versions prior to 2012R2	2020-11-09 15:26:02 +00:00
drvlxc.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
drvnodedev.html.in	node_device: detecting mdev_types capability on CSS devices	2020-11-11 16:56:33 +01:00
drvopenvz.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
drvqemu.html.in	docs: remove use of the term 'whitelist' from cgroup docs	2020-06-26 15:38:34 +01:00
drvremote.html.in	docs: switch to using HTML5 doctype declaration	2017-08-02 17:00:11 +01:00
drvsecret.html.in	docs: fix since version in driver documentation	2020-01-27 17:36:05 +01:00
drvtest.html.in	docs: switch to using HTML5 doctype declaration	2017-08-02 17:00:11 +01:00
drvvbox.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
drvvirtuozzo.html.in	docs: switch to using HTML5 doctype declaration	2017-08-02 17:00:11 +01:00
drvvmware.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
drvxen.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
errors.html.in	docs: Grammar and spelling fixes	2018-05-03 12:40:37 +01:00
favicon-16x16.png	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
favicon-32x32.png	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
favicon.ico	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
firewall.html.in	doc: document new filters and not documented ones	2020-11-04 17:21:45 +01:00
format.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
formatbackup.rst	conf: backup: Format index of 'store'	2020-12-08 15:12:34 +01:00
formatcaps.html.in	conf: add support for specifying CPU "dies" parameter	2020-01-16 15:11:42 +00:00
formatcheckpoint.rst	conf: checkpoint: Don't require <domain> when redefining checkpoints	2020-12-04 16:15:03 +01:00
formatdomain.rst	conf: parse/format <teaming> element in plain <hostdev>	2021-02-11 17:15:34 -05:00
formatdomaincaps.html.in	conf: add reporting of "maximum" CPU mode in domain caps	2021-02-10 11:44:48 +00:00
formatnetwork.html.in	Fix format network dns doc	2021-01-26 14:29:48 +01:00
formatnetworkport.html.in	docs: document port isolated property in domain/network/networkport	2020-02-26 11:48:23 -05:00
formatnode.html.in	docs: Clarify the documentation of the <css> elements	2021-02-01 16:02:39 +01:00
formatnwfilter.html.in	doc: document new filters and not documented ones	2020-11-04 17:21:45 +01:00
formatsecret.html.in	docs: secret: Unify and sanitize examples on how to set secret value	2020-01-28 18:10:36 +01:00
formatsnapshot.html.in	conf: snapshot: Add support for <metadata_cache>	2021-01-08 15:27:00 +01:00
formatstorage.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
formatstoragecaps.html.in	docs: Fix link for virConnectGetStoragePoolCapabilities	2020-12-02 16:15:43 +01:00
formatstorageencryption.html.in	docs: support qcow2 format in luks encryption volume	2021-01-05 13:54:11 +01:00
generic.css	docs: css: Make definition list 'code' entries bold when converted from rst	2020-08-03 18:41:11 +02:00
glib-adoption.rst	docs: glib-adoption: add string arrays and objects	2020-10-02 14:10:44 +02:00
goals.html.in	docs: switch to using HTML5 doctype declaration	2017-08-02 17:00:11 +01:00
governance.html.in	docs/governance: Clarify the version number of the LGPL	2019-01-25 14:04:20 +01:00
hacking.rst	Revert "docs: Drop glib-adoption.rst"	2020-10-02 14:10:40 +02:00
hooks.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
index.html.in	docs: use a relative link to the kbase page	2021-02-03 16:33:18 +00:00
internals.html.in	docs: switch to using HTML5 doctype declaration	2017-08-02 17:00:11 +01:00
java.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
libvirt-daemon-arch.png
libvirt-daemon-arch.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
libvirt-driver-arch.png
libvirt-driver-arch.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
libvirt-go-xml.rst	docs: Point to pkg.go.dev instead of godoc.org	2020-07-07 14:07:33 +02:00
libvirt-go.rst	docs: Point to pkg.go.dev instead of godoc.org	2020-07-07 14:07:33 +02:00
libvirt-object-model.png
libvirt-object-model.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
libvirt-virConnect-example.png
libvirt-virConnect-example.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
libvirt.css	docs: css: Modify appearance of the kbase directory page	2020-11-16 14:04:04 +01:00
logging.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
main.css	docs: make website responsive for mobile devices	2017-08-07 14:44:40 +01:00
manifest.json	docs: Fix syntax-check error	2017-08-02 15:00:28 -04:00
meson.build	docs: kbase: Move index page to docs/kbase	2020-11-16 14:04:03 +01:00
migration-managed-direct.png
migration-managed-direct.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
migration-managed-p2p.png
migration-managed-p2p.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
migration-native.png
migration-native.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
migration-tunnel.png
migration-tunnel.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
migration-unmanaged-direct.png
migration-unmanaged-direct.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
migration.html.in	docs: migration: remove xenmigr	2021-01-05 13:40:25 +01:00
mobile.css	docs: add advanced search capabilities	2019-04-11 15:20:17 +01:00
mstile-150x150.png	docs: add full set of "favicon" files to support modern clients	2017-08-02 17:00:11 +01:00
newapi.xsl	docs: fix libvirt go-import metadata in pages and links in 404 page	2020-08-04 17:06:33 +01:00
newreposetup.rst	docs: Document CIRRUS_GITHUB_REPO variable	2020-06-11 12:03:41 +02:00
node.gif
node.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
nss.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
page.xsl	docs: xsl: Unify stylability of main container element	2020-11-16 14:04:04 +01:00
pci-addresses.rst	docs: Document reserved PCI addresses for QEMU	2020-04-24 09:55:29 +02:00
pci-hotplug.html.in	Prefer https: for libguestfs.org links	2020-09-01 21:58:46 +02:00
php.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
platforms.rst	docs: platforms: Mention Windows API target	2020-07-14 18:04:13 +02:00
programming-languages.rst	Fix capitalization "CLang" -> "Clang"	2020-11-12 15:01:42 +01:00
python.html.in	doc/python: Update to Python 3	2020-04-20 14:06:25 +01:00
remote.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
securityprocess.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
site.xsl	docs: fix libvirt go-import metadata in pages and links in 404 page	2020-08-04 17:06:33 +01:00
storage.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
strategy.html.in	docs: fix misc spelling errors reported by codespell	2020-10-05 10:28:37 +01:00
structures.svg	docs: convert FIG files into SVG format	2020-07-10 16:07:02 +02:00
styleguide.rst	docs: Document list-tables as recommended	2020-05-11 13:55:27 +02:00
submitting-patches.rst	docs/submitting-patches: add reference to DCO	2020-10-09 09:12:39 +02:00
subsite.xsl	docs: fix libvirt go-import metadata in pages and links in 404 page	2020-08-04 17:06:33 +01:00
support.html.in	docs: Grammar and spelling fixes	2018-05-03 12:40:37 +01:00
testapi.html.in	docs: point to GitLab as the primary git hosting	2020-06-03 13:38:33 +02:00
testsuites.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
testtck.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
tlscerts.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
uri.html.in	docs: Add 'known_hosts_verify' parameter for libssh(2) connection uris	2021-02-05 16:02:22 +01:00
virshcmdref.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
windows.html.in	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00