libvirt/docs
Laine Stump 9658e70f7d conf/openvz: eliminate incorrect/undocumented use of <source dev='blah'/>
When support for <interface type='ethernet'> was added in commit
9a4b705f back in 2010, it erroneously looked at <source dev='blah'/>
for a user-specified guest-side interface name. This was never
documented though. (that attribute already existed at the time in the
data.ethernet union member of virDomainNetDef, but apparently had no
practical use - it was only used as a storage place for a NetDef's
bridge name during qemuDomainXMLToNative(), but even then that was
never used for anything).

When support for similar guest-side device naming was added to the lxc
driver several years later, it was put in a new subelement <guest
dev='blah'/>.

In the intervening years, since there was no validation that
ethernet.dev was NULL in the other drivers that didn't actually use
it, innocent souls who were adding other features assuming they needed
to account for non-NULL ethernet.dev when really they didn't, so
little bits of the usual pointless cargo-cult code showed up.

This patch not only switches the openvz driver to use the documented
<guest dev='blah'/> notation for naming the guest-side device (just in
case anyone is still using the openvz driver), and logs an error if
anyone tries to set <source dev='blah'/> for a type='ethernet'
interface, it also removes the cargo-cult uses of ethernet.dev and
<source dev='blah'/>, and eliminates if from the RNG and from
virDomainNetDef.

NB: I decided on this course of action after mentioning the
inconsistency here:

  https://www.redhat.com/archives/libvir-list/2016-May/msg02038.html

and getting encouragement do eliminate it in a later IRC discussion
with danpb.
2016-06-26 19:33:08 -04:00
..
api_extension
devhelp
html
internals docs: Document our event loop 2016-06-06 17:35:44 +02:00
schemas conf/openvz: eliminate incorrect/undocumented use of <source dev='blah'/> 2016-06-26 19:33:08 -04:00
32favicon.png
404.html.in
acl.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
aclpolkit.html.in examples: Add example polkit ACL rules 2015-09-04 17:26:04 +02:00
api_extension.html.in maint: improve VIR_ERR_INVALID_CONN usage 2014-01-06 21:41:02 -07:00
api.html.in docs: Rename 'parallels' to 'vz' 2015-08-25 07:21:33 -04:00
apibuild.py apibuild: Substitute only pure number tokens 2016-05-30 15:38:07 +02:00
apps.html.in docs: Don't use <strong> in headers 2016-03-31 16:26:18 +02:00
archdomain.html.in
architecture.fig
architecture.gif
architecture.html.in
archnetwork.html.in
archnode.html.in
archstorage.html.in
auditlog.html.in docs: Use <code> inside <dt> for symbols 2016-04-22 10:36:14 +02:00
auth.html.in add help document relevant to default mapping of credentials to machines 2016-06-24 16:36:54 +01:00
bindings.html.in docs: Fix docs about python bindings package 2015-01-19 14:50:52 +01:00
bugs.html.in Fix common misspellings 2015-03-23 09:01:30 +01:00
cgroups.html.in docs: cgroups: fix typo about LXC cgroups 2014-03-27 06:52:20 -06:00
compiling.html.in maint: Switch to xz compressed PAX release archives 2016-06-15 18:53:34 +02:00
contact.html.in Fix common misspellings 2015-03-23 09:01:30 +01:00
csharp.html.in
deployment.html.in
devguide.html.in docs: Update devguide.html to point to the new Python dev guide 2015-09-10 12:15:45 +01:00
docs.html.in
downloads.html.in maint: Switch to xz compressed PAX release archives 2016-06-15 18:53:34 +02:00
drivers.html.in docs: Rename 'parallels' to 'vz' 2015-08-25 07:21:33 -04:00
drvbhyve.html.in docs: bhyve: document clock configuration 2015-07-22 19:30:56 +03:00
drvesx.html.in typos: fix s/it/is/ where applicable 2014-05-05 11:49:36 +02:00
drvhyperv.html.in
drvlxc.html.in docs: Use <code> inside <dt> for symbols 2016-04-22 10:36:14 +02:00
drvopenvz.html.in
drvphyp.html.in
drvqemu.html.in qemu: really remove last traces of Xenner support 2015-11-10 10:38:15 +00:00
drvremote.html.in
drvtest.html.in
drvuml.html.in docs: typo fix 2014-03-03 17:41:26 +04:00
drvvbox.html.in
drvvirtuozzo.html.in Rename page about vz driver 2015-08-25 07:36:37 -04:00
drvvmware.html.in
drvxen.html.in
errors.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
firewall.html.in Fix typos in various docs 2013-12-02 10:21:26 +08:00
format.html.in
formatcaps.html.in docs: Use <code> inside <dt> for symbols 2016-04-22 10:36:14 +02:00
formatdomain.html.in conf: limit chassisNr, and busNr to a minimum value of 1, not 0 2016-06-21 11:54:46 -04:00
formatdomaincaps.html.in domaincaps: Report video modelType 2016-05-09 16:05:31 -04:00
formatnetwork.html.in docs: fix version number in vlan tagging documentation 2016-05-10 15:23:55 -04:00
formatnode.html.in nodedev: Expose PCI header type 2016-03-18 17:35:06 +01:00
formatnwfilter.html.in docs: remove *other* reference to igmp for IPv6 2016-04-22 12:45:59 -04:00
formatsecret.html.in docs: Fix whitespace in output 2016-06-24 10:22:59 -04:00
formatsnapshot.html.in syntax-check: Enforce <code> inside <dt> elements 2016-04-25 12:09:34 +02:00
formatstorage.html.in storage: Fix algorithm generating path names for devmapper 2016-05-11 09:23:31 -04:00
formatstorageencryption.html.in docs: fix encryption format attribute in example 2014-09-10 09:25:40 +02:00
genaclperms.pl
generic.css docs: Add bold style for <dt><code> elements 2016-04-22 08:14:17 -04:00
goals.html.in
governance.html.in Fix minor typo in governance doc 2014-02-04 10:43:15 -07:00
hacking1.xsl
hacking2.xsl
hacking.html.in virtestmock: Print invalid file accesses into a file 2016-05-14 09:46:23 +02:00
hooks.html.in qemu: hook: Provide hook when restoring a domain save image 2014-09-22 17:11:56 +02:00
hvsupport.pl docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
index.html.in Fix link to page for Virtuozzo driver 2015-08-26 09:05:59 -04:00
index.py
internals.html.in docs: Document our event loop 2016-06-06 17:35:44 +02:00
intro.html.in
java.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
library.xen
libvirt-daemon-arch.fig
libvirt-daemon-arch.png
libvirt-driver-arch.fig
libvirt-driver-arch.png
libvirt-header-bg.png
libvirt-header-logo.png
libvirt-net-logical.fig
libvirt-net-logical.png
libvirt-net-physical.fig
libvirt-net-physical.png
libvirt-object-model.fig
libvirt-object-model.png
libvirt-virConnect-example.fig
libvirt-virConnect-example.png
libvirt.css docs: Remove unused #sponsor CSS rule 2016-04-01 13:28:03 +02:00
libvirtLogo404.png
libvirtLogo.png
locking-lockd.html.in docs: add page about virtlockd setup 2015-02-17 13:59:54 +00:00
locking-sanlock.html.in docs: split out sanlock setup docs 2015-02-17 13:59:19 +00:00
locking.html.in docs: Use <code> inside <dt> for symbols 2016-04-22 10:36:14 +02:00
logging.html.in docs: update to properly reflect meaning of fields in log filter 2016-01-04 15:19:38 -05:00
madeWith.png
main.css
Makefile.am admin: enable both admin API functionality and tarball distribution 2016-06-26 00:21:06 +02:00
migration-managed-direct.fig
migration-managed-direct.png
migration-managed-p2p.fig
migration-managed-p2p.png
migration-native.fig
migration-native.png
migration-tunnel.fig
migration-tunnel.png
migration-unmanaged-direct.fig
migration-unmanaged-direct.png
migration.html.in Spell VMware with a lowercase w 2016-02-15 15:35:48 +01:00
newapi.xsl docs: generate links from plain text documentation 2013-10-30 17:30:12 +01:00
news-2005.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2006.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2007.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2008.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2009.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2010.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2011.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2012.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2013.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2014.html.in NEWS: Split releases by year 2015-10-20 17:29:03 +02:00
news-2015.html.in NEWS: Don't prefix version numbers with 'v' 2016-01-18 10:53:22 +01:00
news.html.in Release of libvirt-1.3.5 2016-06-04 23:29:59 +08:00
news.xsl NEWS: Fix XSLT stylesheet 2015-10-20 17:30:34 +02:00
node.fig
node.gif
nss.html.in docs: Document NSS module 2016-03-29 13:45:33 +02:00
page.xsl docs: website: Remove the et.redhat.com footer 2016-03-10 11:06:25 -05:00
pending.html.in
php.html.in docs: php: remove reference to Red Hat 2015-06-04 10:00:59 +02:00
python.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
relatedlinks.html.in
remote.html.in remote: allow TLS protocol/cipher priority override in URI 2016-06-08 13:48:45 +01:00
search.php.code.in better patch for the XSS search issue 2015-07-03 21:04:24 +08:00
search.php.in
secureusage.html.in
securityprocess.html.in Fix common misspellings 2015-03-23 09:01:30 +01:00
site.xsl
sitemap.html.in docs: Document our event loop 2016-06-06 17:35:44 +02:00
storage.html.in docs: mention ZFS on Linux support 2016-02-27 05:39:50 +03:00
structures.fig
subsite.xsl
testapi.html.in
testsuites.html.in
testtck.html.in
todo.cfg-example
todo.pl
uri.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
virshcmdref.html.in
windows.html.in
wrapstring.xsl