1
2DEFHEADING(Standard options:)
3
4DEF("help", 0, QEMU_OPTION_h,
5"-h or -help display this help and exit\n", QEMU_ARCH_ALL)
6
7DEF("version", 0, QEMU_OPTION_version,
8"-version display version information and exit\n", QEMU_ARCH_ALL)
9
10DEF("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",
27QEMU_ARCH_ALL)
28
29DEF("M", HAS_ARG, QEMU_OPTION_M, "", QEMU_ARCH_ALL)
30
31DEF("cpu", HAS_ARG, QEMU_OPTION_cpu,
32"-cpu cpu select CPU ('-cpu help' for list)\n", QEMU_ARCH_ALL)
33
34DEF("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
39DEF("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",
48QEMU_ARCH_ALL)
49
50DEF("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",
55QEMU_ARCH_ALL)
56
57DEF("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
61DEF("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
66DEF("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",
70QEMU_ARCH_ALL)
71
72DEF("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",
79QEMU_ARCH_ALL)
80
81DEF("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",
88QEMU_ARCH_ALL)
89
90DEF("mem-path", HAS_ARG, QEMU_OPTION_mempath,
91"-mem-path FILE provide backing storage for guest RAM\n", QEMU_ARCH_ALL)
92
93DEF("mem-prealloc", 0, QEMU_OPTION_mem_prealloc,
94"-mem-prealloc preallocate guest memory (use with -mem-path)\n",
95QEMU_ARCH_ALL)
96
97DEF("k", HAS_ARG, QEMU_OPTION_k,
98"-k language use keyboard layout (for example 'fr' for French)\n",
99QEMU_ARCH_ALL)
100
101
102DEF("audio-help", 0, QEMU_OPTION_audio_help,
103"-audio-help show -audiodev equivalent of the currently specified audio settings\n",
104QEMU_ARCH_ALL)
105
106DEF("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",
157QEMU_ARCH_ALL)
158
159DEF("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
165DEF("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",
171QEMU_ARCH_ALL)
172
173DEF("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",
179QEMU_ARCH_ALL)
180
181DEF("uuid", HAS_ARG, QEMU_OPTION_uuid,
182"-uuid %08x-%04x-%04x-%04x-%012x\n"
183" specify machine UUID\n", QEMU_ARCH_ALL)
184
185DEFHEADING()
186
187DEFHEADING(Block device options:)
188
189DEF("fda", HAS_ARG, QEMU_OPTION_fda,
190"-fda/-fdb file use 'file' as floppy disk 0/1 image\n", QEMU_ARCH_ALL)
191DEF("fdb", HAS_ARG, QEMU_OPTION_fdb, "", QEMU_ARCH_ALL)
192
193DEF("hda", HAS_ARG, QEMU_OPTION_hda,
194"-hda/-hdb file use 'file' as IDE hard disk 0/1 image\n", QEMU_ARCH_ALL)
195DEF("hdb", HAS_ARG, QEMU_OPTION_hdb, "", QEMU_ARCH_ALL)
196DEF("hdc", HAS_ARG, QEMU_OPTION_hdc,
197"-hdc/-hdd file use 'file' as IDE hard disk 2/3 image\n", QEMU_ARCH_ALL)
198DEF("hdd", HAS_ARG, QEMU_OPTION_hdd, "", QEMU_ARCH_ALL)
199
200DEF("cdrom", HAS_ARG, QEMU_OPTION_cdrom,
201"-cdrom file use 'file' as IDE cdrom image (cdrom is ide1 master)\n",
202QEMU_ARCH_ALL)
203
204DEF("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
211DEF("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
226DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock,
227"-mtdblock file use 'file' as on-board Flash memory image\n",
228QEMU_ARCH_ALL)
229
230DEF("sd", HAS_ARG, QEMU_OPTION_sd,
231"-sd file use 'file' as SecureDigital card image\n", QEMU_ARCH_ALL)
232
233DEF("pflash", HAS_ARG, QEMU_OPTION_pflash,
234"-pflash file use 'file' as a parallel flash image\n", QEMU_ARCH_ALL)
235
236DEF("snapshot", 0, QEMU_OPTION_snapshot,
237"-snapshot write to temporary files instead of disk image files\n",
238QEMU_ARCH_ALL)
239
240DEF("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",
251QEMU_ARCH_ALL)
252
253
254DEF("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",
260QEMU_ARCH_ALL)
261
262
263DEF("virtfs_synth", 0, QEMU_OPTION_virtfs_synth,
264"-virtfs_synth Create synthetic file system image\n",
265QEMU_ARCH_ALL)
266
267DEF("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
275DEFHEADING()
276
277DEFHEADING(USB options:)
278
279DEF("usb", 0, QEMU_OPTION_usb,
280"-usb enable on-board USB host controller (if not enabled by default)\n",
281QEMU_ARCH_ALL)
282
283DEF("usbdevice", HAS_ARG, QEMU_OPTION_usbdevice,
284"-usbdevice name add the host or guest USB device 'name'\n",
285QEMU_ARCH_ALL)
286
287DEFHEADING()
288
289DEFHEADING(Display options:)
290
291DEF("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
315DEF("nographic", 0, QEMU_OPTION_nographic,
316"-nographic disable graphical output and redirect serial I/Os to console\n",
317QEMU_ARCH_ALL)
318
319DEF("curses", 0, QEMU_OPTION_curses,
320"-curses shorthand for -display curses\n",
321QEMU_ARCH_ALL)
322
323DEF("alt-grab", 0, QEMU_OPTION_alt_grab,
324"-alt-grab use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt)\n",
325QEMU_ARCH_ALL)
326
327DEF("ctrl-grab", 0, QEMU_OPTION_ctrl_grab,
328"-ctrl-grab use Right-Ctrl to grab mouse (instead of Ctrl-Alt)\n",
329QEMU_ARCH_ALL)
330
331DEF("no-quit", 0, QEMU_OPTION_no_quit,
332"-no-quit disable SDL window close capability\n", QEMU_ARCH_ALL)
333
334DEF("sdl", 0, QEMU_OPTION_sdl,
335"-sdl shorthand for -display sdl\n", QEMU_ARCH_ALL)
336
337DEF("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",
355QEMU_ARCH_ALL)
356
357DEF("portrait", 0, QEMU_OPTION_portrait,
358"-portrait rotate graphical output 90 deg left (only PXA LCD)\n",
359QEMU_ARCH_ALL)
360
361DEF("rotate", HAS_ARG, QEMU_OPTION_rotate,
362"-rotate <deg> rotate graphical output some deg left (only PXA LCD)\n",
363QEMU_ARCH_ALL)
364
365DEF("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
369DEF("full-screen", 0, QEMU_OPTION_full_screen,
370"-full-screen start in full screen\n", QEMU_ARCH_ALL)
371
372DEF("g", 1, QEMU_OPTION_g ,
373"-g WxH[xDEPTH] Set the initial graphical resolution and depth\n",
374QEMU_ARCH_PPC | QEMU_ARCH_SPARC)
375
376DEF("vnc", HAS_ARG, QEMU_OPTION_vnc ,
377"-vnc <display> shorthand for -display vnc=<display>\n", QEMU_ARCH_ALL)
378
379ARCHHEADING(, QEMU_ARCH_I386)
380
381ARCHHEADING(i386 target only:, QEMU_ARCH_I386)
382
383DEF("win2k-hack", 0, QEMU_OPTION_win2k_hack,
384"-win2k-hack use it when installing Windows 2000 to avoid a disk full bug\n",
385QEMU_ARCH_I386)
386
387DEF("no-fd-bootchk", 0, QEMU_OPTION_no_fd_bootchk,
388"-no-fd-bootchk disable boot signature checking for floppy disks\n",
389QEMU_ARCH_I386)
390
391DEF("no-acpi", 0, QEMU_OPTION_no_acpi,
392"-no-acpi disable ACPI\n", QEMU_ARCH_I386 | QEMU_ARCH_ARM)
393
394DEF("no-hpet", 0, QEMU_OPTION_no_hpet,
395"-no-hpet disable HPET\n", QEMU_ARCH_I386)
396
397DEF("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
401DEF("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",
422QEMU_ARCH_I386 | QEMU_ARCH_ARM)
423
424DEFHEADING()
425
426DEFHEADING(Network options:)
427
428DEF("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)
531DEF("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",
553QEMU_ARCH_ALL)
554DEF("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
574DEFHEADING()
575
576DEFHEADING(Character device options:)
577
578DEF("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
622DEFHEADING()
623
624DEFHEADING(Bluetooth(R) options:)
625
626DEF("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",
636QEMU_ARCH_ALL)
637
638DEFHEADING()
639
640#ifdef CONFIG_TPM
641DEFHEADING(TPM device options:)
642
643DEF("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",
650QEMU_ARCH_ALL)
651
652DEFHEADING()
653
654#endif
655
656DEFHEADING(Linux/Multiboot boot specific:)
657
658DEF("kernel", HAS_ARG, QEMU_OPTION_kernel, \
659"-kernel bzImage use 'bzImage' as kernel image\n", QEMU_ARCH_ALL)
660
661DEF("append", HAS_ARG, QEMU_OPTION_append, \
662"-append cmdline use 'cmdline' as kernel command line\n", QEMU_ARCH_ALL)
663
664DEF("initrd", HAS_ARG, QEMU_OPTION_initrd, \
665"-initrd file use 'file' as initial ram disk\n", QEMU_ARCH_ALL)
666
667DEF("dtb", HAS_ARG, QEMU_OPTION_dtb, \
668"-dtb file use 'file' as device tree image\n", QEMU_ARCH_ALL)
669
670DEFHEADING()
671
672DEFHEADING(Debug/Expert options:)
673
674DEF("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",
679QEMU_ARCH_ALL)
680
681DEF("serial", HAS_ARG, QEMU_OPTION_serial, \
682"-serial dev redirect the serial port to char device 'dev'\n",
683QEMU_ARCH_ALL)
684
685DEF("parallel", HAS_ARG, QEMU_OPTION_parallel, \
686"-parallel dev redirect the parallel port to char device 'dev'\n",
687QEMU_ARCH_ALL)
688
689DEF("monitor", HAS_ARG, QEMU_OPTION_monitor, \
690"-monitor dev redirect the monitor to char device 'dev'\n",
691QEMU_ARCH_ALL)
692DEF("qmp", HAS_ARG, QEMU_OPTION_qmp, \
693"-qmp dev like -monitor but opens in 'control' mode\n",
694QEMU_ARCH_ALL)
695DEF("qmp-pretty", HAS_ARG, QEMU_OPTION_qmp_pretty, \
696"-qmp-pretty dev like -qmp but uses pretty JSON formatting\n",
697QEMU_ARCH_ALL)
698
699DEF("mon", HAS_ARG, QEMU_OPTION_mon, \
700"-mon [chardev=]name[,mode=readline|control][,pretty[=on|off]]\n", QEMU_ARCH_ALL)
701
702DEF("debugcon", HAS_ARG, QEMU_OPTION_debugcon, \
703"-debugcon dev redirect the debug console to char device 'dev'\n",
704QEMU_ARCH_ALL)
705
706DEF("pidfile", HAS_ARG, QEMU_OPTION_pidfile, \
707"-pidfile file write PID to 'file'\n", QEMU_ARCH_ALL)
708
709DEF("singlestep", 0, QEMU_OPTION_singlestep, \
710"-singlestep always run in singlestep mode\n", QEMU_ARCH_ALL)
711
712DEF("preconfig", 0, QEMU_OPTION_preconfig, \
713"--preconfig pause QEMU before machine is initialized (experimental)\n",
714QEMU_ARCH_ALL)
715
716DEF("S", 0, QEMU_OPTION_S, \
717"-S freeze CPU at startup (use 'c' to start execution)\n",
718QEMU_ARCH_ALL)
719
720DEF("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",
724QEMU_ARCH_ALL)
725
726DEF("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",
731QEMU_ARCH_ALL)
732
733DEF("gdb", HAS_ARG, QEMU_OPTION_gdb, \
734"-gdb dev wait for gdb connection on 'dev'\n", QEMU_ARCH_ALL)
735
736DEF("s", 0, QEMU_OPTION_s, \
737"-s shorthand for -gdb tcp::" DEFAULT_GDBSTUB_PORT "\n",
738QEMU_ARCH_ALL)
739
740DEF("d", HAS_ARG, QEMU_OPTION_d, \
741"-d item1,... enable logging of specified items (use '-d help' for a list of log items)\n",
742QEMU_ARCH_ALL)
743
744DEF("D", HAS_ARG, QEMU_OPTION_D, \
745"-D logfile output log to logfile (default stderr)\n",
746QEMU_ARCH_ALL)
747
748DEF("dfilter", HAS_ARG, QEMU_OPTION_DFILTER, \
749"-dfilter range,.. filter debug output to range of addresses (useful for -d cpu,exec,etc..)\n",
750QEMU_ARCH_ALL)
751
752DEF("seed", HAS_ARG, QEMU_OPTION_seed, \
753"-seed number seed the pseudo-random number generator\n",
754QEMU_ARCH_ALL)
755
756DEF("L", HAS_ARG, QEMU_OPTION_L, \
757"-L path set the directory for the BIOS, VGA BIOS and keymaps\n",
758QEMU_ARCH_ALL)
759
760DEF("bios", HAS_ARG, QEMU_OPTION_bios, \
761"-bios file set the filename for the BIOS\n", QEMU_ARCH_ALL)
762
763DEF("enable-kvm", 0, QEMU_OPTION_enable_kvm, \
764"-enable-kvm enable KVM full virtualization support\n", QEMU_ARCH_ALL)
765
766DEF("xen-domid", HAS_ARG, QEMU_OPTION_xen_domid,
767"-xen-domid id specify xen guest domain id\n", QEMU_ARCH_ALL)
768DEF("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",
771QEMU_ARCH_ALL)
772DEF("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",
776QEMU_ARCH_ALL)
777
778DEF("no-reboot", 0, QEMU_OPTION_no_reboot, \
779"-no-reboot exit instead of rebooting\n", QEMU_ARCH_ALL)
780
781DEF("no-shutdown", 0, QEMU_OPTION_no_shutdown, \
782"-no-shutdown stop before shutdown\n", QEMU_ARCH_ALL)
783
784DEF("loadvm", HAS_ARG, QEMU_OPTION_loadvm, \
785"-loadvm [tag|id]\n" \
786" start right away with a saved state (loadvm in monitor)\n",
787QEMU_ARCH_ALL)
788
789#ifndef _WIN32
790DEF("daemonize", 0, QEMU_OPTION_daemonize, \
791"-daemonize daemonize QEMU after initializing\n", QEMU_ARCH_ALL)
792#endif
793
794DEF("option-rom", HAS_ARG, QEMU_OPTION_option_rom, \
795"-option-rom rom load a file, rom, into the option ROM space\n",
796QEMU_ARCH_ALL)
797
798DEF("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",
801QEMU_ARCH_ALL)
802
803
804DEF("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
810DEF("watchdog", HAS_ARG, QEMU_OPTION_watchdog, \
811"-watchdog model\n" \
812" enable virtual hardware watchdog [default=none]\n",
813QEMU_ARCH_ALL)
814
815DEF("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",
818QEMU_ARCH_ALL)
819
820DEF("echr", HAS_ARG, QEMU_OPTION_echr, \
821"-echr chr set terminal escape character instead of ctrl-a\n",
822QEMU_ARCH_ALL)
823
824DEF("show-cursor", 0, QEMU_OPTION_show_cursor, \
825"-show-cursor show cursor\n", QEMU_ARCH_ALL)
826
827DEF("tb-size", HAS_ARG, QEMU_OPTION_tb_size, \
828"-tb-size n set TB size\n", QEMU_ARCH_ALL)
829
830DEF("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",
842QEMU_ARCH_ALL)
843
844DEF("only-migratable", 0, QEMU_OPTION_only_migratable, \
845"-only-migratable allow only migratable devices\n", QEMU_ARCH_ALL)
846
847DEF("nodefaults", 0, QEMU_OPTION_nodefaults, \
848"-nodefaults don't create default devices\n", QEMU_ARCH_ALL)
849
850#ifndef _WIN32
851DEF("chroot", HAS_ARG, QEMU_OPTION_chroot, \
852"-chroot dir chroot to dir just before starting the VM\n",
853QEMU_ARCH_ALL)
854#endif
855
856#ifndef _WIN32
857DEF("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",
860QEMU_ARCH_ALL)
861#endif
862
863DEF("prom-env", HAS_ARG, QEMU_OPTION_prom_env,
864"-prom-env variable=value\n"
865" set OpenBIOS nvram variables\n",
866QEMU_ARCH_PPC | QEMU_ARCH_SPARC)
867DEF("semihosting", 0, QEMU_OPTION_semihosting,
868"-semihosting semihosting mode\n",
869QEMU_ARCH_ARM | QEMU_ARCH_M68K | QEMU_ARCH_XTENSA | QEMU_ARCH_LM32 |
870QEMU_ARCH_MIPS | QEMU_ARCH_NIOS2)
871DEF("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",
874QEMU_ARCH_ARM | QEMU_ARCH_M68K | QEMU_ARCH_XTENSA | QEMU_ARCH_LM32 |
875QEMU_ARCH_MIPS | QEMU_ARCH_NIOS2)
876DEF("old-param", 0, QEMU_OPTION_old_param,
877"-old-param old param mode\n", QEMU_ARCH_ARM)
878
879DEF("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",
893QEMU_ARCH_ALL)
894
895DEF("readconfig", HAS_ARG, QEMU_OPTION_readconfig,
896"-readconfig <file>\n", QEMU_ARCH_ALL)
897DEF("writeconfig", HAS_ARG, QEMU_OPTION_writeconfig,
898"-writeconfig <file>\n"
899" read/write config file\n", QEMU_ARCH_ALL)
900
901DEF("no-user-config", 0, QEMU_OPTION_nouserconfig,
902"-no-user-config\n"
903" do not load default user-provided config files at startup\n",
904QEMU_ARCH_ALL)
905
906DEF("trace", HAS_ARG, QEMU_OPTION_trace,
907"-trace [[enable=]<pattern>][,events=<file>][,file=<file>]\n"
908" specify tracing options\n",
909QEMU_ARCH_ALL)
910
911DEF("qtest", HAS_ARG, QEMU_OPTION_qtest, "", QEMU_ARCH_ALL)
912DEF("qtest-log", HAS_ARG, QEMU_OPTION_qtest_log, "", QEMU_ARCH_ALL)
913
914#ifdef __linux__
915DEF("enable-fips", 0, QEMU_OPTION_enablefips,
916"-enable-fips enable FIPS 140-2 compliance\n",
917QEMU_ARCH_ALL)
918#endif
919
920DEF("no-kvm", 0, QEMU_OPTION_no_kvm, "", QEMU_ARCH_I386)
921
922DEF("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",
926QEMU_ARCH_ALL)
927
928DEF("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",
934QEMU_ARCH_ALL)
935
936DEF("enable-sync-profile", 0, QEMU_OPTION_enable_sync_profile,
937"-enable-sync-profile\n"
938" enable synchronization profiling\n",
939QEMU_ARCH_ALL)
940
941DEFHEADING()
942
943DEFHEADING(Generic object creation:)
944
945DEF("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",
951QEMU_ARCH_ALL)
952
953
954