xref: /qemu/qapi/trace.json (revision 261f4d6d)
1# -*- mode: python -*-
2#
3# Copyright (C) 2011-2014 Lluís Vilanova <vilanova@ac.upc.edu>
4#
5# This work is licensed under the terms of the GNU GPL, version 2 or later.
6# See the COPYING file in the top-level directory.
7
8
9##
10# @TraceEventState:
11#
12# State of a tracing event.
13#
14# @unavailable: The event is statically disabled.
15#
16# @disabled: The event is dynamically disabled.
17#
18# @enabled: The event is dynamically enabled.
19#
20# Since 2.2
21##
22{ 'enum': 'TraceEventState',
23  'data': ['unavailable', 'disabled', 'enabled'] }
24
25##
26# @TraceEventInfo:
27#
28# Information of a tracing event.
29#
30# @name: Event name.
31# @state: Tracing state.
32#
33# Since 2.2
34##
35{ 'struct': 'TraceEventInfo',
36  'data': {'name': 'str', 'state': 'TraceEventState'} }
37
38##
39# @trace-event-get-state:
40#
41# Query the state of events.
42#
43# @name: Event name pattern (case-sensitive glob).
44#
45# Returns: a list of @TraceEventInfo for the matching events
46#
47# Since 2.2
48##
49{ 'command': 'trace-event-get-state',
50  'data': {'name': 'str'},
51  'returns': ['TraceEventInfo'] }
52
53##
54# @trace-event-set-state:
55#
56# Set the dynamic tracing state of events.
57#
58# @name: Event name pattern (case-sensitive glob).
59# @enable: Whether to enable tracing.
60# @ignore-unavailable: #optional Do not match unavailable events with @name.
61#
62# Since 2.2
63##
64{ 'command': 'trace-event-set-state',
65  'data': {'name': 'str', 'enable': 'bool', '*ignore-unavailable': 'bool'} }
66