pub/scm/virt/kvm/mst/virtio-text.git  about / heads / tags
=desc pub/scm/path/to/repo virtio spec 1.0 work in progress in text format. NOTE: this is just a staging area for convenience.
$ git log --pretty=format:'%h %s (%cs)%d'
089bc59 virtio-iommu: Remove invalid requirement about padding (2020-05-04)
	(HEAD -> master, mst-next)
baf58fe Remove all mentioned of subversion (2020-05-04)
54806cd add explicit shebang to script (2020-05-04)
f42cc75 virtio-net/rss: maximal -> maximum (2020-03-01)
0c0dd71 virtio-gpu: some edid clarifications (2020-02-27)
6112433 virtio-gpu: add 3d command overview (2020-02-27)
da60923 content: document speed, duplex (2020-01-28)
d7e91b5 virtio-rng: fix device/driver confusion (2020-01-28)
6914d2d content: Reserve device ID for video encoder and decoder device (2020-01-28)
652237e Add virtio-iommu device specification (2020-01-20)

$ git cat-file blob

<p>Members of the <a href="">OASIS Virtual I/O Device (VIRTIO) TC</a> create and manage technical content in this TC GitHub repository ( <a href=""></a> ) as part of the TC's chartered work (<i>i.e.</i>, the program of work and deliverables described in its <a href="">charter</a>).</p>

<p>OASIS TC GitHub repositories, as described in <a href="">GitHub Repositories for OASIS TC Members' Chartered Work</a>, are governed by the OASIS <a href="">TC Process</a>, <a href="">IPR Policy</a>, 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 from <a href="">OASIS Open Repositories</a>, which are used for development of open source <a href="">licensed</a> content.</p>


<p>This repository includes the <a href="">authoritative source</a> 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 &mdash; and this document treats them as such. This similarity allows the guest to use standard drivers and discovery mechanisms. </p>

<p>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.</p>

<p>As stated in this repository's <a href="">CONTRIBUTING file</a>, 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 and <a href="">participate</a> 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 the <a href="">OASIS Feedback License</a>.</p>

<p>Please see the <a href="">LICENSE</a> 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 repository <a href="">LICENSE</a> file.</p>


<h3>Further Description of this Repository</h3>
<h4>Building Instructions</h4>
Authoritative version of the specification is maintained in the
TeX document format. PDF and HTML versions are made available for
ease of use and review.
In order to build the HTML and PDF versions of the spec you will need the
TeX document production system.
The easiest way to get it up and running is probably by installing
<a href="">Tex-Live</a>.

<dl>Installation cheat sheet:
sudo dnf install texlive-scheme-full
Ubuntu and other Debian derivatives:
sudo apt-get install texlive-full
<dd>OSX users don't need to install Tex-Live because they already have
<a href="">MacTeX</a> installed.
<dl>The build process generates a ZIP package file including the
original TeX sources, as well as HTML and PDF formatted
versions of the specification.
<dt>To generate the ZIP package, run:<dt>
<dt>Troubleshooting notes:</dt>
<dd> PDFs of the specification can be generated with
either 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 above
font packages.
<h4>Providing Feedback</h4>
Feedback must be provided the <strong>virtio-comment</strong> mailing list,
and archived in the mailing list archives.
<p>See <A
<p>Note that only plain text part of the message is archived, and all
attachments are stripped. Accordingly, messages sent to the
mailing list should use text/plain encoding and not
have any attachments.
<p>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<br>
... edit spec text, and save ...<br>
git commit -a<br>
... describe the proposed change, in the following format:<br>
single line summary<br>
detailed description, including motivation for the change<br>
Signed-off-by: Name &lt;email&gt;<br>
... then save and close the editor ... <br>
git format-patch -o proposal1/ HEAD~1..<br>
... generates a new directory proposal1/ and a file starting with 0001- ...<br>
git send-email proposal1/0001-*
<h4>Note for TC Members</h4>
<p>TC Members should review TC specific
process rules under "Further Description of this Repository"
in <A

<h4>Implementation discussion</h4>
Implementation discussion should take place on the <strong>virtio-dev</strong> mailing list,
and be archived in the mailing list archives.
<p>See <A
<p>This is the correct list to copy on Linux virtio UAPI change proposals.
<p>Note that only the plain text part of the message is archived, and all
attachments are stripped. Accordingly, messages sent to the
mailing list should use text/plain encoding and not
have any attachments.
<h4>Use of github issues</h4>
Note: according to the virtio TC rules, all official TC communication
is taking place on one of the TC mailing lists.
In particular, all comments must be provided on
one of the TC mailing lists. Accordingly, the TC will not respond
to comments provided in github issues: github issues are
used solely to track integration of comments into the
To request a TC vote on resolving a specific comment:
<li>Create a github issue, or edit an existing issue, with
a short summary of the comment.
The issue MUST specify
the link to the latest proposal in the TC mailing list
archives. <em>Note:</em> the link MUST be in the issue description itself -
<em>not</em> in the comments.</li>
<li>Reply by email to the comment email, requesting that the TC vote
on resolving the issue.
The mail requesting the vote should include the following, on a line by itself:<br>
(NNN is the issue number)</li>
<li>Please make sure to allow time for review between posting a comment
and asking for a vote. </li>
<h4>TC standing rules</h4>
The TC adopted the following standing rule:
Minor cleanups, including editorial formatting changes, spelling
and typo fixes can be committed directly into git for approval as
part of the next specification approval ballot.
<li>To request such a commit, reply by email to the comment email, requesting that the
issue is resolved under the minor cleanups standing rule.
<li>Please make sure to allow time for review between posting a comment
and asking for a commit. </li>

<p>Please send questions or comments about <a href="">OASIS TC GitHub repositories</a> to <a href="">Robin Cover</a> and <a href="">Chet Ensign</a>.  For questions about content in this repository, please contact the TC Chair or Co-Chairs as listed on the the virtio TC's <a href="">home page</a>.</p>

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       virtio-iommu: Remove invalid requirement about padding (2020-05-04)
  mst-next     virtio-iommu: Remove invalid requirement about padding (2020-05-04)
  trunk        virtio-net: add Max MTU configuration field (2016-10-11)
  tags/v1.0-cs04 Create tag v1.0-cs04 (2016-07-22)
  v1.0         REVISION: update for cs04 (2016-07-22)
  tags/v1.0-csprd05 Create tag v1.0-csprd05 (2016-02-16)
  tags/v1.0-cs03 Create tag v1.0-cs03 (2015-08-02)
  tags/v1.0-cs02 Create tag v1.0-cs02 (2015-02-15)
  tags/v1.0-cs01 makediff: fix up using git-svn commit IDs (2014-12-22)
  tags/v1.0-cs01@435 makediff: fix up to cherry-picks (2014-10-19)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
for_review   for review Feb 11 (2014-02-10) tar.gz

# associated public inboxes:
# (number on the left is used for dev purposes)
         82 virtio-dev
         19 virtio-comment
         10 lkml
          6 qemu-devel
          5 linux-mediatek
          5 stable
          5 dri-devel
          4 linux-wireless
          4 linux-devicetree
          4 netdev
          4 dpdk-dev
          4 intel-gfx
          4 u-boot
          3 linux-xfs
          3 linux-media
          3 linux-mips
          3 linux-pm
          3 linux-btrfs
          3 linux-arm-kernel
          3 linux-clk
          3 linux-rdma
          3 linuxppc-dev
          3 linux-doc
          3 amd-gfx
          3 linux-tegra
          3 linux-can
          3 linux-rockchip
          3 openembedded-core
          2 linux-samsung-soc
          2 linux-mtd
          2 linux-riscv
          2 linux-nvme
          2 bpf
          2 linux-nfs
          2 linux-crypto
          2 linux-acpi
          2 netfilter-devel
          2 linux-fsdevel
          2 linux-cifs
          2 linux-arm-msm
          2 linux-amlogic
          2 linux-erofs
          2 linux-mm
          2 linux-iommu
          2 xen-devel
          2 fstests
          2 linux-rtc
          2 linux-input
          2 alsa-devel
          2 linux-scsi
          2 kvmarm
          2 driverdev-devel
          2 linux-usb
          2 linux-renesas-soc
          2 linux-kselftest
          2 selinux
          2 linux-iio
          2 linux-gpio
          2 linux-ext4
          2 linux-security-module
          2 linux-pci
          2 linux-f2fs-devel
          2 kvm
          2 linux-modules
          2 linux-rt-users
          2 linux-bluetooth
          2 linux-ide
          2 linux-serial
          2 linux-watchdog
          2 linux-trace-devel
          2 util-linux
          2 backports
          2 git
          2 linux-man
          2 linux-mmc
          2 linux-api
          2 linux-omap
          2 linux-spi
          2 linux-i2c
          2 linux-sparse
          2 lttng-dev
          2 virtualization
          2 linux-kbuild
          2 linux-arch
          2 containers
          2 linux-raid
          2 openbmc
          2 linux-fbdev
          2 linux-cxl
          2 linux-perf-users
          2 linux-sh
          2 soc
          2 nouveau
          2 linux-s390
          2 linux-sunxi
          2 linux-coco
          2 buildroot
          2 iwd
          2 ofono
          2 ltp
          2 yocto
          2 yocto-meta-freescale
          2 yocto-toaster
          2 yocto-meta-arm
          2 openembedded-devel
          2 bitbake-devel
          2 linux-patches
          2 yocto-meta-virtualization
          2 yocto-meta-ti
          2 yocto-meta-arago
          2 outreachy
          2 openrisc
          2 intel-wired-lan
          2 kexec
          2 intel-xe
          2 linux-um
          2 poky
          2 qemu-riscv
          2 cluster-devel
          2 grub-devel
          2 kvm-ppc
          2 linux-hexagon
          2 reiserfs-devel
          2 lvm-devel
          2 virtio-fs
          2 ../../../../../../fuego
          2 ../../../../../../igt-dev
          1 linux-fscrypt
          1 cocci
          1 linux-block
          1 live-patching
          1 linux-efi
          1 linux-integrity
          1 linux-edac
          1 linux-nvdimm
          1 linux-snps-arc
          1 linux-hwmon
          1 kernel-hardening
          1 dmaengine
          1 linux-next
          1 linux-parisc
          1 linux-leds
          1 kernelnewbies
          1 linux-sgx
          1 linux-hyperv
          1 workflows
          1 rcu
          1 selinux-refpolicy
          1 linux-m68k
          1 linux-i3c
          1 linux-spdx
          1 linux-wpan
          1 ksummit-discuss
          1 wireguard
          1 io-uring
          1 linux-kernel-mentees
          1 linux-csky
          1 tpmdd-devel
          1 linux-unionfs
          1 linux-firmware
          1 cip-dev
          1 linux-audit
          1 linux-remoteproc
          1 linux-dash
          1 linux-bcache
          1 mm-commits
          1 linux-pwm
          1 linux-fpga
          1 ceph-devel
          1 xdp-newbies
          1 platform-driver-x86
          1 phone-devel
          1 linux-hardening
          1 dash
          1 dm-devel
          1 keyrings
          1 linux-sctp
          1 target-devel
          1 lustre-devel
          1 ocfs2-devel
          1 rust-for-linux
          1 ath10k
          1 ath11k
          1 linux-phy
          1 kernel-janitors
          1 sparclinux
          1 linux-staging
          1 mptcp
          1 regressions
          1 ksummit
          1 b43-dev
          1 nvdimm
          1 linux-nfc
          1 linux-bcachefs
          1 ath9k-devel
          1 ntfs3
          1 llvm
          1 fio
          1 ell
          1 yocto-docs
          1 chrome-platform
          1 ntb
          1 xenomai
          1 damon
          1 asahi
          1 loongarch
          1 imx
          1 ath12k
          1 b4-sent
          1 linux-trace-kernel
          1 oe-linux-nfc
          1 oe-kbuild-all
          1 oe-chipsec
          1 batman
          1 v9fs
          1 ecryptfs
          1 linux-ia64
          1 kbd
          1 autofs
          1 cpufreq
          1 dccp
          1 cgroups
          1 devicetree-spec
          1 devicetree-compiler
          1 initramfs
          1 hail-devel
          1 kvm-ia64
          1 linux-8086
          1 kernel-testers
          1 linux-alpha
          1 linux-btrace
          1 linux-embedded
          1 linux-hams
          1 linux-hotplug
          1 linux-laptop
          1 linux-sound
          1 trinity
          1 linux-metag
          1 linux-x25
          1 linux-nilfs
          1 lvs-devel
          1 netfilter
          1 linux-oxnas
          1 u-boot-amlogic
          1 lm-sensors
          1 acpica-devel
          1 perfbook
          1 smatch
          1 ../../../../../../wireless-regdb
          1 ../../../../../../powertop

git clone