72
72
@item PC (x86 or x86_64 processor)
73
73
@item ISA PC (old style PC without PCI bus)
74
74
@item PREP (PowerPC processor)
75
@item G3 BW PowerMac (PowerPC processor)
75
@item G3 Beige PowerMac (PowerPC processor)
76
76
@item Mac99 PowerMac (PowerPC processor, in progress)
77
77
@item Sun4m/Sun4c/Sun4d (32-bit Sparc processor)
78
@item Sun4u (64-bit Sparc processor, in progress)
78
@item Sun4u/Sun4v (64-bit Sparc processor, in progress)
79
79
@item Malta board (32-bit and 64-bit MIPS processors)
80
@item MIPS Magnum (64-bit MIPS processor)
80
81
@item ARM Integrator/CP (ARM)
81
82
@item ARM Versatile baseboard (ARM)
82
83
@item ARM RealView Emulation baseboard (ARM)
83
@item Spitz, Akita, Borzoi and Terrier PDAs (PXA270 processor)
84
@item Spitz, Akita, Borzoi, Terrier and Tosa PDAs (PXA270 processor)
84
85
@item Luminary Micro LM3S811EVB (ARM Cortex-M3)
85
86
@item Luminary Micro LM3S6965EVB (ARM Cortex-M3)
86
87
@item Freescale MCF5208EVB (ColdFire V2).
87
88
@item Arnewsh MCF5206 evaluation board (ColdFire V2).
88
89
@item Palm Tungsten|E PDA (OMAP310 processor)
90
@item N800 and N810 tablets (OMAP2420 processor)
91
@item MusicPal (MV88W8618 ARM processor)
92
@item Gumstix "Connex" and "Verdex" motherboards (PXA255/270).
93
@item Siemens SX1 smartphone (OMAP310 processor)
91
96
For user emulation, x86, PowerPC, ARM, 32-bit MIPS, Sparc32/64 and ColdFire(m68k) CPUs are supported.
167
172
ENSONIQ AudioPCI ES1370 sound card
174
Intel 82801AA AC97 Audio compatible sound card
169
176
Adlib(OPL2) - Yamaha YM3812 compatible chip
178
Gravis Ultrasound GF1 sound card
180
CS4231A compatible sound card
171
182
PCI UHCI USB controller and a virtual USB hub.
174
185
SMP is supported with up to 255 CPUs.
176
Note that adlib is only available when QEMU was configured with
187
Note that adlib, gus and cs4231a are only available when QEMU was
188
configured with --audio-card-list option containing the name(s) of
179
191
QEMU uses the PC BIOS from the Bochs project and the Plex86/Bochs LGPL
182
194
QEMU uses YM3812 emulation by Tatsuyuki Satoh.
196
QEMU uses GUS emulation(GUSEMU32 @url{http://www.deinmeister.de/gusemu/})
197
by Tibor "TS" Schütz.
199
CS4231A is the chip used in Windows Sound System and GUSMAX products
186
203
@node pcsys_quickstart
235
264
@item file=@var{file}
236
265
This option defines which disk image (@pxref{disk_images}) to use with
266
this drive. If the filename contains comma, you must double it
267
(for instance, "file=my,,file" to use file "my,file").
238
268
@item if=@var{interface}
239
269
This option defines on which type on interface the drive is connected.
240
Available types are: ide, scsi, sd, mtd, floppy, pflash.
270
Available types are: ide, scsi, sd, mtd, floppy, pflash, virtio.
241
271
@item bus=@var{bus},unit=@var{unit}
242
272
These options define where is connected the drive by defining the bus number and
251
281
@item snapshot=@var{snapshot}
252
282
@var{snapshot} is "on" or "off" and allows to enable snapshot for given drive (see @option{-snapshot}).
253
283
@item cache=@var{cache}
254
@var{cache} is "on" or "off" and allows to disable host cache to access data.
284
@var{cache} is "none", "writeback", or "writethrough" and controls how the host cache is used to access block data.
285
@item format=@var{format}
286
Specify which disk @var{format} will be used rather than detecting
287
the format. Can be used to specifiy format=raw to avoid interpreting
288
an untrusted format header.
289
@item serial=@var{serial}
290
This option specifies the serial number to assign to the device.
293
By default, writethrough caching is used for all block device. This means that
294
the host page cache will be used to read and write data but write notification
295
will be sent to the guest only when the data has been reported as written by
296
the storage subsystem.
298
Writeback caching will report data writes as completed as soon as the data is
299
present in the host page cache. This is safe as long as you trust your host.
300
If your host crashes or loses power, then the guest may experience data
301
corruption. When using the @option{-snapshot} option, writeback caching is
304
The host page can be avoided entirely with @option{cache=none}. This will
305
attempt to do disk IO directly to the guests memory. QEMU may still perform
306
an internal copy of the data.
308
Some block drivers perform badly with @option{cache=writethrough}, most notably,
309
qcow2. If performance is more important than correctness,
310
@option{cache=writeback} should be used with qcow2. By default, if no explicit
311
caching is specified for a qcow2 disk image, @option{cache=writeback} will be
312
used. For all other disk types, @option{cache=writethrough} is the default.
257
314
Instead of @option{-cdrom} you can use:
259
316
qemu -drive file=file,index=2,media=cdrom
308
374
the raw disk image you use is not written back. You can however force
309
375
the write back by pressing @key{C-a s} (@pxref{disk_images}).
312
Disable boot signature checking for floppy disks in Bochs BIOS. It may
313
be needed to boot from old floppy disks.
315
377
@item -m @var{megs}
316
Set virtual RAM size to @var{megs} megabytes. Default is 128 MiB.
319
Simulate an SMP system with @var{n} CPUs. On the PC target, up to 255
320
CPUs are supported. On Sparc32 target, Linux limits the number of usable CPUs
378
Set virtual RAM size to @var{megs} megabytes. Default is 128 MiB. Optionally,
379
a suffix of ``M'' or ``G'' can be used to signify a value in megabytes or
380
gigabytes respectively.
382
@item -k @var{language}
384
Use keyboard layout @var{language} (for example @code{fr} for
385
French). This option is only needed where it is not easy to get raw PC
386
keycodes (e.g. on Macs, with some X11 servers or with a VNC
387
display). You don't normally need to use it on PC/Linux or PC/Windows
390
The available layouts are:
392
ar de-ch es fo fr-ca hu ja mk no pt-br sv
393
da en-gb et fr fr-ch is lt nl pl ru th
394
de en-us fi fr-be hr it lv nl-be pt sl tr
397
The default is @code{en-us}.
323
399
@item -audio-help
331
407
available sound hardware.
334
qemu -soundhw sb16,adlib hda
335
qemu -soundhw es1370 hda
336
qemu -soundhw all hda
410
qemu -soundhw sb16,adlib disk.img
411
qemu -soundhw es1370 disk.img
412
qemu -soundhw ac97 disk.img
413
qemu -soundhw all disk.img
341
Set the real time clock to local time (the default is to UTC
342
time). This option is needed to have correct date in MS-DOS or
345
@item -startdate @var{date}
346
Set the initial date of the real time clock. Valid format for
347
@var{date} are: @code{now} or @code{2006-06-17T16:01:21} or
348
@code{2006-06-17}. The default value is @code{now}.
350
@item -pidfile @var{file}
351
Store the QEMU process PID in @var{file}. It is useful if you launch QEMU
355
Daemonize the QEMU process after initialization. QEMU will not detach from
356
standard IO until it is ready to receive connections on any of its devices.
357
This option is a useful way for external programs to launch QEMU without having
358
to cope with initialization race conditions.
361
Use it when installing Windows 2000 to avoid a disk full bug. After
362
Windows 2000 is installed, you no longer need this option (this option
363
slows down the IDE transfers).
365
@item -option-rom @var{file}
366
Load the contents of @var{file} as an option ROM.
367
This option is useful to load things like EtherBoot.
417
Note that Linux's i810_audio OSS kernel (for AC97) module might
418
require manually specifying clocking.
421
modprobe i810_audio clocking=48000
430
Enable the USB driver (will be the default soon)
432
@item -usbdevice @var{devname}
433
Add the USB device @var{devname}. @xref{usb_devices}.
438
Virtual Mouse. This will override the PS/2 mouse emulation when activated.
441
Pointer device that uses absolute coordinates (like a touchscreen). This
442
means qemu is able to report the mouse position without having to grab the
443
mouse. Also overrides the PS/2 mouse emulation when activated.
445
@item disk:[format=@var{format}]:file
446
Mass storage device based on file. The optional @var{format} argument
447
will be used rather than detecting the format. Can be used to specifiy
448
format=raw to avoid interpreting an untrusted format header.
451
Pass through the host device identified by bus.addr (Linux only).
453
@item host:vendor_id:product_id
454
Pass through the host device identified by vendor_id:product_id (Linux only).
456
@item serial:[vendorid=@var{vendor_id}][,productid=@var{product_id}]:@var{dev}
457
Serial converter to host character device @var{dev}, see @code{-serial} for the
461
Braille device. This will use BrlAPI to display the braille output on a real
465
Network adapter that supports CDC ethernet and RNDIS protocols.
369
469
@item -name @var{name}
370
470
Sets the @var{name} of the guest.
371
This name will be display in the SDL window caption.
471
This name will be displayed in the SDL window caption.
372
472
The @var{name} will also be used for the VNC server.
474
@item -uuid @var{uuid}
384
487
the console. Therefore, you can still use QEMU to debug a Linux kernel
385
488
with a serial console.
492
Normally, QEMU uses SDL to display the VGA output. With this option,
493
QEMU can display the VGA output when in text mode using a
494
curses/ncurses interface. Nothing is displayed in graphical mode.
389
498
Do not use decorations for SDL windows and start them using the whole
390
499
available screen space. This makes the using QEMU in a dedicated desktop
391
500
workspace more convenient.
504
Use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt).
508
Disable SDL window close capability.
516
Rotate graphical output 90 deg left (only PXA LCD).
518
@item -vga @var{type}
519
Select type of VGA card to emulate. Valid values for @var{type} are
522
Cirrus Logic GD5446 Video card. All Windows versions starting from
523
Windows 95 should recognize and use this graphic card. For optimal
524
performances, use 16 bit color depth in the guest and the host OS.
525
(This one is the default)
527
Standard VGA card with Bochs VBE extensions. If your guest OS
528
supports the VESA 2.0 VBE extensions (e.g. Windows XP) and if you want
529
to use high resolution modes (>= 1280x1024x16) then you should use
532
VMWare SVGA-II compatible adapter. Use it if you have sufficiently
533
recent XFree86/XOrg server or Windows guest with a driver for this
393
539
@item -full-screen
394
540
Start in full screen.
408
@item @var{interface}:@var{d}
410
TCP connections will only be allowed from @var{interface} on display @var{d}.
411
By convention the TCP port is 5900+@var{d}. Optionally, @var{interface} can
412
be omitted in which case the server will bind to all interfaces.
414
@item @var{unix}:@var{path}
554
@item @var{host}:@var{d}
556
TCP connections will only be allowed from @var{host} on display @var{d}.
557
By convention the TCP port is 5900+@var{d}. Optionally, @var{host} can
558
be omitted in which case the server will accept connections from any host.
560
@item @code{unix}:@var{path}
416
562
Connections will be allowed over UNIX domain sockets where @var{path} is the
417
563
location of a unix socket to listen for connections on.
421
VNC is initialized by not started. The monitor @code{change} command can be used
422
to later start the VNC server.
567
VNC is initialized but not started. The monitor @code{change} command
568
can be used to later start the VNC server.
468
@item -k @var{language}
470
Use keyboard layout @var{language} (for example @code{fr} for
471
French). This option is only needed where it is not easy to get raw PC
472
keycodes (e.g. on Macs, with some X11 servers or with a VNC
473
display). You don't normally need to use it on PC/Linux or PC/Windows
476
The available layouts are:
478
ar de-ch es fo fr-ca hu ja mk no pt-br sv
479
da en-gb et fr fr-ch is lt nl pl ru th
480
de en-us fi fr-be hr it lv nl-be pt sl tr
483
The default is @code{en-us}.
491
Enable the USB driver (will be the default soon)
493
@item -usbdevice @var{devname}
494
Add the USB device @var{devname}. @xref{usb_devices}.
501
@item -net nic[,vlan=@var{n}][,macaddr=@var{addr}][,model=@var{type}]
627
@item -net nic[,vlan=@var{n}][,macaddr=@var{addr}][,model=@var{type}][,name=@var{name}]
502
628
Create a new Network Interface Card and connect it to VLAN @var{n} (@var{n}
503
629
= 0 is the default). The NIC is an ne2k_pci by default on the PC
504
target. Optionally, the MAC address can be changed. If no
630
target. Optionally, the MAC address can be changed to @var{addr}
631
and a @var{name} can be assigned for use in monitor commands. If no
505
632
@option{-net} option is specified, a single NIC is created.
506
633
Qemu can emulate several different models of network card.
507
634
Valid values for @var{type} are
508
635
@code{i82551}, @code{i82557b}, @code{i82559er},
509
636
@code{ne2k_pci}, @code{ne2k_isa}, @code{pcnet}, @code{rtl8139},
510
@code{smc91c111}, @code{lance} and @code{mcf_fec}.
637
@code{e1000}, @code{smc91c111}, @code{lance} and @code{mcf_fec}.
511
638
Not all devices are supported on all targets. Use -net nic,model=?
512
639
for a list of available devices for your target.
514
@item -net user[,vlan=@var{n}][,hostname=@var{name}]
641
@item -net user[,vlan=@var{n}][,hostname=@var{name}][,name=@var{name}]
515
642
Use the user mode network stack which requires no administrator
516
643
privilege to run. @option{hostname=name} can be used to specify the client
517
644
hostname reported by the builtin DHCP server.
519
@item -net tap[,vlan=@var{n}][,fd=@var{h}][,ifname=@var{name}][,script=@var{file}]
520
Connect the host TAP network interface @var{name} to VLAN @var{n} and
521
use the network script @var{file} to configure it. The default
522
network script is @file{/etc/qemu-ifup}. Use @option{script=no} to
523
disable script execution. If @var{name} is not
524
provided, the OS automatically provides one. @option{fd}=@var{h} can be
525
used to specify the handle of an already opened host TAP interface. Example:
646
@item -net channel,@var{port}:@var{dev}
647
Forward @option{user} TCP connection to port @var{port} to character device @var{dev}
649
@item -net tap[,vlan=@var{n}][,name=@var{name}][,fd=@var{h}][,ifname=@var{name}][,script=@var{file}][,downscript=@var{dfile}]
650
Connect the host TAP network interface @var{name} to VLAN @var{n}, use
651
the network script @var{file} to configure it and the network script
652
@var{dfile} to deconfigure it. If @var{name} is not provided, the OS
653
automatically provides one. @option{fd}=@var{h} can be used to specify
654
the handle of an already opened host TAP interface. The default network
655
configure script is @file{/etc/qemu-ifup} and the default network
656
deconfigure script is @file{/etc/qemu-ifdown}. Use @option{script=no}
657
or @option{downscript=no} to disable script execution. Example:
528
660
qemu linux.img -net nic -net tap
595
727
/path/to/linux ubd0=/path/to/root_fs eth0=mcast
730
@item -net vde[,vlan=@var{n}][,name=@var{name}][,sock=@var{socketpath}][,port=@var{n}][,group=@var{groupname}][,mode=@var{octalmode}]
731
Connect VLAN @var{n} to PORT @var{n} of a vde switch running on host and
732
listening for incoming connections on @var{socketpath}. Use GROUP @var{groupname}
733
and MODE @var{octalmode} to change default ownership and permissions for
734
communication port. This option is available only if QEMU has been compiled
735
with vde support enabled.
740
vde_switch -F -sock /tmp/myswitch
741
# launch QEMU instance
742
qemu linux.img -net nic -net vde,sock=/tmp/myswitch
599
746
Indicate that no network devices should be configured. It is used to
600
747
override the default configuration (@option{-net nic -net user}) which
817
Bluetooth(R) options:
821
Defines the function of the corresponding Bluetooth HCI. -bt options
822
are matched with the HCIs present in the chosen machine type. For
823
example when emulating a machine with only one HCI built into it, only
824
the first @code{-bt hci[...]} option is valid and defines the HCI's
825
logic. The Transport Layer is decided by the machine type. Currently
826
the machines @code{n800} and @code{n810} have one HCI and all other
830
The following three types are recognized:
834
(default) The corresponding Bluetooth HCI assumes no internal logic
835
and will not respond to any HCI commands or emit events.
837
@item -bt hci,host[:@var{id}]
838
(@code{bluez} only) The corresponding HCI passes commands / events
839
to / from the physical HCI identified by the name @var{id} (default:
840
@code{hci0}) on the computer running QEMU. Only available on @code{bluez}
841
capable systems like Linux.
843
@item -bt hci[,vlan=@var{n}]
844
Add a virtual, standard HCI that will participate in the Bluetooth
845
scatternet @var{n} (default @code{0}). Similarly to @option{-net}
846
VLANs, devices inside a bluetooth network @var{n} can only communicate
847
with other devices in the same network (scatternet).
850
@item -bt vhci[,vlan=@var{n}]
851
(Linux-host only) Create a HCI in scatternet @var{n} (default 0) attached
852
to the host bluetooth stack instead of to the emulated target. This
853
allows the host and target machines to participate in a common scatternet
854
and communicate. Requires the Linux @code{vhci} driver installed. Can
855
be used as following:
858
qemu [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5
861
@item -bt device:@var{dev}[,vlan=@var{n}]
862
Emulate a bluetooth device @var{dev} and place it in network @var{n}
863
(default @code{0}). QEMU can only emulate one type of bluetooth devices
868
Virtual wireless keyboard implementing the HIDP bluetooth profile.
878
Use it when installing Windows 2000 to avoid a disk full bug. After
879
Windows 2000 is installed, you no longer need this option (this option
880
slows down the IDE transfers).
883
Use it if you experience time drift problem in Windows with ACPI HAL.
884
This option will try to figure out how many timer interrupts were not
885
processed by the Windows guest and will re-inject them.
888
Disable boot signature checking for floppy disks in Bochs BIOS. It may
889
be needed to boot from old floppy disks.
892
Disable ACPI (Advanced Configuration and Power Interface) support. Use
893
it if your guest OS complains about ACPI problems (PC target machine
897
Disable HPET support.
899
@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}]...]
900
Add ACPI table with specified header fields and context from specified files.
670
904
Linux boot specific: When using these options, you can use a given
671
905
Linux kernel without installing it in the disk image. It can be useful
672
906
for easier testing of various kernels.
822
1062
The default device is @code{vc} in graphical mode and @code{stdio} in
823
1063
non graphical mode.
825
@item -echr numeric_ascii_value
826
Change the escape character used for switching to the monitor when using
827
monitor and serial sharing. The default is @code{0x01} when using the
828
@code{-nographic} option. @code{0x01} is equal to pressing
829
@code{Control-a}. You can select a different character from the ascii
830
control keys where 1 through 26 map to Control-a through Control-z. For
831
instance you could use the either of the following to change the escape
832
character to Control-t.
1065
@item -pidfile @var{file}
1066
Store the QEMU process PID in @var{file}. It is useful if you launch QEMU
1070
Do not start CPU at startup (you must type 'c' in the monitor).
839
1073
Wait gdb connection to port 1234 (@pxref{gdb_usage}).
840
1075
@item -p @var{port}
841
1076
Change gdb connection port. @var{port} can be either a decimal number
842
1077
to specify a TCP port, or a host device (same devices as the serial port).
844
Do not start CPU at startup (you must type 'c' in the monitor).
846
1080
Output log in /tmp/qemu.log
847
1081
@item -hdachs @var{c},@var{h},@var{s},[,@var{t}]
851
1085
all those parameters. This option is useful for old MS-DOS disk
855
1089
Set the directory for the BIOS, VGA BIOS and keymaps.
858
Simulate a standard VGA card with Bochs VBE extensions (default is
859
Cirrus Logic GD5446 PCI VGA). If your guest OS supports the VESA 2.0
860
VBE extensions (e.g. Windows XP) and if you want to use high
861
resolution modes (>= 1280x1024x16) then you should use this option.
864
Disable ACPI (Advanced Configuration and Power Interface) support. Use
865
it if your guest OS complains about ACPI problems (PC target machine
1091
@item -bios @var{file}
1092
Set the filename for the BIOS.
1095
Enable KQEMU full virtualization (default is user mode only).
1098
Disable KQEMU kernel module usage. KQEMU options are only available if
1099
KQEMU support is enabled when compiling.
1102
Enable KVM full virtualization support. This option is only available
1103
if KVM support is enabled when compiling.
868
1105
@item -no-reboot
869
1106
Exit instead of rebooting.
1109
Don't exit QEMU on guest shutdown, but instead only stop the emulation.
1110
This allows for instance switching to monitor to commit changes to the
1113
@item -loadvm @var{file}
872
1114
Start right away with a saved state (@code{loadvm} in monitor)
875
Enable semihosting syscall emulation (ARM and M68K target machines only).
877
On ARM this implements the "Angel" interface.
878
On M68K this implements the "ColdFire GDB" interface used by libgloss.
880
Note that this allows guest direct access to the host filesystem,
881
so should only be used with trusted guest OS.
1117
Daemonize the QEMU process after initialization. QEMU will not detach from
1118
standard IO until it is ready to receive connections on any of its devices.
1119
This option is a useful way for external programs to launch QEMU without having
1120
to cope with initialization race conditions.
1122
@item -option-rom @var{file}
1123
Load the contents of @var{file} as an option ROM.
1124
This option is useful to load things like EtherBoot.
1126
@item -clock @var{method}
1127
Force the use of the given methods for timer alarm. To see what timers
1128
are available use -clock ?.
1131
Set the real time clock to local time (the default is to UTC
1132
time). This option is needed to have correct date in MS-DOS or
1135
@item -startdate @var{date}
1136
Set the initial date of the real time clock. Valid formats for
1137
@var{date} are: @code{now} or @code{2006-06-17T16:01:21} or
1138
@code{2006-06-17}. The default value is @code{now}.
1140
@item -icount [N|auto]
1141
Enable virtual instruction counter. The virtual cpu will execute one
1142
instruction every 2^N ns of virtual time. If @code{auto} is specified
1143
then the virtual cpu speed will be automatically adjusted to keep virtual
1144
time within a few seconds of real time.
1146
Note that while this option can give deterministic behavior, it does not
1147
provide cycle accurate emulation. Modern CPUs contain superscalar out of
1148
order cores with complex cache hierarchies. The number of instructions
1149
executed often has little or no correlation with actual performance.
1151
@item -echr numeric_ascii_value
1152
Change the escape character used for switching to the monitor when using
1153
monitor and serial sharing. The default is @code{0x01} when using the
1154
@code{-nographic} option. @code{0x01} is equal to pressing
1155
@code{Control-a}. You can select a different character from the ascii
1156
control keys where 1 through 26 map to Control-a through Control-z. For
1157
instance you could use the either of the following to change the escape
1158
character to Control-t.
1165
Immediately before starting guest execution, chroot to the specified
1166
directory. Especially useful in combination with -runas.
1169
Immediately before starting guest execution, drop root privileges, switching
1170
to the specified user.
981
1272
Show various information about the system state.
1276
show the version of QEMU
984
1277
@item info network
985
1278
show the various VLANs and the associated devices
1280
show the character devices
986
1281
@item info block
987
1282
show the block devices
1284
show block device statistics
988
1285
@item info registers
989
1286
show the cpu registers
1288
show infos for each CPU
990
1289
@item info history
991
1290
show the command line history
1292
show the interrupts statistics (if available)
1294
show i8259 (PIC) state
993
show emulated PCI device
1296
show emulated PCI device info
1298
show virtual to physical memory mappings (i386 only)
1300
show the active virtual memory mappings (i386 only)
1302
show state of HPET (i386 only)
1304
show KQEMU information
1306
show KVM information
995
1308
show USB devices plugged on the virtual USB hub
996
1309
@item info usbhost
997
1310
show all USB host devices
1312
show profiling information
998
1313
@item info capture
999
1314
show information about active capturing
1000
1315
@item info snapshots
1001
1316
show list of VM snapshots
1318
show the current VM status (running|paused)
1320
show guest PCMCIA status
1002
1321
@item info mice
1003
1322
show which guest mouse is receiving events
1324
show the vnc server status
1326
show the current VM name
1328
show the current VM UUID
1332
show SLIRP statistics (if available)
1334
show migration status
1336
show balloon information
1006
1339
@item q or quit
1045
1380
@item screendump @var{filename}
1046
1381
Save screen into PPM image @var{filename}.
1048
@item mouse_move @var{dx} @var{dy} [@var{dz}]
1049
Move the active mouse to the specified coordinates @var{dx} @var{dy}
1050
with optional scroll axis @var{dz}.
1052
@item mouse_button @var{val}
1053
Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
1055
@item mouse_set @var{index}
1056
Set which mouse device receives events at given @var{index}, index
1057
can be obtained with
1062
@item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
1063
Capture audio into @var{filename}. Using sample rate @var{frequency}
1064
bits per sample @var{bits} and number of channels @var{channels}.
1068
@item Sample rate = 44100 Hz - CD quality
1070
@item Number of channels = 2 - Stereo
1073
@item stopcapture @var{index}
1074
Stop capture with a given @var{index}, index can be obtained with
1383
@item logfile @var{filename}
1384
Output logs to @var{filename}.
1079
1386
@item log @var{item1}[,...]
1080
1387
Activate logging of the specified items to @file{/tmp/qemu.log}.
1191
1507
hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor
1192
1508
command @code{info usb} to see the devices you can remove.
1510
@item mouse_move @var{dx} @var{dy} [@var{dz}]
1511
Move the active mouse to the specified coordinates @var{dx} @var{dy}
1512
with optional scroll axis @var{dz}.
1514
@item mouse_button @var{val}
1515
Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
1517
@item mouse_set @var{index}
1518
Set which mouse device receives events at given @var{index}, index
1519
can be obtained with
1524
@item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
1525
Capture audio into @var{filename}. Using sample rate @var{frequency}
1526
bits per sample @var{bits} and number of channels @var{channels}.
1530
@item Sample rate = 44100 Hz - CD quality
1532
@item Number of channels = 2 - Stereo
1535
@item stopcapture @var{index}
1536
Stop capture with a given @var{index}, index can be obtained with
1541
@item memsave @var{addr} @var{size} @var{file}
1542
save to disk virtual memory dump starting at @var{addr} of size @var{size}.
1544
@item pmemsave @var{addr} @var{size} @var{file}
1545
save to disk physical memory dump starting at @var{addr} of size @var{size}.
1547
@item boot_set @var{bootdevicelist}
1549
Define new values for the boot device list. Those values will override
1550
the values specified on the command line through the @code{-boot} option.
1552
The values that can be specified here depend on the machine type, but are
1553
the same that can be specified in the @code{-boot} command line option.
1556
Inject an NMI on the given CPU.
1558
@item migrate [-d] @var{uri}
1559
Migrate to @var{uri} (using -d to not wait for completion).
1561
@item migrate_cancel
1562
Cancel the current VM migration.
1564
@item migrate_set_speed @var{value}
1565
Set maximum speed to @var{value} (in bytes) for migrations.
1567
@item balloon @var{value}
1568
Request VM to change its memory allocation to @var{value} (in MB).
1570
@item set_link @var{name} [up|down]
1571
Set link @var{name} up or down.
1196
1575
@subsection Integer expressions
1392
1778
@item write to the FAT directory on the host system while accessing it with the guest system.
1781
@node disk_images_nbd
1782
@subsection NBD access
1784
QEMU can access directly to block device exported using the Network Block Device
1788
qemu linux.img -hdb nbd:my_nbd_server.mydomain.org:1024
1791
If the NBD server is located on the same host, you can use an unix socket instead
1795
qemu linux.img -hdb nbd:unix:/tmp/my_socket
1798
In this case, the block device must be exported using qemu-nbd:
1801
qemu-nbd --socket=/tmp/my_socket my_disk.qcow2
1804
The use of qemu-nbd allows to share a disk between several guests:
1806
qemu-nbd --socket=/tmp/my_socket --share=2 my_disk.qcow2
1809
and then you can use it with two guests:
1811
qemu linux1.img -hdb nbd:unix:/tmp/my_socket
1812
qemu linux2.img -hdb nbd:unix:/tmp/my_socket
1395
1815
@node pcsys_network
1396
1816
@section Network emulation
1527
1947
USB devices can be connected with the @option{-usbdevice} commandline option
1528
1948
or the @code{usb_add} monitor command. Available devices are:
1532
1952
Virtual Mouse. This will override the PS/2 mouse emulation when activated.
1534
1954
Pointer device that uses absolute coordinates (like a touchscreen).
1535
1955
This means qemu is able to report the mouse position without having
1536
1956
to grab the mouse. Also overrides the PS/2 mouse emulation when activated.
1537
@item @code{disk:@var{file}}
1957
@item disk:@var{file}
1538
1958
Mass storage device based on @var{file} (@pxref{disk_images})
1539
@item @code{host:@var{bus.addr}}
1959
@item host:@var{bus.addr}
1540
1960
Pass through the host device identified by @var{bus.addr}
1542
@item @code{host:@var{vendor_id:product_id}}
1962
@item host:@var{vendor_id:product_id}
1543
1963
Pass through the host device identified by @var{vendor_id:product_id}
1545
@item @code{wacom-tablet}
1546
1966
Virtual Wacom PenPartner tablet. This device is similar to the @code{tablet}
1547
1967
above but it can be used with the tslib library because in addition to touch
1548
1968
coordinates it reports touch pressure.
1549
@item @code{keyboard}
1550
1970
Standard USB keyboard. Will override the PS/2 keyboard (if present).
1971
@item serial:[vendorid=@var{vendor_id}][,product_id=@var{product_id}]:@var{dev}
1972
Serial converter. This emulates an FTDI FT232BM chip connected to host character
1973
device @var{dev}. The available character devices are the same as for the
1974
@code{-serial} option. The @code{vendorid} and @code{productid} options can be
1975
used to override the default 0403:6001. For instance,
1977
usb_add serial:productid=FA00:tcp:192.168.0.2:4444
1979
will connect to tcp port 4444 of ip 192.168.0.2, and plug that to the virtual
1980
serial converter, faking a Matrix Orbital LCD Display (USB ID 0403:FA00).
1982
Braille device. This will use BrlAPI to display the braille output on a real
1984
@item net:@var{options}
1985
Network adapter that supports CDC ethernet and RNDIS protocols. @var{options}
1986
specifies NIC options as with @code{-net nic,}@var{options} (see description).
1987
For instance, user-mode networking can be used with
1989
qemu [...OPTIONS...] -net user,vlan=0 -usbdevice net:vlan=0
1991
Currently this cannot be used in machines that support PCI NICs.
1992
@item bt[:@var{hci-type}]
1993
Bluetooth dongle whose type is specified in the same format as with
1994
the @option{-bt hci} option, @pxref{bt-hcis,,allowed HCI types}. If
1995
no type is given, the HCI logic corresponds to @code{-bt hci,vlan=0}.
1996
This USB device implements the USB Transport Layer of HCI. Example
1999
qemu [...OPTIONS...] -usbdevice bt:hci,vlan=3 -bt device:keyboard,vlan=3
1553
2003
@node host_usb_devices
1847
2297
@code{x/10i $cs*16+$eip} to dump the code at the PC position.
2300
Advanced debugging options:
2302
The default single stepping behavior is step with the IRQs and timer service routines off. It is set this way because when gdb executes a single step it expects to advance beyond the current instruction. With the IRQs and and timer service routines on, a single step might jump into the one of the interrupt or exception vectors instead of executing the current instruction. This means you may hit the same breakpoint a number of times before executing the instruction gdb wants to have executed. Because there are rare circumstances where you want to single step into an interrupt vector the behavior can be controlled from GDB. There are three commands you can query and set the single step behavior:
2304
@item maintenance packet qqemu.sstepbits
2306
This will display the MASK bits used to control the single stepping IE:
2308
(gdb) maintenance packet qqemu.sstepbits
2309
sending: "qqemu.sstepbits"
2310
received: "ENABLE=1,NOIRQ=2,NOTIMER=4"
2312
@item maintenance packet qqemu.sstep
2314
This will display the current value of the mask used when single stepping IE:
2316
(gdb) maintenance packet qqemu.sstep
2317
sending: "qqemu.sstep"
2320
@item maintenance packet Qqemu.sstep=HEX_VALUE
2322
This will change the single step mask, so if wanted to enable IRQs on the single step, but not timers, you would use:
2324
(gdb) maintenance packet Qqemu.sstep=0x5
2325
sending: "qemu.sstep=0x5"
1850
2330
@node pcsys_os_specific
1851
2331
@section Target OS specific information
2025
2522
@node Sparc32 System emulator
2026
2523
@section Sparc32 System emulator
2028
Use the executable @file{qemu-system-sparc} to simulate a SPARCstation
2029
5, SPARCstation 10, SPARCstation 20, SPARCserver 600MP (sun4m
2030
architecture), SPARCstation 2 (sun4c architecture), SPARCserver 1000,
2031
or SPARCcenter 2000 (sun4d architecture). The emulation is somewhat
2032
complete. SMP up to 16 CPUs is supported, but Linux limits the number
2033
of usable CPUs to 4.
2035
QEMU emulates the following sun4m/sun4d peripherals:
2525
Use the executable @file{qemu-system-sparc} to simulate the following
2526
Sun4m architecture machines:
2541
SPARCstation Voyager
2548
The emulation is somewhat complete. SMP up to 16 CPUs is supported,
2549
but Linux limits the number of usable CPUs to 4.
2551
It's also possible to simulate a SPARCstation 2 (sun4c architecture),
2552
SPARCserver 1000, or SPARCcenter 2000 (sun4d architecture), but these
2553
emulators are not usable yet.
2555
QEMU emulates the following sun4m/sun4c/sun4d peripherals:
2037
2557
@itemize @minus
2098
2620
@node Sparc64 System emulator
2099
2621
@section Sparc64 System emulator
2101
Use the executable @file{qemu-system-sparc64} to simulate a Sun4u machine.
2102
The emulator is not usable for anything yet.
2623
Use the executable @file{qemu-system-sparc64} to simulate a Sun4u
2624
(UltraSPARC PC-like machine), Sun4v (T1 PC-like machine), or generic
2625
Niagara (T1) machine. The emulator is not usable for anything yet, but
2626
it can launch some kernels.
2104
QEMU emulates the following sun4u peripherals:
2628
QEMU emulates the following peripherals:
2106
2630
@itemize @minus
2110
2634
PCI VGA compatible card with VESA Bochs Extensions
2636
PS/2 mouse and keyboard
2112
2638
Non Volatile RAM M48T59
2114
2640
PC-compatible serial ports
2642
2 PCI IDE interfaces with hard disk and CD-ROM support
2647
@c man begin OPTIONS
2649
The following options are specific to the Sparc64 emulation:
2653
@item -prom-env string
2655
Set OpenBIOS variables in NVRAM, for example:
2658
qemu-system-sparc64 -prom-env 'auto-boot?=false'
2661
@item -M [sun4u|sun4v|Niagara]
2663
Set the emulated machine type. The default is sun4u.
2117
2669
@node MIPS System emulator
2118
2670
@section MIPS System emulator
2120
2672
Four executables cover simulation of 32 and 64-bit MIPS systems in
2121
2673
both endian options, @file{qemu-system-mips}, @file{qemu-system-mipsel}
2122
2674
@file{qemu-system-mips64} and @file{qemu-system-mips64el}.
2123
Four different machine types are emulated:
2675
Five different machine types are emulated:
2125
2677
@itemize @minus
2320
2890
Three on-chip UARTs
2893
Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 / 48)
2894
emulation supports the following elements:
2898
Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
2900
RAM and non-volatile OneNAND Flash memories
2902
Display connected to EPSON remote framebuffer chip and OMAP on-chip
2903
display controller and a LS041y3 MIPI DBI-C controller
2905
TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen controllers
2906
driven through SPI bus
2908
National Semiconductor LM8323-controlled qwerty keyboard driven
2909
through I@math{^2}C bus
2911
Secure Digital card connected to OMAP MMC/SD host
2913
Three OMAP on-chip UARTs and on-chip STI debugging console
2915
A Bluetooth(R) transciever and HCI connected to an UART
2917
Mentor Graphics "Inventra" dual-role USB controller embedded in a TI
2918
TUSB6010 chip - only USB host mode is supported
2920
TI TMP105 temperature sensor driven through I@math{^2}C bus
2922
TI TWL92230C power management companion with an RTC on I@math{^2}C bus
2924
Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
2323
2928
The Luminary Micro Stellaris LM3S811EVB emulation includes the following
2348
2953
OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via SSI.
2956
The Freecom MusicPal internet radio emulation includes the following
2961
Marvell MV88W8618 ARM core.
2963
32 MB RAM, 256 KB SRAM, 8 MB flash.
2967
MV88W8xx8 Ethernet controller
2969
MV88W8618 audio controller, WM8750 CODEC and mixer
2971
128�64 display with brightness control
2973
2 buttons, 2 navigation wheels with button function
2976
The Siemens SX1 models v1 and v2 (default) basic emulation.
2977
The emulaton includes the following elements:
2981
Texas Instruments OMAP310 System-on-chip (ARM 925T core)
2983
ROM and RAM memories (ROM firmware image can be loaded with -pflash)
2985
1 Flash of 16MB and 1 Flash of 8MB
2989
On-chip LCD controller
2991
On-chip Real Time Clock
2993
Secure Digital card connected to OMAP MMC/SD host
2351
2998
A Linux 2.6 test image is available on the QEMU web site. More
2352
2999
information is available in the QEMU mailing-list archive.
3001
@c man begin OPTIONS
3003
The following options are specific to the ARM emulation:
3008
Enable semihosting syscall emulation.
3010
On ARM this implements the "Angel" interface.
3012
Note that this allows guest direct access to the host filesystem,
3013
so should only be used with trusted guest OS.
2354
3017
@node ColdFire System emulator
2355
3018
@section ColdFire System emulator
2629
3317
Act as if the host page size was 'pagesize' bytes
3320
@node BSD User space emulator
3321
@section BSD User space emulator
3326
* BSD Command line options::
3330
@subsection BSD Status
3334
target Sparc64 on Sparc64: Some trivial programs work.
3337
@node BSD Quick Start
3338
@subsection Quick Start
3340
In order to launch a BSD process, QEMU needs the process executable
3341
itself and all the target dynamic libraries used by it.
3345
@item On Sparc64, you can just try to launch any process by using the native
3349
qemu-sparc64 /bin/ls
3354
@node BSD Command line options
3355
@subsection Command line options
3358
usage: qemu-sparc64 [-h] [-d] [-L path] [-s size] [-bsd type] program [arguments...]
3365
Set the library root path (default=/)
3367
Set the stack size in bytes (default=524288)
3369
Set the type of the emulated BSD Operating system. Valid values are
3370
FreeBSD, NetBSD and OpenBSD (default).
3377
Activate log (logfile=/tmp/qemu.log)
3379
Act as if the host page size was 'pagesize' bytes
2632
3382
@node compilation
2633
3383
@chapter Compilation from the sources