/docs/libvirt-lxc-*.xml
/docs/libvirt-qemu-*.xml
/docs/libvirt-refs.xml
+/docs/news.html.in
/docs/search.php
/docs/todo.html.in
/examples/admin/client_close
pkgconfigdir = $(libdir)/pkgconfig
pkgconfig_DATA = libvirt.pc libvirt-qemu.pc libvirt-lxc.pc libvirt-admin.pc
-NEWS: $(top_srcdir)/docs/news.xsl $(top_srcdir)/docs/news.html.in
+NEWS: \
+ $(srcdir)/docs/news.xml \
+ $(srcdir)/docs/news-ascii.xsl
$(AM_V_GEN)if [ -x $(XSLTPROC) ] ; then \
- $(XSLTPROC) --nonet $(top_srcdir)/docs/news.xsl \
- $(top_srcdir)/docs/news.html.in \
+ $(XSLTPROC) --nonet $(srcdir)/docs/news-ascii.xsl \
+ $(srcdir)/docs/news.xml \
| perl -0777 -pe 's/\n\n+$$/\n/' \
| perl -pe 's/[ \t]+$$//' \
> $@-t && mv $@-t $@ ; fi
+EXTRA_DIST += \
+ $(srcdir)/docs/news.xml \
+ $(srcdir)/docs/news-ascii.xsl
$(top_srcdir)/HACKING: $(top_srcdir)/docs/hacking1.xsl \
$(top_srcdir)/docs/hacking2.xsl \
# Since we ship pre-built html in the tarball, we must also
# ship the sources, even when those sources are themselves
# generated.
-# Generate hvsupport.html first, since it takes one extra step.
+# Generate hvsupport.html and news.html first, since they take one extra step.
dot_html_in = \
hvsupport.html.in \
+ news.html.in \
$(notdir $(wildcard $(srcdir)/*.html.in))
dot_html = $(dot_html_in:%.html.in=%.html)
EXTRA_DIST= \
apibuild.py genaclperms.pl \
- site.xsl subsite.xsl newapi.xsl news.xsl page.xsl \
+ site.xsl subsite.xsl newapi.xsl page.xsl \
hacking1.xsl hacking2.xsl wrapstring.xsl \
$(dot_html) $(dot_html_in) $(gif) $(apihtml) $(apipng) \
$(devhelphtml) $(devhelppng) $(devhelpcss) $(devhelpxsl) \
$(AM_V_GEN)$(PERL) $(srcdir)/hvsupport.pl $(top_srcdir)/src > $@ \
|| { rm $@ && exit 1; }
+# xsltproc seems to add the xmlns="" attribute to random output elements:
+# use sed to strip it out, as leaving it there triggers XML errors during
+# further transformation steps
+news.html.in: \
+ $(srcdir)/news.xml \
+ $(srcdir)/news-html.xsl
+ $(AM_V_GEN) \
+ if [ -x $(XSLTPROC) ]; then \
+ $(XSLTPROC) --nonet \
+ $(srcdir)/news-html.xsl \
+ $(srcdir)/news.xml \
+ >$@-tmp \
+ || { rm -f $@-tmp; exit 1; }; \
+ sed 's/ xmlns=""//g' $@-tmp >$@ \
+ || { rm -f $@-tmp; exit 1; }; \
+ rm -f $@-tmp; \
+ fi
+EXTRA_DIST += \
+ $(srcdir)/news.xml \
+ $(srcdir)/news-html.xsl
+MAINTAINERCLEANFILES += \
+ $(srcdir)/news.html.in
+
%.png: %.fig
convert -rotate 90 $< $@
--- /dev/null
+<?xml version="1.0"?>
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+ <xsl:output method="text" encoding="UTF-8"/>
+
+ <!-- This XSLT stylesheet can be applied to the XML version of the release
+ notes to produce a plain text document. The output document is not
+ formatted properly and needs to be processed further -->
+
+ <!-- Document -->
+ <xsl:template match="/libvirt">
+ <xsl:text>libvirt releases
+================
+</xsl:text>
+ <xsl:apply-templates select="release"/>
+ <xsl:text>
+==============================================================================
+Older libvirt releases didn't have proper release notes: if you are interested
+in changes between them, you should check out ChangeLog* and docs/news-*.html.
+</xsl:text>
+ </xsl:template>
+
+ <!-- Release -->
+ <xsl:template match="release">
+ <xsl:text>
+# </xsl:text>
+ <xsl:value-of select="@version"/>
+ <xsl:text> (</xsl:text>
+ <xsl:value-of select="@date"/>
+ <xsl:text>)
+</xsl:text>
+ <xsl:apply-templates select="section"/>
+ </xsl:template>
+
+ <!-- Section -->
+ <xsl:template match="section">
+ <xsl:text>
+* </xsl:text>
+ <xsl:value-of select="@title"/>
+ <xsl:text>
+</xsl:text>
+ <xsl:apply-templates select="change"/>
+ </xsl:template>
+
+ <!-- Change -->
+ <xsl:template match="change">
+ <xsl:text>
+</xsl:text>
+ <xsl:apply-templates select="summary"/>
+ <xsl:apply-templates select="description"/>
+ </xsl:template>
+
+ <!-- Change summary -->
+ <xsl:template match="summary">
+ <xsl:text>- </xsl:text>
+ <xsl:value-of select="normalize-space()"/>
+ <xsl:text>
+</xsl:text>
+ </xsl:template>
+
+ <!-- Change description -->
+ <xsl:template match="description">
+ <xsl:text>|</xsl:text> <!-- This will be removed when reformatting -->
+ <xsl:value-of select="normalize-space()"/>
+ <xsl:text>
+</xsl:text>
+ </xsl:template>
+
+</xsl:stylesheet>
--- /dev/null
+<?xml version="1.0"?>
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+ <xsl:output method="xml" indent="yes" encoding="UTF-8"/>
+
+ <!-- This XSLT stylesheet can be applied to the XML version of the release
+ notes to produce an HTML document suitable for further processing.
+ In particular, the final output will end up on the libvirt website -->
+
+ <!-- Document -->
+ <xsl:template match="/libvirt">
+ <xsl:text disable-output-escaping="yes"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+</xsl:text>
+ <html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ </head>
+ <body>
+ <xsl:text disable-output-escaping="yes">
+
+ <!-- DO NOT EDIT THIS FILE! It was generated automatically.
+ Edit the source file (news.xml) instead -->
+
+ </xsl:text>
+ <h1>Releases</h1>
+ <p>This is the list of official releases for libvirt, along with an
+ overview of the changes introduced by each of them.</p>
+ <p>For a more fine-grained view, use the
+ <a href="http://libvirt.org/git/?p=libvirt.git;a=log">git log</a>.
+ </p>
+ <xsl:apply-templates select="release"/>
+ <p>Older libvirt releases didn't have proper release notes,
+ and as such are not included in this page: if you're looking
+ for information about them, start from those made in
+ <a href="news-2016.html">2016</a> and work your way back.</p>
+ </body>
+ </html>
+ </xsl:template>
+
+ <!-- Release -->
+ <xsl:template match="release">
+ <h3>
+ <strong>
+ <xsl:value-of select="@version"/>
+ <xsl:text> (</xsl:text>
+ <xsl:value-of select="@date"/>
+ <xsl:text>)</xsl:text>
+ </strong>
+ </h3>
+ <ul>
+ <xsl:apply-templates select="section"/>
+ </ul>
+ </xsl:template>
+
+ <!-- Section -->
+ <xsl:template match="section">
+ <li>
+ <strong>
+ <xsl:value-of select="@title"/>
+ </strong>
+ <ul>
+ <xsl:apply-templates select="change"/>
+ </ul>
+ </li>
+ </xsl:template>
+
+ <!-- Change -->
+ <xsl:template match="change">
+ <li>
+ <xsl:apply-templates select="summary"/>
+ <xsl:apply-templates select="description"/>
+ </li>
+ </xsl:template>
+
+ <!-- Change summary -->
+ <xsl:template match="summary">
+ <xsl:apply-templates/>
+ </xsl:template>
+
+ <!-- Change description -->
+ <xsl:template match="description">
+ <br/>
+ <xsl:apply-templates/>
+ </xsl:template>
+
+ <!-- Misc HTML tags, add more as they are needed -->
+ <xsl:template match="code|i|tt">
+ <xsl:text disable-output-escaping="yes"><</xsl:text>
+ <xsl:value-of select="name()"/>
+ <xsl:text disable-output-escaping="yes">></xsl:text>
+ <xsl:apply-templates/>
+ <xsl:text disable-output-escaping="yes"></</xsl:text>
+ <xsl:value-of select="name()"/>
+ <xsl:text disable-output-escaping="yes">></xsl:text>
+ </xsl:template>
+
+</xsl:stylesheet>
+++ /dev/null
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- </head>
- <body>
- <h1>Releases</h1>
- <p>This is the list of official releases for libvirt, along with an
- overview of the changes introduced by each of them.</p>
- <p>For a more fine-grained view, use the
- <a href="http://libvirt.org/git/?p=libvirt.git;a=log">git log</a>.
- </p>
-
- <h3>v3.0.0 (<i>unreleased</i>)</h3>
- <ul>
- <li><strong>New features</strong>
- <ul>
- <li>New localPtr attribute for "ip" element in network XML
- </li>
- <li>qemu: Support QEMU group I/O throttling<br/>
- Add the capability to allow group I/O throttling via a new
- domain <disk> <iotune> subelement "group_name"
- to allow sharing I/O throttling quota between multiple drives
- </li>
- <li>nss: Introduce <code>libvirt-guest</code><br/>
- New <code>libvirt-guest</code> nss module that translates libvirt
- guest names into IP addresses
- </li>
- <li>daemon: Add support for runtime logging settings adjustment<br/>
- Logging-related settings like log outputs and filters can now be
- adjusted during runtime using the admin interface without the
- necessity of the daemon's restart
- </li>
- <li>storage: Add virStorageVolInfoFlags API<br/>
- Add the API to support using the VIR_STORAGE_VOL_GET_PHYSICAL
- flag in order to return the host physical size in bytes
- of the image container in the allocation field of the
- _virStorageVolInfo structure. The --physical flag has been
- added to the virsh vol-info command to access the data
- </li>
- <li>libxl: Implement virDomainGetMaxVcpus API
- </li>
- </ul>
- </li>
- <li><strong>Improvements</strong>
- <ul>
- <li>perf: Add more perf statistics<br/>
- Add support to get the count of branch instructions
- executed, branch misses, bus cycles, stalled frontend
- cpu cycles, stalled backend cpu cycles, ref cpu
- cycles and cache l1d by applications running on
- the platform
- </li>
- <li>conf: Display <physical> for volume xml<br/>
- Add a display of the <physical> size of a disk
- volume in the output of the volume XML
- </li>
- <li>qemu: Use virtio-pci by default for aarch64 mach-virt guests<br/>
- virtio-pci provides several advantages over virtio-mmio, such
- as the ability to hotplug devices and improved performance.
- While opting in to virtio-pci has been possible for a while,
- newly-defined guests will now use it automatically
- </li>
- </ul>
- </li>
- <li><strong>Bug fixes</strong>
- <ul>
- <li>qemu: Correct GetBlockInfo values<br/>
- For an active domain, correct the physical value provided for
- a raw sparse file backed storage and the allocation value provided
- for a qcow2 file backed storage that hasn't yet been opened on
- the domain
- </li>
- <li>qemu: Make virtio console usable on ppc64 guests<br/>
- The chardev detection code has been improved and can now handle this
- configuration properly
- </li>
- <li>qemu: Enable mount namespace<br/>
- To avoid funny races with udev relabelling devices under our hands and
- to enhance security, libvirt now spawns each qemu process with its own
- <code>/dev</code></li>
- </ul>
- </li>
- </ul>
-
- <h3>v2.5.0 (2016-12-04)</h3>
- <ul>
- <li><strong>New features</strong>
- <ul>
- <li>shmem: Add support for additional models<br/>
- The shmem device can now utilize QEMU's ivshmem-plain and
- ivshmem-doorbell, more modern versions of ivshmem
- </li>
- <li>vbox: Add VirtualBox 5.1 support
- </li>
- <li>libssh: New transport<br/>
- The new libssh transport allows one to connect to a running
- libvirtd via SSH, using the libssh library; for example:
- <tt>qemu+libssh://<i>server</i>/system</tt>
- </li>
- <li>vhost-scsi: Add support scsi_host hostdev passthrough<br/>
- Add the capability to pass through a scsi_host HBA and the
- associated LUNs to the guest
- </li>
- <li>qemu: Users can now enable debug logging for native gluster
- volumes in qemu using the "gluster_debug_level" option in qemu.conf
- </li>
- <li>memory hotplug: Slot numbers for memory devices are now
- automatically allocated and thus persistent. In addition slot numbers
- can be specified without providing a base address, which simplifies
- user configuration
- </li>
- <li>qemu: Express devices will be placed on PCIe bus by default<br/>
- For machine types that use a PCI Express root bus
- (e.g. x86_64/Q35 and aarch64/virt), any unaddressed PCI
- device that is an Express device (all virtio-1.0 devices,
- e1000e, nec-xhci, vfio assigned devices) will be placed on
- an Express controller (i.e. a pcie-root-port) instead of a
- legacy PCI controller (i.e. pci-bridge) with the root ports
- added as needed
- </li>
- </ul>
- </li>
- <li><strong>Improvements</strong>
- <ul>
- <li>docs: Better documentation for migration APIs and flags
- </li>
- <li>vbox: Address thread safety issues
- </li>
- <li>virsh: Add support for passing an alternative persistent XML
- to migrate command
- </li>
- <li>vhostuser: Allow hotplug of multiqueue devices
- </li>
- <li>NEWS: Switch to an improved format<br/>
- List user-visible changes instead of single commits for a better
- high-level overview of differences between libvirt releases
- </li>
- <li>website: Modernize layout and branding<br/>
- The libvirt website looked very cluttered and outdated; it has now
- been completely overhauled, resulting in a design that's better
- organized and more pleasant to look at
- </li>
- </ul>
- </li>
- <li><strong>Bug fixes</strong>
- <ul>
- <li>vz: Fix migration in P2P mode
- </li>
- <li>Forbid newline character in names of some libvirt objects
- </li>
- <li>Fix compilation on macOS
- </li>
- </ul>
- </li>
- </ul>
-
- <p>Releases earlier than v2.5.0 detailed their changes using a different
- format and as such are excluded from the list above.
- You can read about those older release, starting from those made in
- <a href="news-2016.html">2016</a>.
- </p>
-
- </body>
-</html>
--- /dev/null
+<?xml version="1.0"?>
+
+<!-- libvirt release notes
+
+ This file will be processed to produce both HTML and plain text versions
+ of the release notes.
+
+ Keep the style consistent with existing entries as much as possible:
+ each change should be documented by a short, one-sentence summary
+ and optionally a description where it's explained in more detail -->
+
+<libvirt>
+ <release version="v3.0.0" date="unreleased">
+ <section title="New features">
+ <change>
+ <summary>
+ New localPtr attribute for "ip" element in network XML
+ </summary>
+ </change>
+ <change>
+ <summary>
+ qemu: Support QEMU group I/O throttling
+ </summary>
+ <description>
+ Add the capability to allow group I/O throttling via a new
+ domain <disk> <iotune> subelement "group_name"
+ to allow sharing I/O throttling quota between multiple drives
+ </description>
+ </change>
+ <change>
+ <summary>
+ nss: Introduce <code>libvirt-guest</code>
+ </summary>
+ <description>
+ New <code>libvirt-guest</code> nss module that translates libvirt
+ guest names into IP addresses
+ </description>
+ </change>
+ <change>
+ <summary>
+ daemon: Add support for runtime logging settings adjustment
+ </summary>
+ <description>
+ Logging-related settings like log outputs and filters can now be
+ adjusted during runtime using the admin interface without the
+ necessity of the daemon's restart
+ </description>
+ </change>
+ <change>
+ <summary>
+ storage: Add virStorageVolInfoFlags API
+ </summary>
+ <description>
+ Add the API to support using the VIR_STORAGE_VOL_GET_PHYSICAL
+ flag in order to return the host physical size in bytes
+ of the image container in the allocation field of the
+ _virStorageVolInfo structure. The --physical flag has been
+ added to the virsh vol-info command to access the data
+ </description>
+ </change>
+ <change>
+ <summary>
+ libxl: Implement virDomainGetMaxVcpus API
+ </summary>
+ </change>
+ </section>
+ <section title="Improvements">
+ <change>
+ <summary>
+ perf: Add more perf statistics
+ </summary>
+ <description>
+ Add support to get the count of branch instructions
+ executed, branch misses, bus cycles, stalled frontend
+ cpu cycles, stalled backend cpu cycles, and ref cpu
+ cycles by applications running on the platform
+ </description>
+ </change>
+ <change>
+ <summary>
+ conf: Display <physical> for volume xml
+ </summary>
+ <description>
+ Add a display of the <physical> size of a disk
+ volume in the output of the volume XML
+ </description>
+ </change>
+ <change>
+ <summary>
+ qemu: Use virtio-pci by default for aarch64 mach-virt guests
+ </summary>
+ <description>
+ virtio-pci provides several advantages over virtio-mmio, such
+ as the ability to hotplug devices and improved performance.
+ While opting in to virtio-pci has been possible for a while,
+ newly-defined guests will now use it automatically
+ </description>
+ </change>
+ </section>
+ <section title="Bug fixes">
+ <change>
+ <summary>
+ qemu: Correct GetBlockInfo values
+ </summary>
+ <description>
+ For an active domain, correct the physical value provided for
+ a raw sparse file backed storage and the allocation value provided
+ for a qcow2 file backed storage that hasn't yet been opened on
+ the domain
+ </description>
+ </change>
+ <change>
+ <summary>
+ qemu: Make virtio console usable on ppc64 guests
+ </summary>
+ <description>
+ The chardev detection code has been improved and can now handle this
+ configuration properly
+ </description>
+ </change>
+ <change>
+ <summary>
+ qemu: Enable mount namespace
+ </summary>
+ <description>
+ To avoid funny races with udev relabelling devices under our hands and
+ to enhance security, libvirt now spawns each qemu process with its own
+ <code>/dev</code>.
+ </description>
+ </change>
+ </section>
+ </release>
+ <release version="v2.5.0" date="2016-12-04">
+ <section title="New features">
+ <change>
+ <summary>
+ shmem: Add support for additional models
+ </summary>
+ <description>
+ The shmem device can now utilize QEMU's ivshmem-plain and
+ ivshmem-doorbell, more modern versions of ivshmem
+ </description>
+ </change>
+ <change>
+ <summary>
+ vbox: Add VirtualBox 5.1 support
+ </summary>
+ </change>
+ <change>
+ <summary>
+ libssh: New transport
+ </summary>
+ <description>
+ The new libssh transport allows one to connect to a running
+ libvirtd via SSH, using the libssh library; for example:
+ <tt>qemu+libssh://<i>server</i>/system</tt>
+ </description>
+ </change>
+ <change>
+ <summary>
+ vhost-scsi: Add support scsi_host hostdev passthrough
+ </summary>
+ <description>
+ Add the capability to pass through a scsi_host HBA and the
+ associated LUNs to the guest
+ </description>
+ </change>
+ <change>
+ <summary>
+ qemu: Users can now enable debug logging for native gluster
+ volumes in qemu using the "gluster_debug_level" option in qemu.conf
+ </summary>
+ </change>
+ <change>
+ <summary>
+ memory hotplug: Slot numbers for memory devices are now
+ automatically allocated and thus persistent. In addition slot numbers
+ can be specified without providing a base address, which simplifies
+ user configuration
+ </summary>
+ </change>
+ <change>
+ <summary>
+ qemu: Express devices will be placed on PCIe bus by default
+ </summary>
+ <description>
+ For machine types that use a PCI Express root bus
+ (e.g. x86_64/Q35 and aarch64/virt), any unaddressed PCI
+ device that is an Express device (all virtio-1.0 devices,
+ e1000e, nec-xhci, vfio assigned devices) will be placed on
+ an Express controller (i.e. a pcie-root-port) instead of a
+ legacy PCI controller (i.e. pci-bridge) with the root ports
+ added as needed
+ </description>
+ </change>
+ </section>
+ <section title="Improvements">
+ <change>
+ <summary>
+ docs: Better documentation for migration APIs and flags
+ </summary>
+ </change>
+ <change>
+ <summary>
+ vbox: Address thread safety issues
+ </summary>
+ </change>
+ <change>
+ <summary>
+ virsh: Add support for passing an alternative persistent XML
+ to migrate command
+ </summary>
+ </change>
+ <change>
+ <summary>
+ vhostuser: Allow hotplug of multiqueue devices
+ </summary>
+ </change>
+ <change>
+ <summary>
+ NEWS: Switch to an improved format
+ </summary>
+ <description>
+ List user-visible changes instead of single commits for a better
+ high-level overview of differences between libvirt releases
+ </description>
+ </change>
+ <change>
+ <summary>
+ website: Modernize layout and branding
+ </summary>
+ <description>
+ The libvirt website looked very cluttered and outdated; it has now
+ been completely overhauled, resulting in a design that's better
+ organized and more pleasant to look at
+ </description>
+ </change>
+ </section>
+ <section title="Bug fixes">
+ <change>
+ <summary>
+ vz: Fix migration in P2P mode
+ </summary>
+ </change>
+ <change>
+ <summary>
+ Forbid newline character in names of some libvirt objects
+ </summary>
+ </change>
+ <change>
+ <summary>
+ Fix compilation on macOS
+ </summary>
+ </change>
+ </section>
+ </release>
+</libvirt>
+++ /dev/null
-<?xml version="1.0"?>
-<xsl:stylesheet version="1.0"
- xmlns:html="http://www.w3.org/1999/xhtml"
- xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
- <xsl:output method="text" encoding="UTF-8"/>
-
- <xsl:template match="/">
- <xsl:text>libvirt releases
-================
-</xsl:text>
- <xsl:apply-templates select="html:html/html:body/*"/>
- </xsl:template>
-
- <xsl:template match="html:h1"/>
- <xsl:template match="html:p"/>
-
- <xsl:template match="html:h3">
- <xsl:text>
-</xsl:text>
- <xsl:text># </xsl:text>
- <xsl:apply-templates/>
- <xsl:text>
-
-</xsl:text>
- </xsl:template>
-
- <xsl:template match="html:ul">
- <xsl:apply-templates select="html:li"/>
- </xsl:template>
-
- <xsl:template match="html:li">
- <xsl:text> * </xsl:text>
- <xsl:apply-templates select="html:strong|*/html:li"/>
- </xsl:template>
-
- <xsl:template match="html:li/*/html:li">
- <xsl:text> - </xsl:text>
- <xsl:apply-templates/>
- <xsl:text>
-</xsl:text>
- </xsl:template>
-
- <xsl:template match="html:strong">
- <xsl:apply-templates/>
- <xsl:text>
-
-</xsl:text>
- </xsl:template>
-
-</xsl:stylesheet>
projects / libvirt.git / commitdiff