OASIS Virtual I/O Device (VIRTIO) TC

 View Only
Expand all | Collapse all

[PATCH v3 00/18] admin: reconfirming the TC charter

  • 1.  [PATCH v3 00/18] admin: reconfirming the TC charter

    Posted 04-01-2021 16:50
    As previously reported https://lists.oasis-open.org/archives/virtio/202101/msg00000.html the latest revisions to the TC Process and the OASIS Committee Operations Process include new requirements to periodically confirm the TC charter and appoint or reappoint the TC chair(s). Our current charter can be found here: https://www.oasis-open.org/committees/virtio/charter.php Also included as patch 1 in the series. Some of it is a bit out of date. E.g. it talks of 1.0 in a future tense. There is nothing major though. I therefore propose the following clarifications to the charter. I did my best to address previous comments by Cornelia. Please review, we need to finish the process by March. My idea is to eventually continue the TC through a charter clarification (Section 1.8). changes from v2: charter: drop attempts to list all devices address comments by Halil charter: rearrange the deliverables section new patch to address comments by Halil changes from v1: address comments by Cornelia Michael S. Tsirkin (18): import the current TC charter charter: update historical notes charter: 1.0 is history charter: mention 1.x series in the background section charter: add channel I/O to list charter: drop attempts to list all devices charter: reserved id/feature list has nothing to do with 2.0 charter: explain what legacy is in the background section charter: update on deliverables charter: add motivation for changes made since 1.0 charter: update to mention 1.X instead of 0.9, 2.0 charter: document our focus on compatibility charter: TC as registrar for device IDs/features chater: document what we care about in changes charter: driver/device terminology charter: legacy mode terminology charter: audience terminology charter: rearrange the deliverables section charter.html 152 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 152 insertions(+) create mode 100644 charter.html -- MST


  • 2.  [PATCH v3 01/18] import the current TC charter

    Posted 04-01-2021 16:50
    Import the TC charter from: https://www.oasis-open.org/committees/virtio/charter.php Signed-off-by: Michael S. Tsirkin <mst@redhat.com> --- charter.html 133 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 charter.html diff --git a/charter.html b/charter.html new file mode 100644 index 0000000..7006009 --- /dev/null +++ b/charter.html @@ -0,0 +1,133 @@ +<html> +<title>OASIS Virtual I/O Device (VIRTIO) Technical Committee TC charter</title> +<body> + <ol id="charter-outline" class="bold-lower-alpha"> + <li> + TC Name + <p>OASIS Virtual I/O Device (VIRTIO) Technical Committee</p> + </li> + <li>Statement of Purpose + <p> + Background: + </p> + <p> + Hardware virtualization allows multiple operating systems ("guests") to share the same hardware ("host") managed by host software ("hypervisor"). + </p> + <p> + These guests need networks, storage, consoles and similar but non-virtualization-aware standard devices cannot be shared, or guests may not be permitted to access host devices at all. The simplest solution is to emulate a device expected by the guest operating system, but this can be slow and/or complicated. As most operating systems have facilities for adding drivers for new physical hardware, we can use the same facilities to add drivers for devices which are easier and/or more efficient to implement in software. + </p> + <p> + As every hypervisor is different, they tend to implement hypervisor-specific devices, requiring every guest to support a new device for that environment. For example, Linux currently supports completely separate drivers for eight different virtualization platforms, with most drivers being sub-optimal. In 2007, an attempt was made to implement a hypervisor and OS-agnostic device model in Linux guests and the KVM hypervisor over the standard PCI bys. This is now also supported by the VirtualBox hypervisor (2010) and FreeBSD guests (2011). + </p> + <p> + A Draft Specification + </p> + <p> + In 2009, as interest accumulated, the "Virtio PCI Card Specification" was published, with appendices for network, block storage and console devices. The emphasis was that virtual devices should be simple, look like driver authors expect physical devices to look, should be extensible, and that they should perform well. + </p> + <p> + Even at the time, there were implementations of virtio devices over non-PCI transports, and in 2011 the simplified "mmio" transport was added as an Appendix, as well as a "remote processor message" device which is actually used to communicate to a separate, physical CPU, rather than a virtual guest. + </p> + <p> + The years of experience have highlighted some of the implementation and design mistakes: enhancements have worked around many of them, but at cost of simplicity. Implementation bugs have also caused occasional anguish. + </p> + <p> + A 1.0 Specification + </p> + <p> + Our goal is to keep the good, discard the bad, and make the ugly optional. In particular, we will try not to break too much, and ensure it's possible for devices to support both 1.0 compliant and legacy guest drivers. + </p> + </li> + <li> + Scope + <p> + The "Virtio PCI Card Specification" 0.9.5, minus the Appendix H, shall be used as a starting point (referred to as "legacy"). Note that we expect the final output of this TC to be incompatible with that specification, though it will be possible for virtual devices to support both legacy and modern guest drivers. + </p> + <p> + The TC will produce an OASIS Standard by refining and documenting existing implementations and practice. After publication of the initial OASIS Standard, the TC may choose to develop a Version 2.0 standard that builds on lessons learned and identified trends and that may result in a significantly different architecture and approach. Until then, the TC shall not throw out the baby with the bathwater, boil the ocean, or embark on a PhD research topic. + </p> + <p> + The TC will consider one or more buses for virtual devices, including PCI. It will consider various kinds of devices, including network devices. Each part of the OASIS Standard will be considered in terms of portability, simplicity, least-surprise for driver authors, extensibility and performance. In particular, the effect of future radical extensions (such as layout changes) will be considered. + </p> + </li> + <li> + Deliverables + <ol class="spaced decimal"> + <li> + Specification of feature negotiation, configuration and queues, from both driver and device points of view. + <ol class="vanilla-lower-alpha"> + <li> + Specifically for virtio over PCI. + </li> + <li> + Specifically for virtio over mmio. + </li> + <li> + Specifically for other transports as decided by TC. + </li> + </ol> + </li> + <li> + Specification of device-specific configuration. + <ol class="vanilla-lower-alpha"> + <li> + For network devices. + </li> + <li> + For block storage devices. + </li> + <li> + For entropy devices. + </li> + <li> + For console devices. + </li> + <li> + For memory ballooning devices. + </li> + <li> + For SCSI endpoint devices. + </li> + <li> + Non-normative advice for designing new device types. + </li> + <li> + List of reserved device numbers for non-specified device types. (This section is likely to see ongoing maintenance before 2.0). + </li> + <li> + List of reserved feature numbers for non-specified features for each device type. (This section is likely to see ongoing maintenance before 2.0). + </li> + </ol> + </li> + <li> + Non-normative code examples for operation of guest/host side of buffers. + </li> + <li> + Non-normative guide for creating devices which also support previous mode(s). + </li> + </ol> + <p> + We anticipate deliverables (1) and (2) to be a single work, and (3) and (4) to be separate works. The projected delivery dates are 12 to 16 months after the first meeting. + </p> + </li> + <li> + IPR Mode + <p> + Non-Assertion Mode + </p> + </li> + <li> + Audience + <p> + Developers of hypervisors and device driver authors. + </p> + </li> + <li> + Language + <p> + US English. + </p> + </li> + </ol> +</body> +</html> -- MST


  • 3.  [PATCH v3 02/18] charter: update historical notes

    Posted 04-01-2021 16:50
    In the background section, be more specific that it refers to state at the time it was written (2013). Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Acked-by: Halil Pasic <pasic@linux.ibm.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index 7006009..1e1ffd3 100644 --- a/charter.html +++ b/charter.html @@ -17,7 +17,7 @@ These guests need networks, storage, consoles and similar but non-virtualization-aware standard devices cannot be shared, or guests may not be permitted to access host devices at all. The simplest solution is to emulate a device expected by the guest operating system, but this can be slow and/or complicated. As most operating systems have facilities for adding drivers for new physical hardware, we can use the same facilities to add drivers for devices which are easier and/or more efficient to implement in software. </p> <p> - As every hypervisor is different, they tend to implement hypervisor-specific devices, requiring every guest to support a new device for that environment. For example, Linux currently supports completely separate drivers for eight different virtualization platforms, with most drivers being sub-optimal. In 2007, an attempt was made to implement a hypervisor and OS-agnostic device model in Linux guests and the KVM hypervisor over the standard PCI bys. This is now also supported by the VirtualBox hypervisor (2010) and FreeBSD guests (2011). + As every hypervisor is different, they tend to implement hypervisor-specific devices, requiring every guest to support a new device for that environment. For example, in 2013 Linux supported completely separate drivers for eight different virtualization platforms, with most drivers being sub-optimal. In 2007, an attempt was made to implement a hypervisor and OS-agnostic device model in Linux guests and the KVM hypervisor over the standard PCI bus. This is now supported by multiple other hypervisors. </p> <p> A Draft Specification -- MST


  • 4.  [PATCH v3 03/18] charter: 1.0 is history

    Posted 04-01-2021 16:50
    make everything there past tense Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Halil Pasic <pasic@linux.ibm.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index 1e1ffd3..cec72d9 100644 --- a/charter.html +++ b/charter.html @@ -35,7 +35,7 @@ A 1.0 Specification </p> <p> - Our goal is to keep the good, discard the bad, and make the ugly optional. In particular, we will try not to break too much, and ensure it's possible for devices to support both 1.0 compliant and legacy guest drivers. + With the 1.0 Specification, the goal of the OASIS Virtual I/O Device (VIRTIO) Technical Committee was to keep the good, discard the bad, and make the ugly optional. In particular, the Committee tried not to break too much, and (with the exception of the mmio transport) the specification is designed to make it possible for devices to support both 1.0 compliant and legacy guest drivers. </p> </li> <li> -- MST


  • 5.  [PATCH v3 04/18] charter: mention 1.x series in the background section

    Posted 04-01-2021 16:50
    Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Halil Pasic <pasic@linux.ibm.com> --- charter.html 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/charter.html b/charter.html index cec72d9..a8b2356 100644 --- a/charter.html +++ b/charter.html @@ -37,6 +37,12 @@ <p> With the 1.0 Specification, the goal of the OASIS Virtual I/O Device (VIRTIO) Technical Committee was to keep the good, discard the bad, and make the ugly optional. In particular, the Committee tried not to break too much, and (with the exception of the mmio transport) the specification is designed to make it possible for devices to support both 1.0 compliant and legacy guest drivers. </p> + <p> + 1.X Specifications + </p> + <p> + With the 1.1, 1.2 and future revisions of the Specification, we aim to evolve this standard further, while both continuing to honor the goals of the 1.0 Specification and to include new objectives. + </p> </li> <li> Scope -- MST


  • 6.  [PATCH v3 06/18] charter: drop attempts to list all devices

    Posted 04-01-2021 16:50
    we are adding new device types all the time. no point in trying to list them all in the charter. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 18 +++--------------- 1 file changed, 3 insertions(+), 15 deletions(-) diff --git a/charter.html b/charter.html index 38cad98..9dcd2d3 100644 --- a/charter.html +++ b/charter.html @@ -79,23 +79,11 @@ <li> Specification of device-specific configuration. <ol class="vanilla-lower-alpha"> - <li> - For network devices. + <li> + Definition for multiple specified device types. </li> <li> - For block storage devices. - </li> - <li> - For entropy devices. - </li> - <li> - For console devices. - </li> - <li> - For memory ballooning devices. - </li> - <li> - For SCSI endpoint devices. + Normative requirements for specified device types. </li> <li> Non-normative advice for designing new device types. -- MST


  • 7.  [PATCH v3 05/18] charter: add channel I/O to list

    Posted 04-01-2021 16:50
    Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Halil Pasic <pasic@linux.ibm.com> --- charter.html 3 +++ 1 file changed, 3 insertions(+) diff --git a/charter.html b/charter.html index a8b2356..38cad98 100644 --- a/charter.html +++ b/charter.html @@ -68,6 +68,9 @@ <li> Specifically for virtio over mmio. </li> + <li> + Specifically for virtio over channel I/O. + </li> <li> Specifically for other transports as decided by TC. </li> -- MST


  • 8.  [PATCH v3 08/18] charter: explain what legacy is in the background section

    Posted 04-01-2021 16:50
    Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index b88f815..5a4222a 100644 --- a/charter.html +++ b/charter.html @@ -35,7 +35,7 @@ A 1.0 Specification </p> <p> - With the 1.0 Specification, the goal of the OASIS Virtual I/O Device (VIRTIO) Technical Committee was to keep the good, discard the bad, and make the ugly optional. In particular, the Committee tried not to break too much, and (with the exception of the mmio transport) the specification is designed to make it possible for devices to support both 1.0 compliant and legacy guest drivers. + With the 1.0 Specification, the goal of the OASIS Virtual I/O Device (VIRTIO) Technical Committee was to keep the good, discard the bad, and make the ugly optional. The "Virtio PCI Card Specification" 0.9.5, was used as a starting point (referred to as "legacy"). In particular, the Committee tried not to break too much, and (with the exception of the mmio transport) the specification is designed to make it possible for devices to support both 1.0 compliant and legacy guest drivers. </p> <p> 1.X Specifications -- MST


  • 9.  [PATCH v3 07/18] charter: reserved id/feature list has nothing to do with 2.0

    Posted 04-01-2021 16:50
    Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Halil Pasic <pasic@linux.ibm.com> --- charter.html 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/charter.html b/charter.html index 9dcd2d3..b88f815 100644 --- a/charter.html +++ b/charter.html @@ -89,10 +89,10 @@ Non-normative advice for designing new device types. </li> <li> - List of reserved device numbers for non-specified device types. (This section is likely to see ongoing maintenance before 2.0). + List of reserved device numbers for non-specified device types. (This section is likely to see ongoing maintenance). </li> <li> - List of reserved feature numbers for non-specified features for each device type. (This section is likely to see ongoing maintenance before 2.0). + List of reserved feature numbers for non-specified features for each device type. (This section is likely to see ongoing maintenance). </li> </ol> </li> -- MST


  • 10.  [PATCH v3 09/18] charter: update on deliverables

    Posted 04-01-2021 16:50
    we don't have multiple documents. we expect to deliver specifications periodically. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index 5a4222a..fb5564d 100644 --- a/charter.html +++ b/charter.html @@ -104,7 +104,7 @@ </li> </ol> <p> - We anticipate deliverables (1) and (2) to be a single work, and (3) and (4) to be separate works. The projected delivery dates are 12 to 16 months after the first meeting. + The projected delivery dates for the specifications are every 12 to 16 months. </p> </li> <li> -- MST


  • 11.  [PATCH v3 10/18] charter: add motivation for changes made since 1.0

    Posted 04-01-2021 16:50
    Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Halil Pasic <pasic@linux.ibm.com> --- charter.html 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/charter.html b/charter.html index fb5564d..17c2a87 100644 --- a/charter.html +++ b/charter.html @@ -41,7 +41,12 @@ 1.X Specifications </p> <p> - With the 1.1, 1.2 and future revisions of the Specification, we aim to evolve this standard further, while both continuing to honor the goals of the 1.0 Specification and to include new objectives. + Support for new technologies often calls for extensions to the standard. For example, + as technologies such as nested virtualization and hardware-based + implementations of VIRTIO devices became popular, these devices are no longer + necessarily part of a hypervisor. This in turn requires a strong commitment to + driver and device compatibility, as well as to driver and device security. + With the 1.1, 1.2 and future revisions of the Specification, we aim to evolve the VIRTIO standard further, addressing such new requirements while both continuing to honor the goals of the 1.0 Specification and including new objectives. </p> </li> <li> -- MST


  • 12.  [PATCH v3 11/18] charter: update to mention 1.X instead of 0.9, 2.0

    Posted 04-01-2021 16:50
    0.9 is no longer relevant. As for 2.0, let's stick to documenting what we know we plan to do, and not speculate on what we might do in indefinitely future. Also, drop some idiomatic humor - while fun, its meaning is not immediately obvious for non-native english speakers. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Halil Pasic <pasic@linux.ibm.com> --- charter.html 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/charter.html b/charter.html index 17c2a87..5db7053 100644 --- a/charter.html +++ b/charter.html @@ -52,11 +52,13 @@ <li> Scope <p> - The "Virtio PCI Card Specification" 0.9.5, minus the Appendix H, shall be used as a starting point (referred to as "legacy"). Note that we expect the final output of this TC to be incompatible with that specification, though it will be possible for virtual devices to support both legacy and modern guest drivers. + The TC will develop and produce versions 1.X of the OASIS Virtual I/O Device (VIRTIO) OASIS Standard by refining and documenting existing implementations and practice. </p> <p> - The TC will produce an OASIS Standard by refining and documenting existing implementations and practice. After publication of the initial OASIS Standard, the TC may choose to develop a Version 2.0 standard that builds on lessons learned and identified trends and that may result in a significantly different architecture and approach. Until then, the TC shall not throw out the baby with the bathwater, boil the ocean, or embark on a PhD research topic. </p> + <p> + Starting from version 1.1, each version of the specification shall be used as a starting point for the development of the next version of the specification. + </p> <p> The TC will consider one or more buses for virtual devices, including PCI. It will consider various kinds of devices, including network devices. Each part of the OASIS Standard will be considered in terms of portability, simplicity, least-surprise for driver authors, extensibility and performance. In particular, the effect of future radical extensions (such as layout changes) will be considered. </p> -- MST


  • 13.  [PATCH v3 12/18] charter: document our focus on compatibility

    Posted 04-01-2021 16:50
    This has been a FAQ for a long time. Let's address this. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/charter.html b/charter.html index 5db7053..2408b48 100644 --- a/charter.html +++ b/charter.html @@ -59,6 +59,20 @@ <p> Starting from version 1.1, each version of the specification shall be used as a starting point for the development of the next version of the specification. </p> + <p> + Note that we expect the output of this TC to be compatible with all previous versions of the specification, such that + compliant devices and drivers remain compliant with future versions of the specification. + In particular, special care will be taken such that drivers compliant with a certain version of the specification can also support devices compliant with all past versions of the specification, and vice versa. + </p> + <p> + When correcting defects in the specification, e.g. by adding new normative statements, the TC will + also take special care to avoid declaring existing working implementations non-compliant + as far as possible. + The TC will take into account factors such as existance and prevalence of implementations with the + defective behaviour and whether these implementations are working and robust. + When in doubt, the TC will err on the conservative side, such as by adding new feature bits + or by making the corrected behaviour recommended but not mandatory. + </p> <p> The TC will consider one or more buses for virtual devices, including PCI. It will consider various kinds of devices, including network devices. Each part of the OASIS Standard will be considered in terms of portability, simplicity, least-surprise for driver authors, extensibility and performance. In particular, the effect of future radical extensions (such as layout changes) will be considered. </p> -- MST


  • 14.  [PATCH v3 14/18] chater: document what we care about in changes

    Posted 04-01-2021 16:50
    add compatibility, securiry. layout changes need not be a drasctic change if done carefully. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index 8da8108..55fdf40 100644 --- a/charter.html +++ b/charter.html @@ -75,7 +75,7 @@ or by making the corrected behaviour recommended but not mandatory. </p> <p> - The TC will consider one or more buses for virtual devices, including PCI. It will consider various kinds of devices, including network devices. Each part of the OASIS Standard will be considered in terms of portability, simplicity, least-surprise for driver authors, extensibility and performance. In particular, the effect of future radical extensions (such as layout changes) will be considered. + The TC will consider one or more buses for virtual devices, including PCI. It will consider various kinds of devices, including network devices. Each part of the OASIS Standard will be considered in terms of portability, simplicity, least-surprise for driver authors, security, compatibility, extensibility and performance. In particular, the effect of future extensions (such as layout changes) will be considered. </p> </li> <li> -- MST


  • 15.  [PATCH v3 13/18] charter: TC as registrar for device IDs/features

    Posted 04-01-2021 16:50
    Already the case, let's document this is in scope. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 1 + 1 file changed, 1 insertion(+) diff --git a/charter.html b/charter.html index 2408b48..8da8108 100644 --- a/charter.html +++ b/charter.html @@ -55,6 +55,7 @@ The TC will develop and produce versions 1.X of the OASIS Virtual I/O Device (VIRTIO) OASIS Standard by refining and documenting existing implementations and practice. </p> <p> + The TC will also act as a registrar for the list of reserved device numbers for non-specified device types, as well as the list of reserved feature numbers for non-specified features for each device type. </p> <p> Starting from version 1.1, each version of the specification shall be used as a starting point for the development of the next version of the specification. -- MST


  • 16.  [PATCH v3 15/18] charter: driver/device terminology

    Posted 04-01-2021 16:50
    Use terminology consistent with spec. Say driver/device and not guest/host. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index 55fdf40..bad8f9f 100644 --- a/charter.html +++ b/charter.html @@ -119,7 +119,7 @@ </ol> </li> <li> - Non-normative code examples for operation of guest/host side of buffers. + Non-normative code examples for operation of driver/device side of buffers. </li> <li> Non-normative guide for creating devices which also support previous mode(s). -- MST


  • 17.  [PATCH v3 16/18] charter: legacy mode terminology

    Posted 04-01-2021 16:50
    Consistent with spec, say legacy and not previous mode. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index bad8f9f..89a6b10 100644 --- a/charter.html +++ b/charter.html @@ -122,7 +122,7 @@ Non-normative code examples for operation of driver/device side of buffers. </li> <li> - Non-normative guide for creating devices which also support previous mode(s). + Non-normative guide for creating devices and drivers which also support a legacy mode. </li> </ol> <p> -- MST


  • 18.  [PATCH v3 17/18] charter: audience terminology

    Posted 04-01-2021 16:50
    It's ok to mention hypervisors but list device developers as audience as well. Devices are no longer always part of the hypervisor. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> Reviewed-by: Cornelia Huck <cohuck@redhat.com> --- charter.html 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/charter.html b/charter.html index 89a6b10..2696079 100644 --- a/charter.html +++ b/charter.html @@ -138,7 +138,7 @@ <li> Audience <p> - Developers of hypervisors and device driver authors. + Developers of devices, hypervisors and device drivers. </p> </li> <li> -- MST


  • 19.  [PATCH v3 18/18] charter: rearrange the deliverables section

    Posted 04-01-2021 16:50
    make the list in charter match our current spec layout by rearranging list of deliverables, and make some delierables clearer (e.g. device specific chapters also describe features and operation). Signed-off-by: Michael S. Tsirkin <mst@redhat.com> --- charter.html 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/charter.html b/charter.html index 2696079..69b711c 100644 --- a/charter.html +++ b/charter.html @@ -99,7 +99,7 @@ </ol> </li> <li> - Specification of device-specific configuration. + Specification of device-specific features, configuration and operation. <ol class="vanilla-lower-alpha"> <li> Definition for multiple specified device types. @@ -108,21 +108,21 @@ Normative requirements for specified device types. </li> <li> - Non-normative advice for designing new device types. + List of reserved feature numbers for non-specified features for each device type. (This section is likely to see ongoing maintenance). </li> <li> List of reserved device numbers for non-specified device types. (This section is likely to see ongoing maintenance). </li> - <li> - List of reserved feature numbers for non-specified features for each device type. (This section is likely to see ongoing maintenance). - </li> </ol> </li> <li> Non-normative code examples for operation of driver/device side of buffers. </li> <li> - Non-normative guide for creating devices and drivers which also support a legacy mode. + Non-normative advice for designing new device types. + </li> + <li> + Non-normative guidance for creating devices and drivers which also support a legacy mode. </li> </ol> <p> -- MST


  • 20.  [PATCH v3 19/18] charter: full diff of proposed changes

    Posted 04-01-2021 16:53
    Full updated version attached below. As all comments on the previous ones were minor, I will now start a ballot to request a special majority vote. --- diff --git a/charter.html b/charter.html index 7006009..69b711c 100644 --- a/charter.html +++ b/charter.html @@ -17,7 +17,7 @@ These guests need networks, storage, consoles and similar but non-virtualization-aware standard devices cannot be shared, or guests may not be permitted to access host devices at all. The simplest solution is to emulate a device expected by the guest operating system, but this can be slow and/or complicated. As most operating systems have facilities for adding drivers for new physical hardware, we can use the same facilities to add drivers for devices which are easier and/or more efficient to implement in software. </p> <p> - As every hypervisor is different, they tend to implement hypervisor-specific devices, requiring every guest to support a new device for that environment. For example, Linux currently supports completely separate drivers for eight different virtualization platforms, with most drivers being sub-optimal. In 2007, an attempt was made to implement a hypervisor and OS-agnostic device model in Linux guests and the KVM hypervisor over the standard PCI bys. This is now also supported by the VirtualBox hypervisor (2010) and FreeBSD guests (2011). + As every hypervisor is different, they tend to implement hypervisor-specific devices, requiring every guest to support a new device for that environment. For example, in 2013 Linux supported completely separate drivers for eight different virtualization platforms, with most drivers being sub-optimal. In 2007, an attempt was made to implement a hypervisor and OS-agnostic device model in Linux guests and the KVM hypervisor over the standard PCI bus. This is now supported by multiple other hypervisors. </p> <p> A Draft Specification @@ -35,19 +35,47 @@ A 1.0 Specification </p> <p> - Our goal is to keep the good, discard the bad, and make the ugly optional. In particular, we will try not to break too much, and ensure it's possible for devices to support both 1.0 compliant and legacy guest drivers. + With the 1.0 Specification, the goal of the OASIS Virtual I/O Device (VIRTIO) Technical Committee was to keep the good, discard the bad, and make the ugly optional. The "Virtio PCI Card Specification" 0.9.5, was used as a starting point (referred to as "legacy"). In particular, the Committee tried not to break too much, and (with the exception of the mmio transport) the specification is designed to make it possible for devices to support both 1.0 compliant and legacy guest drivers. + </p> + <p> + 1.X Specifications + </p> + <p> + Support for new technologies often calls for extensions to the standard. For example, + as technologies such as nested virtualization and hardware-based + implementations of VIRTIO devices became popular, these devices are no longer + necessarily part of a hypervisor. This in turn requires a strong commitment to + driver and device compatibility, as well as to driver and device security. + With the 1.1, 1.2 and future revisions of the Specification, we aim to evolve the VIRTIO standard further, addressing such new requirements while both continuing to honor the goals of the 1.0 Specification and including new objectives. </p> </li> <li> Scope <p> - The "Virtio PCI Card Specification" 0.9.5, minus the Appendix H, shall be used as a starting point (referred to as "legacy"). Note that we expect the final output of this TC to be incompatible with that specification, though it will be possible for virtual devices to support both legacy and modern guest drivers. + The TC will develop and produce versions 1.X of the OASIS Virtual I/O Device (VIRTIO) OASIS Standard by refining and documenting existing implementations and practice. </p> <p> - The TC will produce an OASIS Standard by refining and documenting existing implementations and practice. After publication of the initial OASIS Standard, the TC may choose to develop a Version 2.0 standard that builds on lessons learned and identified trends and that may result in a significantly different architecture and approach. Until then, the TC shall not throw out the baby with the bathwater, boil the ocean, or embark on a PhD research topic. + The TC will also act as a registrar for the list of reserved device numbers for non-specified device types, as well as the list of reserved feature numbers for non-specified features for each device type. </p> <p> - The TC will consider one or more buses for virtual devices, including PCI. It will consider various kinds of devices, including network devices. Each part of the OASIS Standard will be considered in terms of portability, simplicity, least-surprise for driver authors, extensibility and performance. In particular, the effect of future radical extensions (such as layout changes) will be considered. + Starting from version 1.1, each version of the specification shall be used as a starting point for the development of the next version of the specification. + </p> + <p> + Note that we expect the output of this TC to be compatible with all previous versions of the specification, such that + compliant devices and drivers remain compliant with future versions of the specification. + In particular, special care will be taken such that drivers compliant with a certain version of the specification can also support devices compliant with all past versions of the specification, and vice versa. + </p> + <p> + When correcting defects in the specification, e.g. by adding new normative statements, the TC will + also take special care to avoid declaring existing working implementations non-compliant + as far as possible. + The TC will take into account factors such as existance and prevalence of implementations with the + defective behaviour and whether these implementations are working and robust. + When in doubt, the TC will err on the conservative side, such as by adding new feature bits + or by making the corrected behaviour recommended but not mandatory. + </p> + <p> + The TC will consider one or more buses for virtual devices, including PCI. It will consider various kinds of devices, including network devices. Each part of the OASIS Standard will be considered in terms of portability, simplicity, least-surprise for driver authors, security, compatibility, extensibility and performance. In particular, the effect of future extensions (such as layout changes) will be considered. </p> </li> <li> @@ -62,52 +90,43 @@ <li> Specifically for virtio over mmio. </li> + <li> + Specifically for virtio over channel I/O. + </li> <li> Specifically for other transports as decided by TC. </li> </ol> </li> <li> - Specification of device-specific configuration. + Specification of device-specific features, configuration and operation. <ol class="vanilla-lower-alpha"> - <li> - For network devices. + <li> + Definition for multiple specified device types. </li> <li> - For block storage devices. + Normative requirements for specified device types. </li> <li> - For entropy devices. + List of reserved feature numbers for non-specified features for each device type. (This section is likely to see ongoing maintenance). </li> <li> - For console devices. - </li> - <li> - For memory ballooning devices. - </li> - <li> - For SCSI endpoint devices. - </li> - <li> - Non-normative advice for designing new device types. - </li> - <li> - List of reserved device numbers for non-specified device types. (This section is likely to see ongoing maintenance before 2.0). - </li> - <li> - List of reserved feature numbers for non-specified features for each device type. (This section is likely to see ongoing maintenance before 2.0). + List of reserved device numbers for non-specified device types. (This section is likely to see ongoing maintenance). </li> </ol> </li> <li> - Non-normative code examples for operation of guest/host side of buffers. + Non-normative code examples for operation of driver/device side of buffers. </li> <li> - Non-normative guide for creating devices which also support previous mode(s). + Non-normative advice for designing new device types. + </li> + <li> + Non-normative guidance for creating devices and drivers which also support a legacy mode. </li> </ol> <p> - We anticipate deliverables (1) and (2) to be a single work, and (3) and (4) to be separate works. The projected delivery dates are 12 to 16 months after the first meeting. + The projected delivery dates for the specifications are every 12 to 16 months. </p> </li> <li> @@ -119,7 +138,7 @@ <li> Audience <p> - Developers of hypervisors and device driver authors. + Developers of devices, hypervisors and device drivers. </p> </li> <li>


  • 21.  Re: [virtio] [PATCH v3 00/18] admin: reconfirming the TC charter

    Posted 04-12-2021 15:43
    On Thu, Apr 01, 2021 at 12:49:30PM -0400, Michael S. Tsirkin wrote: > > As previously reported > https://lists.oasis-open.org/archives/virtio/202101/msg00000.html > the latest revisions to the TC Process and the OASIS > Committee Operations Process include new requirements to periodically confirm > the TC charter and appoint or reappoint the TC chair(s). > > Our current charter can be found here: > https://www.oasis-open.org/committees/virtio/charter.php > > Also included as patch 1 in the series. > Some of it is a bit out of date. E.g. it talks of 1.0 in a future > tense. There is nothing major though. > > I therefore propose the following clarifications to the charter. > I did my best to address previous comments by Cornelia. > > Please review, we need to finish the process by March. My idea is to > eventually continue the TC through a charter clarification (Section > 1.8). I now submitted a request for oasis admins to start a special majority vote itself. The proposed charter is now uploaded at: https://github.com/oasis-tcs/virtio-admin/blob/master/charter.html > changes from v2: > charter: drop attempts to list all devices > address comments by Halil > charter: rearrange the deliverables section > new patch to address comments by Halil > > changes from v1: > address comments by Cornelia > > > Michael S. Tsirkin (18): > import the current TC charter > charter: update historical notes > charter: 1.0 is history > charter: mention 1.x series in the background section > charter: add channel I/O to list > charter: drop attempts to list all devices > charter: reserved id/feature list has nothing to do with 2.0 > charter: explain what legacy is in the background section > charter: update on deliverables > charter: add motivation for changes made since 1.0 > charter: update to mention 1.X instead of 0.9, 2.0 > charter: document our focus on compatibility > charter: TC as registrar for device IDs/features > chater: document what we care about in changes > charter: driver/device terminology > charter: legacy mode terminology > charter: audience terminology > charter: rearrange the deliverables section > > charter.html 152 +++++++++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 152 insertions(+) > create mode 100644 charter.html > > -- > MST > > > --------------------------------------------------------------------- > To unsubscribe from this mail list, you must leave the OASIS TC that > generates this mail. Follow this link to all your TCs in OASIS at: > https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php