summaryrefslogtreecommitdiff
path: root/virtio-v1.0-wd01-part1-specification.txt
AgeCommit message (Collapse)Author
2013-10-04Copy linear layout to CCW, MMIO sections.rusty
Revision r49 "virtqueue: flexible layout, size, alignment" moved the linear assumption into the legacy section. We also need it in the per-transport sections until (if?) those two transports go non-linear. Just copied the paragraph, with variable names changed to match the particular transport field nomenclature. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@52 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-042.1: Add ccw to forward references.rusty
Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@51 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-04Legacy Interfaces: A Note on Virtqueue Layout: Remove dup paragraph.rusty
Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@50 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-30virtqueue: flexible layout, size, alignmentmstsirkin
Transports can now lay out available/used/descriptor regions in a flexible way. This is useful for embedded systems to save memory, and for large systems to reduce the need for physically-contigious memory. However, this does not add a way to actually program this in any of the transports, so it's not useful by itself, separate follow-up patches will add a way to program this for transports. Resolves issue: VIRTIO-23 Approved OASIS meeting 2013-09-24. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@49 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-30pci: remove requirement for revision ID to be 0mstsirkin
While spec previously required revision to be 0 exactly it turned out not to be an efficient means to disable legacy drivers - we had to resort to changing device ID instead. So let's free up this field making it available for device makers for hardware versioning. Resolves VIRTIO-22 Approved OASIS meeting 2013-09-24. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@48 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-30pci: new layout: move footnotemstsirkin
Legacy footnotes belong directly within text. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@47 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-30pci: new layout: driver must not write to bits>63mstsirkin
Since we never offer feature bits >63, driver must not ack them. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@46 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-30pci: new configuration layoutmstsirkin
- split data path, common config and device specific config - support for new VQ layout Resolves issue VIRTIO-21 Approved OASIS meeting 2013-09-24. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@45 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-25virtio-ccw: document GPR4/GPR2 cookie valuesrusty
virtio-ccw on kvm can use a cookie value passed to guest to optimize channel/VQ lookups. Document this. VIRTIO-29, approved OASIS meeting 2013-09-24. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@44 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-252.3.3.2 virtio-ccw clarifications.rusty
Ported from draft commit 67843fe9745e96c10e148f00ba0aa64397c64f06. Issue VIRTIO-29, approved OASIS meeting 2013-09-24. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@43 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-252.3.3 virtio-ccw: Add secondary indicators.rusty
Ported from draft commit e945661b40bcfd29efc35dfa73465bcc960bd20b. Issue VIRTIO-29, approved OASIS meeting 2013-09-24. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@42 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-252.3.3 Add virtio-ccw spec.rusty
Ported from draft commit cdbad68fd1ccb8b99b3853836e2b38e0bf74361b. Issue VIRTIO-29, approved OASIS meeting 2013-09-24. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@41 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-252.4.2.5: Remove ioprio field.rusty
Leave a reserved field in there for alignment. See: https://tools.oasis-open.org/issues/browse/VIRTIO-20 Approved OASIS meeting 2013-09-24. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@40 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-252.4.2.3: Remove VIRTIO_BLK_F_BARRIER.rusty
As per VIRTIO-19, approved OASIS meeting 2013-09-24. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@39 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-25Relegate the VIRTIO_BLK_F_SCSI feature to legacyrusty
As per issue virtio-18, approved OASIS meeting 2013-09-24. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@38 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-252.4.1.3: Remove VIRTIO_NET_F_GSOrusty
As per VIRTIO-17, approved OASIS meeting 2013-09-24. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@37 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-25Remove VIRTIO_F_NOTIFY_ON_EMPTYrusty
As per http://tools.oasis-open.org/issues/browse/VIRTIO-13 (Includes le8 -> u8 fix) Approved OASIS meeting 2013-09-24. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@36 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-25Any layout is allowed (deprecate VIRTIO_F_ANY_LAYOUT)rusty
As per issue virtio-10, approved OASIS meeting 2013-09-24. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@35 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-18transitional: minor clarificationmstsirkin
It's useful to have a common term that includes transitional drivers running on legacy devices and legacy drivers running on transitional devices. The wording "using legacy interface" seems to describe this well, let's make this explicit. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@34 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-112.5 Reserve device ID 0 (zero) as invalidrusty
See minutes: https://lists.oasis-open.org/archives/virtio/201309/msg00041.html Signed-off-by: Pawel Moll <pawel.moll@arm.com> Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@33 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-11VIRTIO_F_VERSION_1: indentifying legacy devices.rusty
Most of this text is taken directly from Michael Tsirkin's proposal, separated from the PCI-specific parts, and given an explicit feature name. See minutes: https://lists.oasis-open.org/archives/virtio/201309/msg00041.html Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@32 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-042.4.2.2 Define all MMIO registers as little endianrusty
Port of draft commit 88f37f9ec178b664213b77211fec03687b87958b. Signed-off-by: Pawel Moll <pawel.moll@arm.com> Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@31 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-032.5.6.6.3: add configuration change eventrusty
This adds an event for changes to LUN parameters, for example capacity. These are reported in virtio-blk via configuration changes, and we want a similar functionality in virtio-scsi too. There is no list of supported parameter changes, instead we just refer to the list of sense codes in the SCSI specification. This event will usually be serviced in one of three ways: 1) call an OS service to revalidate the disk, either always or only for some specific sense codes; 2) somehow pass the sense directly to the upper-level driver; 3) inject a TEST UNIT READY command into the upper-level device, so that the OS will see the unit attention code and react. Of course a mix of the three is also possible, depending on how the driver writer prefers to have his layering violations served. Signed-off-by: Paolo Bonzini <pbonzini@redhat.com> See: https://lists.oasis-open.org/archives/virtio-comment/201308/msg00032.html Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@30 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-09-032.5.6.6.3: unify event structs From: Paolo Bonzini <pbonzini@redhat.com>rusty
All currently defined event structs have the same fields. Simplify the driver by enforcing this also for future structs. Signed-off-by: Paolo Bonzini <pbonzini@redhat.com> See: https://lists.oasis-open.org/archives/virtio-comment/201308/msg00031.html Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@29 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-30formatting: fix two xrefsmstsirkin
Fix incorrect section number in one xref, fill in actual targets for another. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@28 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-30formatting: fix xref to virtio_ring.hmstsirkin
Text simply had a stub *XREF* text, make it point at the actual section. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@27 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-30formatting: fix more xrefsmstsirkin
Text had some xrefs in the form [sub:text]. These point nowhere, find the target making most sense and make them point there. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@26 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29formatting: fix up section and footnote numberingmstsirkin
automatically done by script. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@24 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29formatting: fix numberingmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@22 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29format: remove trailing whitespacemstsirkin
no reason to have it Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@21 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29minor: rename sectionmstsirkin
Section in PCI part of spec talks about interrupts, not used buffers (that's generic). Also tweak formatting. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@20 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29formatting: put cross-references in "", fix FIXMEmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@19 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29formatting: more fixupsmstsirkin
Fix up formatting for cross-references e.g. (see X.Y.Z. Foo Bar) to match section names. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@18 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29formatting fixesmstsirkin
for consistency, make sure the following formatting rules hold: - each subchapter number ends with dot - each subchapter title is followed by a line of dashes Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@17 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-29virtio: fix feature bit thinkomstsirkin
32 Feature bits means 0 to 31, not 32. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@16 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-08-19Rename to conform to OASIS Naming Directives.rusty
http://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@15 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652