]>
Commit | Line | Data |
---|---|---|
dbeee392 | 1 | # -*- Mode: Python -*- |
f7160f32 | 2 | # vim: filetype=python |
dbeee392 MA |
3 | # |
4 | ||
5 | ## | |
6 | # = Character devices | |
7 | ## | |
8 | ||
9 | { 'include': 'sockets.json' } | |
10 | ||
11 | ## | |
12 | # @ChardevInfo: | |
13 | # | |
14 | # Information about a character device. | |
15 | # | |
16 | # @label: the label of the character device | |
17 | # | |
18 | # @filename: the filename of the character device | |
19 | # | |
a937b6aa | 20 | # @frontend-open: shows whether the frontend device attached to this |
ff62c210 | 21 | # backend (e.g. with the chardev=... option) is in open or closed |
a937b6aa | 22 | # state (since 2.1) |
dbeee392 | 23 | # |
a937b6aa MA |
24 | # Notes: @filename is encoded using the QEMU command line character |
25 | # device encoding. See the QEMU man page for details. | |
dbeee392 | 26 | # |
9bc6e893 | 27 | # Since: 0.14 |
dbeee392 | 28 | ## |
b0ddeba2 MAL |
29 | { 'struct': 'ChardevInfo', |
30 | 'data': { 'label': 'str', | |
31 | 'filename': 'str', | |
32 | 'frontend-open': 'bool' } } | |
dbeee392 MA |
33 | |
34 | ## | |
35 | # @query-chardev: | |
36 | # | |
37 | # Returns information about current character devices. | |
38 | # | |
39 | # Returns: a list of @ChardevInfo | |
40 | # | |
9bc6e893 | 41 | # Since: 0.14 |
dbeee392 MA |
42 | # |
43 | # Example: | |
44 | # | |
45 | # -> { "execute": "query-chardev" } | |
46 | # <- { | |
47 | # "return": [ | |
48 | # { | |
49 | # "label": "charchannel0", | |
9d902d51 | 50 | # "filename": "unix:/var/lib/libvirt/qemu/seabios.rhel6.agent,server=on", |
dbeee392 MA |
51 | # "frontend-open": false |
52 | # }, | |
53 | # { | |
54 | # "label": "charmonitor", | |
9d902d51 | 55 | # "filename": "unix:/var/lib/libvirt/qemu/seabios.rhel6.monitor,server=on", |
dbeee392 MA |
56 | # "frontend-open": true |
57 | # }, | |
58 | # { | |
59 | # "label": "charserial0", | |
60 | # "filename": "pty:/dev/pts/2", | |
61 | # "frontend-open": true | |
62 | # } | |
63 | # ] | |
64 | # } | |
dbeee392 | 65 | ## |
a87706c8 IM |
66 | { 'command': 'query-chardev', 'returns': ['ChardevInfo'], |
67 | 'allow-preconfig': true } | |
dbeee392 MA |
68 | |
69 | ## | |
70 | # @ChardevBackendInfo: | |
71 | # | |
72 | # Information about a character device backend | |
73 | # | |
74 | # @name: The backend name | |
75 | # | |
76 | # Since: 2.0 | |
77 | ## | |
78 | { 'struct': 'ChardevBackendInfo', 'data': {'name': 'str'} } | |
79 | ||
80 | ## | |
81 | # @query-chardev-backends: | |
82 | # | |
83 | # Returns information about character device backends. | |
84 | # | |
85 | # Returns: a list of @ChardevBackendInfo | |
86 | # | |
87 | # Since: 2.0 | |
88 | # | |
89 | # Example: | |
90 | # | |
91 | # -> { "execute": "query-chardev-backends" } | |
92 | # <- { | |
93 | # "return":[ | |
94 | # { | |
95 | # "name":"udp" | |
96 | # }, | |
97 | # { | |
98 | # "name":"tcp" | |
99 | # }, | |
100 | # { | |
101 | # "name":"unix" | |
102 | # }, | |
103 | # { | |
104 | # "name":"spiceport" | |
105 | # } | |
106 | # ] | |
107 | # } | |
dbeee392 MA |
108 | ## |
109 | { 'command': 'query-chardev-backends', 'returns': ['ChardevBackendInfo'] } | |
110 | ||
111 | ## | |
112 | # @DataFormat: | |
113 | # | |
114 | # An enumeration of data format. | |
115 | # | |
116 | # @utf8: Data is a UTF-8 string (RFC 3629) | |
117 | # | |
118 | # @base64: Data is Base64 encoded binary (RFC 3548) | |
119 | # | |
120 | # Since: 1.4 | |
121 | ## | |
122 | { 'enum': 'DataFormat', | |
123 | 'data': [ 'utf8', 'base64' ] } | |
124 | ||
125 | ## | |
126 | # @ringbuf-write: | |
127 | # | |
128 | # Write to a ring buffer character device. | |
129 | # | |
130 | # @device: the ring buffer character device name | |
131 | # | |
132 | # @data: data to write | |
133 | # | |
134 | # @format: data encoding (default 'utf8'). | |
100cc4fe | 135 | # |
a937b6aa MA |
136 | # - base64: data must be base64 encoded text. Its binary decoding |
137 | # gets written. | |
138 | # - utf8: data's UTF-8 encoding is written | |
139 | # - data itself is always Unicode regardless of format, like any | |
140 | # other string. | |
dbeee392 MA |
141 | # |
142 | # Returns: Nothing on success | |
143 | # | |
144 | # Since: 1.4 | |
145 | # | |
146 | # Example: | |
147 | # | |
148 | # -> { "execute": "ringbuf-write", | |
149 | # "arguments": { "device": "foo", | |
150 | # "data": "abcdefgh", | |
151 | # "format": "utf8" } } | |
152 | # <- { "return": {} } | |
dbeee392 MA |
153 | ## |
154 | { 'command': 'ringbuf-write', | |
b0ddeba2 MAL |
155 | 'data': { 'device': 'str', |
156 | 'data': 'str', | |
dbeee392 MA |
157 | '*format': 'DataFormat'} } |
158 | ||
159 | ## | |
160 | # @ringbuf-read: | |
161 | # | |
162 | # Read from a ring buffer character device. | |
163 | # | |
164 | # @device: the ring buffer character device name | |
165 | # | |
166 | # @size: how many bytes to read at most | |
167 | # | |
168 | # @format: data encoding (default 'utf8'). | |
100cc4fe | 169 | # |
a937b6aa MA |
170 | # - base64: the data read is returned in base64 encoding. |
171 | # - utf8: the data read is interpreted as UTF-8. | |
172 | # Bug: can screw up when the buffer contains invalid UTF-8 | |
173 | # sequences, NUL characters, after the ring buffer lost data, | |
174 | # and when reading stops because the size limit is reached. | |
175 | # - The return value is always Unicode regardless of format, like | |
176 | # any other string. | |
dbeee392 MA |
177 | # |
178 | # Returns: data read from the device | |
179 | # | |
180 | # Since: 1.4 | |
181 | # | |
182 | # Example: | |
183 | # | |
184 | # -> { "execute": "ringbuf-read", | |
185 | # "arguments": { "device": "foo", | |
186 | # "size": 1000, | |
187 | # "format": "utf8" } } | |
188 | # <- { "return": "abcdefgh" } | |
dbeee392 MA |
189 | ## |
190 | { 'command': 'ringbuf-read', | |
191 | 'data': {'device': 'str', 'size': 'int', '*format': 'DataFormat'}, | |
192 | 'returns': 'str' } | |
193 | ||
194 | ## | |
195 | # @ChardevCommon: | |
196 | # | |
197 | # Configuration shared across all chardev backends | |
198 | # | |
199 | # @logfile: The name of a logfile to save output | |
a937b6aa MA |
200 | # |
201 | # @logappend: true to append instead of truncate (default to false to | |
202 | # truncate) | |
dbeee392 MA |
203 | # |
204 | # Since: 2.6 | |
205 | ## | |
b0ddeba2 MAL |
206 | { 'struct': 'ChardevCommon', |
207 | 'data': { '*logfile': 'str', | |
208 | '*logappend': 'bool' } } | |
dbeee392 MA |
209 | |
210 | ## | |
211 | # @ChardevFile: | |
212 | # | |
213 | # Configuration info for file chardevs. | |
214 | # | |
23e46452 | 215 | # @in: The name of the input file |
a937b6aa | 216 | # |
dbeee392 | 217 | # @out: The name of the output file |
a937b6aa MA |
218 | # |
219 | # @append: Open the file in append mode (default false to truncate) | |
220 | # (Since 2.6) | |
dbeee392 MA |
221 | # |
222 | # Since: 1.4 | |
223 | ## | |
b0ddeba2 MAL |
224 | { 'struct': 'ChardevFile', |
225 | 'data': { '*in': 'str', | |
226 | 'out': 'str', | |
227 | '*append': 'bool' }, | |
dbeee392 MA |
228 | 'base': 'ChardevCommon' } |
229 | ||
230 | ## | |
231 | # @ChardevHostdev: | |
232 | # | |
233 | # Configuration info for device and pipe chardevs. | |
234 | # | |
a937b6aa MA |
235 | # @device: The name of the special file for the device, i.e. |
236 | # /dev/ttyS0 on Unix or COM1: on Windows | |
dbeee392 MA |
237 | # |
238 | # Since: 1.4 | |
239 | ## | |
b0ddeba2 MAL |
240 | { 'struct': 'ChardevHostdev', |
241 | 'data': { 'device': 'str' }, | |
dbeee392 MA |
242 | 'base': 'ChardevCommon' } |
243 | ||
244 | ## | |
245 | # @ChardevSocket: | |
246 | # | |
247 | # Configuration info for (stream) socket chardevs. | |
248 | # | |
a937b6aa MA |
249 | # @addr: socket address to listen on (server=true) or connect to |
250 | # (server=false) | |
251 | # | |
dbeee392 | 252 | # @tls-creds: the ID of the TLS credentials object (since 2.6) |
a937b6aa | 253 | # |
fd4a5fd4 | 254 | # @tls-authz: the ID of the QAuthZ authorization object against which |
a937b6aa MA |
255 | # the client's x509 distinguished name will be validated. This |
256 | # object is only resolved at time of use, so can be deleted and | |
257 | # recreated on the fly while the chardev server is active. If | |
258 | # missing, it will default to denying access (since 4.0) | |
259 | # | |
dbeee392 | 260 | # @server: create server socket (default: true) |
a937b6aa MA |
261 | # |
262 | # @wait: wait for incoming connection on server sockets (default: | |
263 | # false). Silently ignored with server: false. This use is | |
264 | # deprecated. | |
265 | # | |
dbeee392 | 266 | # @nodelay: set TCP_NODELAY socket option (default: false) |
a937b6aa MA |
267 | # |
268 | # @telnet: enable telnet protocol on server sockets (default: false) | |
269 | # | |
270 | # @tn3270: enable tn3270 protocol on server sockets (default: false) | |
271 | # (Since: 2.10) | |
272 | # | |
273 | # @websocket: enable websocket protocol on server sockets | |
274 | # (default: false) (Since: 3.1) | |
275 | # | |
276 | # @reconnect: For a client socket, if a socket is disconnected, then | |
277 | # attempt a reconnect after the given number of seconds. Setting | |
278 | # this to zero disables this function. (default: 0) (Since: 2.2) | |
dbeee392 MA |
279 | # |
280 | # Since: 1.4 | |
281 | ## | |
b0ddeba2 MAL |
282 | { 'struct': 'ChardevSocket', |
283 | 'data': { 'addr': 'SocketAddressLegacy', | |
284 | '*tls-creds': 'str', | |
fd4a5fd4 | 285 | '*tls-authz' : 'str', |
b0ddeba2 MAL |
286 | '*server': 'bool', |
287 | '*wait': 'bool', | |
288 | '*nodelay': 'bool', | |
289 | '*telnet': 'bool', | |
290 | '*tn3270': 'bool', | |
291 | '*websocket': 'bool', | |
292 | '*reconnect': 'int' }, | |
dbeee392 MA |
293 | 'base': 'ChardevCommon' } |
294 | ||
295 | ## | |
296 | # @ChardevUdp: | |
297 | # | |
298 | # Configuration info for datagram socket chardevs. | |
299 | # | |
300 | # @remote: remote address | |
a937b6aa | 301 | # |
dbeee392 MA |
302 | # @local: local address |
303 | # | |
304 | # Since: 1.5 | |
305 | ## | |
b0ddeba2 MAL |
306 | { 'struct': 'ChardevUdp', |
307 | 'data': { 'remote': 'SocketAddressLegacy', | |
308 | '*local': 'SocketAddressLegacy' }, | |
dbeee392 MA |
309 | 'base': 'ChardevCommon' } |
310 | ||
311 | ## | |
312 | # @ChardevMux: | |
313 | # | |
314 | # Configuration info for mux chardevs. | |
315 | # | |
316 | # @chardev: name of the base chardev. | |
317 | # | |
318 | # Since: 1.5 | |
319 | ## | |
b0ddeba2 MAL |
320 | { 'struct': 'ChardevMux', |
321 | 'data': { 'chardev': 'str' }, | |
dbeee392 MA |
322 | 'base': 'ChardevCommon' } |
323 | ||
324 | ## | |
325 | # @ChardevStdio: | |
326 | # | |
327 | # Configuration info for stdio chardevs. | |
328 | # | |
a937b6aa MA |
329 | # @signal: Allow signals (such as SIGINT triggered by ^C) be delivered |
330 | # to qemu. Default: true. | |
dbeee392 MA |
331 | # |
332 | # Since: 1.5 | |
333 | ## | |
b0ddeba2 MAL |
334 | { 'struct': 'ChardevStdio', |
335 | 'data': { '*signal': 'bool' }, | |
dbeee392 MA |
336 | 'base': 'ChardevCommon' } |
337 | ||
dbeee392 MA |
338 | ## |
339 | # @ChardevSpiceChannel: | |
340 | # | |
341 | # Configuration info for spice vm channel chardevs. | |
342 | # | |
343 | # @type: kind of channel (for example vdagent). | |
344 | # | |
345 | # Since: 1.5 | |
346 | ## | |
b0ddeba2 MAL |
347 | { 'struct': 'ChardevSpiceChannel', |
348 | 'data': { 'type': 'str' }, | |
fd9dda3b | 349 | 'base': 'ChardevCommon', |
8a9f1e1d | 350 | 'if': 'CONFIG_SPICE' } |
dbeee392 MA |
351 | |
352 | ## | |
353 | # @ChardevSpicePort: | |
354 | # | |
355 | # Configuration info for spice port chardevs. | |
356 | # | |
357 | # @fqdn: name of the channel (see docs/spice-port-fqdn.txt) | |
358 | # | |
359 | # Since: 1.5 | |
360 | ## | |
b0ddeba2 MAL |
361 | { 'struct': 'ChardevSpicePort', |
362 | 'data': { 'fqdn': 'str' }, | |
fd9dda3b | 363 | 'base': 'ChardevCommon', |
8a9f1e1d | 364 | 'if': 'CONFIG_SPICE' } |
dbeee392 | 365 | |
3e301c8d MAL |
366 | ## |
367 | # @ChardevDBus: | |
368 | # | |
369 | # Configuration info for DBus chardevs. | |
370 | # | |
371 | # @name: name of the channel (following docs/spice-port-fqdn.txt) | |
372 | # | |
373 | # Since: 7.0 | |
374 | ## | |
375 | { 'struct': 'ChardevDBus', | |
376 | 'data': { 'name': 'str' }, | |
377 | 'base': 'ChardevCommon', | |
378 | 'if': 'CONFIG_DBUS_DISPLAY' } | |
379 | ||
dbeee392 MA |
380 | ## |
381 | # @ChardevVC: | |
382 | # | |
383 | # Configuration info for virtual console chardevs. | |
384 | # | |
c0ac533b | 385 | # @width: console width, in pixels |
a937b6aa | 386 | # |
dbeee392 | 387 | # @height: console height, in pixels |
a937b6aa | 388 | # |
c0ac533b | 389 | # @cols: console width, in chars |
a937b6aa | 390 | # |
c0ac533b | 391 | # @rows: console height, in chars |
dbeee392 | 392 | # |
32aa1f8d | 393 | # Note: the options are only effective when the VNC or SDL graphical |
e6ab40fe MA |
394 | # display backend is active. They are ignored with the GTK, |
395 | # Spice, VNC and D-Bus display backends. | |
32aa1f8d | 396 | # |
dbeee392 MA |
397 | # Since: 1.5 |
398 | ## | |
b0ddeba2 MAL |
399 | { 'struct': 'ChardevVC', |
400 | 'data': { '*width': 'int', | |
401 | '*height': 'int', | |
402 | '*cols': 'int', | |
403 | '*rows': 'int' }, | |
dbeee392 MA |
404 | 'base': 'ChardevCommon' } |
405 | ||
406 | ## | |
407 | # @ChardevRingbuf: | |
408 | # | |
409 | # Configuration info for ring buffer chardevs. | |
410 | # | |
411 | # @size: ring buffer size, must be power of two, default is 65536 | |
412 | # | |
413 | # Since: 1.5 | |
414 | ## | |
b0ddeba2 MAL |
415 | { 'struct': 'ChardevRingbuf', |
416 | 'data': { '*size': 'int' }, | |
dbeee392 MA |
417 | 'base': 'ChardevCommon' } |
418 | ||
de74a22c GH |
419 | ## |
420 | # @ChardevQemuVDAgent: | |
421 | # | |
422 | # Configuration info for qemu vdagent implementation. | |
423 | # | |
56081919 | 424 | # @mouse: enable/disable mouse, default is enabled. |
a937b6aa | 425 | # |
f0349f4d | 426 | # @clipboard: enable/disable clipboard, default is disabled. |
56081919 | 427 | # |
de74a22c | 428 | # Since: 6.1 |
de74a22c GH |
429 | ## |
430 | { 'struct': 'ChardevQemuVDAgent', | |
f0349f4d GH |
431 | 'data': { '*mouse': 'bool', |
432 | '*clipboard': 'bool' }, | |
de74a22c | 433 | 'base': 'ChardevCommon', |
8a9f1e1d | 434 | 'if': 'CONFIG_SPICE_PROTOCOL' } |
de74a22c | 435 | |
3218c0e9 MA |
436 | ## |
437 | # @ChardevBackendKind: | |
438 | # | |
439 | # @pipe: Since 1.5 | |
a937b6aa | 440 | # |
3218c0e9 | 441 | # @udp: Since 1.5 |
a937b6aa | 442 | # |
3218c0e9 | 443 | # @mux: Since 1.5 |
a937b6aa | 444 | # |
3218c0e9 | 445 | # @msmouse: Since 1.5 |
a937b6aa | 446 | # |
3218c0e9 | 447 | # @wctablet: Since 2.9 |
a937b6aa | 448 | # |
3218c0e9 | 449 | # @braille: Since 1.5 |
a937b6aa | 450 | # |
3218c0e9 | 451 | # @testdev: Since 2.2 |
a937b6aa | 452 | # |
3218c0e9 | 453 | # @stdio: Since 1.5 |
a937b6aa | 454 | # |
3218c0e9 | 455 | # @console: Since 1.5 |
a937b6aa | 456 | # |
3218c0e9 | 457 | # @spicevmc: Since 1.5 |
a937b6aa | 458 | # |
3218c0e9 | 459 | # @spiceport: Since 1.5 |
a937b6aa | 460 | # |
3218c0e9 | 461 | # @qemu-vdagent: Since 6.1 |
a937b6aa | 462 | # |
3e301c8d | 463 | # @dbus: Since 7.0 |
a937b6aa | 464 | # |
3218c0e9 | 465 | # @vc: v1.5 |
a937b6aa | 466 | # |
3218c0e9 | 467 | # @ringbuf: Since 1.6 |
a937b6aa | 468 | # |
3218c0e9 MA |
469 | # @memory: Since 1.5 |
470 | # | |
471 | # Since: 1.4 | |
472 | ## | |
473 | { 'enum': 'ChardevBackendKind', | |
474 | 'data': [ 'file', | |
475 | 'serial', | |
476 | 'parallel', | |
477 | 'pipe', | |
478 | 'socket', | |
479 | 'udp', | |
480 | 'pty', | |
481 | 'null', | |
482 | 'mux', | |
483 | 'msmouse', | |
484 | 'wctablet', | |
485 | 'braille', | |
486 | 'testdev', | |
487 | 'stdio', | |
488 | 'console', | |
489 | { 'name': 'spicevmc', 'if': 'CONFIG_SPICE' }, | |
490 | { 'name': 'spiceport', 'if': 'CONFIG_SPICE' }, | |
491 | { 'name': 'qemu-vdagent', 'if': 'CONFIG_SPICE_PROTOCOL' }, | |
3e301c8d | 492 | { 'name': 'dbus', 'if': 'CONFIG_DBUS_DISPLAY' }, |
3218c0e9 MA |
493 | 'vc', |
494 | 'ringbuf', | |
495 | # next one is just for compatibility | |
496 | 'memory' ] } | |
497 | ||
498 | ## | |
499 | # @ChardevFileWrapper: | |
500 | # | |
501 | # Since: 1.4 | |
502 | ## | |
503 | { 'struct': 'ChardevFileWrapper', | |
504 | 'data': { 'data': 'ChardevFile' } } | |
505 | ||
506 | ## | |
507 | # @ChardevHostdevWrapper: | |
508 | # | |
509 | # Since: 1.4 | |
510 | ## | |
511 | { 'struct': 'ChardevHostdevWrapper', | |
512 | 'data': { 'data': 'ChardevHostdev' } } | |
513 | ||
514 | ## | |
515 | # @ChardevSocketWrapper: | |
516 | # | |
517 | # Since: 1.4 | |
518 | ## | |
519 | { 'struct': 'ChardevSocketWrapper', | |
520 | 'data': { 'data': 'ChardevSocket' } } | |
521 | ||
522 | ## | |
523 | # @ChardevUdpWrapper: | |
524 | # | |
525 | # Since: 1.5 | |
526 | ## | |
527 | { 'struct': 'ChardevUdpWrapper', | |
528 | 'data': { 'data': 'ChardevUdp' } } | |
529 | ||
530 | ## | |
531 | # @ChardevCommonWrapper: | |
532 | # | |
533 | # Since: 2.6 | |
534 | ## | |
535 | { 'struct': 'ChardevCommonWrapper', | |
536 | 'data': { 'data': 'ChardevCommon' } } | |
537 | ||
538 | ## | |
539 | # @ChardevMuxWrapper: | |
540 | # | |
541 | # Since: 1.5 | |
542 | ## | |
543 | { 'struct': 'ChardevMuxWrapper', | |
544 | 'data': { 'data': 'ChardevMux' } } | |
545 | ||
546 | ## | |
547 | # @ChardevStdioWrapper: | |
548 | # | |
549 | # Since: 1.5 | |
550 | ## | |
551 | { 'struct': 'ChardevStdioWrapper', | |
552 | 'data': { 'data': 'ChardevStdio' } } | |
553 | ||
554 | ## | |
555 | # @ChardevSpiceChannelWrapper: | |
556 | # | |
557 | # Since: 1.5 | |
558 | ## | |
559 | { 'struct': 'ChardevSpiceChannelWrapper', | |
560 | 'data': { 'data': 'ChardevSpiceChannel' }, | |
561 | 'if': 'CONFIG_SPICE' } | |
562 | ||
563 | ## | |
564 | # @ChardevSpicePortWrapper: | |
565 | # | |
566 | # Since: 1.5 | |
567 | ## | |
568 | { 'struct': 'ChardevSpicePortWrapper', | |
569 | 'data': { 'data': 'ChardevSpicePort' }, | |
570 | 'if': 'CONFIG_SPICE' } | |
571 | ||
572 | ## | |
573 | # @ChardevQemuVDAgentWrapper: | |
574 | # | |
575 | # Since: 6.1 | |
576 | ## | |
577 | { 'struct': 'ChardevQemuVDAgentWrapper', | |
578 | 'data': { 'data': 'ChardevQemuVDAgent' }, | |
579 | 'if': 'CONFIG_SPICE_PROTOCOL' } | |
580 | ||
3e301c8d MAL |
581 | ## |
582 | # @ChardevDBusWrapper: | |
583 | # | |
584 | # Since: 7.0 | |
585 | ## | |
586 | { 'struct': 'ChardevDBusWrapper', | |
587 | 'data': { 'data': 'ChardevDBus' }, | |
588 | 'if': 'CONFIG_DBUS_DISPLAY' } | |
589 | ||
3218c0e9 MA |
590 | ## |
591 | # @ChardevVCWrapper: | |
592 | # | |
593 | # Since: 1.5 | |
594 | ## | |
595 | { 'struct': 'ChardevVCWrapper', | |
596 | 'data': { 'data': 'ChardevVC' } } | |
597 | ||
598 | ## | |
599 | # @ChardevRingbufWrapper: | |
600 | # | |
601 | # Since: 1.5 | |
602 | ## | |
603 | { 'struct': 'ChardevRingbufWrapper', | |
604 | 'data': { 'data': 'ChardevRingbuf' } } | |
605 | ||
dbeee392 MA |
606 | ## |
607 | # @ChardevBackend: | |
608 | # | |
609 | # Configuration info for the new chardev backend. | |
610 | # | |
3218c0e9 | 611 | # Since: 1.4 |
dbeee392 | 612 | ## |
b0ddeba2 | 613 | { 'union': 'ChardevBackend', |
3218c0e9 MA |
614 | 'base': { 'type': 'ChardevBackendKind' }, |
615 | 'discriminator': 'type', | |
616 | 'data': { 'file': 'ChardevFileWrapper', | |
617 | 'serial': 'ChardevHostdevWrapper', | |
618 | 'parallel': 'ChardevHostdevWrapper', | |
619 | 'pipe': 'ChardevHostdevWrapper', | |
620 | 'socket': 'ChardevSocketWrapper', | |
621 | 'udp': 'ChardevUdpWrapper', | |
622 | 'pty': 'ChardevCommonWrapper', | |
623 | 'null': 'ChardevCommonWrapper', | |
624 | 'mux': 'ChardevMuxWrapper', | |
625 | 'msmouse': 'ChardevCommonWrapper', | |
626 | 'wctablet': 'ChardevCommonWrapper', | |
627 | 'braille': 'ChardevCommonWrapper', | |
628 | 'testdev': 'ChardevCommonWrapper', | |
629 | 'stdio': 'ChardevStdioWrapper', | |
630 | 'console': 'ChardevCommonWrapper', | |
631 | 'spicevmc': { 'type': 'ChardevSpiceChannelWrapper', | |
8a9f1e1d | 632 | 'if': 'CONFIG_SPICE' }, |
3218c0e9 | 633 | 'spiceport': { 'type': 'ChardevSpicePortWrapper', |
8a9f1e1d | 634 | 'if': 'CONFIG_SPICE' }, |
3218c0e9 | 635 | 'qemu-vdagent': { 'type': 'ChardevQemuVDAgentWrapper', |
8a9f1e1d | 636 | 'if': 'CONFIG_SPICE_PROTOCOL' }, |
3e301c8d MAL |
637 | 'dbus': { 'type': 'ChardevDBusWrapper', |
638 | 'if': 'CONFIG_DBUS_DISPLAY' }, | |
3218c0e9 MA |
639 | 'vc': 'ChardevVCWrapper', |
640 | 'ringbuf': 'ChardevRingbufWrapper', | |
b0ddeba2 | 641 | # next one is just for compatibility |
3218c0e9 | 642 | 'memory': 'ChardevRingbufWrapper' } } |
dbeee392 MA |
643 | |
644 | ## | |
645 | # @ChardevReturn: | |
646 | # | |
647 | # Return info about the chardev backend just created. | |
648 | # | |
a937b6aa MA |
649 | # @pty: name of the slave pseudoterminal device, present if and only |
650 | # if a chardev of type 'pty' was created | |
dbeee392 MA |
651 | # |
652 | # Since: 1.4 | |
653 | ## | |
b0ddeba2 MAL |
654 | { 'struct' : 'ChardevReturn', |
655 | 'data': { '*pty': 'str' } } | |
dbeee392 MA |
656 | |
657 | ## | |
658 | # @chardev-add: | |
659 | # | |
660 | # Add a character device backend | |
661 | # | |
662 | # @id: the chardev's ID, must be unique | |
a937b6aa | 663 | # |
dbeee392 MA |
664 | # @backend: backend type and parameters |
665 | # | |
666 | # Returns: ChardevReturn. | |
667 | # | |
668 | # Since: 1.4 | |
669 | # | |
37fa48a4 | 670 | # Examples: |
dbeee392 MA |
671 | # |
672 | # -> { "execute" : "chardev-add", | |
673 | # "arguments" : { "id" : "foo", | |
674 | # "backend" : { "type" : "null", "data" : {} } } } | |
675 | # <- { "return": {} } | |
676 | # | |
677 | # -> { "execute" : "chardev-add", | |
678 | # "arguments" : { "id" : "bar", | |
679 | # "backend" : { "type" : "file", | |
680 | # "data" : { "out" : "/tmp/bar.log" } } } } | |
681 | # <- { "return": {} } | |
682 | # | |
683 | # -> { "execute" : "chardev-add", | |
684 | # "arguments" : { "id" : "baz", | |
685 | # "backend" : { "type" : "pty", "data" : {} } } } | |
686 | # <- { "return": { "pty" : "/dev/pty/42" } } | |
dbeee392 | 687 | ## |
b0ddeba2 MAL |
688 | { 'command': 'chardev-add', |
689 | 'data': { 'id': 'str', | |
690 | 'backend': 'ChardevBackend' }, | |
dbeee392 MA |
691 | 'returns': 'ChardevReturn' } |
692 | ||
693 | ## | |
694 | # @chardev-change: | |
695 | # | |
696 | # Change a character device backend | |
697 | # | |
698 | # @id: the chardev's ID, must exist | |
a937b6aa | 699 | # |
dbeee392 MA |
700 | # @backend: new backend type and parameters |
701 | # | |
702 | # Returns: ChardevReturn. | |
703 | # | |
704 | # Since: 2.10 | |
705 | # | |
37fa48a4 | 706 | # Examples: |
dbeee392 MA |
707 | # |
708 | # -> { "execute" : "chardev-change", | |
709 | # "arguments" : { "id" : "baz", | |
710 | # "backend" : { "type" : "pty", "data" : {} } } } | |
711 | # <- { "return": { "pty" : "/dev/pty/42" } } | |
712 | # | |
713 | # -> {"execute" : "chardev-change", | |
714 | # "arguments" : { | |
715 | # "id" : "charchannel2", | |
716 | # "backend" : { | |
717 | # "type" : "socket", | |
718 | # "data" : { | |
719 | # "addr" : { | |
720 | # "type" : "unix" , | |
721 | # "data" : { | |
722 | # "path" : "/tmp/charchannel2.socket" | |
723 | # } | |
724 | # }, | |
725 | # "server" : true, | |
726 | # "wait" : false }}}} | |
727 | # <- {"return": {}} | |
dbeee392 | 728 | ## |
b0ddeba2 MAL |
729 | { 'command': 'chardev-change', |
730 | 'data': { 'id': 'str', | |
731 | 'backend': 'ChardevBackend' }, | |
dbeee392 MA |
732 | 'returns': 'ChardevReturn' } |
733 | ||
734 | ## | |
735 | # @chardev-remove: | |
736 | # | |
737 | # Remove a character device backend | |
738 | # | |
739 | # @id: the chardev's ID, must exist and not be in use | |
740 | # | |
741 | # Returns: Nothing on success | |
742 | # | |
743 | # Since: 1.4 | |
744 | # | |
745 | # Example: | |
746 | # | |
747 | # -> { "execute": "chardev-remove", "arguments": { "id" : "foo" } } | |
748 | # <- { "return": {} } | |
dbeee392 | 749 | ## |
b0ddeba2 MAL |
750 | { 'command': 'chardev-remove', |
751 | 'data': { 'id': 'str' } } | |
dbeee392 MA |
752 | |
753 | ## | |
754 | # @chardev-send-break: | |
755 | # | |
756 | # Send a break to a character device | |
757 | # | |
758 | # @id: the chardev's ID, must exist | |
759 | # | |
760 | # Returns: Nothing on success | |
761 | # | |
762 | # Since: 2.10 | |
763 | # | |
764 | # Example: | |
765 | # | |
766 | # -> { "execute": "chardev-send-break", "arguments": { "id" : "foo" } } | |
767 | # <- { "return": {} } | |
dbeee392 | 768 | ## |
b0ddeba2 MAL |
769 | { 'command': 'chardev-send-break', |
770 | 'data': { 'id': 'str' } } | |
dbeee392 MA |
771 | |
772 | ## | |
773 | # @VSERPORT_CHANGE: | |
774 | # | |
775 | # Emitted when the guest opens or closes a virtio-serial port. | |
776 | # | |
777 | # @id: device identifier of the virtio-serial port | |
778 | # | |
779 | # @open: true if the guest has opened the virtio-serial port | |
780 | # | |
382bd1cb MA |
781 | # Note: This event is rate-limited. |
782 | # | |
dbeee392 MA |
783 | # Since: 2.1 |
784 | # | |
785 | # Example: | |
786 | # | |
787 | # <- { "event": "VSERPORT_CHANGE", | |
788 | # "data": { "id": "channel0", "open": true }, | |
789 | # "timestamp": { "seconds": 1401385907, "microseconds": 422329 } } | |
dbeee392 MA |
790 | ## |
791 | { 'event': 'VSERPORT_CHANGE', | |
b0ddeba2 MAL |
792 | 'data': { 'id': 'str', |
793 | 'open': 'bool' } } |