1 | |
2 | DEFHEADING(Standard options:) |
3 | |
4 | DEF("help" , 0, QEMU_OPTION_h, |
5 | "-h or -help display this help and exit\n" , QEMU_ARCH_ALL) |
6 | |
7 | DEF("version" , 0, QEMU_OPTION_version, |
8 | "-version display version information and exit\n" , QEMU_ARCH_ALL) |
9 | |
10 | DEF("machine" , HAS_ARG, QEMU_OPTION_machine, \ |
11 | "-machine [type=]name[,prop[=value][,...]]\n" |
12 | " selects emulated machine ('-machine help' for list)\n" |
13 | " property accel=accel1[:accel2[:...]] selects accelerator\n" |
14 | " supported accelerators are kvm, xen, hax, hvf, whpx or tcg (default: tcg)\n" |
15 | " kernel_irqchip=on|off|split controls accelerated irqchip support (default=off)\n" |
16 | " vmport=on|off|auto controls emulation of vmport (default: auto)\n" |
17 | " kvm_shadow_mem=size of KVM shadow MMU in bytes\n" |
18 | " dump-guest-core=on|off include guest memory in a core dump (default=on)\n" |
19 | " mem-merge=on|off controls memory merge support (default: on)\n" |
20 | " igd-passthru=on|off controls IGD GFX passthrough support (default=off)\n" |
21 | " aes-key-wrap=on|off controls support for AES key wrapping (default=on)\n" |
22 | " dea-key-wrap=on|off controls support for DEA key wrapping (default=on)\n" |
23 | " suppress-vmdesc=on|off disables self-describing migration (default=off)\n" |
24 | " nvdimm=on|off controls NVDIMM support (default=off)\n" |
25 | " enforce-config-section=on|off enforce configuration section migration (default=off)\n" |
26 | " memory-encryption=@var{} memory encryption object to use (default=none)\n" , |
27 | QEMU_ARCH_ALL) |
28 | |
29 | DEF("M" , HAS_ARG, QEMU_OPTION_M, "" , QEMU_ARCH_ALL) |
30 | |
31 | DEF("cpu" , HAS_ARG, QEMU_OPTION_cpu, |
32 | "-cpu cpu select CPU ('-cpu help' for list)\n" , QEMU_ARCH_ALL) |
33 | |
34 | DEF("accel" , HAS_ARG, QEMU_OPTION_accel, |
35 | "-accel [accel=]accelerator[,thread=single|multi]\n" |
36 | " select accelerator (kvm, xen, hax, hvf, whpx or tcg; use 'help' for a list)\n" |
37 | " thread=single|multi (enable multi-threaded TCG)\n" , QEMU_ARCH_ALL) |
38 | |
39 | DEF("smp" , HAS_ARG, QEMU_OPTION_smp, |
40 | "-smp [cpus=]n[,maxcpus=cpus][,cores=cores][,threads=threads][,dies=dies][,sockets=sockets]\n" |
41 | " set the number of CPUs to 'n' [default=1]\n" |
42 | " maxcpus= maximum number of total cpus, including\n" |
43 | " offline CPUs for hotplug, etc\n" |
44 | " cores= number of CPU cores on one socket (for PC, it's on one die)\n" |
45 | " threads= number of threads on one CPU core\n" |
46 | " dies= number of CPU dies on one socket (for PC only)\n" |
47 | " sockets= number of discrete sockets in the system\n" , |
48 | QEMU_ARCH_ALL) |
49 | |
50 | DEF("numa" , HAS_ARG, QEMU_OPTION_numa, |
51 | "-numa node[,mem=size][,cpus=firstcpu[-lastcpu]][,nodeid=node]\n" |
52 | "-numa node[,memdev=id][,cpus=firstcpu[-lastcpu]][,nodeid=node]\n" |
53 | "-numa dist,src=source,dst=destination,val=distance\n" |
54 | "-numa cpu,node-id=node[,socket-id=x][,core-id=y][,thread-id=z]\n" , |
55 | QEMU_ARCH_ALL) |
56 | |
57 | DEF("add-fd" , HAS_ARG, QEMU_OPTION_add_fd, |
58 | "-add-fd fd=fd,set=set[,opaque=opaque]\n" |
59 | " Add 'fd' to fd 'set'\n" , QEMU_ARCH_ALL) |
60 | |
61 | DEF("set" , HAS_ARG, QEMU_OPTION_set, |
62 | "-set group.id.arg=value\n" |
63 | " set <arg> parameter for item <id> of type <group>\n" |
64 | " i.e. -set drive.$id.file=/path/to/image\n" , QEMU_ARCH_ALL) |
65 | |
66 | DEF("global" , HAS_ARG, QEMU_OPTION_global, |
67 | "-global driver.property=value\n" |
68 | "-global driver=driver,property=property,value=value\n" |
69 | " set a global default for a driver property\n" , |
70 | QEMU_ARCH_ALL) |
71 | |
72 | DEF("boot" , HAS_ARG, QEMU_OPTION_boot, |
73 | "-boot [order=drives][,once=drives][,menu=on|off]\n" |
74 | " [,splash=sp_name][,splash-time=sp_time][,reboot-timeout=rb_time][,strict=on|off]\n" |
75 | " 'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)\n" |
76 | " 'sp_name': the file's name that would be passed to bios as logo picture, if menu=on\n" |
77 | " 'sp_time': the period that splash picture last if menu=on, unit is ms\n" |
78 | " 'rb_timeout': the timeout before guest reboot when boot failed, unit is ms\n" , |
79 | QEMU_ARCH_ALL) |
80 | |
81 | DEF("m" , HAS_ARG, QEMU_OPTION_m, |
82 | "-m [size=]megs[,slots=n,maxmem=size]\n" |
83 | " configure guest RAM\n" |
84 | " size: initial amount of guest memory\n" |
85 | " slots: number of hotplug slots (default: none)\n" |
86 | " maxmem: maximum amount of guest memory (default: none)\n" |
87 | "NOTE: Some architectures might enforce a specific granularity\n" , |
88 | QEMU_ARCH_ALL) |
89 | |
90 | DEF("mem-path" , HAS_ARG, QEMU_OPTION_mempath, |
91 | "-mem-path FILE provide backing storage for guest RAM\n" , QEMU_ARCH_ALL) |
92 | |
93 | DEF("mem-prealloc" , 0, QEMU_OPTION_mem_prealloc, |
94 | "-mem-prealloc preallocate guest memory (use with -mem-path)\n" , |
95 | QEMU_ARCH_ALL) |
96 | |
97 | DEF("k" , HAS_ARG, QEMU_OPTION_k, |
98 | "-k language use keyboard layout (for example 'fr' for French)\n" , |
99 | QEMU_ARCH_ALL) |
100 | |
101 | |
102 | DEF("audio-help" , 0, QEMU_OPTION_audio_help, |
103 | "-audio-help show -audiodev equivalent of the currently specified audio settings\n" , |
104 | QEMU_ARCH_ALL) |
105 | |
106 | DEF("audiodev" , HAS_ARG, QEMU_OPTION_audiodev, |
107 | "-audiodev [driver=]driver,id=id[,prop[=value][,...]]\n" |
108 | " specifies the audio backend to use\n" |
109 | " id= identifier of the backend\n" |
110 | " timer-period= timer period in microseconds\n" |
111 | " in|out.fixed-settings= use fixed settings for host audio\n" |
112 | " in|out.frequency= frequency to use with fixed settings\n" |
113 | " in|out.channels= number of channels to use with fixed settings\n" |
114 | " in|out.format= sample format to use with fixed settings\n" |
115 | " valid values: s8, s16, s32, u8, u16, u32\n" |
116 | " in|out.voices= number of voices to use\n" |
117 | " in|out.buffer-len= length of buffer in microseconds\n" |
118 | "-audiodev none,id=id,[,prop[=value][,...]]\n" |
119 | " dummy driver that discards all output\n" |
120 | #ifdef CONFIG_AUDIO_ALSA |
121 | "-audiodev alsa,id=id[,prop[=value][,...]]\n" |
122 | " in|out.dev= name of the audio device to use\n" |
123 | " in|out.period-len= length of period in microseconds\n" |
124 | " in|out.try-poll= attempt to use poll mode\n" |
125 | " threshold= threshold (in microseconds) when playback starts\n" |
126 | #endif |
127 | #ifdef CONFIG_AUDIO_COREAUDIO |
128 | "-audiodev coreaudio,id=id[,prop[=value][,...]]\n" |
129 | " in|out.buffer-count= number of buffers\n" |
130 | #endif |
131 | #ifdef CONFIG_AUDIO_DSOUND |
132 | "-audiodev dsound,id=id[,prop[=value][,...]]\n" |
133 | " latency= add extra latency to playback in microseconds\n" |
134 | #endif |
135 | #ifdef CONFIG_AUDIO_OSS |
136 | "-audiodev oss,id=id[,prop[=value][,...]]\n" |
137 | " in|out.dev= path of the audio device to use\n" |
138 | " in|out.buffer-count= number of buffers\n" |
139 | " in|out.try-poll= attempt to use poll mode\n" |
140 | " try-mmap= try using memory mapped access\n" |
141 | " exclusive= open device in exclusive mode\n" |
142 | " dsp-policy= set timing policy (0..10), -1 to use fragment mode\n" |
143 | #endif |
144 | #ifdef CONFIG_AUDIO_PA |
145 | "-audiodev pa,id=id[,prop[=value][,...]]\n" |
146 | " server= PulseAudio server address\n" |
147 | " in|out.name= source/sink device name\n" |
148 | #endif |
149 | #ifdef CONFIG_AUDIO_SDL |
150 | "-audiodev sdl,id=id[,prop[=value][,...]]\n" |
151 | #endif |
152 | #ifdef CONFIG_SPICE |
153 | "-audiodev spice,id=id[,prop[=value][,...]]\n" |
154 | #endif |
155 | "-audiodev wav,id=id[,prop[=value][,...]]\n" |
156 | " path= path of wav file to record\n" , |
157 | QEMU_ARCH_ALL) |
158 | |
159 | DEF("soundhw" , HAS_ARG, QEMU_OPTION_soundhw, |
160 | "-soundhw c1,... enable audio support\n" |
161 | " and only specified sound cards (comma separated list)\n" |
162 | " use '-soundhw help' to get the list of supported cards\n" |
163 | " use '-soundhw all' to enable all of them\n" , QEMU_ARCH_ALL) |
164 | |
165 | DEF("device" , HAS_ARG, QEMU_OPTION_device, |
166 | "-device driver[,prop[=value][,...]]\n" |
167 | " add device (based on driver)\n" |
168 | " prop=value,... sets driver properties\n" |
169 | " use '-device help' to print all possible drivers\n" |
170 | " use '-device driver,help' to print all possible properties\n" , |
171 | QEMU_ARCH_ALL) |
172 | |
173 | DEF("name" , HAS_ARG, QEMU_OPTION_name, |
174 | "-name string1[,process=string2][,debug-threads=on|off]\n" |
175 | " set the name of the guest\n" |
176 | " string1 sets the window title and string2 the process name\n" |
177 | " When debug-threads is enabled, individual threads are given a separate name\n" |
178 | " NOTE: The thread names are for debugging and not a stable API.\n" , |
179 | QEMU_ARCH_ALL) |
180 | |
181 | DEF("uuid" , HAS_ARG, QEMU_OPTION_uuid, |
182 | "-uuid %08x-%04x-%04x-%04x-%012x\n" |
183 | " specify machine UUID\n" , QEMU_ARCH_ALL) |
184 | |
185 | DEFHEADING() |
186 | |
187 | DEFHEADING(Block device options:) |
188 | |
189 | DEF("fda" , HAS_ARG, QEMU_OPTION_fda, |
190 | "-fda/-fdb file use 'file' as floppy disk 0/1 image\n" , QEMU_ARCH_ALL) |
191 | DEF("fdb" , HAS_ARG, QEMU_OPTION_fdb, "" , QEMU_ARCH_ALL) |
192 | |
193 | DEF("hda" , HAS_ARG, QEMU_OPTION_hda, |
194 | "-hda/-hdb file use 'file' as IDE hard disk 0/1 image\n" , QEMU_ARCH_ALL) |
195 | DEF("hdb" , HAS_ARG, QEMU_OPTION_hdb, "" , QEMU_ARCH_ALL) |
196 | DEF("hdc" , HAS_ARG, QEMU_OPTION_hdc, |
197 | "-hdc/-hdd file use 'file' as IDE hard disk 2/3 image\n" , QEMU_ARCH_ALL) |
198 | DEF("hdd" , HAS_ARG, QEMU_OPTION_hdd, "" , QEMU_ARCH_ALL) |
199 | |
200 | DEF("cdrom" , HAS_ARG, QEMU_OPTION_cdrom, |
201 | "-cdrom file use 'file' as IDE cdrom image (cdrom is ide1 master)\n" , |
202 | QEMU_ARCH_ALL) |
203 | |
204 | DEF("blockdev" , HAS_ARG, QEMU_OPTION_blockdev, |
205 | "-blockdev [driver=]driver[,node-name=N][,discard=ignore|unmap]\n" |
206 | " [,cache.direct=on|off][,cache.no-flush=on|off]\n" |
207 | " [,read-only=on|off][,detect-zeroes=on|off|unmap]\n" |
208 | " [,driver specific parameters...]\n" |
209 | " configure a block backend\n" , QEMU_ARCH_ALL) |
210 | |
211 | DEF("drive" , HAS_ARG, QEMU_OPTION_drive, |
212 | "-drive [file=file][,if=type][,bus=n][,unit=m][,media=d][,index=i]\n" |
213 | " [,cache=writethrough|writeback|none|directsync|unsafe][,format=f]\n" |
214 | " [,snapshot=on|off][,rerror=ignore|stop|report]\n" |
215 | " [,werror=ignore|stop|report|enospc][,id=name][,aio=threads|native]\n" |
216 | " [,readonly=on|off][,copy-on-read=on|off]\n" |
217 | " [,discard=ignore|unmap][,detect-zeroes=on|off|unmap]\n" |
218 | " [[,bps=b]|[[,bps_rd=r][,bps_wr=w]]]\n" |
219 | " [[,iops=i]|[[,iops_rd=r][,iops_wr=w]]]\n" |
220 | " [[,bps_max=bm]|[[,bps_rd_max=rm][,bps_wr_max=wm]]]\n" |
221 | " [[,iops_max=im]|[[,iops_rd_max=irm][,iops_wr_max=iwm]]]\n" |
222 | " [[,iops_size=is]]\n" |
223 | " [[,group=g]]\n" |
224 | " use 'file' as a drive image\n" , QEMU_ARCH_ALL) |
225 | |
226 | DEF("mtdblock" , HAS_ARG, QEMU_OPTION_mtdblock, |
227 | "-mtdblock file use 'file' as on-board Flash memory image\n" , |
228 | QEMU_ARCH_ALL) |
229 | |
230 | DEF("sd" , HAS_ARG, QEMU_OPTION_sd, |
231 | "-sd file use 'file' as SecureDigital card image\n" , QEMU_ARCH_ALL) |
232 | |
233 | DEF("pflash" , HAS_ARG, QEMU_OPTION_pflash, |
234 | "-pflash file use 'file' as a parallel flash image\n" , QEMU_ARCH_ALL) |
235 | |
236 | DEF("snapshot" , 0, QEMU_OPTION_snapshot, |
237 | "-snapshot write to temporary files instead of disk image files\n" , |
238 | QEMU_ARCH_ALL) |
239 | |
240 | DEF("fsdev" , HAS_ARG, QEMU_OPTION_fsdev, |
241 | "-fsdev local,id=id,path=path,security_model=mapped-xattr|mapped-file|passthrough|none\n" |
242 | " [,writeout=immediate][,readonly][,fmode=fmode][,dmode=dmode]\n" |
243 | " [[,throttling.bps-total=b]|[[,throttling.bps-read=r][,throttling.bps-write=w]]]\n" |
244 | " [[,throttling.iops-total=i]|[[,throttling.iops-read=r][,throttling.iops-write=w]]]\n" |
245 | " [[,throttling.bps-total-max=bm]|[[,throttling.bps-read-max=rm][,throttling.bps-write-max=wm]]]\n" |
246 | " [[,throttling.iops-total-max=im]|[[,throttling.iops-read-max=irm][,throttling.iops-write-max=iwm]]]\n" |
247 | " [[,throttling.iops-size=is]]\n" |
248 | "-fsdev proxy,id=id,socket=socket[,writeout=immediate][,readonly]\n" |
249 | "-fsdev proxy,id=id,sock_fd=sock_fd[,writeout=immediate][,readonly]\n" |
250 | "-fsdev synth,id=id\n" , |
251 | QEMU_ARCH_ALL) |
252 | |
253 | |
254 | DEF("virtfs" , HAS_ARG, QEMU_OPTION_virtfs, |
255 | "-virtfs local,path=path,mount_tag=tag,security_model=mapped-xattr|mapped-file|passthrough|none\n" |
256 | " [,id=id][,writeout=immediate][,readonly][,fmode=fmode][,dmode=dmode]\n" |
257 | "-virtfs proxy,mount_tag=tag,socket=socket[,id=id][,writeout=immediate][,readonly]\n" |
258 | "-virtfs proxy,mount_tag=tag,sock_fd=sock_fd[,id=id][,writeout=immediate][,readonly]\n" |
259 | "-virtfs synth,mount_tag=tag[,id=id][,readonly]\n" , |
260 | QEMU_ARCH_ALL) |
261 | |
262 | |
263 | DEF("virtfs_synth" , 0, QEMU_OPTION_virtfs_synth, |
264 | "-virtfs_synth Create synthetic file system image\n" , |
265 | QEMU_ARCH_ALL) |
266 | |
267 | DEF("iscsi" , HAS_ARG, QEMU_OPTION_iscsi, |
268 | "-iscsi [user=user][,password=password]\n" |
269 | " [,header-digest=CRC32C|CR32C-NONE|NONE-CRC32C|NONE\n" |
270 | " [,initiator-name=initiator-iqn][,id=target-iqn]\n" |
271 | " [,timeout=timeout]\n" |
272 | " iSCSI session parameters\n" , QEMU_ARCH_ALL) |
273 | |
274 | |
275 | DEFHEADING() |
276 | |
277 | DEFHEADING(USB options:) |
278 | |
279 | DEF("usb" , 0, QEMU_OPTION_usb, |
280 | "-usb enable on-board USB host controller (if not enabled by default)\n" , |
281 | QEMU_ARCH_ALL) |
282 | |
283 | DEF("usbdevice" , HAS_ARG, QEMU_OPTION_usbdevice, |
284 | "-usbdevice name add the host or guest USB device 'name'\n" , |
285 | QEMU_ARCH_ALL) |
286 | |
287 | DEFHEADING() |
288 | |
289 | DEFHEADING(Display options:) |
290 | |
291 | DEF("display" , HAS_ARG, QEMU_OPTION_display, |
292 | "-display spice-app[,gl=on|off]\n" |
293 | "-display sdl[,frame=on|off][,alt_grab=on|off][,ctrl_grab=on|off]\n" |
294 | " [,window_close=on|off][,gl=on|core|es|off]\n" |
295 | "-display gtk[,grab_on_hover=on|off][,gl=on|off]|\n" |
296 | "-display vnc=<display>[,<optargs>]\n" |
297 | "-display curses[,charset=<encoding>]\n" |
298 | "-display none\n" |
299 | "-display egl-headless[,rendernode=<file>]" |
300 | " select display type\n" |
301 | "The default display is equivalent to\n" |
302 | #if defined(CONFIG_GTK) |
303 | "\t\"-display gtk\"\n" |
304 | #elif defined(CONFIG_SDL) |
305 | "\t\"-display sdl\"\n" |
306 | #elif defined(CONFIG_COCOA) |
307 | "\t\"-display cocoa\"\n" |
308 | #elif defined(CONFIG_VNC) |
309 | "\t\"-vnc localhost:0,to=99,id=default\"\n" |
310 | #else |
311 | "\t\"-display none\"\n" |
312 | #endif |
313 | , QEMU_ARCH_ALL) |
314 | |
315 | DEF("nographic" , 0, QEMU_OPTION_nographic, |
316 | "-nographic disable graphical output and redirect serial I/Os to console\n" , |
317 | QEMU_ARCH_ALL) |
318 | |
319 | DEF("curses" , 0, QEMU_OPTION_curses, |
320 | "-curses shorthand for -display curses\n" , |
321 | QEMU_ARCH_ALL) |
322 | |
323 | DEF("alt-grab" , 0, QEMU_OPTION_alt_grab, |
324 | "-alt-grab use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt)\n" , |
325 | QEMU_ARCH_ALL) |
326 | |
327 | DEF("ctrl-grab" , 0, QEMU_OPTION_ctrl_grab, |
328 | "-ctrl-grab use Right-Ctrl to grab mouse (instead of Ctrl-Alt)\n" , |
329 | QEMU_ARCH_ALL) |
330 | |
331 | DEF("no-quit" , 0, QEMU_OPTION_no_quit, |
332 | "-no-quit disable SDL window close capability\n" , QEMU_ARCH_ALL) |
333 | |
334 | DEF("sdl" , 0, QEMU_OPTION_sdl, |
335 | "-sdl shorthand for -display sdl\n" , QEMU_ARCH_ALL) |
336 | |
337 | DEF("spice" , HAS_ARG, QEMU_OPTION_spice, |
338 | "-spice [port=port][,tls-port=secured-port][,x509-dir=<dir>]\n" |
339 | " [,x509-key-file=<file>][,x509-key-password=<file>]\n" |
340 | " [,x509-cert-file=<file>][,x509-cacert-file=<file>]\n" |
341 | " [,x509-dh-key-file=<file>][,addr=addr][,ipv4|ipv6|unix]\n" |
342 | " [,tls-ciphers=<list>]\n" |
343 | " [,tls-channel=[main|display|cursor|inputs|record|playback]]\n" |
344 | " [,plaintext-channel=[main|display|cursor|inputs|record|playback]]\n" |
345 | " [,sasl][,password=<secret>][,disable-ticketing]\n" |
346 | " [,image-compression=[auto_glz|auto_lz|quic|glz|lz|off]]\n" |
347 | " [,jpeg-wan-compression=[auto|never|always]]\n" |
348 | " [,zlib-glz-wan-compression=[auto|never|always]]\n" |
349 | " [,streaming-video=[off|all|filter]][,disable-copy-paste]\n" |
350 | " [,disable-agent-file-xfer][,agent-mouse=[on|off]]\n" |
351 | " [,playback-compression=[on|off]][,seamless-migration=[on|off]]\n" |
352 | " [,gl=[on|off]][,rendernode=<file>]\n" |
353 | " enable spice\n" |
354 | " at least one of {port, tls-port} is mandatory\n" , |
355 | QEMU_ARCH_ALL) |
356 | |
357 | DEF("portrait" , 0, QEMU_OPTION_portrait, |
358 | "-portrait rotate graphical output 90 deg left (only PXA LCD)\n" , |
359 | QEMU_ARCH_ALL) |
360 | |
361 | DEF("rotate" , HAS_ARG, QEMU_OPTION_rotate, |
362 | "-rotate <deg> rotate graphical output some deg left (only PXA LCD)\n" , |
363 | QEMU_ARCH_ALL) |
364 | |
365 | DEF("vga" , HAS_ARG, QEMU_OPTION_vga, |
366 | "-vga [std|cirrus|vmware|qxl|xenfb|tcx|cg3|virtio|none]\n" |
367 | " select video card type\n" , QEMU_ARCH_ALL) |
368 | |
369 | DEF("full-screen" , 0, QEMU_OPTION_full_screen, |
370 | "-full-screen start in full screen\n" , QEMU_ARCH_ALL) |
371 | |
372 | DEF("g" , 1, QEMU_OPTION_g , |
373 | "-g WxH[xDEPTH] Set the initial graphical resolution and depth\n" , |
374 | QEMU_ARCH_PPC | QEMU_ARCH_SPARC) |
375 | |
376 | DEF("vnc" , HAS_ARG, QEMU_OPTION_vnc , |
377 | "-vnc <display> shorthand for -display vnc=<display>\n" , QEMU_ARCH_ALL) |
378 | |
379 | ARCHHEADING(, QEMU_ARCH_I386) |
380 | |
381 | ARCHHEADING(i386 target only:, QEMU_ARCH_I386) |
382 | |
383 | DEF("win2k-hack" , 0, QEMU_OPTION_win2k_hack, |
384 | "-win2k-hack use it when installing Windows 2000 to avoid a disk full bug\n" , |
385 | QEMU_ARCH_I386) |
386 | |
387 | DEF("no-fd-bootchk" , 0, QEMU_OPTION_no_fd_bootchk, |
388 | "-no-fd-bootchk disable boot signature checking for floppy disks\n" , |
389 | QEMU_ARCH_I386) |
390 | |
391 | DEF("no-acpi" , 0, QEMU_OPTION_no_acpi, |
392 | "-no-acpi disable ACPI\n" , QEMU_ARCH_I386 | QEMU_ARCH_ARM) |
393 | |
394 | DEF("no-hpet" , 0, QEMU_OPTION_no_hpet, |
395 | "-no-hpet disable HPET\n" , QEMU_ARCH_I386) |
396 | |
397 | DEF("acpitable" , HAS_ARG, QEMU_OPTION_acpitable, |
398 | "-acpitable [sig=str][,rev=n][,oem_id=str][,oem_table_id=str][,oem_rev=n][,asl_compiler_id=str][,asl_compiler_rev=n][,{data|file}=file1[:file2]...]\n" |
399 | " ACPI table description\n" , QEMU_ARCH_I386) |
400 | |
401 | DEF("smbios" , HAS_ARG, QEMU_OPTION_smbios, |
402 | "-smbios file=binary\n" |
403 | " load SMBIOS entry from binary file\n" |
404 | "-smbios type=0[,vendor=str][,version=str][,date=str][,release=%d.%d]\n" |
405 | " [,uefi=on|off]\n" |
406 | " specify SMBIOS type 0 fields\n" |
407 | "-smbios type=1[,manufacturer=str][,product=str][,version=str][,serial=str]\n" |
408 | " [,uuid=uuid][,sku=str][,family=str]\n" |
409 | " specify SMBIOS type 1 fields\n" |
410 | "-smbios type=2[,manufacturer=str][,product=str][,version=str][,serial=str]\n" |
411 | " [,asset=str][,location=str]\n" |
412 | " specify SMBIOS type 2 fields\n" |
413 | "-smbios type=3[,manufacturer=str][,version=str][,serial=str][,asset=str]\n" |
414 | " [,sku=str]\n" |
415 | " specify SMBIOS type 3 fields\n" |
416 | "-smbios type=4[,sock_pfx=str][,manufacturer=str][,version=str][,serial=str]\n" |
417 | " [,asset=str][,part=str]\n" |
418 | " specify SMBIOS type 4 fields\n" |
419 | "-smbios type=17[,loc_pfx=str][,bank=str][,manufacturer=str][,serial=str]\n" |
420 | " [,asset=str][,part=str][,speed=%d]\n" |
421 | " specify SMBIOS type 17 fields\n" , |
422 | QEMU_ARCH_I386 | QEMU_ARCH_ARM) |
423 | |
424 | DEFHEADING() |
425 | |
426 | DEFHEADING(Network options:) |
427 | |
428 | DEF("netdev" , HAS_ARG, QEMU_OPTION_netdev, |
429 | #ifdef CONFIG_SLIRP |
430 | "-netdev user,id=str[,ipv4[=on|off]][,net=addr[/mask]][,host=addr]\n" |
431 | " [,ipv6[=on|off]][,ipv6-net=addr[/int]][,ipv6-host=addr]\n" |
432 | " [,restrict=on|off][,hostname=host][,dhcpstart=addr]\n" |
433 | " [,dns=addr][,ipv6-dns=addr][,dnssearch=domain][,domainname=domain]\n" |
434 | " [,tftp=dir][,tftp-server-name=name][,bootfile=f][,hostfwd=rule][,guestfwd=rule]" |
435 | #ifndef _WIN32 |
436 | "[,smb=dir[,smbserver=addr]]\n" |
437 | #endif |
438 | " configure a user mode network backend with ID 'str',\n" |
439 | " its DHCP server and optional services\n" |
440 | #endif |
441 | #ifdef _WIN32 |
442 | "-netdev tap,id=str,ifname=name\n" |
443 | " configure a host TAP network backend with ID 'str'\n" |
444 | #else |
445 | "-netdev tap,id=str[,fd=h][,fds=x:y:...:z][,ifname=name][,script=file][,downscript=dfile]\n" |
446 | " [,br=bridge][,helper=helper][,sndbuf=nbytes][,vnet_hdr=on|off][,vhost=on|off]\n" |
447 | " [,vhostfd=h][,vhostfds=x:y:...:z][,vhostforce=on|off][,queues=n]\n" |
448 | " [,poll-us=n]\n" |
449 | " configure a host TAP network backend with ID 'str'\n" |
450 | " connected to a bridge (default=" DEFAULT_BRIDGE_INTERFACE ")\n" |
451 | " use network scripts 'file' (default=" DEFAULT_NETWORK_SCRIPT ")\n" |
452 | " to configure it and 'dfile' (default=" DEFAULT_NETWORK_DOWN_SCRIPT ")\n" |
453 | " to deconfigure it\n" |
454 | " use '[down]script=no' to disable script execution\n" |
455 | " use network helper 'helper' (default=" DEFAULT_BRIDGE_HELPER ") to\n" |
456 | " configure it\n" |
457 | " use 'fd=h' to connect to an already opened TAP interface\n" |
458 | " use 'fds=x:y:...:z' to connect to already opened multiqueue capable TAP interfaces\n" |
459 | " use 'sndbuf=nbytes' to limit the size of the send buffer (the\n" |
460 | " default is disabled 'sndbuf=0' to enable flow control set 'sndbuf=1048576')\n" |
461 | " use vnet_hdr=off to avoid enabling the IFF_VNET_HDR tap flag\n" |
462 | " use vnet_hdr=on to make the lack of IFF_VNET_HDR support an error condition\n" |
463 | " use vhost=on to enable experimental in kernel accelerator\n" |
464 | " (only has effect for virtio guests which use MSIX)\n" |
465 | " use vhostforce=on to force vhost on for non-MSIX virtio guests\n" |
466 | " use 'vhostfd=h' to connect to an already opened vhost net device\n" |
467 | " use 'vhostfds=x:y:...:z to connect to multiple already opened vhost net devices\n" |
468 | " use 'queues=n' to specify the number of queues to be created for multiqueue TAP\n" |
469 | " use 'poll-us=n' to speciy the maximum number of microseconds that could be\n" |
470 | " spent on busy polling for vhost net\n" |
471 | "-netdev bridge,id=str[,br=bridge][,helper=helper]\n" |
472 | " configure a host TAP network backend with ID 'str' that is\n" |
473 | " connected to a bridge (default=" DEFAULT_BRIDGE_INTERFACE ")\n" |
474 | " using the program 'helper (default=" DEFAULT_BRIDGE_HELPER ")\n" |
475 | #endif |
476 | #ifdef __linux__ |
477 | "-netdev l2tpv3,id=str,src=srcaddr,dst=dstaddr[,srcport=srcport][,dstport=dstport]\n" |
478 | " [,rxsession=rxsession],txsession=txsession[,ipv6=on/off][,udp=on/off]\n" |
479 | " [,cookie64=on/off][,counter][,pincounter][,txcookie=txcookie]\n" |
480 | " [,rxcookie=rxcookie][,offset=offset]\n" |
481 | " configure a network backend with ID 'str' connected to\n" |
482 | " an Ethernet over L2TPv3 pseudowire.\n" |
483 | " Linux kernel 3.3+ as well as most routers can talk\n" |
484 | " L2TPv3. This transport allows connecting a VM to a VM,\n" |
485 | " VM to a router and even VM to Host. It is a nearly-universal\n" |
486 | " standard (RFC3391). Note - this implementation uses static\n" |
487 | " pre-configured tunnels (same as the Linux kernel).\n" |
488 | " use 'src=' to specify source address\n" |
489 | " use 'dst=' to specify destination address\n" |
490 | " use 'udp=on' to specify udp encapsulation\n" |
491 | " use 'srcport=' to specify source udp port\n" |
492 | " use 'dstport=' to specify destination udp port\n" |
493 | " use 'ipv6=on' to force v6\n" |
494 | " L2TPv3 uses cookies to prevent misconfiguration as\n" |
495 | " well as a weak security measure\n" |
496 | " use 'rxcookie=0x012345678' to specify a rxcookie\n" |
497 | " use 'txcookie=0x012345678' to specify a txcookie\n" |
498 | " use 'cookie64=on' to set cookie size to 64 bit, otherwise 32\n" |
499 | " use 'counter=off' to force a 'cut-down' L2TPv3 with no counter\n" |
500 | " use 'pincounter=on' to work around broken counter handling in peer\n" |
501 | " use 'offset=X' to add an extra offset between header and data\n" |
502 | #endif |
503 | "-netdev socket,id=str[,fd=h][,listen=[host]:port][,connect=host:port]\n" |
504 | " configure a network backend to connect to another network\n" |
505 | " using a socket connection\n" |
506 | "-netdev socket,id=str[,fd=h][,mcast=maddr:port[,localaddr=addr]]\n" |
507 | " configure a network backend to connect to a multicast maddr and port\n" |
508 | " use 'localaddr=addr' to specify the host address to send packets from\n" |
509 | "-netdev socket,id=str[,fd=h][,udp=host:port][,localaddr=host:port]\n" |
510 | " configure a network backend to connect to another network\n" |
511 | " using an UDP tunnel\n" |
512 | #ifdef CONFIG_VDE |
513 | "-netdev vde,id=str[,sock=socketpath][,port=n][,group=groupname][,mode=octalmode]\n" |
514 | " configure a network backend to connect to port 'n' of a vde switch\n" |
515 | " running on host and listening for incoming connections on 'socketpath'.\n" |
516 | " Use group 'groupname' and mode 'octalmode' to change default\n" |
517 | " ownership and permissions for communication port.\n" |
518 | #endif |
519 | #ifdef CONFIG_NETMAP |
520 | "-netdev netmap,id=str,ifname=name[,devname=nmname]\n" |
521 | " attach to the existing netmap-enabled network interface 'name', or to a\n" |
522 | " VALE port (created on the fly) called 'name' ('nmname' is name of the \n" |
523 | " netmap device, defaults to '/dev/netmap')\n" |
524 | #endif |
525 | #ifdef CONFIG_POSIX |
526 | "-netdev vhost-user,id=str,chardev=dev[,vhostforce=on|off]\n" |
527 | " configure a vhost-user network, backed by a chardev 'dev'\n" |
528 | #endif |
529 | "-netdev hubport,id=str,hubid=n[,netdev=nd]\n" |
530 | " configure a hub port on the hub with ID 'n'\n" , QEMU_ARCH_ALL) |
531 | DEF("nic" , HAS_ARG, QEMU_OPTION_nic, |
532 | "-nic [tap|bridge|" |
533 | #ifdef CONFIG_SLIRP |
534 | "user|" |
535 | #endif |
536 | #ifdef __linux__ |
537 | "l2tpv3|" |
538 | #endif |
539 | #ifdef CONFIG_VDE |
540 | "vde|" |
541 | #endif |
542 | #ifdef CONFIG_NETMAP |
543 | "netmap|" |
544 | #endif |
545 | #ifdef CONFIG_POSIX |
546 | "vhost-user|" |
547 | #endif |
548 | "socket][,option][,...][mac=macaddr]\n" |
549 | " initialize an on-board / default host NIC (using MAC address\n" |
550 | " macaddr) and connect it to the given host network backend\n" |
551 | "-nic none use it alone to have zero network devices (the default is to\n" |
552 | " provided a 'user' network connection)\n" , |
553 | QEMU_ARCH_ALL) |
554 | DEF("net" , HAS_ARG, QEMU_OPTION_net, |
555 | "-net nic[,macaddr=mac][,model=type][,name=str][,addr=str][,vectors=v]\n" |
556 | " configure or create an on-board (or machine default) NIC and\n" |
557 | " connect it to hub 0 (please use -nic unless you need a hub)\n" |
558 | "-net [" |
559 | #ifdef CONFIG_SLIRP |
560 | "user|" |
561 | #endif |
562 | "tap|" |
563 | "bridge|" |
564 | #ifdef CONFIG_VDE |
565 | "vde|" |
566 | #endif |
567 | #ifdef CONFIG_NETMAP |
568 | "netmap|" |
569 | #endif |
570 | "socket][,option][,option][,...]\n" |
571 | " old way to initialize a host network interface\n" |
572 | " (use the -netdev option if possible instead)\n" , QEMU_ARCH_ALL) |
573 | |
574 | DEFHEADING() |
575 | |
576 | DEFHEADING(Character device options:) |
577 | |
578 | DEF("chardev" , HAS_ARG, QEMU_OPTION_chardev, |
579 | "-chardev help\n" |
580 | "-chardev null,id=id[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
581 | "-chardev socket,id=id[,host=host],port=port[,to=to][,ipv4][,ipv6][,nodelay][,reconnect=seconds]\n" |
582 | " [,server][,nowait][,telnet][,websocket][,reconnect=seconds][,mux=on|off]\n" |
583 | " [,logfile=PATH][,logappend=on|off][,tls-creds=ID][,tls-authz=ID] (tcp)\n" |
584 | "-chardev socket,id=id,path=path[,server][,nowait][,telnet][,websocket][,reconnect=seconds]\n" |
585 | " [,mux=on|off][,logfile=PATH][,logappend=on|off] (unix)\n" |
586 | "-chardev udp,id=id[,host=host],port=port[,localaddr=localaddr]\n" |
587 | " [,localport=localport][,ipv4][,ipv6][,mux=on|off]\n" |
588 | " [,logfile=PATH][,logappend=on|off]\n" |
589 | "-chardev msmouse,id=id[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
590 | "-chardev vc,id=id[[,width=width][,height=height]][[,cols=cols][,rows=rows]]\n" |
591 | " [,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
592 | "-chardev ringbuf,id=id[,size=size][,logfile=PATH][,logappend=on|off]\n" |
593 | "-chardev file,id=id,path=path[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
594 | "-chardev pipe,id=id,path=path[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
595 | #ifdef _WIN32 |
596 | "-chardev console,id=id[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
597 | "-chardev serial,id=id,path=path[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
598 | #else |
599 | "-chardev pty,id=id[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
600 | "-chardev stdio,id=id[,mux=on|off][,signal=on|off][,logfile=PATH][,logappend=on|off]\n" |
601 | #endif |
602 | #ifdef CONFIG_BRLAPI |
603 | "-chardev braille,id=id[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
604 | #endif |
605 | #if defined(__linux__) || defined(__sun__) || defined(__FreeBSD__) \ |
606 | || defined(__NetBSD__) || defined(__OpenBSD__) || defined(__DragonFly__) |
607 | "-chardev serial,id=id,path=path[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
608 | "-chardev tty,id=id,path=path[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
609 | #endif |
610 | #if defined(__linux__) || defined(__FreeBSD__) || defined(__DragonFly__) |
611 | "-chardev parallel,id=id,path=path[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
612 | "-chardev parport,id=id,path=path[,mux=on|off][,logfile=PATH][,logappend=on|off]\n" |
613 | #endif |
614 | #if defined(CONFIG_SPICE) |
615 | "-chardev spicevmc,id=id,name=name[,debug=debug][,logfile=PATH][,logappend=on|off]\n" |
616 | "-chardev spiceport,id=id,name=name[,debug=debug][,logfile=PATH][,logappend=on|off]\n" |
617 | #endif |
618 | , QEMU_ARCH_ALL |
619 | ) |
620 | |
621 | |
622 | DEFHEADING() |
623 | |
624 | DEFHEADING(Bluetooth(R) options:) |
625 | |
626 | DEF("bt" , HAS_ARG, QEMU_OPTION_bt, \ |
627 | "-bt hci,null dumb bluetooth HCI - doesn't respond to commands\n" \ |
628 | "-bt hci,host[:id]\n" \ |
629 | " use host's HCI with the given name\n" \ |
630 | "-bt hci[,vlan=n]\n" \ |
631 | " emulate a standard HCI in virtual scatternet 'n'\n" \ |
632 | "-bt vhci[,vlan=n]\n" \ |
633 | " add host computer to virtual scatternet 'n' using VHCI\n" \ |
634 | "-bt device:dev[,vlan=n]\n" \ |
635 | " emulate a bluetooth device 'dev' in scatternet 'n'\n" , |
636 | QEMU_ARCH_ALL) |
637 | |
638 | DEFHEADING() |
639 | |
640 | #ifdef CONFIG_TPM |
641 | DEFHEADING(TPM device options:) |
642 | |
643 | DEF("tpmdev" , HAS_ARG, QEMU_OPTION_tpmdev, \ |
644 | "-tpmdev passthrough,id=id[,path=path][,cancel-path=path]\n" |
645 | " use path to provide path to a character device; default is /dev/tpm0\n" |
646 | " use cancel-path to provide path to TPM's cancel sysfs entry; if\n" |
647 | " not provided it will be searched for in /sys/class/misc/tpm?/device\n" |
648 | "-tpmdev emulator,id=id,chardev=dev\n" |
649 | " configure the TPM device using chardev backend\n" , |
650 | QEMU_ARCH_ALL) |
651 | |
652 | DEFHEADING() |
653 | |
654 | #endif |
655 | |
656 | DEFHEADING(Linux/Multiboot boot specific:) |
657 | |
658 | DEF("kernel" , HAS_ARG, QEMU_OPTION_kernel, \ |
659 | "-kernel bzImage use 'bzImage' as kernel image\n" , QEMU_ARCH_ALL) |
660 | |
661 | DEF("append" , HAS_ARG, QEMU_OPTION_append, \ |
662 | "-append cmdline use 'cmdline' as kernel command line\n" , QEMU_ARCH_ALL) |
663 | |
664 | DEF("initrd" , HAS_ARG, QEMU_OPTION_initrd, \ |
665 | "-initrd file use 'file' as initial ram disk\n" , QEMU_ARCH_ALL) |
666 | |
667 | DEF("dtb" , HAS_ARG, QEMU_OPTION_dtb, \ |
668 | "-dtb file use 'file' as device tree image\n" , QEMU_ARCH_ALL) |
669 | |
670 | DEFHEADING() |
671 | |
672 | DEFHEADING(Debug/Expert options:) |
673 | |
674 | DEF("fw_cfg" , HAS_ARG, QEMU_OPTION_fwcfg, |
675 | "-fw_cfg [name=]<name>,file=<file>\n" |
676 | " add named fw_cfg entry with contents from file\n" |
677 | "-fw_cfg [name=]<name>,string=<str>\n" |
678 | " add named fw_cfg entry with contents from string\n" , |
679 | QEMU_ARCH_ALL) |
680 | |
681 | DEF("serial" , HAS_ARG, QEMU_OPTION_serial, \ |
682 | "-serial dev redirect the serial port to char device 'dev'\n" , |
683 | QEMU_ARCH_ALL) |
684 | |
685 | DEF("parallel" , HAS_ARG, QEMU_OPTION_parallel, \ |
686 | "-parallel dev redirect the parallel port to char device 'dev'\n" , |
687 | QEMU_ARCH_ALL) |
688 | |
689 | DEF("monitor" , HAS_ARG, QEMU_OPTION_monitor, \ |
690 | "-monitor dev redirect the monitor to char device 'dev'\n" , |
691 | QEMU_ARCH_ALL) |
692 | DEF("qmp" , HAS_ARG, QEMU_OPTION_qmp, \ |
693 | "-qmp dev like -monitor but opens in 'control' mode\n" , |
694 | QEMU_ARCH_ALL) |
695 | DEF("qmp-pretty" , HAS_ARG, QEMU_OPTION_qmp_pretty, \ |
696 | "-qmp-pretty dev like -qmp but uses pretty JSON formatting\n" , |
697 | QEMU_ARCH_ALL) |
698 | |
699 | DEF("mon" , HAS_ARG, QEMU_OPTION_mon, \ |
700 | "-mon [chardev=]name[,mode=readline|control][,pretty[=on|off]]\n" , QEMU_ARCH_ALL) |
701 | |
702 | DEF("debugcon" , HAS_ARG, QEMU_OPTION_debugcon, \ |
703 | "-debugcon dev redirect the debug console to char device 'dev'\n" , |
704 | QEMU_ARCH_ALL) |
705 | |
706 | DEF("pidfile" , HAS_ARG, QEMU_OPTION_pidfile, \ |
707 | "-pidfile file write PID to 'file'\n" , QEMU_ARCH_ALL) |
708 | |
709 | DEF("singlestep" , 0, QEMU_OPTION_singlestep, \ |
710 | "-singlestep always run in singlestep mode\n" , QEMU_ARCH_ALL) |
711 | |
712 | DEF("preconfig" , 0, QEMU_OPTION_preconfig, \ |
713 | "--preconfig pause QEMU before machine is initialized (experimental)\n" , |
714 | QEMU_ARCH_ALL) |
715 | |
716 | DEF("S" , 0, QEMU_OPTION_S, \ |
717 | "-S freeze CPU at startup (use 'c' to start execution)\n" , |
718 | QEMU_ARCH_ALL) |
719 | |
720 | DEF("realtime" , HAS_ARG, QEMU_OPTION_realtime, |
721 | "-realtime [mlock=on|off]\n" |
722 | " run qemu with realtime features\n" |
723 | " mlock=on|off controls mlock support (default: on)\n" , |
724 | QEMU_ARCH_ALL) |
725 | |
726 | DEF("overcommit" , HAS_ARG, QEMU_OPTION_overcommit, |
727 | "-overcommit [mem-lock=on|off][cpu-pm=on|off]\n" |
728 | " run qemu with overcommit hints\n" |
729 | " mem-lock=on|off controls memory lock support (default: off)\n" |
730 | " cpu-pm=on|off controls cpu power management (default: off)\n" , |
731 | QEMU_ARCH_ALL) |
732 | |
733 | DEF("gdb" , HAS_ARG, QEMU_OPTION_gdb, \ |
734 | "-gdb dev wait for gdb connection on 'dev'\n" , QEMU_ARCH_ALL) |
735 | |
736 | DEF("s" , 0, QEMU_OPTION_s, \ |
737 | "-s shorthand for -gdb tcp::" DEFAULT_GDBSTUB_PORT "\n" , |
738 | QEMU_ARCH_ALL) |
739 | |
740 | DEF("d" , HAS_ARG, QEMU_OPTION_d, \ |
741 | "-d item1,... enable logging of specified items (use '-d help' for a list of log items)\n" , |
742 | QEMU_ARCH_ALL) |
743 | |
744 | DEF("D" , HAS_ARG, QEMU_OPTION_D, \ |
745 | "-D logfile output log to logfile (default stderr)\n" , |
746 | QEMU_ARCH_ALL) |
747 | |
748 | DEF("dfilter" , HAS_ARG, QEMU_OPTION_DFILTER, \ |
749 | "-dfilter range,.. filter debug output to range of addresses (useful for -d cpu,exec,etc..)\n" , |
750 | QEMU_ARCH_ALL) |
751 | |
752 | DEF("seed" , HAS_ARG, QEMU_OPTION_seed, \ |
753 | "-seed number seed the pseudo-random number generator\n" , |
754 | QEMU_ARCH_ALL) |
755 | |
756 | DEF("L" , HAS_ARG, QEMU_OPTION_L, \ |
757 | "-L path set the directory for the BIOS, VGA BIOS and keymaps\n" , |
758 | QEMU_ARCH_ALL) |
759 | |
760 | DEF("bios" , HAS_ARG, QEMU_OPTION_bios, \ |
761 | "-bios file set the filename for the BIOS\n" , QEMU_ARCH_ALL) |
762 | |
763 | DEF("enable-kvm" , 0, QEMU_OPTION_enable_kvm, \ |
764 | "-enable-kvm enable KVM full virtualization support\n" , QEMU_ARCH_ALL) |
765 | |
766 | DEF("xen-domid" , HAS_ARG, QEMU_OPTION_xen_domid, |
767 | "-xen-domid id specify xen guest domain id\n" , QEMU_ARCH_ALL) |
768 | DEF("xen-attach" , 0, QEMU_OPTION_xen_attach, |
769 | "-xen-attach attach to existing xen domain\n" |
770 | " libxl will use this when starting QEMU\n" , |
771 | QEMU_ARCH_ALL) |
772 | DEF("xen-domid-restrict" , 0, QEMU_OPTION_xen_domid_restrict, |
773 | "-xen-domid-restrict restrict set of available xen operations\n" |
774 | " to specified domain id. (Does not affect\n" |
775 | " xenpv machine type).\n" , |
776 | QEMU_ARCH_ALL) |
777 | |
778 | DEF("no-reboot" , 0, QEMU_OPTION_no_reboot, \ |
779 | "-no-reboot exit instead of rebooting\n" , QEMU_ARCH_ALL) |
780 | |
781 | DEF("no-shutdown" , 0, QEMU_OPTION_no_shutdown, \ |
782 | "-no-shutdown stop before shutdown\n" , QEMU_ARCH_ALL) |
783 | |
784 | DEF("loadvm" , HAS_ARG, QEMU_OPTION_loadvm, \ |
785 | "-loadvm [tag|id]\n" \ |
786 | " start right away with a saved state (loadvm in monitor)\n" , |
787 | QEMU_ARCH_ALL) |
788 | |
789 | #ifndef _WIN32 |
790 | DEF("daemonize" , 0, QEMU_OPTION_daemonize, \ |
791 | "-daemonize daemonize QEMU after initializing\n" , QEMU_ARCH_ALL) |
792 | #endif |
793 | |
794 | DEF("option-rom" , HAS_ARG, QEMU_OPTION_option_rom, \ |
795 | "-option-rom rom load a file, rom, into the option ROM space\n" , |
796 | QEMU_ARCH_ALL) |
797 | |
798 | DEF("rtc" , HAS_ARG, QEMU_OPTION_rtc, \ |
799 | "-rtc [base=utc|localtime|<datetime>][,clock=host|rt|vm][,driftfix=none|slew]\n" \ |
800 | " set the RTC base and clock, enable drift fix for clock ticks (x86 only)\n" , |
801 | QEMU_ARCH_ALL) |
802 | |
803 | |
804 | DEF("icount" , HAS_ARG, QEMU_OPTION_icount, \ |
805 | "-icount [shift=N|auto][,align=on|off][,sleep=on|off,rr=record|replay,rrfile=<filename>,rrsnapshot=<snapshot>]\n" \ |
806 | " enable virtual instruction counter with 2^N clock ticks per\n" \ |
807 | " instruction, enable aligning the host and virtual clocks\n" \ |
808 | " or disable real time cpu sleeping\n" , QEMU_ARCH_ALL) |
809 | |
810 | DEF("watchdog" , HAS_ARG, QEMU_OPTION_watchdog, \ |
811 | "-watchdog model\n" \ |
812 | " enable virtual hardware watchdog [default=none]\n" , |
813 | QEMU_ARCH_ALL) |
814 | |
815 | DEF("watchdog-action" , HAS_ARG, QEMU_OPTION_watchdog_action, \ |
816 | "-watchdog-action reset|shutdown|poweroff|inject-nmi|pause|debug|none\n" \ |
817 | " action when watchdog fires [default=reset]\n" , |
818 | QEMU_ARCH_ALL) |
819 | |
820 | DEF("echr" , HAS_ARG, QEMU_OPTION_echr, \ |
821 | "-echr chr set terminal escape character instead of ctrl-a\n" , |
822 | QEMU_ARCH_ALL) |
823 | |
824 | DEF("show-cursor" , 0, QEMU_OPTION_show_cursor, \ |
825 | "-show-cursor show cursor\n" , QEMU_ARCH_ALL) |
826 | |
827 | DEF("tb-size" , HAS_ARG, QEMU_OPTION_tb_size, \ |
828 | "-tb-size n set TB size\n" , QEMU_ARCH_ALL) |
829 | |
830 | DEF("incoming" , HAS_ARG, QEMU_OPTION_incoming, \ |
831 | "-incoming tcp:[host]:port[,to=maxport][,ipv4][,ipv6]\n" \ |
832 | "-incoming rdma:host:port[,ipv4][,ipv6]\n" \ |
833 | "-incoming unix:socketpath\n" \ |
834 | " prepare for incoming migration, listen on\n" \ |
835 | " specified protocol and socket address\n" \ |
836 | "-incoming fd:fd\n" \ |
837 | "-incoming exec:cmdline\n" \ |
838 | " accept incoming migration on given file descriptor\n" \ |
839 | " or from given external command\n" \ |
840 | "-incoming defer\n" \ |
841 | " wait for the URI to be specified via migrate_incoming\n" , |
842 | QEMU_ARCH_ALL) |
843 | |
844 | DEF("only-migratable" , 0, QEMU_OPTION_only_migratable, \ |
845 | "-only-migratable allow only migratable devices\n" , QEMU_ARCH_ALL) |
846 | |
847 | DEF("nodefaults" , 0, QEMU_OPTION_nodefaults, \ |
848 | "-nodefaults don't create default devices\n" , QEMU_ARCH_ALL) |
849 | |
850 | #ifndef _WIN32 |
851 | DEF("chroot" , HAS_ARG, QEMU_OPTION_chroot, \ |
852 | "-chroot dir chroot to dir just before starting the VM\n" , |
853 | QEMU_ARCH_ALL) |
854 | #endif |
855 | |
856 | #ifndef _WIN32 |
857 | DEF("runas" , HAS_ARG, QEMU_OPTION_runas, \ |
858 | "-runas user change to user id user just before starting the VM\n" \ |
859 | " user can be numeric uid:gid instead\n" , |
860 | QEMU_ARCH_ALL) |
861 | #endif |
862 | |
863 | DEF("prom-env" , HAS_ARG, QEMU_OPTION_prom_env, |
864 | "-prom-env variable=value\n" |
865 | " set OpenBIOS nvram variables\n" , |
866 | QEMU_ARCH_PPC | QEMU_ARCH_SPARC) |
867 | DEF("semihosting" , 0, QEMU_OPTION_semihosting, |
868 | "-semihosting semihosting mode\n" , |
869 | QEMU_ARCH_ARM | QEMU_ARCH_M68K | QEMU_ARCH_XTENSA | QEMU_ARCH_LM32 | |
870 | QEMU_ARCH_MIPS | QEMU_ARCH_NIOS2) |
871 | DEF("semihosting-config" , HAS_ARG, QEMU_OPTION_semihosting_config, |
872 | "-semihosting-config [enable=on|off][,target=native|gdb|auto][,chardev=id][,arg=str[,...]]\n" \ |
873 | " semihosting configuration\n" , |
874 | QEMU_ARCH_ARM | QEMU_ARCH_M68K | QEMU_ARCH_XTENSA | QEMU_ARCH_LM32 | |
875 | QEMU_ARCH_MIPS | QEMU_ARCH_NIOS2) |
876 | DEF("old-param" , 0, QEMU_OPTION_old_param, |
877 | "-old-param old param mode\n" , QEMU_ARCH_ARM) |
878 | |
879 | DEF("sandbox" , HAS_ARG, QEMU_OPTION_sandbox, \ |
880 | "-sandbox on[,obsolete=allow|deny][,elevateprivileges=allow|deny|children]\n" \ |
881 | " [,spawn=allow|deny][,resourcecontrol=allow|deny]\n" \ |
882 | " Enable seccomp mode 2 system call filter (default 'off').\n" \ |
883 | " use 'obsolete' to allow obsolete system calls that are provided\n" \ |
884 | " by the kernel, but typically no longer used by modern\n" \ |
885 | " C library implementations.\n" \ |
886 | " use 'elevateprivileges' to allow or deny QEMU process to elevate\n" \ |
887 | " its privileges by blacklisting all set*uid|gid system calls.\n" \ |
888 | " The value 'children' will deny set*uid|gid system calls for\n" \ |
889 | " main QEMU process but will allow forks and execves to run unprivileged\n" \ |
890 | " use 'spawn' to avoid QEMU to spawn new threads or processes by\n" \ |
891 | " blacklisting *fork and execve\n" \ |
892 | " use 'resourcecontrol' to disable process affinity and schedular priority\n" , |
893 | QEMU_ARCH_ALL) |
894 | |
895 | DEF("readconfig" , HAS_ARG, QEMU_OPTION_readconfig, |
896 | "-readconfig <file>\n" , QEMU_ARCH_ALL) |
897 | DEF("writeconfig" , HAS_ARG, QEMU_OPTION_writeconfig, |
898 | "-writeconfig <file>\n" |
899 | " read/write config file\n" , QEMU_ARCH_ALL) |
900 | |
901 | DEF("no-user-config" , 0, QEMU_OPTION_nouserconfig, |
902 | "-no-user-config\n" |
903 | " do not load default user-provided config files at startup\n" , |
904 | QEMU_ARCH_ALL) |
905 | |
906 | DEF("trace" , HAS_ARG, QEMU_OPTION_trace, |
907 | "-trace [[enable=]<pattern>][,events=<file>][,file=<file>]\n" |
908 | " specify tracing options\n" , |
909 | QEMU_ARCH_ALL) |
910 | |
911 | DEF("qtest" , HAS_ARG, QEMU_OPTION_qtest, "" , QEMU_ARCH_ALL) |
912 | DEF("qtest-log" , HAS_ARG, QEMU_OPTION_qtest_log, "" , QEMU_ARCH_ALL) |
913 | |
914 | #ifdef __linux__ |
915 | DEF("enable-fips" , 0, QEMU_OPTION_enablefips, |
916 | "-enable-fips enable FIPS 140-2 compliance\n" , |
917 | QEMU_ARCH_ALL) |
918 | #endif |
919 | |
920 | DEF("no-kvm" , 0, QEMU_OPTION_no_kvm, "" , QEMU_ARCH_I386) |
921 | |
922 | DEF("msg" , HAS_ARG, QEMU_OPTION_msg, |
923 | "-msg timestamp[=on|off]\n" |
924 | " change the format of messages\n" |
925 | " on|off controls leading timestamps (default:on)\n" , |
926 | QEMU_ARCH_ALL) |
927 | |
928 | DEF("dump-vmstate" , HAS_ARG, QEMU_OPTION_dump_vmstate, |
929 | "-dump-vmstate <file>\n" |
930 | " Output vmstate information in JSON format to file.\n" |
931 | " Use the scripts/vmstate-static-checker.py file to\n" |
932 | " check for possible regressions in migration code\n" |
933 | " by comparing two such vmstate dumps.\n" , |
934 | QEMU_ARCH_ALL) |
935 | |
936 | DEF("enable-sync-profile" , 0, QEMU_OPTION_enable_sync_profile, |
937 | "-enable-sync-profile\n" |
938 | " enable synchronization profiling\n" , |
939 | QEMU_ARCH_ALL) |
940 | |
941 | DEFHEADING() |
942 | |
943 | DEFHEADING(Generic object creation:) |
944 | |
945 | DEF("object" , HAS_ARG, QEMU_OPTION_object, |
946 | "-object TYPENAME[,PROP1=VALUE1,...]\n" |
947 | " create a new object of type TYPENAME setting properties\n" |
948 | " in the order they are specified. Note that the 'id'\n" |
949 | " property must be set. These objects are placed in the\n" |
950 | " '/objects' path.\n" , |
951 | QEMU_ARCH_ALL) |
952 | |
953 | |
954 | |