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>
Spelling fixes in comments and documentation
Codespell detected these new spelling issues.
Signed-off-by: Stefan Weil <sw@weilnetz.de>Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
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
Signed-off-by: Zhi Yong Wu <wuzhy@linux.vnet.ibm.com>Signed-off-by: Kevin Wolf <kwolf@redhat.com>
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.
Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>Signed-off-by: Kevin Wolf <kwolf@redhat.com>
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>