Show a cover letter.

GET /api/covers/810734/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 810734,
    "url": "http://patchwork.ozlabs.org/api/covers/810734/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/cover/150471856141.24907.274176769201097378.stgit@frigg.lan/",
    "project": {
        "id": 14,
        "url": "http://patchwork.ozlabs.org/api/projects/14/?format=api",
        "name": "QEMU Development",
        "link_name": "qemu-devel",
        "list_id": "qemu-devel.nongnu.org",
        "list_email": "qemu-devel@nongnu.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": "",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<150471856141.24907.274176769201097378.stgit@frigg.lan>",
    "list_archive_url": null,
    "date": "2017-09-06T17:22:41",
    "name": "[v4,00/20] instrument: Add basic event instrumentation",
    "submitter": {
        "id": 9099,
        "url": "http://patchwork.ozlabs.org/api/people/9099/?format=api",
        "name": "Lluís Vilanova",
        "email": "vilanova@ac.upc.edu"
    },
    "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/cover/150471856141.24907.274176769201097378.stgit@frigg.lan/mbox/",
    "series": [
        {
            "id": 1859,
            "url": "http://patchwork.ozlabs.org/api/series/1859/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=1859",
            "date": "2017-09-06T17:22:41",
            "name": "instrument: Add basic event instrumentation",
            "version": 4,
            "mbox": "http://patchwork.ozlabs.org/series/1859/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/covers/810734/comments/",
    "headers": {
        "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>",
        "X-Original-To": "incoming@patchwork.ozlabs.org",
        "Delivered-To": "patchwork-incoming@bilbo.ozlabs.org",
        "Authentication-Results": "ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=nongnu.org\n\t(client-ip=2001:4830:134:3::11; helo=lists.gnu.org;\n\tenvelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n\treceiver=<UNKNOWN>)",
        "Received": [
            "from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11])\n\t(using TLSv1 with cipher AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 3xnVmR07Rpz9t2d\n\tfor <incoming@patchwork.ozlabs.org>;\n\tThu,  7 Sep 2017 03:23:34 +1000 (AEST)",
            "from localhost ([::1]:37244 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>)\n\tid 1dpe32-0007Mk-I1\n\tfor incoming@patchwork.ozlabs.org; Wed, 06 Sep 2017 13:23:32 -0400",
            "from eggs.gnu.org ([2001:4830:134:3::10]:35889)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from <vilanova@ac.upc.edu>) id 1dpe2X-0007MS-1A\n\tfor qemu-devel@nongnu.org; Wed, 06 Sep 2017 13:23:02 -0400",
            "from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from <vilanova@ac.upc.edu>) id 1dpe2Q-0000cx-VS\n\tfor qemu-devel@nongnu.org; Wed, 06 Sep 2017 13:23:01 -0400",
            "from roura.ac.upc.es ([147.83.33.10]:55258)\n\tby eggs.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from <vilanova@ac.upc.edu>) id 1dpe2Q-0000bS-Ex\n\tfor qemu-devel@nongnu.org; Wed, 06 Sep 2017 13:22:54 -0400",
            "from correu-2.ac.upc.es (correu-2.ac.upc.es [147.83.30.92])\n\tby roura.ac.upc.es (8.13.8/8.13.8) with ESMTP id v86HMn4A003659;\n\tWed, 6 Sep 2017 19:22:49 +0200",
            "from localhost (unknown [31.210.187.58])\n\tby correu-2.ac.upc.es (Postfix) with ESMTPSA id 81C1633A;\n\tWed,  6 Sep 2017 19:22:43 +0200 (CEST)"
        ],
        "From": "=?utf-8?b?TGx1w61z?= Vilanova <vilanova@ac.upc.edu>",
        "To": "qemu-devel@nongnu.org",
        "Date": "Wed,  6 Sep 2017 20:22:41 +0300",
        "Message-Id": "<150471856141.24907.274176769201097378.stgit@frigg.lan>",
        "X-Mailer": "git-send-email 2.14.1",
        "User-Agent": "StGit/0.17.1-dirty",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "quoted-printable",
        "X-MIME-Autoconverted": "from 8bit to quoted-printable by roura.ac.upc.es id\n\tv86HMn4A003659",
        "X-detected-operating-system": "by eggs.gnu.org: GNU/Linux 2.6.x [fuzzy]",
        "X-Received-From": "147.83.33.10",
        "Subject": "[Qemu-devel] [PATCH v4 00/20] instrument: Add basic event\n\tinstrumentation",
        "X-BeenThere": "qemu-devel@nongnu.org",
        "X-Mailman-Version": "2.1.21",
        "Precedence": "list",
        "List-Id": "<qemu-devel.nongnu.org>",
        "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n\t<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>",
        "List-Archive": "<http://lists.nongnu.org/archive/html/qemu-devel/>",
        "List-Post": "<mailto:qemu-devel@nongnu.org>",
        "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>",
        "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n\t<mailto:qemu-devel-request@nongnu.org?subject=subscribe>",
        "Cc": "\"Emilio G. Cota\" <cota@braap.org>, Stefan Hajnoczi <stefanha@redhat.com>",
        "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org",
        "Sender": "\"Qemu-devel\"\n\t<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>"
    },
    "content": "This series adds an API to add instrumentation events.\n\nIt also provides additional APIs for:\n* Controlling tracing events\n* Peek/poke guest memory\n\nThere's still missing APIs for (can be added in later series?):\n* Provide something like tracing's per-vCPU trace states (i.e., so that each\n  vCPU can have different instrumentation code). It's still not clear to me if\n  we should extend the per-vCPU bitmap with instrumentation events, or otherwise\n  somehow reuse the bits in tracing events (since they're currently limited).\n* Peek/poke guest registers\n\nThe instrumentation code is dynamically loaded as a library into QEMU either\nwhen it starts or later using its remote control interfaces.\n\nSigned-off-by: Lluís Vilanova <vilanova@ac.upc.edu>\n---\n\nChanges in v4\n=============\n\n* Add missing stub function.\n\n\nChanges in v3\n=============\n\n* Use a separate event set for instrumentation (i.e., do not instrument tracing\n  events) [Stefan Hajnoczi].\n* Add API for peek/poke guest memory.\n\n\nChanges in v2\n=============\n\n* Update QEMU version in QAPI [Eric Blake].\n* Clarify 'msg' result in QAPI is for humans only.\n* Make 'msg' and 'handle' results optional in QAPI.\n* Use a list of 'str' in 'instr-load' QAPI command.\n* Update MAINTAINERS.\n* Add macros for error-reporting in API.\n\n\nLluís Vilanova (20):\n      instrument: Add documentation\n      instrument: Add configure-time flag\n      instrument: Add generic library loader\n      instrument: [linux-user] Add command line library loader\n      instrument: [bsd-user] Add command line library loader\n      instrument: [softmmu] Add command line library loader\n      instrument: [qapi] Add library loader\n      instrument: [hmp] Add library loader\n      instrument: Add basic control interface\n      instrument: Add support for tracing events\n      instrument: Track vCPUs\n      instrument: Add event 'guest_cpu_enter'\n      instrument: Add event 'guest_cpu_exit'\n      instrument: Add event 'guest_cpu_reset'\n      trace: Introduce a proper structure to describe memory accesses\n      instrument: Add event 'guest_mem_before_trans'\n      instrument: Add event 'guest_mem_before_exec'\n      instrument: Add event 'guest_user_syscall'\n      instrument: Add event 'guest_user_syscall_ret'\n      instrument: Add API to manipulate guest memory\n\n\n .gitignore                                |    1 \n MAINTAINERS                               |    7 +\n Makefile                                  |    8 +\n Makefile.objs                             |    4 +\n Makefile.target                           |    1 \n bsd-user/main.c                           |   15 ++\n bsd-user/syscall.c                        |   11 ++\n configure                                 |   12 ++\n cpus-common.c                             |    9 +\n docs/instrument.txt                       |  174 ++++++++++++++++++++++++++\n hmp-commands.hx                           |   28 ++++\n include/exec/cpu_ldst_template.h          |   19 +--\n include/exec/cpu_ldst_useronly_template.h |   19 +--\n include/exec/helper-gen.h                 |    1 \n include/exec/helper-proto.h               |    1 \n include/exec/helper-tcg.h                 |    1 \n instrument/Makefile.objs                  |    9 +\n instrument/cmdline.c                      |  124 ++++++++++++++++++\n instrument/cmdline.h                      |   49 +++++++\n instrument/control.c                      |  148 ++++++++++++++++++++++\n instrument/control.h                      |  123 ++++++++++++++++++\n instrument/control.inc.h                  |   56 ++++++++\n instrument/error.h                        |   34 +++++\n instrument/events.h                       |   86 +++++++++++++\n instrument/events.inc.h                   |  108 ++++++++++++++++\n instrument/helpers.h                      |    1 \n instrument/load.c                         |  196 +++++++++++++++++++++++++++++\n instrument/load.h                         |   87 +++++++++++++\n instrument/qemu-instr/control.h           |  169 +++++++++++++++++++++++++\n instrument/qemu-instr/state.h             |  104 +++++++++++++++\n instrument/qemu-instr/types.h             |  115 +++++++++++++++++\n instrument/qemu-instr/types.inc.h         |   15 ++\n instrument/qemu-instr/visibility.h        |   58 +++++++++\n instrument/qmp.c                          |   88 +++++++++++++\n instrument/state.c                        |   72 +++++++++++\n instrument/trace.c                        |  125 ++++++++++++++++++\n linux-user/main.c                         |   19 +++\n linux-user/syscall.c                      |    6 +\n monitor.c                                 |   60 +++++++++\n qapi-schema.json                          |    3 \n qapi/instrument.json                      |   96 ++++++++++++++\n qemu-options.hx                           |   19 +++\n qom/cpu.c                                 |    2 \n stubs/Makefile.objs                       |    1 \n stubs/instrument.c                        |   25 ++++\n tcg/tcg-op.c                              |   27 +++-\n trace/control-target.c                    |    2 \n trace/control.c                           |    4 -\n trace/control.h                           |   24 ++++\n trace/mem-internal.h                      |   22 ++-\n trace/mem.h                               |    8 +\n vl.c                                      |   15 ++\n 52 files changed, 2371 insertions(+), 40 deletions(-)\n create mode 100644 docs/instrument.txt\n create mode 100644 instrument/Makefile.objs\n create mode 100644 instrument/cmdline.c\n create mode 100644 instrument/cmdline.h\n create mode 100644 instrument/control.c\n create mode 100644 instrument/control.h\n create mode 100644 instrument/control.inc.h\n create mode 100644 instrument/error.h\n create mode 100644 instrument/events.h\n create mode 100644 instrument/events.inc.h\n create mode 100644 instrument/helpers.h\n create mode 100644 instrument/load.c\n create mode 100644 instrument/load.h\n create mode 100644 instrument/qemu-instr/control.h\n create mode 100644 instrument/qemu-instr/state.h\n create mode 100644 instrument/qemu-instr/types.h\n create mode 100644 instrument/qemu-instr/types.inc.h\n create mode 100644 instrument/qemu-instr/visibility.h\n create mode 100644 instrument/qmp.c\n create mode 100644 instrument/state.c\n create mode 100644 instrument/trace.c\n create mode 100644 qapi/instrument.json\n create mode 100644 stubs/instrument.c\n\n\nTo: qemu-devel@nongnu.org\nCc: Stefan Hajnoczi <stefanha@redhat.com>\nCc: Emilio G. Cota <cota@braap.org>\nCc: Eric Blake <eblake@redhat.com>"
}