QMP/qmp-events.txt

   1                    QEMU Monitor Protocol Events
   2                    ============================
   3
   4 BLOCK_IO_ERROR
   5 --------------
   6
   7 Emitted when a disk I/O error occurs.
   8
   9 Data:
  10
  11 - "device": device name (json-string)
  12 - "operation": I/O operation (json-string, "read" or "write")
  13 - "action": action that has been taken, it's one of the following (json-string):
  14     "ignore": error has been ignored
  15     "report": error has been reported to the device
  16     "stop": error caused VM to be stopped
  17
  18 Example:
  19
  20 { "event": "BLOCK_IO_ERROR",
  21     "data": { "device": "ide0-hd1",
  22               "operation": "write",
  23               "action": "stop" },
  24     "timestamp": { "seconds": 1265044230, "microseconds": 450486 } }
  25
  26 Note: If action is "stop", a STOP event will eventually follow the
  27 BLOCK_IO_ERROR event.
  28
  29 RESET
  30 -----
  31
  32 Emitted when the Virtual Machine is reseted.
  33
  34 Data: None.
  35
  36 Example:
  37
  38 { "event": "RESET",
  39     "timestamp": { "seconds": 1267041653, "microseconds": 9518 } }
  40
  41 RESUME
  42 ------
  43
  44 Emitted when the Virtual Machine resumes execution.
  45
  46 Data: None.
  47
  48 Example:
  49
  50 { "event": "RESUME",
  51     "timestamp": { "seconds": 1271770767, "microseconds": 582542 } }
  52
  53 RTC_CHANGE
  54 ----------
  55
  56 Emitted when the guest changes the RTC time.
  57
  58 Data:
  59
  60 - "offset": delta against the host UTC in seconds (json-number)
  61
  62 Example:
  63
  64 { "event": "RTC_CHANGE",
  65     "data": { "offset": 78 },
  66     "timestamp": { "seconds": 1267020223, "microseconds": 435656 } }
  67
  68 SHUTDOWN
  69 --------
  70
  71 Emitted when the Virtual Machine is powered down.
  72
  73 Data: None.
  74
  75 Example:
  76
  77 { "event": "SHUTDOWN",
  78     "timestamp": { "seconds": 1267040730, "microseconds": 682951 } }
  79
  80 Note: If the command-line option "-no-shutdown" has been specified, a STOP
  81 event will eventually follow the SHUTDOWN event.
  82
  83 STOP
  84 ----
  85
  86 Emitted when the Virtual Machine is stopped.
  87
  88 Data: None.
  89
  90 Example:
  91
  92 { "event": "STOP",
  93     "timestamp": { "seconds": 1267041730, "microseconds": 281295 } }
  94
  95 VNC_CONNECTED
  96 -------------
  97
  98 Emitted when a VNC client establishes a connection.
  99
 100 Data:
 101
 102 - "server": Server information (json-object)
 103   - "host": IP address (json-string)
 104   - "service": port number (json-string)
 105   - "family": address family (json-string, "ipv4" or "ipv6")
 106   - "auth": authentication method (json-string, optional)
 107 - "client": Client information (json-object)
 108   - "host": IP address (json-string)
 109   - "service": port number (json-string)
 110   - "family": address family (json-string, "ipv4" or "ipv6")
 111
 112 Example:
 113
 114 { "event": "VNC_CONNECTED",
 115     "data": {
 116         "server": { "auth": "sasl", "family": "ipv4",
 117                     "service": "5901", "host": "0.0.0.0" },
 118         "client": { "family": "ipv4", "service": "58425",
 119                     "host": "127.0.0.1" } },
 120     "timestamp": { "seconds": 1262976601, "microseconds": 975795 } }
 121
 122
 123 Note: This event is emitted before any authentication takes place, thus
 124 the authentication ID is not provided.
 125
 126 VNC_DISCONNECTED
 127 ----------------
 128
 129 Emitted when the conection is closed.
 130
 131 Data:
 132
 133 - "server": Server information (json-object)
 134   - "host": IP address (json-string)
 135   - "service": port number (json-string)
 136   - "family": address family (json-string, "ipv4" or "ipv6")
 137   - "auth": authentication method (json-string, optional)
 138 - "client": Client information (json-object)
 139   - "host": IP address (json-string)
 140   - "service": port number (json-string)
 141   - "family": address family (json-string, "ipv4" or "ipv6")
 142   - "x509_dname": TLS dname (json-string, optional)
 143   - "sasl_username": SASL username (json-string, optional)
 144
 145 Example:
 146
 147 { "event": "VNC_DISCONNECTED",
 148     "data": {
 149         "server": { "auth": "sasl", "family": "ipv4",
 150                     "service": "5901", "host": "0.0.0.0" },
 151         "client": { "family": "ipv4", "service": "58425",
 152                     "host": "127.0.0.1", "sasl_username": "luiz" } },
 153     "timestamp": { "seconds": 1262976601, "microseconds": 975795 } }
 154
 155 VNC_INITIALIZED
 156 ---------------
 157
 158 Emitted after authentication takes place (if any) and the VNC session is
 159 made active.
 160
 161 Data:
 162
 163 - "server": Server information (json-object)
 164   - "host": IP address (json-string)
 165   - "service": port number (json-string)
 166   - "family": address family (json-string, "ipv4" or "ipv6")
 167   - "auth": authentication method (json-string, optional)
 168 - "client": Client information (json-object)
 169   - "host": IP address (json-string)
 170   - "service": port number (json-string)
 171   - "family": address family (json-string, "ipv4" or "ipv6")
 172   - "x509_dname": TLS dname (json-string, optional)
 173   - "sasl_username": SASL username (json-string, optional)
 174
 175 Example:
 176
 177 { "event": "VNC_INITIALIZED",
 178     "data": {
 179         "server": { "auth": "sasl", "family": "ipv4",
 180                     "service": "5901", "host": "0.0.0.0"},
 181         "client": { "family": "ipv4", "service": "46089",
 182                     "host": "127.0.0.1", "sasl_username": "luiz" } },
 183         "timestamp": { "seconds": 1263475302, "microseconds": 150772 } }
 184
 185 WATCHDOG
 186 --------
 187
 188 Emitted when the watchdog device's timer is expired.
 189
 190 Data:
 191
 192 - "action": Action that has been taken, it's one of the following (json-string):
 193             "reset", "shutdown", "poweroff", "pause", "debug", or "none"
 194
 195 Example:
 196
 197 { "event": "WATCHDOG",
 198      "data": { "action": "reset" },
 199      "timestamp": { "seconds": 1267061043, "microseconds": 959568 } }
 200
 201 Note: If action is "reset", "shutdown", or "pause" the WATCHDOG event is
 202 followed respectively by the RESET, SHUTDOWN, or STOP events.