Spelling fixes in comments and documentation
These wrong spellings were detected by codespell:
["also is" -> "is also" and "ressources" -> "resources" suggested by...
docs: Fix spelling (propery -> property)
Signed-off-by: Stefan Weil <sw@weilnetz.de>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
Merge remote-tracking branch 'qmp/queue/qmp' into staging
docs: writing-qmp-commands.txt: update error section
Add information about the new error format and improve the text a bit.
Signed-off-by: Luiz Capitulino <lcapitulino@redhat.com>Reviewed-by: Markus Armbruster <armbru@redhat.com>
Add XBZRLE documentation
Signed-off-by: Orit Wasserman <owasserm@redhat.com>
Reviewed-by: Luiz Capitulino <lcapitulino@redhat.com>Reviewed-by: Eric Blake <eblake@redhat.com>
docs: add dirty bit to qcow2 specification
The dirty bit will make it possible to perform lazy refcount updates,where the image file is not kept consistent all the time. Upon openinga dirty image file, it is necessary to perform a consistency check and...
docs: add lazy refcounts bit to qcow2 specification
The lazy refcounts bit indicates that this image can take advantage ofthe dirty bit and that refcount updates can be postponed.
Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Merge remote-tracking branch 'stefanha/net' into staging
qapi: fix error propagation
Don't overwrite / leak previously set errors.Make traversal cope with missing mandatory sub-structs.Don't try to end a container that could not be started.
v1->v2:- unchanged
v2->v3:- instead of examining, assert that we never overwrite errors with...
Fix some more Qemus in documentation and help text
Hopefully they will be eliminated one day.
usb: add usb attached scsi emulation
$subject says all. First cut.
It's a pure UAS (usb attached scsi) emulation, without BOT (bulk-onlytransport) compatibility. If your guest can't handle it use usb-storageinstead.
The emulation works like any other scsi hba emulation (eps, lsi, virtio,...
spapr: Add "memop" hypercall
This adds a qemu-specific hypervisor call to the pseries machinewhich allows to do what amounts to memmove, memcpy and xor overregions of physical memory such as the framebuffer.
This is the simplest way to get usable framebuffer speed from...
xhci: add usage info to docs
Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
docs: fix one issue in qcow2 specs
Signed-off-by: Zhi Yong Wu <wuzhy@linux.vnet.ibm.com>Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Specification for qcow2 version 3
This updates the qcow2 specification to cover version 3. It contains thefollowing changes:
- Added compatible/incompatible/auto-clear feature bits plus an optional feature name table to allow useful error messages even if an older...
acpi_piix4: Remove PCI_RMV_BASE write code
Clarify this register as read-only and remove write code. Nochange in existing behavior.
Signed-off-by: Alex Williamson <alex.williamson@redhat.com>Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
acpi_piix4: Re-define PCI hotplug eject register read
The PCI hotplug eject register has always returned 0, so let's redefineit as a hotplug feature register. The existing model of using separateup & down read-only registers and an eject via write to this register...
acpi_piix4: Disallow write to up/down PCI hotplug registers
The write side of these registers is never used and actually can't beused as defined because any read/modify/write sequence from the guestpotentially races with qemu. Drop the write support and define these...
Replace Qemu by QEMU in internal documentation
The official spelling is QEMU.
Signed-off-by: Stefan Weil <sw@weilnetz.de>Reviewed-by: Andreas Färber <afaerber@suse.de>Signed-off-by: Blue Swirl <blauwirbel@gmail.com>
qapi: untangle next_list
Right now, the semantics of next_list are complicated. The caller must:
Merge remote-tracking branch 'sstabellini/saverestore-8' into staging
Introduce "xen-save-devices-state"
- add an "is_ram" flag to SaveStateEntry;
- register_savevm_live sets is_ram for live_savevm devices;
- introduce a "xen-save-devices-state" QAPI command that can be used to savethe state of all devices, but not the RAM or the block devices of the...
trace: Provide a per-event status define for conditional compilation
Adds a 'TRACE_${NAME}_ENABLED' preprocessor define for each tracing event in"trace.h".
This lets the user conditionally compile code with a relatively high executioncost that is only necessary when producing the tracing information for an event...
docs: correct ./configure line in tracing.txt
This patch corrects the configure's trace option in docs/tracing.txt.
Signed-off-by: Jun Koi <junkoi2004@gmail.com>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
libcacard: Spelling and grammar fixes in documentation
v2:Also replace 'aid' by 'AID' (thanks to Peter Maydell for this hint)....
docs: describe live block operations
Signed-off-by: Marcelo Tosatti <mtosatti@redhat.com>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Codespell detected these new spelling issues.
Merge remote-tracking branch 'qemu-kvm/memory/mutators' into staging
Conflicts: memory.h
qcow2: Allow >4 GB VM state
This is a compatible extension to the snapshot header format that allowssaving a 64 bit VM state size.
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Merge remote-tracking branch 'stefanha/trivial-patches-next' into staging
docs: document memory API interaction with migration
Signed-off-by: Avi Kivity <avi@redhat.com>
docs: Add writing-qmp-commands.txt
Explains how to write QMP commands using the QAPI.
Signed-off-by: Luiz Capitulino <lcapitulino@redhat.com>
memory: minor documentation fixes/enhancements
Fix typos and minor documentation errors in both memory.h anddocs/memory.txt.
Also add missing documentation formatting tags to transactionfunctions.
Reviewed-by: Stefan Weil <sw@weilnetz.de>Signed-off-by: Ademar de Souza Reis Jr <areis@redhat.com>...
Fixing some spelling in docs/libcacard.txt
Reviewed-by: Alon Levy <alevy@redhat.com>Signed-off-by: Matthias Brugger <matthias.bgg@gmail.com>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
Fix spelling in documentation and comments (similiar -> similar)
This bug was detected by codespell.In mips_mipssim.c a grammatical error was fixed, too.
Fix some spelling bugs in documentation and comments
These errors were detected by codespell:
remaing -> remainingsoley -> solelyvirutal -> virtualseperate -> separate
libcacard.txt still needs some more patches.
Signed-off-by: Stefan Weil <sw@weilnetz.de>...
Merge remote-tracking branch 'stefanha/tracing' into staging
trace: Add wildcard trace event support
A basic wildcard matching is supported in both the monitor command"trace-event" and the events list file. That means you can enable/disablethe events having a common prefix in a batch. For example, virtio-blk trace...
qapi: fix typos in documentation JSON examples
Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
qcow2: fix some errors and typo in qcow2.txt
trace: Update docs to use example events that exist
The events 'qemu_malloc' and 'qemu_free' used in the examples no longer exist,so use 'qemu_vmalloc' and 'qemu_vfree' instead.
Signed-off-by: Lluís Vilanova <vilanova@ac.upc.edu>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
trace: allow trace events with string arguments
String arguments are useful for producing human-readable traces withoutpost-processing (e.g. stderr backend). Although the simple backendcannot handles strings all others can. Strings should be allowed and...
trace: allow PRI*64 at beginning and ending of format string
The tracetool parser only picks up PRI*64 and other format string macroswhen enclosed between double quoted strings. Lift this restriction byextracting everything after the closing ')' as the format string:...
docs: Fix qdev-device-use.txt typo in -chardev serial, path=COM<NUM>
Signed-off-by: Markus Armbruster <armbru@redhat.com>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
trace: generalize the "property" concept in the trace-events file
This adds/modifies the following functions:
Signed-off-by: Lluís Vilanova <vilanova@ac.upc.edu>
trace: always compile support for controlling and querying trace event states
The current interface is generic for this small set of operations, and thusother backends can easily modify the "trace/control.c" file to add their ownimplementation.
trace: add "-trace events" argument to control initial state
The "-trace events" argument can be used to provide a file with a list of traceevent names that will be enabled prior to starting execution, thus providingearly tracing.
This saves the user from manually toggling event states through the monitor...
trace: always use the "nop" backend on events with the "disable" keyword
Any event with the keyword/property "disable" generates an empty trace eventusing the "nop" backend, regardless of the current backend.
trace: [simple] disable all trace points by default
Note that this refers to the backend-specific state (whether the output must begenerated), not the event "disabled" property (which always uses the "nop" backend).
trace: [stderr] add support for dynamically enabling/disabling events
Uses the generic interface provided in "trace/control.h" in order to providea programmatic interface as well as command line and monitor controls.
Signed-off-by: Fabien Chouteau <chouteau@adacore.com>...
Fix spelling in comments and debug messages (recieve -> receive)
Signed-off-by: Stefan Weil <weil@mail.berlios.de>Reviewed-by: Andreas Färber <andreas.faerber@web.de>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
memory: correct documentation typos
Noted by Drew Jones.
Signed-off-by: Avi Kivity <avi@redhat.com>Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
Add memory API documentation
qapi: add QAPI code generation documentation
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>Signed-off-by: Luiz Capitulino <lcapitulino@gmail.com>
usb: update documentation
Add a paragraph on companion controller mode and aconfiguration file which sets it all up for you.
Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
usb: documentation update
Add some more informations to docs/usb2.txt about using usb2 (also usb1)devices.
docs: qdev-device-use.txt has become stale, update it
Document more bus addresses.
Update for bugs fixed.
Describe where exactly the -drive options go.
Update for recent split of qdev ide-drive into ide-{cd,hd},scsi-disk into scsi-{cd,hd}.
Document scsi-hd's removable property only for usb-storage, because...
usb: add ehci adapter
This patch finally merges the EHCI host adapter aka USB 2.0 support.
Based on the ehci bits collected @ git://git.kiszka.org/qemu.git ehci
EHCI has a long out-of-tree history. Project was started by MarkBurkley, with contributions by Niels de Vos. David S. Ahern continued...
docs: Trace events must not expect pointer dereferencing
docs/tracing.txt: minor documentation fixes
docs: Describe zero data clusters in QED specification
Zero data clusters are a space-efficient way of storing zeroed regionsof the image.
libcacard: add docs
ccid: add docs
Add documentation for the usb-ccid device and accompanying two carddevices, ccid-card-emulated and ccid-card-passthru.
Signed-off-by: Alon Levy <alevy@redhat.com>
Add qcow2 documentation
This adds a description of the qcow2 file format to the docs/ directory.Besides documenting what's there, which is never wrong, the document shouldprovide a good basis for the discussion of format extensions (called "qcow3" in previous discussions)...
simpletrace: Thread-safe tracing
Trace events outside the global mutex cannot be used with the simpletrace backend since it is not thread-safe. There is no check to preventthem being enabled so people sometimes learn this the hard way.
This patch restructures the simple trace backend with a ring buffer...
docs: Update stderr and simple backend, add systemtap backend
The following additions to the tracing documentation are included:
1. Move "stderr" backend documentation to top-level and out of "simple" backend. Include hints on when this backend is useful....
Add boot index documentation.
Signed-off-by: Gleb Natapov <gleb@redhat.com>Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
New trace-event backend: stderr
This backend sends trace events to standard error output during the emulation.
Also add a "--list-backends" option to tracetool, so configure script candisplay the list of available backends.
docs: Document scsi-disk and usb-storage removable parameter
document QEMU<->ACPIBIOS PCI hotplug interface
Document how QEMU communicates with ACPI BIOS for PCI hotplug.
Signed-off-by: Marcelo Tosatti <mtosatti@redhat.com>Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
docs: Document virtio PCI -device ioeventfd=on|off
docs: Fix missing carets in QED specification
For some reason the carets ('^') in the QED specification disappeared.This patch puts them back.
docs: Add QED image format specification
trace: Format strings must begin/end with double quotes
Document the restriction that format strings must begin and end withdouble quotes. This is for easy parsing since we don't run cpp overtrace-events.
Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>...
trace: Use portable format strings
It is not portable to use "%ld" for int64_t because int64_t may havetype long on 64-bit platforms and long long on 32-bit platforms. Usethe standard library PRId64 macros to keep format strings portable.
docs: Improve documentation
Fix some inconsistencies (tabs and punctuation)and try to improve grammar and spelling.
Cc: Juan Quintela <quintela@redhat.com>Signed-off-by: Stefan Weil <weil@mail.berlios.de>
blkverify: Add block driver for verifying I/O
The blkverify block driver makes investigating image format datacorruption much easier. A raw image initialized with the same contentsas the test image (e.g. qcow2 file) must be provided. The raw imagemirrors read/write operations and is used to verify that data read from...
trace: Add user documentation
Device specification for shared memory PCI device
Signed-off-by: Cam Macdonell <cam@cs.ualberta.ca>Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
Initial documentation for migration
Signed-off-by: Juan Quintela <quintela@redhat.com>Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
docs: New qdev-device-use.txt
Signed-off-by: Markus Armbruster <armbru@redhat.com>Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>