summaryrefslogtreecommitdiff
AgeCommit message (Collapse)Author
2013-11-25tex: fix html build: add packagesmstsirkin
tabularx is required. Things seem to build without underscore but just in case let's import it too. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@122 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25content.tex: manual legacy pci device layoutmstsirkin
rewrite legacy pci device layout using tabularx. it was too wide for verbatim to lay out reasonably. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@121 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25content.tex: manually fix malformed tablemstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@120 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25content.tex: fix up cross-reference to S390mstsirkin
make it a hyper-link. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@119 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25content.tex: drop text moved to introduction.texmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@118 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25introduction.tex: import from text documentmstsirkin
manually import introduction from main text. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@117 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25latex: add a commentmstsirkin
Add a comment about an alternative to \usepackage{underscore}, in case we'll want to use it in the future. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@116 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-11-25latex: include content.texmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@115 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
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