Members of theOASIS Virtual I/O Device (VIRTIO) TC create and manage technical content in this TC GitHub repository (https://github.com/oasis-tcs/virtio-spec ) as part of the TC's chartered work (i.e., the program of work and deliverables described in itscharter).

OASIS TC GitHub repositories, as described inGitHub Repositories for OASIS TC Members' Chartered Work, are governed by the OASISTC Process,IPR Policy, and other policies, similar to TC Wikis, TC JIRA issues tracking instances, TC SVN/Subversion repositories, etc. While they make use of public GitHub repositories, these TC GitHub repositories are distinct fromOASIS Open Repositories, which are used for development of open sourcelicensed content.

This repository includes theauthoritative source of the VIRTIO (Virtual I/O) Specification document. VIRTIO document describes the specifications of the "virtio" family of devices. These devices are found in virtual environments, yet by design they look like physical devices to the guest within the virtual machine — and this document treats them as such. This similarity allows the guest to use standard drivers and discovery mechanisms.

The purpose of virtio and this specification is that virtual environments and guests should have a straightforward, efficient, standard and extensible mechanism for virtual devices, rather than boutique per-environment or per-OS mechanisms.

As stated in this repository'sCONTRIBUTING file, contributors to this repository are expected to be Members of the OASIS virtio TC, for any substantive change requests. Anyone wishing to contribute to this GitHub project andparticipate in the TC's technical activity is invited to join as an OASIS TC Member. Public feedback is also accepted, subject to the terms of theOASIS Feedback License.

Please see theLICENSE file for description of the license terms and OASIS policies applicable to the TC's work in this GitHub project. Content in this repository is intended to be part of the virtio TC's permanent record of activity, visible and freely available for all to use, subject to applicable OASIS policies, as presented in the repositoryLICENSE file.

Installation cheat sheet:

Fedora:

sudo dnf install texlive-scheme-full

Ubuntu and other Debian derivatives:

sudo apt-get install texlive-full

OSX:

OSX users don't need to install Tex-Live because they already haveMacTeX installed.

The build process generates a ZIP package file including theoriginal TeX sources, as well as HTML and PDF formattedversions of the specification.

To generate the ZIP package, run:

./makeall.sh

Troubleshooting notes:

PDFs of the specification can be generated witheither MicroSoft's Core fonts for the Web: Arial and Courier New,or Liberation fonts: Liberation Sans and Liberation Mono.Most systems come with one of these two variants included:should you get an error message about missing fonts,you will need to downloads and install one of the abovefont packages.

Note that only plain text part of the message is archived, and allattachments are stripped. Accordingly, messages sent to themailing list should use text/plain encoding and nothave any attachments.

The preferred form of providing feedback is in form of a patch.A patch can be generated and sent by cloning the spec repository,creating a commit, formatting it as a patch and then sending it.For example:

git clone https://github.com/oasis-tcs/virtio-spec.git
... edit spec text, and save ...


git commit -a
... describe the proposed change, in the following format:
single line summary

detailed description, including motivation for the change

Signed-off-by: Name <email>
... then save and close the editor ...


git format-patch -o proposal1/ HEAD~1..
... generates a new directory proposal1/ and a file starting with 0001- ...


git send-email --to=virtio-comment@lists.linux.dev proposal1/0001-*

When to use the virtio-comment mailing list:

questions and change proposals for the Virtio specification, including the specification of basic functionality, transports and devices.

Whennot to use the virtio-comment mailing list:

questions and change proposals for Virtio drivers and devices implementing the specification. (please use the virtio-dev mailing list for this).

To do:

send email preferably in text format (best for archiving).

Not to do:

• copy both virtio-dev and virtio-comment mailing lists (instead, pick one);
• send full copies of the virtio spec (in any format).

TC Members should review TC specificprocess rules under "Further Description of this Repository"inhttps://github.com/oasis-tcs/virtio-admin.

Implementation discussion

Use of github issues

TC standing rules

Contact