summaryrefslogtreecommitdiff
AgeCommit message (Collapse)Author
2014-01-17Fixes for first WD front page.rusty
Based on feedback from Paul Knight <paul.knight@oasis-open.org>. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@184 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2014-01-12html: Convert ligatures into normal ASCII charactermstsirkin
Seems to work for me, although I don't know exactly why (I have a feeling, but no proof ;-) 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@183 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2014-01-12makehtml.sh: drop workaround, add warningmstsirkin
Issues in html generation turn out to be due to tex4ht being unable to find fonts due to misconfigured font paths. As we are unable to work-around them properly anyway replace work-around with a warning and print suggestions for fixing the config. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@182 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2014-01-12README: note on issues and work-aroundsmstsirkin
Document that makehtml needs to be edited to use workaround. Document that paths need to be adjusted if copying config from an old installation. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@181 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2014-01-12.exrc: rename to _vimrcmstsirkin
.exrc is not allowed in the OASIS Library, since "dot" files are special files in file system. They are specifically disallowed by the Naming Directives [1] : "Filenames and directory names must neither begin nor end with a punctuation character (period or hyphen). [...]" Rename to _vimrc which also works - from vim help: d. If the 'exrc' option is on (which is not the default), the current directory is searched for three files. The first that exists is used, the others are ignored. - The file ".vimrc" (for Unix, Amiga and OS/2) (*) "_vimrc" (for MS-DOS and Win32) (*) - The file "_vimrc" (for Unix, Amiga and OS/2) (*) ".vimrc" (for MS-DOS and Win32) (*) - The file ".exrc" (for Unix, Amiga and OS/2) "_exrc" (for MS-DOS and Win32) Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@180 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2014-01-03mmio: Obviously wrong notification register namehornet
The "4.2.3.3 Notifying The Device" section said "writing the index of the updated queue to the QueueNum". This is obviously wrong - should read "QueueNotify". Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@179 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-16title & acknowledgements: Make ARM less limitedhornet
... by removing the "Limited" bit of the name. Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@178 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-162.3.2 MMIO: Configuration space offset correctedhornet
The offset in the MMIO configuration space description (table 4.1) became wrong at some time (0x0fff). Fixed. Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@177 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-122.3.2 MMIO: Notifications & interrupts clarificationshornet
(Hopefully) clarified the way notifications are being passed between the device and the driver and about the meaning of the interrupt registers. Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@176 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-121. Introduction: Removed left-over "PCI"hornet
The "Extensible" paragraph of the introduction still referred to "Virtio PCI devices". Changed to "Virtio devices". Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@175 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-122.3.2 MMIO: Further clarificationshornet
Clarified driver behaviour for out-of-spec MagicValue, Version and DeviceID values. Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@174 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-12ccw: feature bit endiannesscornelia.huck
In contrast to the other values transmitted in ccw payload, feature bits are little endian. Fix it in the structure definition. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@173 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-12ccw: clarify passing of subchannel idcornelia.huck
Make clear that the upper half of the register must be ignored, just like normal I/O instructions do. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@172 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-12ccw: Tighten specification language.cornelia.huck
must -> MUST changes, removed inappropriate mays. Signed-off-by: Cornelia Huck <cornelia.huck@de.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@171 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-092.3.2 MMIO: LaTeXisationhornet
Converter the register layout descriptions into tables. Also hardened the specification language, using MUSTs and MUST NOTs. Signed-off-by: Pawel Moll <pawel.moll@arm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@170 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08virtio-html: add right and left borders for tablesmstsirkin
In html version our tables lack vertical separators, that's ugly. Tweak config file for htlatex to add these. htlatex wants to use hr for horizontal separation (presumably for portability?) So add only vertical borders using CSS. Note: pdf version has a dual line after 1st column in each row, I didn't figure out how to make this with htlatex yet. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@169 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08commands-pdf.tex: align title pagemstsirkin
Section titles are currently misaligned on the title page. This patch aligns them back. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@168 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08net: document VIRTIO_NET_F_MAC_ADDRmstsirkin
VIRTIO-50 commit f058954d131e3dc73058778ad23b241a235ae8e1 virtio-spec: set mac address by a new vq command Approved Dec 3, 2013 Reported-by: Francesco Fusco <ffusco@redhat.com> Signed-off-by: Amos Kong <akong@redhat.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@167 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08net: add _F_MQ supportmstsirkin
VIRTIO-49 Includes git commits: 3c600996f641614d3720c94dd52155aaaba670fa virtio-spec: fix two typos commit 67023431c8796bc430ec0a79b15bab57e2e0f1f6 virtio-spec: virtio network device multiqueue support commit a02d91f8729b4a333d525015d22138a86ce9b644 net: add note that you can defer rx queue init until mq enable. Approved Dec 3, 2013 Reported-by: Francesco Fusco <ffusco@redhat.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@166 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08REVISION: wd02mstsirkin
As we are working towards csd02, change default spec file name. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@165 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08REVISION: virtio-v1.0-csprd01mstsirkin
This revision was approved at VIRTIO TC Meeting, 3 December 2013 Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@164 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08makeall.sh: take revision from REVISION by defaultmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@163 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08REVISION: virtio v1.0 csd01mstsirkin
This version was approved as v1.0 csd01 on Tue, Dec 03, 2013 Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@162 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08makeall.sh: support generating archive from svnmstsirkin
Not everyone's using git ... Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@161 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-08remove .txt format filemstsirkin
It's out of date anyway by now Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@160 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-03title.tex: add space before and after URLsmstsirkin
Something seems to eat up space right before and after a urldef call unless we protect it with { }. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@159 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-03title.tex: fix citation format as suggested by Chetmstsirkin
Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@158 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-03virtio-html.tex: add hrulefill before each chaptermstsirkin
Same as we have in PDF. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@157 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-03More formatting fixes from Chet's suggestions:rusty
1) Indented pdf subtitles correctly. 2) Correct wording for public review drafts 3) Include footnote html files. 4) "approved by VIRTIO" not "members of OASIS" 5) "OASIS Standard" in citation section changed to depend on filename. 6) URL in citation section fixed. 7) Footnotes in HTML version are all consecutively numbered. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@156 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-03acknowledgements.tex: tweak MST's namemstsirkin
I prefer it when the S. initial is included. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@155 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-03Remove suggestion to use old virtualization list for number assignment.rusty
Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@154 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-03Formatting repair as per Chet's feedback.rusty
1) Populate TC member list. 2) Remove Non-Normative References section 3) Fix URLs to point to correct place. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@153 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-034.1.2.5: Make table clearerrusty
As suggested by Cornelia Huck. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@152 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-02tex: fix some urlsmstsirkin
replace 1.0 with v1.0 make urls work correctly in html Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@151 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-02tex: s/item:/itm:/mstsirkin
It is preferable to use standard prefixes for labels, in case we ever want to use fancyref. See http://en.wikibooks.org/wiki/LaTeX/Labels_and_Cross-referencing Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@150 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-02content.tex: fix html buildmstsirkin
_ should not be used in labels Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@149 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-02latexify document more.rusty
This change: - Turns formatted lists into real lists (itemize, etc). - Turns ascii tables into real tables. - Use \ldots for ... - Moves \footnote to immediately after what it refers to, otherwise we get awkward whitespace before the superscript. - List of stats for balloon contains values in () to match other lists. - Puts lstlisting around CCW code example - Cross references to numbered steps, rather than hardcoded (2) etc. No actual contents changed. Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@148 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-02Specify requirements more clearly.rusty
The spec language is mostly written with a view to driver authors, and contains assumptions, eg: The Device Status field is updated by the OS and driver... But the spec is for both device and driver authors. It should specify exactly what is to be done, and by whom, eg: The driver MUST update the Device Status field... 1) Change from passive to active (eg "foo must be reset" => "driver must reset foo"). 2) Upcase SHOULD, MUST etc. There are probably more that I missed. 3) Make the following requirements explicit: - The driver must not clear device status bits. - Make bad on looped descriptors explicit. - Driver must not set VRING_DESC_F_INDIRECT unless negotiated feature. - Available/used ring sections rewritten to be more explicit that driver must not set VRING_AVAIL_F_NO_INTERRUPT. - Following device initialization sequence is a MUST. - Driver must not continue initialization if it sets FAILED. - "memory barriers" are now a MUST, though the weasel-word "suitable" was added. - Driver MUST notify device. 4) Misc changes: - Use "device offers" / "driver accepts" language for feature negotiation. - config space always uses little-endian, remove 'generally'. - "descriptor chain" term used everywhere. - Extraneous "+" deleted. - Remove "Unless explicitly specified otherwise" from PCI spec endian sentence. - Refer to notify_off_multiplier in queue_notify_off discussion. Signed-off-by: Rusty Russell <rusty@au.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@147 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-02pci: fix config notify bit.rusty
The Linux code uses 0x2, so I assume second lowest bit is right... Signed-off-by: Rusty Russell <rusty@au1.ibm.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@146 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-02Terminology: Device and driver, not host and guest.rusty
We've mixed both together, whereas from a spec-reader point of view, "driver" and "device" is probably clearer. CCW part incorporated: Switch the parts of the virtio-ccw specification that did not already to device/driver instead of guest/host. For more general discussions, host/guest is kept (like when talking about guest<->host notifications in general). This should make things more consistent. 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@145 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01tex: fix links in generated htmlmstsirkin
Use \urldef to make them expand macros. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@144 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01title.tex: fix typo in macro usagemstsirkin
missing \ Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@143 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01tex: tweak generated output file namesmstsirkin
Tweak output to match oasis requirements. Make it possible to specify output name through environment, and set draft stage and version automatically. Add script to export all files in a zip archive. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@142 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01html: rename filemstsirkin
htlatex doesn't seem to support -jobname for output file name, so simply rename file before processing. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@141 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01tex: rename filemstsirkin
Rename virtio-v1.0-csd01.tex to virtio.tex, so we don't have to rename before use. Use --jobname for output. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@140 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01introduction.tex: import abstractmstsirkin
import abstract from abstract.tex Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@139 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01title.tex: add abstractmstsirkin
import from abstract.tex Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@138 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01abstract.tex: add abstractmstsirkin
move it out of introduction.tex, use \input to avoid duplication. Fix a minor typo (the the). Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@137 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01title.tex: comment out unused textmstsirkin
We don't have related work and xml namespaces, so comment them out. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@136 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652
2013-12-01title.tex: prettify slightlymstsirkin
Remove an ugly vfill, nicer to have space at bottom of page. Signed-off-by: Michael S. Tsirkin <mst@redhat.com> git-svn-id: https://tools.oasis-open.org/version-control/svn/virtio@135 0c8fb4dd-22a2-4bb5-bc14-6c75a5f43652