Revision 6616b2ad qemu-options.hx
b/qemu-options.hx | ||
---|---|---|
14 | 14 |
"-h or -help display this help and exit\n") |
15 | 15 |
STEXI |
16 | 16 |
@item -h |
17 |
@findex -h |
|
17 | 18 |
Display help and exit |
18 | 19 |
ETEXI |
19 | 20 |
|
... | ... | |
21 | 22 |
"-version display version information and exit\n") |
22 | 23 |
STEXI |
23 | 24 |
@item -version |
25 |
@findex -version |
|
24 | 26 |
Display version information and exit |
25 | 27 |
ETEXI |
26 | 28 |
|
... | ... | |
28 | 30 |
"-M machine select emulated machine (-M ? for list)\n") |
29 | 31 |
STEXI |
30 | 32 |
@item -M @var{machine} |
33 |
@findex -M |
|
31 | 34 |
Select the emulated @var{machine} (@code{-M ?} for list) |
32 | 35 |
ETEXI |
33 | 36 |
|
... | ... | |
35 | 38 |
"-cpu cpu select CPU (-cpu ? for list)\n") |
36 | 39 |
STEXI |
37 | 40 |
@item -cpu @var{model} |
41 |
@findex -cpu |
|
38 | 42 |
Select CPU model (-cpu ? for list and additional feature selection) |
39 | 43 |
ETEXI |
40 | 44 |
|
... | ... | |
48 | 52 |
" sockets= number of discrete sockets in the system\n") |
49 | 53 |
STEXI |
50 | 54 |
@item -smp @var{n}[,cores=@var{cores}][,threads=@var{threads}][,sockets=@var{sockets}][,maxcpus=@var{maxcpus}] |
55 |
@findex -smp |
|
51 | 56 |
Simulate an SMP system with @var{n} CPUs. On the PC target, up to 255 |
52 | 57 |
CPUs are supported. On Sparc32 target, Linux limits the number of usable CPUs |
53 | 58 |
to 4. |
... | ... | |
62 | 67 |
"-numa node[,mem=size][,cpus=cpu[-cpu]][,nodeid=node]\n") |
63 | 68 |
STEXI |
64 | 69 |
@item -numa @var{opts} |
70 |
@findex -numa |
|
65 | 71 |
Simulate a multi node NUMA system. If mem and cpus are omitted, resources |
66 | 72 |
are split equally. |
67 | 73 |
ETEXI |
... | ... | |
72 | 78 |
STEXI |
73 | 79 |
@item -fda @var{file} |
74 | 80 |
@item -fdb @var{file} |
81 |
@findex -fda |
|
82 |
@findex -fdb |
|
75 | 83 |
Use @var{file} as floppy disk 0/1 image (@pxref{disk_images}). You can |
76 | 84 |
use the host floppy by using @file{/dev/fd0} as filename (@pxref{host_drives}). |
77 | 85 |
ETEXI |
... | ... | |
87 | 95 |
@item -hdb @var{file} |
88 | 96 |
@item -hdc @var{file} |
89 | 97 |
@item -hdd @var{file} |
98 |
@findex -hda |
|
99 |
@findex -hdb |
|
100 |
@findex -hdc |
|
101 |
@findex -hdd |
|
90 | 102 |
Use @var{file} as hard disk 0, 1, 2 or 3 image (@pxref{disk_images}). |
91 | 103 |
ETEXI |
92 | 104 |
|
... | ... | |
94 | 106 |
"-cdrom file use 'file' as IDE cdrom image (cdrom is ide1 master)\n") |
95 | 107 |
STEXI |
96 | 108 |
@item -cdrom @var{file} |
109 |
@findex -cdrom |
|
97 | 110 |
Use @var{file} as CD-ROM image (you cannot use @option{-hdc} and |
98 | 111 |
@option{-cdrom} at the same time). You can use the host CD-ROM by |
99 | 112 |
using @file{/dev/cdrom} as filename (@pxref{host_drives}). |
... | ... | |
105 | 118 |
" [,cache=writethrough|writeback|none][,format=f][,serial=s]\n" |
106 | 119 |
" [,addr=A][,id=name][,aio=threads|native][,readonly=on|off]\n" |
107 | 120 |
" use 'file' as a drive image\n") |
108 |
DEF("set", HAS_ARG, QEMU_OPTION_set, |
|
109 |
"-set group.id.arg=value\n" |
|
110 |
" set <arg> parameter for item <id> of type <group>\n" |
|
111 |
" i.e. -set drive.$id.file=/path/to/image\n") |
|
112 |
DEF("global", HAS_ARG, QEMU_OPTION_global, |
|
113 |
"-global driver.property=value\n" |
|
114 |
" set a global default for a driver property\n") |
|
115 | 121 |
STEXI |
116 | 122 |
@item -drive @var{option}[,@var{option}[,@var{option}[,...]]] |
123 |
@findex -drive |
|
117 | 124 |
|
118 | 125 |
Define a new drive. Valid options are: |
119 | 126 |
|
... | ... | |
216 | 223 |
@end example |
217 | 224 |
ETEXI |
218 | 225 |
|
226 |
DEF("set", HAS_ARG, QEMU_OPTION_set, |
|
227 |
"-set group.id.arg=value\n" |
|
228 |
" set <arg> parameter for item <id> of type <group>\n" |
|
229 |
" i.e. -set drive.$id.file=/path/to/image\n") |
|
230 |
STEXI |
|
231 |
@item -set |
|
232 |
@findex -set |
|
233 |
TODO |
|
234 |
ETEXI |
|
235 |
|
|
236 |
DEF("global", HAS_ARG, QEMU_OPTION_global, |
|
237 |
"-global driver.property=value\n" |
|
238 |
" set a global default for a driver property\n") |
|
239 |
STEXI |
|
240 |
@item -global |
|
241 |
@findex -global |
|
242 |
TODO |
|
243 |
ETEXI |
|
244 |
|
|
219 | 245 |
DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock, |
220 | 246 |
"-mtdblock file use 'file' as on-board Flash memory image\n") |
221 | 247 |
STEXI |
222 |
|
|
223 | 248 |
@item -mtdblock @var{file} |
249 |
@findex -mtdblock |
|
224 | 250 |
Use @var{file} as on-board Flash memory image. |
225 | 251 |
ETEXI |
226 | 252 |
|
... | ... | |
228 | 254 |
"-sd file use 'file' as SecureDigital card image\n") |
229 | 255 |
STEXI |
230 | 256 |
@item -sd @var{file} |
257 |
@findex -sd |
|
231 | 258 |
Use @var{file} as SecureDigital card image. |
232 | 259 |
ETEXI |
233 | 260 |
|
... | ... | |
235 | 262 |
"-pflash file use 'file' as a parallel flash image\n") |
236 | 263 |
STEXI |
237 | 264 |
@item -pflash @var{file} |
265 |
@findex -pflash |
|
238 | 266 |
Use @var{file} as a parallel flash image. |
239 | 267 |
ETEXI |
240 | 268 |
|
... | ... | |
243 | 271 |
" 'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)\n") |
244 | 272 |
STEXI |
245 | 273 |
@item -boot [order=@var{drives}][,once=@var{drives}][,menu=on|off] |
246 |
|
|
274 |
@findex -boot |
|
247 | 275 |
Specify boot order @var{drives} as a string of drive letters. Valid |
248 | 276 |
drive letters depend on the target achitecture. The x86 PC uses: a, b |
249 | 277 |
(floppy 1 and 2), c (first hard disk), d (first CD-ROM), n-p (Etherboot |
... | ... | |
269 | 297 |
"-snapshot write to temporary files instead of disk image files\n") |
270 | 298 |
STEXI |
271 | 299 |
@item -snapshot |
300 |
@findex -snapshot |
|
272 | 301 |
Write to temporary files instead of disk image files. In this case, |
273 | 302 |
the raw disk image you use is not written back. You can however force |
274 | 303 |
the write back by pressing @key{C-a s} (@pxref{disk_images}). |
... | ... | |
279 | 308 |
stringify(DEFAULT_RAM_SIZE) "]\n") |
280 | 309 |
STEXI |
281 | 310 |
@item -m @var{megs} |
311 |
@findex -m |
|
282 | 312 |
Set virtual RAM size to @var{megs} megabytes. Default is 128 MiB. Optionally, |
283 | 313 |
a suffix of ``M'' or ``G'' can be used to signify a value in megabytes or |
284 | 314 |
gigabytes respectively. |
... | ... | |
288 | 318 |
"-k language use keyboard layout (for example 'fr' for French)\n") |
289 | 319 |
STEXI |
290 | 320 |
@item -k @var{language} |
291 |
|
|
321 |
@findex -k |
|
292 | 322 |
Use keyboard layout @var{language} (for example @code{fr} for |
293 | 323 |
French). This option is only needed where it is not easy to get raw PC |
294 | 324 |
keycodes (e.g. on Macs, with some X11 servers or with a VNC |
... | ... | |
312 | 342 |
#endif |
313 | 343 |
STEXI |
314 | 344 |
@item -audio-help |
315 |
|
|
345 |
@findex -audio-help |
|
316 | 346 |
Will show the audio subsystem help: list of drivers, tunable |
317 | 347 |
parameters. |
318 | 348 |
ETEXI |
... | ... | |
326 | 356 |
#endif |
327 | 357 |
STEXI |
328 | 358 |
@item -soundhw @var{card1}[,@var{card2},...] or -soundhw all |
329 |
|
|
359 |
@findex -soundhw |
|
330 | 360 |
Enable audio and selected sound hardware. Use ? to print all |
331 | 361 |
available sound hardware. |
332 | 362 |
|
... | ... | |
357 | 387 |
@table @option |
358 | 388 |
|
359 | 389 |
@item -usb |
390 |
@findex -usb |
|
360 | 391 |
Enable the USB driver (will be the default soon) |
361 | 392 |
ETEXI |
362 | 393 |
|
... | ... | |
365 | 396 |
STEXI |
366 | 397 |
|
367 | 398 |
@item -usbdevice @var{devname} |
399 |
@findex -usbdevice |
|
368 | 400 |
Add the USB device @var{devname}. @xref{usb_devices}. |
369 | 401 |
|
370 | 402 |
@table @option |
... | ... | |
408 | 440 |
" add device (based on driver)\n" |
409 | 441 |
" prop=value,... sets driver properties\n" |
410 | 442 |
" use -device ? to print all possible drivers\n" |
411 |
" use -device driver,? to print all possible properties\n") |
|
443 |
" use -device driver,? to print all possible options\n" |
|
444 |
" use -device driver,option=? to print a help for value\n") |
|
412 | 445 |
STEXI |
413 |
@item -device @var{driver}[,@var{prop}[=@var{value}][,...]] |
|
414 |
Add device @var{driver}. @var{prop}=@var{value} sets driver |
|
415 |
properties. Valid properties depend on the driver. To get help on |
|
416 |
possible drivers and properties, use @code{-device ?} and |
|
417 |
@code{-device @var{driver},?}. |
|
446 |
@item -device @var{driver}[,@var{option}[=@var{value}][,...]] |
|
447 |
@findex -device |
|
448 |
Add device @var{driver}. Depending on the device type, |
|
449 |
@var{option} (with default or given @var{value}) may be useful. |
|
450 |
To get a help on possible @var{driver}s, @var{option}s or @var{value}s, use |
|
451 |
@code{-device ?}, |
|
452 |
@code{-device @var{driver},?} or |
|
453 |
@code{-device @var{driver},@var{option}=?}. |
|
418 | 454 |
ETEXI |
419 | 455 |
|
420 | 456 |
DEF("name", HAS_ARG, QEMU_OPTION_name, |
... | ... | |
423 | 459 |
" string1 sets the window title and string2 the process name (on Linux)\n") |
424 | 460 |
STEXI |
425 | 461 |
@item -name @var{name} |
462 |
@findex -name |
|
426 | 463 |
Sets the @var{name} of the guest. |
427 | 464 |
This name will be displayed in the SDL window caption. |
428 | 465 |
The @var{name} will also be used for the VNC server. |
... | ... | |
434 | 471 |
" specify machine UUID\n") |
435 | 472 |
STEXI |
436 | 473 |
@item -uuid @var{uuid} |
474 |
@findex -uuid |
|
437 | 475 |
Set system UUID. |
438 | 476 |
ETEXI |
439 | 477 |
|
... | ... | |
453 | 491 |
"-nographic disable graphical output and redirect serial I/Os to console\n") |
454 | 492 |
STEXI |
455 | 493 |
@item -nographic |
456 |
|
|
494 |
@findex -nographic |
|
457 | 495 |
Normally, QEMU uses SDL to display the VGA output. With this option, |
458 | 496 |
you can totally disable graphical output so that QEMU is a simple |
459 | 497 |
command line application. The emulated serial port is redirected on |
... | ... | |
467 | 505 |
#endif |
468 | 506 |
STEXI |
469 | 507 |
@item -curses |
470 |
|
|
508 |
@findex curses |
|
471 | 509 |
Normally, QEMU uses SDL to display the VGA output. With this option, |
472 | 510 |
QEMU can display the VGA output when in text mode using a |
473 | 511 |
curses/ncurses interface. Nothing is displayed in graphical mode. |
... | ... | |
479 | 517 |
#endif |
480 | 518 |
STEXI |
481 | 519 |
@item -no-frame |
482 |
|
|
520 |
@findex -no-frame |
|
483 | 521 |
Do not use decorations for SDL windows and start them using the whole |
484 | 522 |
available screen space. This makes the using QEMU in a dedicated desktop |
485 | 523 |
workspace more convenient. |
... | ... | |
491 | 529 |
#endif |
492 | 530 |
STEXI |
493 | 531 |
@item -alt-grab |
494 |
|
|
532 |
@findex -alt-grab |
|
495 | 533 |
Use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt). |
496 | 534 |
ETEXI |
497 | 535 |
|
... | ... | |
501 | 539 |
#endif |
502 | 540 |
STEXI |
503 | 541 |
@item -ctrl-grab |
504 |
|
|
542 |
@findex -ctrl-grab |
|
505 | 543 |
Use Right-Ctrl to grab mouse (instead of Ctrl-Alt). |
506 | 544 |
ETEXI |
507 | 545 |
|
... | ... | |
511 | 549 |
#endif |
512 | 550 |
STEXI |
513 | 551 |
@item -no-quit |
514 |
|
|
552 |
@findex -no-quit |
|
515 | 553 |
Disable SDL window close capability. |
516 | 554 |
ETEXI |
517 | 555 |
|
... | ... | |
521 | 559 |
#endif |
522 | 560 |
STEXI |
523 | 561 |
@item -sdl |
524 |
|
|
562 |
@findex -sdl |
|
525 | 563 |
Enable SDL. |
526 | 564 |
ETEXI |
527 | 565 |
|
... | ... | |
529 | 567 |
"-portrait rotate graphical output 90 deg left (only PXA LCD)\n") |
530 | 568 |
STEXI |
531 | 569 |
@item -portrait |
532 |
|
|
570 |
@findex -portrait |
|
533 | 571 |
Rotate graphical output 90 deg left (only PXA LCD). |
534 | 572 |
ETEXI |
535 | 573 |
|
... | ... | |
538 | 576 |
" select video card type\n") |
539 | 577 |
STEXI |
540 | 578 |
@item -vga @var{type} |
579 |
@findex -vga |
|
541 | 580 |
Select type of VGA card to emulate. Valid values for @var{type} are |
542 | 581 |
@table @option |
543 | 582 |
@item cirrus |
... | ... | |
563 | 602 |
"-full-screen start in full screen\n") |
564 | 603 |
STEXI |
565 | 604 |
@item -full-screen |
605 |
@findex -full-screen |
|
566 | 606 |
Start in full screen. |
567 | 607 |
ETEXI |
568 | 608 |
|
... | ... | |
572 | 612 |
#endif |
573 | 613 |
STEXI |
574 | 614 |
@item -g @var{width}x@var{height}[x@var{depth}] |
615 |
@findex -g |
|
575 | 616 |
Set the initial graphical resolution and depth (PPC, SPARC only). |
576 | 617 |
ETEXI |
577 | 618 |
|
... | ... | |
579 | 620 |
"-vnc display start a VNC server on display\n") |
580 | 621 |
STEXI |
581 | 622 |
@item -vnc @var{display}[,@var{option}[,@var{option}[,...]]] |
582 |
|
|
623 |
@findex -vnc |
|
583 | 624 |
Normally, QEMU uses SDL to display the VGA output. With this option, |
584 | 625 |
you can have QEMU listen on VNC display @var{display} and redirect the VGA |
585 | 626 |
display over the VNC session. It is very useful to enable the usb |
... | ... | |
705 | 746 |
#endif |
706 | 747 |
STEXI |
707 | 748 |
@item -win2k-hack |
749 |
@findex -win2k-hack |
|
708 | 750 |
Use it when installing Windows 2000 to avoid a disk full bug. After |
709 | 751 |
Windows 2000 is installed, you no longer need this option (this option |
710 | 752 |
slows down the IDE transfers). |
... | ... | |
721 | 763 |
#endif |
722 | 764 |
STEXI |
723 | 765 |
@item -no-fd-bootchk |
766 |
@findex -no-fd-bootchk |
|
724 | 767 |
Disable boot signature checking for floppy disks in Bochs BIOS. It may |
725 | 768 |
be needed to boot from old floppy disks. |
769 |
TODO: check reference to Bochs BIOS. |
|
726 | 770 |
ETEXI |
727 | 771 |
|
728 | 772 |
#ifdef TARGET_I386 |
... | ... | |
731 | 775 |
#endif |
732 | 776 |
STEXI |
733 | 777 |
@item -no-acpi |
778 |
@findex -no-acpi |
|
734 | 779 |
Disable ACPI (Advanced Configuration and Power Interface) support. Use |
735 | 780 |
it if your guest OS complains about ACPI problems (PC target machine |
736 | 781 |
only). |
... | ... | |
742 | 787 |
#endif |
743 | 788 |
STEXI |
744 | 789 |
@item -no-hpet |
790 |
@findex -no-hpet |
|
745 | 791 |
Disable HPET support. |
746 | 792 |
ETEXI |
747 | 793 |
|
... | ... | |
753 | 799 |
#endif |
754 | 800 |
STEXI |
755 | 801 |
@item -balloon none |
802 |
@findex -balloon |
|
756 | 803 |
Disable balloon device. |
757 | 804 |
@item -balloon virtio[,addr=@var{addr}] |
758 | 805 |
Enable virtio balloon device (default), optionally with PCI address |
... | ... | |
766 | 813 |
#endif |
767 | 814 |
STEXI |
768 | 815 |
@item -acpitable [sig=@var{str}][,rev=@var{n}][,oem_id=@var{str}][,oem_table_id=@var{str}][,oem_rev=@var{n}] [,asl_compiler_id=@var{str}][,asl_compiler_rev=@var{n}][,data=@var{file1}[:@var{file2}]...] |
816 |
@findex -acpitable |
|
769 | 817 |
Add ACPI table with specified header fields and context from specified files. |
770 | 818 |
ETEXI |
771 | 819 |
|
... | ... | |
781 | 829 |
#endif |
782 | 830 |
STEXI |
783 | 831 |
@item -smbios file=@var{binary} |
832 |
@findex -smbios |
|
784 | 833 |
Load SMBIOS entry from binary file. |
785 | 834 |
|
786 | 835 |
@item -smbios type=0[,vendor=@var{str}][,version=@var{str}][,date=@var{str}][,release=@var{%d.%d}] |
836 |
@findex -smbios |
|
787 | 837 |
Specify SMBIOS type 0 fields |
788 | 838 |
|
789 | 839 |
@item -smbios type=1[,manufacturer=@var{str}][,product=@var{str}][,version=@var{str}][,serial=@var{str}][,uuid=@var{uuid}][,sku=@var{str}][,family=@var{str}] |
... | ... | |
867 | 917 |
"socket],id=str[,option][,option][,...]\n") |
868 | 918 |
STEXI |
869 | 919 |
@item -net nic[,vlan=@var{n}][,macaddr=@var{mac}][,model=@var{type}][,name=@var{name}][,addr=@var{addr}][,vectors=@var{v}] |
920 |
@findex -net |
|
870 | 921 |
Create a new Network Interface Card and connect it to VLAN @var{n} (@var{n} |
871 | 922 |
= 0 is the default). The NIC is an e1000 by default on the PC |
872 | 923 |
target. Optionally, the MAC address can be changed to @var{mac}, the |
... | ... | |
1144 | 1195 |
@table @option |
1145 | 1196 |
|
1146 | 1197 |
@item -chardev @var{backend} ,id=@var{id} [,@var{options}] |
1147 |
|
|
1198 |
@findex -chardev |
|
1148 | 1199 |
Backend is one of: |
1149 | 1200 |
@option{null}, |
1150 | 1201 |
@option{socket}, |
... | ... | |
1348 | 1399 |
@table @option |
1349 | 1400 |
|
1350 | 1401 |
@item -bt hci[...] |
1402 |
@findex -bt |
|
1351 | 1403 |
Defines the function of the corresponding Bluetooth HCI. -bt options |
1352 | 1404 |
are matched with the HCIs present in the chosen machine type. For |
1353 | 1405 |
example when emulating a machine with only one HCI built into it, only |
... | ... | |
1416 | 1468 |
"-kernel bzImage use 'bzImage' as kernel image\n") |
1417 | 1469 |
STEXI |
1418 | 1470 |
@item -kernel @var{bzImage} |
1471 |
@findex -kernel |
|
1419 | 1472 |
Use @var{bzImage} as kernel image. The kernel can be either a Linux kernel |
1420 | 1473 |
or in multiboot format. |
1421 | 1474 |
ETEXI |
... | ... | |
1424 | 1477 |
"-append cmdline use 'cmdline' as kernel command line\n") |
1425 | 1478 |
STEXI |
1426 | 1479 |
@item -append @var{cmdline} |
1480 |
@findex -append |
|
1427 | 1481 |
Use @var{cmdline} as kernel command line |
1428 | 1482 |
ETEXI |
1429 | 1483 |
|
... | ... | |
1431 | 1485 |
"-initrd file use 'file' as initial ram disk\n") |
1432 | 1486 |
STEXI |
1433 | 1487 |
@item -initrd @var{file} |
1488 |
@findex -initrd |
|
1434 | 1489 |
Use @var{file} as initial ram disk. |
1435 | 1490 |
|
1436 | 1491 |
@item -initrd "@var{file1} arg=foo,@var{file2}" |
... | ... | |
1457 | 1512 |
"-serial dev redirect the serial port to char device 'dev'\n") |
1458 | 1513 |
STEXI |
1459 | 1514 |
@item -serial @var{dev} |
1515 |
@findex -serial |
|
1460 | 1516 |
Redirect the virtual serial port to host character device |
1461 | 1517 |
@var{dev}. The default device is @code{vc} in graphical mode and |
1462 | 1518 |
@code{stdio} in non graphical mode. |
... | ... | |
1584 | 1640 |
"-parallel dev redirect the parallel port to char device 'dev'\n") |
1585 | 1641 |
STEXI |
1586 | 1642 |
@item -parallel @var{dev} |
1643 |
@findex -parallel |
|
1587 | 1644 |
Redirect the virtual parallel port to host device @var{dev} (same |
1588 | 1645 |
devices as the serial port). On Linux hosts, @file{/dev/parportN} can |
1589 | 1646 |
be used to use hardware devices connected on the corresponding host |
... | ... | |
1599 | 1656 |
"-monitor dev redirect the monitor to char device 'dev'\n") |
1600 | 1657 |
STEXI |
1601 | 1658 |
@item -monitor @var{dev} |
1659 |
@findex -monitor |
|
1602 | 1660 |
Redirect the monitor to host device @var{dev} (same devices as the |
1603 | 1661 |
serial port). |
1604 | 1662 |
The default device is @code{vc} in graphical mode and @code{stdio} in |
... | ... | |
1608 | 1666 |
"-qmp dev like -monitor but opens in 'control' mode\n") |
1609 | 1667 |
STEXI |
1610 | 1668 |
@item -qmp @var{dev} |
1669 |
@findex -qmp |
|
1611 | 1670 |
Like -monitor but opens in 'control' mode. |
1612 | 1671 |
ETEXI |
1613 | 1672 |
|
... | ... | |
1615 | 1674 |
"-mon chardev=[name][,mode=readline|control][,default]\n") |
1616 | 1675 |
STEXI |
1617 | 1676 |
@item -mon chardev=[name][,mode=readline|control][,default] |
1677 |
@findex -mon |
|
1618 | 1678 |
Setup monitor on chardev @var{name}. |
1619 | 1679 |
ETEXI |
1620 | 1680 |
|
... | ... | |
1622 | 1682 |
"-debugcon dev redirect the debug console to char device 'dev'\n") |
1623 | 1683 |
STEXI |
1624 | 1684 |
@item -debugcon @var{dev} |
1685 |
@findex -debugcon |
|
1625 | 1686 |
Redirect the debug console to host device @var{dev} (same devices as the |
1626 | 1687 |
serial port). The debug console is an I/O port which is typically port |
1627 | 1688 |
0xe9; writing to that I/O port sends output to this device. |
... | ... | |
1633 | 1694 |
"-pidfile file write PID to 'file'\n") |
1634 | 1695 |
STEXI |
1635 | 1696 |
@item -pidfile @var{file} |
1697 |
@findex -pidfile |
|
1636 | 1698 |
Store the QEMU process PID in @var{file}. It is useful if you launch QEMU |
1637 | 1699 |
from a script. |
1638 | 1700 |
ETEXI |
... | ... | |
1641 | 1703 |
"-singlestep always run in singlestep mode\n") |
1642 | 1704 |
STEXI |
1643 | 1705 |
@item -singlestep |
1706 |
@findex -singlestep |
|
1644 | 1707 |
Run the emulation in single step mode. |
1645 | 1708 |
ETEXI |
1646 | 1709 |
|
... | ... | |
1648 | 1711 |
"-S freeze CPU at startup (use 'c' to start execution)\n") |
1649 | 1712 |
STEXI |
1650 | 1713 |
@item -S |
1714 |
@findex -S |
|
1651 | 1715 |
Do not start CPU at startup (you must type 'c' in the monitor). |
1652 | 1716 |
ETEXI |
1653 | 1717 |
|
... | ... | |
1655 | 1719 |
"-gdb dev wait for gdb connection on 'dev'\n") |
1656 | 1720 |
STEXI |
1657 | 1721 |
@item -gdb @var{dev} |
1722 |
@findex -gdb |
|
1658 | 1723 |
Wait for gdb connection on device @var{dev} (@pxref{gdb_usage}). Typical |
1659 | 1724 |
connections will likely be TCP-based, but also UDP, pseudo TTY, or even |
1660 | 1725 |
stdio are reasonable use case. The latter is allowing to start qemu from |
... | ... | |
1668 | 1733 |
"-s shorthand for -gdb tcp::" DEFAULT_GDBSTUB_PORT "\n") |
1669 | 1734 |
STEXI |
1670 | 1735 |
@item -s |
1736 |
@findex -s |
|
1671 | 1737 |
Shorthand for -gdb tcp::1234, i.e. open a gdbserver on TCP port 1234 |
1672 | 1738 |
(@pxref{gdb_usage}). |
1673 | 1739 |
ETEXI |
... | ... | |
1676 | 1742 |
"-d item1,... output log to /tmp/qemu.log (use -d ? for a list of log items)\n") |
1677 | 1743 |
STEXI |
1678 | 1744 |
@item -d |
1745 |
@findex -d |
|
1679 | 1746 |
Output log in /tmp/qemu.log |
1680 | 1747 |
ETEXI |
1681 | 1748 |
|
... | ... | |
1685 | 1752 |
" translation (t=none or lba) (usually qemu can guess them)\n") |
1686 | 1753 |
STEXI |
1687 | 1754 |
@item -hdachs @var{c},@var{h},@var{s},[,@var{t}] |
1755 |
@findex -hdachs |
|
1688 | 1756 |
Force hard disk 0 physical geometry (1 <= @var{c} <= 16383, 1 <= |
1689 | 1757 |
@var{h} <= 16, 1 <= @var{s} <= 63) and optionally force the BIOS |
1690 | 1758 |
translation mode (@var{t}=none, lba or auto). Usually QEMU can guess |
... | ... | |
1696 | 1764 |
"-L path set the directory for the BIOS, VGA BIOS and keymaps\n") |
1697 | 1765 |
STEXI |
1698 | 1766 |
@item -L @var{path} |
1767 |
@findex -L |
|
1699 | 1768 |
Set the directory for the BIOS, VGA BIOS and keymaps. |
1700 | 1769 |
ETEXI |
1701 | 1770 |
|
... | ... | |
1703 | 1772 |
"-bios file set the filename for the BIOS\n") |
1704 | 1773 |
STEXI |
1705 | 1774 |
@item -bios @var{file} |
1775 |
@findex -bios |
|
1706 | 1776 |
Set the filename for the BIOS. |
1707 | 1777 |
ETEXI |
1708 | 1778 |
|
... | ... | |
1712 | 1782 |
#endif |
1713 | 1783 |
STEXI |
1714 | 1784 |
@item -enable-kvm |
1785 |
@findex -enable-kvm |
|
1715 | 1786 |
Enable KVM full virtualization support. This option is only available |
1716 | 1787 |
if KVM support is enabled when compiling. |
1717 | 1788 |
ETEXI |
... | ... | |
1728 | 1799 |
#endif |
1729 | 1800 |
STEXI |
1730 | 1801 |
@item -xen-domid @var{id} |
1802 |
@findex -xen-domid |
|
1731 | 1803 |
Specify xen guest domain @var{id} (XEN only). |
1732 | 1804 |
@item -xen-create |
1805 |
@findex -xen-create |
|
1733 | 1806 |
Create domain using xen hypercalls, bypassing xend. |
1734 | 1807 |
Warning: should not be used when xend is in use (XEN only). |
1735 | 1808 |
@item -xen-attach |
1809 |
@findex -xen-attach |
|
1736 | 1810 |
Attach to existing xen domain. |
1737 | 1811 |
xend will use this when starting qemu (XEN only). |
1738 | 1812 |
ETEXI |
... | ... | |
1741 | 1815 |
"-no-reboot exit instead of rebooting\n") |
1742 | 1816 |
STEXI |
1743 | 1817 |
@item -no-reboot |
1818 |
@findex -no-reboot |
|
1744 | 1819 |
Exit instead of rebooting. |
1745 | 1820 |
ETEXI |
1746 | 1821 |
|
... | ... | |
1748 | 1823 |
"-no-shutdown stop before shutdown\n") |
1749 | 1824 |
STEXI |
1750 | 1825 |
@item -no-shutdown |
1826 |
@findex -no-shutdown |
|
1751 | 1827 |
Don't exit QEMU on guest shutdown, but instead only stop the emulation. |
1752 | 1828 |
This allows for instance switching to monitor to commit changes to the |
1753 | 1829 |
disk image. |
... | ... | |
1758 | 1834 |
" start right away with a saved state (loadvm in monitor)\n") |
1759 | 1835 |
STEXI |
1760 | 1836 |
@item -loadvm @var{file} |
1837 |
@findex -loadvm |
|
1761 | 1838 |
Start right away with a saved state (@code{loadvm} in monitor) |
1762 | 1839 |
ETEXI |
1763 | 1840 |
|
... | ... | |
1767 | 1844 |
#endif |
1768 | 1845 |
STEXI |
1769 | 1846 |
@item -daemonize |
1847 |
@findex -daemonize |
|
1770 | 1848 |
Daemonize the QEMU process after initialization. QEMU will not detach from |
1771 | 1849 |
standard IO until it is ready to receive connections on any of its devices. |
1772 | 1850 |
This option is a useful way for external programs to launch QEMU without having |
... | ... | |
1777 | 1855 |
"-option-rom rom load a file, rom, into the option ROM space\n") |
1778 | 1856 |
STEXI |
1779 | 1857 |
@item -option-rom @var{file} |
1858 |
@findex -option-rom |
|
1780 | 1859 |
Load the contents of @var{file} as an option ROM. |
1781 | 1860 |
This option is useful to load things like EtherBoot. |
1782 | 1861 |
ETEXI |
... | ... | |
1786 | 1865 |
" To see what timers are available use -clock ?\n") |
1787 | 1866 |
STEXI |
1788 | 1867 |
@item -clock @var{method} |
1868 |
@findex -clock |
|
1789 | 1869 |
Force the use of the given methods for timer alarm. To see what timers |
1790 | 1870 |
are available use -clock ?. |
1791 | 1871 |
ETEXI |
... | ... | |
1807 | 1887 |
STEXI |
1808 | 1888 |
|
1809 | 1889 |
@item -rtc [base=utc|localtime|@var{date}][,clock=host|vm][,driftfix=none|slew] |
1890 |
@findex -rtc |
|
1810 | 1891 |
Specify @option{base} as @code{utc} or @code{localtime} to let the RTC start at the current |
1811 | 1892 |
UTC or local time, respectively. @code{localtime} is required for correct date in |
1812 | 1893 |
MS-DOS or Windows. To start at a specific point in time, provide @var{date} in the |
... | ... | |
1830 | 1911 |
" instruction\n") |
1831 | 1912 |
STEXI |
1832 | 1913 |
@item -icount [@var{N}|auto] |
1914 |
@findex -icount |
|
1833 | 1915 |
Enable virtual instruction counter. The virtual cpu will execute one |
1834 | 1916 |
instruction every 2^@var{N} ns of virtual time. If @code{auto} is specified |
1835 | 1917 |
then the virtual cpu speed will be automatically adjusted to keep virtual |
... | ... | |
1846 | 1928 |
" enable virtual hardware watchdog [default=none]\n") |
1847 | 1929 |
STEXI |
1848 | 1930 |
@item -watchdog @var{model} |
1931 |
@findex -watchdog |
|
1849 | 1932 |
Create a virtual hardware watchdog device. Once enabled (by a guest |
1850 | 1933 |
action), the watchdog must be periodically polled by an agent inside |
1851 | 1934 |
the guest or else the guest will be restarted. |
... | ... | |
1895 | 1978 |
STEXI |
1896 | 1979 |
|
1897 | 1980 |
@item -echr @var{numeric_ascii_value} |
1981 |
@findex -echr |
|
1898 | 1982 |
Change the escape character used for switching to the monitor when using |
1899 | 1983 |
monitor and serial sharing. The default is @code{0x01} when using the |
1900 | 1984 |
@code{-nographic} option. @code{0x01} is equal to pressing |
... | ... | |
1913 | 1997 |
" set virtio console\n") |
1914 | 1998 |
STEXI |
1915 | 1999 |
@item -virtioconsole @var{c} |
2000 |
@findex -virtioconsole |
|
1916 | 2001 |
Set virtio console. |
1917 | 2002 |
|
1918 | 2003 |
This option is maintained for backward compatibility. |
... | ... | |
1924 | 2009 |
"-show-cursor show cursor\n") |
1925 | 2010 |
STEXI |
1926 | 2011 |
@item -show-cursor |
2012 |
@findex -show-cursor |
|
1927 | 2013 |
Show cursor. |
1928 | 2014 |
ETEXI |
1929 | 2015 |
|
... | ... | |
1931 | 2017 |
"-tb-size n set TB size\n") |
1932 | 2018 |
STEXI |
1933 | 2019 |
@item -tb-size @var{n} |
2020 |
@findex -tb-size |
|
1934 | 2021 |
Set TB size. |
1935 | 2022 |
ETEXI |
1936 | 2023 |
|
... | ... | |
1938 | 2025 |
"-incoming p prepare for incoming migration, listen on port p\n") |
1939 | 2026 |
STEXI |
1940 | 2027 |
@item -incoming @var{port} |
2028 |
@findex -incoming |
|
1941 | 2029 |
Prepare for incoming migration, listen on @var{port}. |
1942 | 2030 |
ETEXI |
1943 | 2031 |
|
... | ... | |
1945 | 2033 |
"-nodefaults don't create default devices\n") |
1946 | 2034 |
STEXI |
1947 | 2035 |
@item -nodefaults |
2036 |
@findex -nodefaults |
|
1948 | 2037 |
Don't create default devices. |
1949 | 2038 |
ETEXI |
1950 | 2039 |
|
... | ... | |
1954 | 2043 |
#endif |
1955 | 2044 |
STEXI |
1956 | 2045 |
@item -chroot @var{dir} |
2046 |
@findex -chroot |
|
1957 | 2047 |
Immediately before starting guest execution, chroot to the specified |
1958 | 2048 |
directory. Especially useful in combination with -runas. |
1959 | 2049 |
ETEXI |
... | ... | |
1964 | 2054 |
#endif |
1965 | 2055 |
STEXI |
1966 | 2056 |
@item -runas @var{user} |
2057 |
@findex -runas |
|
1967 | 2058 |
Immediately before starting guest execution, drop root privileges, switching |
1968 | 2059 |
to the specified user. |
1969 | 2060 |
ETEXI |
... | ... | |
1975 | 2066 |
#endif |
1976 | 2067 |
STEXI |
1977 | 2068 |
@item -prom-env @var{variable}=@var{value} |
2069 |
@findex -prom-env |
|
1978 | 2070 |
Set OpenBIOS nvram @var{variable} to given @var{value} (PPC, SPARC only). |
1979 | 2071 |
ETEXI |
1980 | 2072 |
#if defined(TARGET_ARM) || defined(TARGET_M68K) |
... | ... | |
1983 | 2075 |
#endif |
1984 | 2076 |
STEXI |
1985 | 2077 |
@item -semihosting |
2078 |
@findex -semihosting |
|
1986 | 2079 |
Semihosting mode (ARM, M68K only). |
1987 | 2080 |
ETEXI |
1988 | 2081 |
#if defined(TARGET_ARM) |
... | ... | |
1991 | 2084 |
#endif |
1992 | 2085 |
STEXI |
1993 | 2086 |
@item -old-param |
2087 |
@findex -old-param (ARM) |
|
1994 | 2088 |
Old param mode (ARM only). |
1995 | 2089 |
ETEXI |
1996 | 2090 |
|
... | ... | |
1998 | 2092 |
"-readconfig <file>\n") |
1999 | 2093 |
STEXI |
2000 | 2094 |
@item -readconfig @var{file} |
2095 |
@findex -readconfig |
|
2001 | 2096 |
Read device configuration from @var{file}. |
2002 | 2097 |
ETEXI |
2003 | 2098 |
DEF("writeconfig", HAS_ARG, QEMU_OPTION_writeconfig, |
... | ... | |
2005 | 2100 |
" read/write config file\n") |
2006 | 2101 |
STEXI |
2007 | 2102 |
@item -writeconfig @var{file} |
2103 |
@findex -writeconfig |
|
2008 | 2104 |
Write device configuration to @var{file}. |
2009 | 2105 |
ETEXI |
2010 | 2106 |
DEF("nodefconfig", 0, QEMU_OPTION_nodefconfig, |
... | ... | |
2012 | 2108 |
" do not load default config files at startup\n") |
2013 | 2109 |
STEXI |
2014 | 2110 |
@item -nodefconfig |
2111 |
@findex -nodefconfig |
|
2015 | 2112 |
Normally QEMU loads a configuration file from @var{sysconfdir}/qemu.conf and |
2016 | 2113 |
@var{sysconfdir}/target-@var{ARCH}.conf on startup. The @code{-nodefconfig} |
2017 | 2114 |
option will prevent QEMU from loading these configuration files at startup. |
Also available in: Unified diff