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 xen_xs: name xendConfigVersion magic numbers 2012-02-01 16:28:17 -07:00
devhelp maint: consolidate several .gitignore files 2012-02-03 15:27:16 -07:00
html maint: consolidate several .gitignore files 2012-02-03 15:27:16 -07:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
architecture.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
architecture.gif
architecture.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
archnetwork.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
archnode.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
archstorage.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
deployment.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvlxc.html.in docs: Use <code> inside <dt> for symbols 2016-04-22 10:36:14 +02:00
drvopenvz.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvphyp.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvqemu.html.in qemu: really remove last traces of Xenner support 2015-11-10 10:38:15 +00:00
drvremote.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvtest.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
drvuml.html.in docs: typo fix 2014-03-03 17:41:26 +04:00
drvvbox.html.in Move VirtualBox driver into libvirtd 2013-05-16 16:28:53 +01:00
drvvirtuozzo.html.in Rename page about vz driver 2015-08-25 07:36:37 -04:00
drvvmware.html.in VMware: Initial VMware Fusion support 2013-09-29 18:40:36 +08:00
drvxen.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Add documentation for access control system 2013-08-09 17:13:02 +01:00
generic.css docs: Add bold style for <dt><code> elements 2016-04-22 08:14:17 -04:00
goals.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
governance.html.in Fix minor typo in governance doc 2014-02-04 10:43:15 -07:00
hacking1.xsl maint: tweak use of <a> in HACKING 2013-07-09 11:49:20 -06:00
hacking2.xsl maint: tweak use of <a> in HACKING 2013-07-09 11:49:20 -06:00
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 Test for object identity when checking for None in Python 2013-08-23 08:12:26 +02:00
internals.html.in docs: Document our event loop 2016-06-06 17:35:44 +02:00
intro.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
java.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
library.xen
libvirt-daemon-arch.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-daemon-arch.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-driver-arch.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-driver-arch.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-header-bg.png
libvirt-header-logo.png
libvirt-net-logical.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-net-logical.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-net-physical.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-net-physical.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-object-model.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
libvirt-object-model.png build: regenerate .png files 2012-07-23 16:07:13 -06:00
libvirt-virConnect-example.fig internals: Update to include RPC and Lock links and add new data 2013-03-04 17:36:03 -05:00
libvirt-virConnect-example.png internals: Update to include RPC and Lock links and add new data 2013-03-04 17:36:03 -05:00
libvirt.css docs: Remove unused #sponsor CSS rule 2016-04-01 13:28:03 +02:00
libvirtLogo404.png Add a custom 404 error page for the website 2012-06-18 20:10:29 +01:00
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 Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-managed-direct.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-managed-p2p.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-managed-p2p.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-native.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-native.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-tunnel.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-tunnel.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
migration-unmanaged-direct.fig Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
migration-unmanaged-direct.png Add documentation about migration. 2011-10-28 10:07:45 +01:00
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 Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
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 Repair the search on libvirt.org 2013-09-12 17:18:32 +08:00
secureusage.html.in Add some notes about secure usage of libvirt 2013-10-15 11:33:01 +01:00
securityprocess.html.in Fix common misspellings 2015-03-23 09:01:30 +01:00
site.xsl Fix docs generator regression in previous commit 2013-05-03 16:58:46 +01:00
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 Remove trailing whitespace from all xfig files 2011-10-28 10:11:16 +01:00
subsite.xsl virCommand: docs for usage of new command APIs 2010-12-02 16:00:47 -07:00
testapi.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
testsuites.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
testtck.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
todo.cfg-example
todo.pl Fix namespace bugs in API docs, todo page & hv support page 2013-05-07 11:19:04 +01:00
uri.html.in docs: Correct invalid hyperlinks 2014-12-02 07:30:10 +01:00
virshcmdref.html.in Fix multiple formatting problems in HTML docs 2013-05-03 15:56:15 +01:00
windows.html.in Point users to Virt-Viewer MSI installers for Windows builds 2013-05-07 15:29:37 +01:00
wrapstring.xsl Generate HACKING from docs/hacking.html.in 2010-11-12 19:47:20 +01:00