]>
Commit | Line | Data |
---|---|---|
44c67847 MA |
1 | @node Deprecated features |
2 | @appendix Deprecated features | |
3 | ||
4 | In general features are intended to be supported indefinitely once | |
5 | introduced into QEMU. In the event that a feature needs to be removed, | |
6 | it will be listed in this appendix. The feature will remain functional | |
7 | for 2 releases prior to actual removal. Deprecated features may also | |
8 | generate warnings on the console when QEMU starts up, or if activated | |
9 | via a monitor command, however, this is not a mandatory requirement. | |
10 | ||
11 | Prior to the 2.10.0 release there was no official policy on how | |
12 | long features would be deprecated prior to their removal, nor | |
13 | any documented list of which features were deprecated. Thus | |
14 | any features deprecated prior to 2.10.0 will be treated as if | |
15 | they were first deprecated in the 2.10.0 release. | |
16 | ||
17 | What follows is a list of all features currently marked as | |
18 | deprecated. | |
19 | ||
20 | @section Build options | |
21 | ||
22 | @subsection GTK 2.x | |
23 | ||
24 | Previously QEMU has supported building against both GTK 2.x | |
25 | and 3.x series APIs. Support for the GTK 2.x builds will be | |
26 | discontinued, so maintainers should switch to using GTK 3.x, | |
27 | which is the default. | |
28 | ||
29 | @subsection SDL 1.2 | |
30 | ||
31 | Previously QEMU has supported building against both SDL 1.2 | |
32 | and 2.0 series APIs. Support for the SDL 1.2 builds will be | |
33 | discontinued, so maintainers should switch to using SDL 2.0, | |
34 | which is the default. | |
35 | ||
36 | @section System emulator command line arguments | |
37 | ||
38 | @subsection -no-kvm (since 1.3.0) | |
39 | ||
40 | The ``-no-kvm'' argument is now a synonym for setting | |
41 | ``-machine accel=tcg''. | |
42 | ||
44c67847 MA |
43 | @subsection -usbdevice (since 2.10.0) |
44 | ||
45 | The ``-usbdevice DEV'' argument is now a synonym for setting | |
46 | the ``-device usb-DEV'' argument instead. The deprecated syntax | |
47 | would automatically enable USB support on the machine type. | |
48 | If using the new syntax, USB support must be explicitly | |
49 | enabled via the ``-machine usb=on'' argument. | |
50 | ||
44c67847 MA |
51 | @subsection -fsdev handle (since 2.12.0) |
52 | ||
53 | The ``handle'' fsdev backend does not support symlinks and causes the 9p | |
54 | filesystem in the guest to fail a fair amount of tests from the PJD POSIX | |
55 | filesystem test suite. Also it requires the CAP_DAC_READ_SEARCH capability, | |
56 | which is not the recommended way to run QEMU. This backend should not be | |
57 | used and it will be removed with no replacement. | |
58 | ||
59 | @subsection -no-frame (since 2.12.0) | |
60 | ||
61 | The @code{--no-frame} argument works with SDL 1.2 only. The other user | |
62 | interfaces never implemented this in the first place. So this will be | |
63 | removed together with SDL 1.2 support. | |
64 | ||
44c67847 MA |
65 | @subsection -virtioconsole (since 3.0.0) |
66 | ||
67 | Option @option{-virtioconsole} has been replaced by | |
68 | @option{-device virtconsole}. | |
69 | ||
70 | @subsection -clock (since 3.0.0) | |
71 | ||
72 | The @code{-clock} option is ignored since QEMU version 1.7.0. There is no | |
73 | replacement since it is not needed anymore. | |
74 | ||
75 | @subsection -enable-hax (since 3.0.0) | |
76 | ||
77 | The @option{-enable-hax} option has been replaced by @option{-accel hax}. | |
78 | Both options have been introduced in QEMU version 2.9.0. | |
79 | ||
80 | @subsection -drive file=json:@{...@{'driver':'file'@}@} (since 3.0) | |
81 | ||
82 | The 'file' driver for drives is no longer appropriate for character or host | |
83 | devices and will only accept regular files (S_IFREG). The correct driver | |
84 | for these file types is 'host_cdrom' or 'host_device' as appropriate. | |
85 | ||
86 | @section QEMU Machine Protocol (QMP) commands | |
87 | ||
88 | @subsection block-dirty-bitmap-add "autoload" parameter (since 2.12.0) | |
89 | ||
90 | "autoload" parameter is now ignored. All bitmaps are automatically loaded | |
91 | from qcow2 images. | |
92 | ||
93 | @subsection query-cpus (since 2.12.0) | |
94 | ||
95 | The ``query-cpus'' command is replaced by the ``query-cpus-fast'' command. | |
96 | ||
97 | @subsection query-cpus-fast "arch" output member (since 3.0.0) | |
98 | ||
99 | The ``arch'' output member of the ``query-cpus-fast'' command is | |
100 | replaced by the ``target'' output member. | |
101 | ||
102 | @section System emulator devices | |
103 | ||
104 | @subsection ivshmem (since 2.6.0) | |
105 | ||
106 | The ``ivshmem'' device type is replaced by either the ``ivshmem-plain'' | |
107 | or ``ivshmem-doorbell`` device types. | |
108 | ||
109 | @subsection Page size support < 4k for embedded PowerPC CPUs (since 2.12.0) | |
110 | ||
111 | qemu-system-ppcemb will be removed. qemu-system-ppc (or qemu-system-ppc64) | |
112 | should be used instead. That means that embedded 4xx PowerPC CPUs will not | |
113 | support page sizes < 4096 any longer. | |
114 | ||
115 | @section System emulator machines | |
116 | ||
117 | @subsection pc-0.10 and pc-0.11 (since 3.0) | |
118 | ||
119 | These machine types are very old and likely can not be used for live migration | |
120 | from old QEMU versions anymore. A newer machine type should be used instead. | |
121 | ||
93323287 HP |
122 | @subsection prep (PowerPC) (since 3.1) |
123 | ||
124 | This machine type uses an unmaintained firmware, broken in lots of ways, | |
125 | and unable to start post-2004 operating systems. 40p machine type should be | |
126 | used instead. | |
127 | ||
44c67847 MA |
128 | @section Device options |
129 | ||
130 | @subsection Block device options | |
131 | ||
132 | @subsubsection "backing": "" (since 2.12.0) | |
133 | ||
134 | In order to prevent QEMU from automatically opening an image's backing | |
135 | chain, use ``"backing": null'' instead. | |
136 | ||
137 | @subsection vio-spapr-device device options | |
138 | ||
139 | @subsubsection "irq": "" (since 3.0.0) | |
140 | ||
141 | The ``irq'' property is obsoleted. |