summaryrefslogtreecommitdiff
AgeCommit message (Collapse)Author
2013-11-25latex: add underscore packagemstsirkin
We use _ widely, make this legal so we don't need to escape all uses. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@114 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25content.tex: spec text converted to latexmstsirkin
This is simply virtio-v1.0-wd01-part1-specification.txt converted by txt2latex.pl Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@113 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25txt2latex.pl: don't put _ in labelsmstsirkin
This doesn't work well if _ is redefined, and is easy to avoid. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@112 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25txt2latex.pl: script to convert text to latexmstsirkin
The result compiles and looks kind of OK. This reverse-engineers our txt format to generate the initial latex file. Tables are included in verbatim sections. Code is included in listing sections. Math is escaped with $$. TODO (possibly manually): - remove extra sections at the beginning of the document - format tales using tabular or similar environment - format lists using itemize/enumerate/description - prevent hyphenation in the middle of identifiers Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@111 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25virtio: LaTeX: change the way the dotted lines are added in the TOCmstsirkin
Instead of using the tocloft package, which seems to collide with OASIS-style TOC headers, patch the report style. More hacky, less intrusive... Signed-off-by: Pawel Moll <pawel.moll@arm.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@110 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25virtio: LaTeX: Do not include leading numbers in the TOC linkmstsirkin
... making them black on the way. Warning! This is a hack and it depends on the hyperref package version. Signed-off-by: Pawel Moll <pawel.moll@arm.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@109 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25virtio: LaTeX: add dot lines for chapters in the TOCmstsirkin
Signed-off-by: Pawel Moll <pawel.moll@arm.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@108 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25makehtml: remove aux before generationmstsirkin
can be corrupt from previous runs. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@107 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25makepdf.sh: remove aux before generationmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@106 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25makepdf: run 3 timesmstsirkin
seems to be needed to resolve cross references. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@105 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25makehtml: use local t4ht stubmstsirkin
Fedora seems to ship a broken t4ht. Skip it. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@104 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25virtio: add latex templates from CMISmstsirkin
I imported latex templates from the CMIS specifications and changed s/CMIS/VIRTIO/ everywhere. The result is very close to one produced by exporting from the ODF we were supplied, with the exception of the TOC formatting, where section numbers are in blue instead of black, and major sections don't have dots leading to page numbers. I'm guessing this isn't very important, someone with more latex knowledge can try to figure this out. Generating html doesn't actually work for me. It doesn't work for me for CMIS either, so it's probably just an issue with my local latex setup. I'm not sure we need html output at all. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@103 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: fix up section cross referencesmstsirkin
Use consistent "number. name" everywhere. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@102 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: format tables in a uniform waymstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@101 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: format tables in a standard waymstsirkin
Make horisontal separators be +-----+ everywhere. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@100 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: indent more listingsmstsirkin
make sure all listings are indented with a leading tab. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@99 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: make code and only code have leading tabmstsirkin
Mostly true already, correct remaining issues. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@98 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: fix up cross-references for virtio-netmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@97 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: put section cross-references on a single linemstsirkin
Easier to handle them automatically this way. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@96 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25minor: add dots after section numbersmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@95 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25virtio: fix duplicate section numbersmstsirkin
make sure section numbers are unique. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@94 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-112.3.2 MMIO: Define reset requirementshornet
This patch addresses VIRTIO-47, adding explicit description of the device behaviour when being reset. As per meeting 2013-11-05 https://lists.oasis-open.org/archives/virtio/201311/msg00031.html Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@93 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-10virtio-pci: access device using configmstsirkin
VIRTIO-39. Accepted Nov 5, 2013 https://lists.oasis-open.org/archives/virtio/201311/msg00031.html Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@92 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-10compatibility: extendable config space and pci cfgmstsirkin
We often specify specific layout of config space, in the past drivers took this to mean "there will be no other fields" and failed devices where config space was larger. To avoid such issues in the future, document that drivers should only check size is >= the required value. VIRTIO-48 Accepted Nov 5, 2013 https://lists.oasis-open.org/archives/virtio/201311/msg00031.html Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@91 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-10pci: use revision id 1 or higher for non transitional devicesmstsirkin
VIRTIO-34 Accepted Nov 5, 2013 https://lists.oasis-open.org/archives/virtio/201311/msg00031.html Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@90 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-10pci: a note on non-transitional devicesmstsirkin
Add a note documenting handling legacy drivers for non transitional devices. VIRTIO-34 Accepted Nov 5, 2013 https://lists.oasis-open.org/archives/virtio/201311/msg00031.html Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@89 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-072.2.2.1: remove advice on notification for empty buffers.rusty
A driver can notify whenever it wants, but it should only make a difference to buggy devices. As per meeting 2013-11-05: http://markmail.org/message/3cjjeakzkfzcqk5c Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@88 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-072.2.1: Remove advice that reset is not req'd on startup.rusty
It's always good practice to reset a device. As per minutes of meeting 2013-11-05: http://markmail.org/message/3cjjeakzkfzcqk5c Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@87 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-05virtio-ccw: introduce revisionscornelia.huck
Provide a new ccw that allows devices and drivers to operate on selected revision levels. VIRTIO-42 Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@86 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-04typo fix: 8-bite->8-bitmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@85 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-04ccw: Improve indicator wording.cornelia.huck
Be clearer about traditional vs. adapter interrupts and virtqueue vs. configuration indicators. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@84 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-04ccw: Remove reference to old s390-virtio transport.cornelia.huck
Historical notes for a mechanism that was never officially specced do not add anything to the standard. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@83 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-04ccw: Tweak the comments on endianess.cornelia.huck
...just to make obvious that we're talking about the transmitted data. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@82 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-31CCW: Make it very clear that CCW channel commands are big-endian.rusty
Noone is likely to get confused, but let's be explicit since the rest of the spec is little-endian. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@81 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-31Remove __ annotations on pci.rusty
We use le32 etc elsewhere, make it consistent. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@80 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-31Thorough endianness notes for legacy.rusty
This is noted at the beginning of the spec, but let's make it explicit everywhere le32 etc is used. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@79 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-31Use le types in all non-legacy places.rusty
Emphasize that legacy endian was different, but change all the basic types to use le32 etc as a constant reminder. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@78 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-312.4.2.3.1 Legacy Interface: Feature bitsrusty
A previous patch put the device config layout in the middle of the legacy feature bits. Fix up now. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@77 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-31virtqueue endian-nessrusty
make all ring structures LE resolves VIRTIO-9 Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@76 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-31configuration space endian-nessrusty
make it all LE and require natural width accesses resolves VIRTIO-9 Signed-off-by: Michael S. Tsirkin <mst@redhat.com> Signed-off-by: Rusty Russell <rusty@au1.ibm.com> (rebase) git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@75 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-31Configuration (read) atomicity.rusty
Aka issue VIRTIO-35. This is solved per transport: 1) PCI: use the 8 bit reserved field. Assume that if you really change that fast, you'll do it lazily on config space read. 2) MMIO (already solved by v2 update) 3) CCW: no transport changes. They always read/write the entire thing. This just shows that Cornelia is smarter than I am. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@74 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-30virtio-ccw: clarify some channel I/O conceptscornelia.huck
Add the documents where channel I/O is generally described to the normative references and add some further words on command rejects and length checks. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@73 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-30virtio-ccw: add adapter interrupt supportcornelia.huck
Specify a new channel command to set up two-stage indicators as needed for adapter interrupts and describe how adapter interrupts are used for notifications. VIRTIO-43 Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@72 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-30Revert "virtio-ccw: introduce revisions"rusty
This reverts commit 663e7294691c6f76488d26c82a81f0d6d1e27593. Accidental commit; minutes say we defer. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@71 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-30virtio-ccw: split descriptor/available/used rings (alternate)rusty
Extend vq_info_block so that the addresses for descriptor table, available ring and used ring may be transmitted independently. VIRTIO-23 Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@70 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-30virtio-ccw: introduce revisionsrusty
Provide a new ccw that allows devices and drivers to operate on selected revision levels. VIRTIO-42 Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@69 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-292.3.2 MMIO: Add config space version registerhornet
... to allow synchronisation between the guest and the host. Based on Rusty's original patch, see VIRTIO-35. Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@68 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-292.3.2 MMIO: Upgrade registers layout to version 2hornet
This patch addresses VIRTIO-44: * Clarifies MagicValue content * Bumps up the Version value to 2 * Removes paged-based addressing and replaces it with 64 bit addresses * Replaces implicit queue organisation (based on alignment size) with explicit desc/avail/used addreses (based on original MST's patch, see VIRTIO-41) * Introduces explicit protocol for queue enabling (based on original MST's idea) and disabling * Defines driver's reaction to an invalid device ID (0x0). Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@67 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-152.3.2 MMIO: Reformatting the text, cont.hornet
Further indentation clean-up and non-ASCII characters hunt. Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@66 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-10-15virtio-ccw: clarify sense id operationcornelia.huck
Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@65 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652