History | View | Annotate | Download (10.8 kB)
Update documentation for LTTng ust tracing
Signed-off-by: Mohamad Gebai <mohamad.gebai@polymtl.ca>Reviewed-by: Alex Bennée <alex.bennee@linaro.org>Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
build: do not use TARGET_ARCH
TARGET_ARCH is generally wrong to use, there are better variablesprovided in config-target.mak. The right one is usually TARGET_NAME(previously TARGET_ARCH2), but for bsd-user we can also use TARGET_ABI_DIRfor consistency with linux-user....
trace: document ftrace backend
Add documentation of ftrace backend.
Signed-off-by: Eiichi Tsukata <eiichi.tsukata.xh@hitachi.com>Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
trace: Provide a detailed event control interface
This interface decouples event obtaining from interaction.
Events can be obtained through three different methods:
Signed-off-by: Lluís Vilanova <vilanova@ac.upc.edu>...
trace: Fix location of simpletrace.py in docs
Missed when commit 4c3b5a48 moved it.
Signed-off-by: Markus Armbruster <armbru@redhat.com>Reviewed-by: Laszlo Ersek <lersek@redhat.com>Reviewed-by: Harsh Prateek Bora <harsh@linux.vnet.ibm.com>Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
trace: Remove "info trace" from documents
commit 88affa1c monitor: remove unused do_info_trace
has removed "info trace" function from monitor, so remove it from documents.
Signed-off-by: Liming Wang <walimisdev@gmail.com>Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
trace: document '-' syntax for disabling events
Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
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>
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...
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:...
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>...
docs: Trace events must not expect pointer dereferencing
Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
docs/tracing.txt: minor documentation fixes
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....
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.
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.
trace: Add user documentation