Re: [Qemu-devel] [PATCH v8 1/5] hypertrace: Add documentation

[Eric Blake <eblake@redhat.com>]

[-- Attachment #1: Type: text/plain, Size: 1353 bytes --]

On 07/30/2017 09:12 AM, Lluís Vilanova wrote:
> Signed-off-by: Lluís Vilanova <vilanova@ac.upc.edu>
> ---
>  docs/devel/tracing.txt |    3 +
>  docs/hypertrace.txt    |  225 ++++++++++++++++++++++++++++++++++++++++++++++++

Do we want the new document directly in docs/, or does it live in one of
the subdirectories?

>  2 files changed, 228 insertions(+)
>  create mode 100644 docs/hypertrace.txt
> 
> diff --git a/docs/devel/tracing.txt b/docs/devel/tracing.txt
> index 5768a0b7a2..9178a308da 100644
> --- a/docs/devel/tracing.txt
> +++ b/docs/devel/tracing.txt
> @@ -5,6 +5,9 @@
>  This document describes the tracing infrastructure in QEMU and how to use it
>  for debugging, profiling, and observing execution.
>  
> +See "docs/hypertrace.txt" to correlate guest tracing events with those in the
> +QEMU host.

Depending on where it should live, this may need a tweak.


> +
> +The hypertrace channel allows guest code to emit events in QEMU (the host) using
> +its tracing infrastructure (see "docs/trace.txt"). This works in both 'system'

Stale filename; needs adjusting.

> +and 'user' modes. Therefore, hypertrace is to tracing what hypercalls are to
> +system calls.
> +


-- 
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3266
Virtualization:  qemu.org | libvirt.org


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 619 bytes --]